Installation and Setup

After installation, you should NOT change the directory structure of the migration tool in anyway, since doing so might result in erratic or unexpected behavior.

This Installation Guide is organized as follows:

• System Requirements
• Installing on Solaris
• Installing on Linux
• Installing on Windows

System Requirements

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. The directories and files are inherited during compilation/build steps carried out after running the tool.
Note: The JAR files 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/ directory.

TOP

Installing on Solaris

Unzip the archive file as follows:

% cd /tmp
% unzip <asmt zip file>

The directory structure appears as follows.

           <INSTALL_DIR>/asmt/
                |
                |-- bin  
                |
                |-- doc
                |
                |-- examples
                |
                |-- lib
                |
                |-- log
                |
                `-- util

1. Before invoking the tool, set the following environment variables appropriately:
• JAVA_HOME -- Set to the directory where the JDK is installed (for example, /usr/java).
• ASMT_HOME -- Set to the directory where the migration tool is installed (for example, /opt/asmt).
• J2EE_HOME -- Set to the directory where the J2EE application server is installed (for example, /opt/appServer). 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.

TOP

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 archive file as follows:

% cd /tmp
% unzip <asmt zip file>

The  directory structure appears as follows.

           <INSTALL_DIR>/
                                                          
                |
                |
                |-- bin
                |
                |-- doc
                |
                |-- examples
                |
                |-- lib
                |
                |-- log
                |
                `-- util

1. Before invoking the tool, set the following environment variables appropriately:
• JAVA_HOME -- Set to the directory where the JDK is installed (for example, /usr/java).
• ASMT_HOME -- Set to the directory where the migration tool is installed (for example, /opt/asmt).
• J2EE_HOME -- Set to the directory where the J2EE application server is installed (for example, /opt/appServer). 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. 
TOP

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 archive file.

The directory structure appears as follows.

         C:\asmt\
                |
                |-- bin
                |
                |-- doc
                |
                |-- examples
                |
                |-- lib
                |
                |-- log
                |
                `-- util

1. Before invoking the tool, set the following environment variables appropriately:
• JAVA_HOME -- Set to the directory where the JDK is installed (for example, C:\java).
• ASMT_HOME -- Set to the directory where the migration tool is installed (for example, C:\asmt).
• J2EE_HOME -- Set to the directory where J2EE application server is installed.(for example, C:\appServer). For more information please refer to the System Requirements section.

                  You can permanently set these variables in the asmigrate.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.