5.1 Task: Install LANSA Integrator on Linux
Step 1. Prepare for LANSA Integrator Installation
- Optionally, request the appropriate LANSA licenses. Licenses are only required at execution time, so you can request and install licenses after the install. Refer to 5.2 Task: Configure the Java Services Manager on Linux for more information.
- Install a Java Runtime Environment (JRE) on your Linux machine. You can install Integrator without a JRE, but you will not be able to run it until a JRE is installed. Java 1.4 or greater is required.
- Optionally, install LANSA for Linux. You should do this before installing LANSA Integrator if you plan to use Integrator from LANSA functions on the same Linux machine. If you have done this, the following items in this step will already have been completed:
- Optionally, create a new Linux group for the LANSA installation. This will allow you to restrict access to the LANSA files and directories to users who belong to a group.
- Create a Linux user id to 'own' LANSA for Linux. This user id is referred to as the LANSA owner.
- Create a directory for the LANSA installation. For example: /lansa. This directory is known as LANSAXROOT. A full install of LANSA Integrator takes around 11Mb of disk space (in addition to any other LANSA products you may have installed in the same location).
- Modify the LANSA owner's login script to export the environment variable LANSAXROOT set to the file system created for LANSA. Set umask to 022 if you wish any Linux user to be able to access the LANSA files and directories. Set umask to 027 if you wish to restrict access to users who belong to the same group as the LANSA owner.
- Alternatively, you may use the LANSA for Linux Installer to do the full installation, which would install both LANSA for Linux and LANSA Integrator for Linux under the same installation directory. LANSA Integrator for Linux installed this way will use the LANSA for Linux in the same installation by default. Refer to the LANSA for Linux Installer Overview for more information.
Step 2. Run the Installer
As the root user, change directory to the install directory and execute the installation script to copy files to their correct locations.
For default installation, i.e. installing all LANSA Integrator for Linux components, the following command line will check if the provided options are valid:
cd <Install image directory>
./liinstall.py –I <INTEGRATOR_ROOT> -O <LANSA Owner> -G <LANSA Group> \
–integrator-options={jsmserver,jsmproxy,useragent,rfi} \
–-integrator-lansa-root=<LANSAXROOT>
Note that the path for the option --integrator-lansa-root is referring to the LANSA for Linux installation that this LANSA Integrator for Linux installation is going to use. If that LANSA for Linux installation and this LANSA Integrator for Linux installation are installed into two different directories, the path for the option
--integrator-lansa-root would be different to that for the option -I that is referring to where this LANSA Integrator for Linux installation is going to reside.
After the above command is run, nothing from LANSA Integrator for Linux will be installed or modified just yet. The command will report if the options are correct and make sense. If there is error, please adjust the command line according to the command output. If there is no error, you can then commit the installation by adding the option --commit to the command line. The command line becomes:
cd <Install image directory>
./liinstall.py –I <INTEGRATOR_ROOT> -O <LANSA Owner> -G <LANSA Group> \
–integrator-options={jsmserver,jsmproxy,useragent,rfi} \
–-integrator-lansa-root=<LANSAXROOT> \
--commit
For customised installation, run the following command to see the full list of options for the installer:
./liinstall.py -h
- Once the install script has completed, please look at the output for any problems that occurred during the install.