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:
- At the DOS prompt, type:
ftp
to start an FTP session from your PC.
- At the ftp> prompt, type:
open server_name
to connect to your UNIX server, named server_name.
Note: To access FTP's in-built
Help, type help at the ftp>
prompt. |
- Log on to the FTP session with a valid
server username and password.
- 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
- 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.
- At the ftp> prompt, type:
binary
to change the transfer type to binary. This step is very important.
- At ftp> prompt, type:
mput *.tar
to transfer the Transoft AppIntegrate Server archive to the UNIX
server from the CD.
- To close the FTP session, at the ftp>
prompt, type:
bye
- 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
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:
- Go to your Server software base
directory, for example /usr/tcf:
cd /usr/tcf
- Run the script install.sh:
./install.sh
This script performs the following:
- It checks that you are logged on as
a superuser.
- It checks that you have TCP/IP installed
and that it is enabled.
- It decompresses and checksums the files
to ensure they are not corrupt.
- 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
- 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.
|