Using XMLink

---

Contents of the Installation Package

• Java files compiled in Java archives

• DTDs used for exchanging data in XML

• Software libraries used to access your Oracle Tuxedo applications

• Online documentation in HTML and PDF formats

• Resource adapter archives

Hardware and Software Requirements

XMLink requires a maximum of 2.1 MB of disk space, of which 1.5 MB is for online documentation.

In addition to XMLink, you need:

• J2EE-compliant application server, version 1.4 (The application server must support the Connection Architecture 1.5 Specification.)

• J2SE, version 1.4 (Latest versions of IBM WebSphere include this package.)

• JRE (Java Runtime Environment) installed on clients (Latest versions of IBM WebSphere include this package.)

• Oracle Tuxedo Server and Client installed, version 6.5 or higher

• Connector architecture reference packages needed by your application server

• For the XML interface, which uses the XML Connector class, an XML parser is required, such as Xerces.

  Figure 2-1 General Installation Setup

  

Installing XMLink on UNIX

Once they are installed, the files distributed with XMLink 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:

• (UNIX only) Login as root to install the files. After installation is complete, set the permissions so that only root can modify the files but all others can read and/or execute them. See chmod in your system manual, or type man chmod for information on setting permissions.

• Create a dummy login ID (for example, prolifics), then log in as that user and perform the installation. This allows whomever has access to the prolifics login account to control ownership, permissions, and modifications. This approach accommodates systems for which access to the root account is tightly controlled.

Determining File Location

After deciding who is going to own the XMLink 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, where C is the letter of the drive where you are installing XMLink.

How to Install from CD-ROM

Installing XMLink on UNIX requires you to copy the distribution from the delivered media.

1. Log in as root or with the login you are using 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 as /cdrom.
5. In /usr/prolifics, to uncompress and extract the contents of the Panther distribution, type the following.

   zcat < /cdrom/CompressedTarFilename | tar -xvf -

   For XMLink 3.0, the tar file name is tconn30.tar.Z.

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

Installing XMLink on Windows

XMLink 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 to install XMLink. The setup program guides you through the steps to install the software.