PreviousTOCNext Start of Help

Installation and Setup

The Migration Tool for Sun Java System Application Server  is distributed as a zip file for Solaris, Windows, and Linux platforms.  The zip file is named asmt-desginator-.zip, where designator is some combination of numbers and letters.

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

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 the following operating systems:
  • Solaris 9, 10 (SPARC and  -x86) Sun Java Desktop System PE
  • Red Hat Enterprise Linux 3.0 4.0
  • Windows 2000 Advanced Server and XP
  • Windows Server 2003
Java Virtual Machine Java 2 Standard Edition 1.4 _10 or later; JRE alone will not suffice. Make sure <j2se-install-dir>/bin directory is in the PATH environment variable. Set the JAVA_HOME enviroment variable to the installation directory (for example, c:\j2se_1_5)
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/.


TOP

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 asmt-desginator-.zip file as follows:

    % cd /tmp
    % unzip asmt-desginator-.zip

    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:
    2. 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 asmt-desginator-.zip file as follows:

      % cd /tmp
      % unzip asmt-desginator-.zip

      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:
      2. 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 asmt-desginator-.zip 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:
      2. 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.
    TOP
    Start of Help
    Copyright (c) 2006 Sun Microsystems, Inc. All rights reserved.