GlassFish Wiki : M2GInstSetup

Installation and Setup

Migration Tool for Project GlassFish is distributed as a zip file.

Note - After installation, do not change the directory structure of the migration tool in anyway, since doing so might result in erratic or unexpected behavior.

System Requirements

Before installing the migration tool, make sure your system meets the following software and hardware requirements.

Software/Hardware	Requirement
Operating System	The migration tool runs on Solaris 9 on x86, Solaris 9 and 8 on Sparc with latest recommended patches , RedHat Linux 2.1, 3.0, Windows 2000 and XP. and Windows 2003
Java Virtual Machine	Download Java ; JRE alone will not suffice. Make sure <javase-install-dir>/bin directory is in the PATH environment variable. Set the JAVA_HOME enviroment variable to the installation directory. Note that currently Java SE 5 is required because of Issue 20
Free disk space	Minimum 40 MB
RAM	Minimum 128 MB, Recommended 256 MB

It is assumed that your system's CLASSPATH is already set up to include the directories and JAR files required by your application for compilation. This is inherited during compilation/build steps carried out after running the tool. Also note that the JARs contained in your JDK's lib/ext directory may conflict with those of the migration tool. In this case, delete the JARs contained in your JDK's lib/ext/.

Installing on Solaris

The following steps assume the migration tool has been downloaded to the /tmp directory. To install the migration tool on Solaris:
Unzip the zip file as follows:

 
        % cd /tmp 
 % unzip __ASMT.ZIP__

The directory structure appears as follows.

 
        &lt;INSTALL_DIR>/migrate2glassfish/
        |
        |-- bin
        |                
        |-- doc                
        |               
        |-- lib                
        |                
        |-- tools 
       

Before Invoking the Migration Tool, set the following environment variables appropriately:

JAVA_HOME – Set to the directory where the JDK is installed (for example, /opt/j2sdk1.4.0).
ASMT_HOME – Set to the directory where the migration tool is installed (for example, /opt/migrate2glassfish).
J2EE_HOME – Set to the directory where the J2EE application server is installed (for example, /opt/j2sdkee1.3.1). For more information please refer to the System Requirements section.
You can permanently set these variables in the asmigrate.sh script. To do so, open the file in any text editor. At the beginning of the file are the following lines:
```
# JAVA_HOME=
# ASMT_HOME= 
# J2EE_HOME=
```

Set the variables accordingly and remove the '#' in front of the lines.

Installing on Linux

The following steps assume the migration tool has been downloaded to the /tmp directory. To install the migration tool on Linux:
Unzip the zip file as follows:

 
        % cd /tmp 
% unzip __ASMT.ZIP__

The directory structure appears as follows.

 
        &lt;INSTALL_DIR>/
        |
        |-- bin
        |                
        |-- doc                
        |                             
        |-- lib                                
        |                
        |-- tools 
       

Before Invoking the Migration Tool, set the following environment variables appropriately:

JAVA_HOME – Set to the directory where the JDK is installed (for example, /opt/j2sdk1.4.0).
ASMT_HOME – Set to the directory where the migration tool is installed (for example, /opt/migrate2glassfish).
J2EE_HOME – Set to the directory where the J2EE application server is installed (for example, /opt/j2sdkee1.3.1). For more information please refer to the System Requirements section.
You can permanently set these variables in the asmigrate.sh script. To do so, open the file asmigrate.sh in any text editor. At the beginning of the file are the following lines:
```
# JAVA_HOME=
# ASMT_HOME= 
# J2EE_HOME=
```

Set the variables accordingly and remove the '#' in front of the lines.

Installing on Windows

The following steps assume the migration tool was downloaded to the C:\temp directory. To install the tool on the Windows:
Using WinZip or another uncompress utility, unzip the zip file.
The directory structure appears as follows.

 
        C:\migrate2glassfish\
        |
        |-- bin
        |                
        |-- doc                
        |               
        |-- lib                                
        |                
        |-- tools 
       

Before Invoking the Migration Tool, set the following environment variables appropriately:

JAVA_HOME – Set to the directory where the JDK is installed (for example, C:\j2sdk1.4.0).
ASMT_HOME – Set to the directory where the migration tool is installed (for example, C:\migrate2glassfish).
J2EE_HOME – Set to the directory where J2EE application server is installed.(for example, C:\j2sdkee1.3.1). For more information please refer to the System Requirements section.
You can permanently set these variables in the asmt.cmd script. To do so, open the file asmt.cmd in any text editor. At the beginning of the file are the following lines:
```
rem set JAVA_HOME= 
rem set ASMT_HOME=
rem set J2EE_HOME=
```

Set the variables accordingly and remove the 'rem' in front of the lines.

Preparing the Application Server to Run Migrated Applications

You must make some changes to the configuration of the Application Server to enable it to run the migrated applications. These changes enable the Application Server to recognize the runtime compatibility libraries that are distributed with the Migration Tool. The following section discusses this modification.
Complete the following steps for Windows, Solaris, and Linux:
In the Application Server Admin Console, navigate to Admin GUI -> Application Server -> JVM settings -> Path Settings -> Classpath Suffix.
Add <INSTALL_DIR>/migrate2glassfish/lib/asmt-rt.jar and save.

Previous Next