Transoft AppIntegrate (Deployment)
UNIX Installation Instructions


Contents

Extracting the UNIX software

Create a base directory for the Transoft AppIntegrate Server software. For example, if you want to install the software in the directory /usr/tcf do the following:

su - Become superuser.
cd /usr  
mkdir tcf - Create the tcf directory.
cd tcf

 

You can either:

  • Load the software directly from a CD-ROM drive capable of reading the CD-R format CD on your UNIX platform, or
  • Use FTP to transfer the Transoft AppIntegrate Server archive file, which is in tar format, from the CD on your PC to the UNIX platform.

These two methods are detailed in the following sections.

Extracting the software directly from the CD on your UNIX platform

  • Ensure that the CD drive on your UNIX platform is capable of reading CD-R format (ISO 9660).
  • Ensure that you are familiar with the procedures to mount a UNIX file system, and that you have the necessary privileges (usually root).
  • You will need to have the correct device code for the local file system (the CD drive) argument of the mount command.
  • You need to have a directory mount point on the machine. In the examples below, this is assumed to be /cdrom, which must exist before the mount command can operate. The following commands below are typical, and are included to show the variations between platforms. They are not intended to be a complete or definitive list, but to illustrate the procedure employed.

    Data General DG/UX:
    mount -t cdrom -o noversion /dev/pdsk/3 /cdrom

    HP 9000 HP-UX:
    mount -F cdfs -o cdcase /dev/dsk/c1t2d0 /cdrom

    SCO OpenServer:
    mount -o lower /dev/cd0 /cdrom

    SCO UnixWare 2.1:
    mount -r -f cdfs /dev/cdrom/c0b0t5l0 /cdrom

  • The device code for the CD drive (the portion in italics in the above list) will vary between different installations, and it is essential that the correct code is used.
  • Some machines, for example the Sun SPARC Solaris, will auto-load the CD and mount the file system on /cdrom/cdrom0. These machines usually require the command eject after use.
  • When the CD is mounted (/cdrom, as above), the product archive can be found in the file /cdrom/UNIX/Server/<platform code>/*.tar. The platform code has _64 appended for 64bit versions of the software, e.g Transoft AppIntegrate Server for IBM AIX 5.3 32bit can be found in /cdrom/UNIX/Server/aix53/*.tar and for IBM AIX 5.2 64bit in /cdrom/UNIX/Server/aix53_64/*.tar.
  • To extract this file, use the tar command to read the file on the CD:

    tar xvf /cdrom/UNIX/Server/<platform code>/*.tar

    where xx is described above.
  • When the CD installation is complete, use the umount command to remove the mounted directory.

Using FTP to transfer the Server archive file from the CD on your PC to your UNIX platform

The FTP command sequence is as follows:

  1. At the DOS prompt, type:

    ftp

    to start an FTP session from your PC.


  2. At the ftp> prompt, type:

    open server_name

    to connect to your UNIX server, named server_name.


  3. Note: To access FTP's in-built Help, type help at the ftp> prompt.

  4. Log on to the FTP session with a valid server username and password.


  5. To change directory on the UNIX server to the base directory you created, for example, /usr/tcf, at the ftp> prompt, type:

    cd /usr/tcf


  6. At the ftp> prompt, type:

    lcd X:\UNIX\Server\<platform code>

    to change your local directory to the appropriate directory on the CD-ROM where X is the CD drive letter and is the relevant platform e.g. for Linux platform. X:\UNIX\Server\linux.


  7. At the ftp> prompt, type:

    binary

    to change the transfer type to binary. This step is very important.


  8. At ftp> prompt, type:

    mput *.tar

    to transfer the Transoft AppIntegrate Server archive to the UNIX server from the CD.


  9. To close the FTP session, at the ftp> prompt, type:

    bye


  10. Log on to the UNIX server with a terminal session, change to the base directory, for example /usr/tcf, and then tar the file:

    cd /usr/tcf
    tar xvf filename.tar


  11. Note: If the tar fails, the most likely cause is that you did not use binary transfer mode (see step 6). If this happens, repeat the FTP session.

Installing the UNIX software

Note: If you are installing a new version of the Transoft AppIntegrate Server software into the same directory as a previous version, make sure that the Transoft Component Broker executable, cfaappserver, is not running. To do this execute the tcf_setup.sh script from the base directory of the previous Server software installation (for example, /usr/tcf) as follows:

cd /usr/tcf
./tcf_setup.sh

Select the Stop Transoft Component Broker option.

After you have extracted the Transoft Component Adapters Server software, install it as follows:

  1. Go to your Server software base directory, for example /usr/tcf:

    cd /usr/tcf


  2. Run the script install.sh:

    ./install.sh

    This script performs the following:


    1. It checks that you are logged on as a superuser.
    2. It checks that you have TCP/IP installed and that it is enabled.
    3. It decompresses and checksums the files to ensure they are not corrupt.
    4. It tests for a free TCP/IP socket port and displays the number. You must record this number as you need it when you install the Transoft AppIntegrate Client software. If you forget this port number, you can find it in the install.data file in the base directory of your Server installation, for example, /usr/tcf, by performing:

      cd /usr/tcf
      more install.data


    5. For most platforms it requests whether you want to have the Transoft Component Broker started automatically at system boot time.

      Do you wish to have the Transoft Component Broker start at system boot time? (y/n):

      Answer y or n.

At this point the installation is complete. The next step is to license your Transoft Component Broker. Please refer to Chapter 4 Licensing of the Transoft AppIntegrate Installation & Licensing Guide.


 

Phone: 770-933-1965 (U.S.) or +44 (0) 1753 778000 (U.K.)
Copyright © Transoft Group Limited 2012. All rights reserved