Using XMLink Universal Gateway

Chapter 3. Installing XMLink Universal Gateway

For XMLink Universal Gateway, you need to install software on your Tuxedo server and, in the case of RMI/IIOP configurations, on the Enterprise Information System (EIS), such as an IBM WebSphere system.

Before installing XMLink Universal Gateway, you need to know the Delivery Agent:

In this manual, configurations using SOAP-RPC are called SOAP implementations and configurations using RMI/IIOP are called RMI/IIOP implementations. Configurations interacting directly with the business logic EJBs are called EJB implementations.

Contents of the Installation Package

Hardware and Software Requirements

XMLink Universal Gateway requires a maximum of 2.2 MB of disk space, of which approximately 1.4 MB is for online documentation. Portions of the product are installed on the Tuxedo server machine and on the EIS machine.

In addition to XMLink Universal Gateway, you need:

Installing XMLink on UNIX and Linux

Implementing File Protection

Once they are installed, the files distributed with XMLink Universal Gateway should not be modified except under special circumstances. To prevent inadvertent changes to the files, we recommend that write-access to them be limited to a system administrator or a specially created prolifics login, and that general users be allowed only read-access.

Two suggested ways of implementing the above recommendations are:

Determining File Location

After deciding who is going to own the XMLink Universal Gateway files (root or a dummy login ID), determine where they will be installed. Do not change this directory once it is set up because users are likely to embed the directory name in makefiles, shell scripts, and so forth. The default installation directory on UNIX is /usr/prolifics. On Windows the default directory is:

C:\Program Files\Prolifics\XMLink Universal Gateway

where C is the letter of the drive where you are installing XMLink Universal Gateway.

How to Install from CD-ROM

Installing XMLink Universal Gateway on UNIX and Linux requires you to copy the distribution from the delivered media.

  1. Log in as root or with the login you created for the installation.
  2. At the command line, type the following.
    mkdir /usr/prolifics
  3. Go to the /usr/prolifics directory by typing the following.
    cd /usr/prolifics
  4. Mount the CD-ROM device, for example, as /dev/cdrom.
  5. In /usr/prolifics, to uncompress and extract the contents of the Panther distribution, type the following.
    zcat < /dev/cdrom/CompressedTarFilename | tar -xvf -

    For XMLink Universal Gateway 2.3, the tar file name is XUG230.tar.Z.

When XMLink Universal Gateway software is loaded, your regular prompt is displayed.

Installing XMLink on Windows

XMLink Universal Gateway is supplied in compressed form on CD-ROM along with a Windows-based setup program.

How to Run the Setup Program

  1. Insert the CD-ROM in the appropriate drive.
  2. If the setup program does not start automatically, choose StartRun. In the Run dialog box, type d:\setup (where d is the letter of the drive from which you are installing).
  3. Choose the components of XMLink Universal Gateway to install on that machine. There are three installation options: