Chapter 1   Installation


This chapter describes how to install the iPlanet Application Server 6.0 Enterprise Connector for Tuxedo, contains the following information:

• Hardware Requirements

• Software Requirements

• Installing the Tuxedo Enterprise Connector

• Post Installation Issues

Hardware Requirements

---

The hardware requirements for the connectors are common to all iPlanet Application Server UIF products.

Computer and Operating system	PC running Microsoft Windows NT version 4.0 with Service Pack 5 Sun SPARC running Solaris 2.6
Memory	Per CPU: 64 MB minimum; 128 MB recommended
Available disk space	Total disk space: 200 MB NT, 400 MB Solaris, 800 MB Solaris if installing both NetDynamics and iPlanet Application Server 6.0
CD-ROM drive

Software Requirements

---

The following software is required to be preinstalled on your system before you install iPlanet Application Server and the UIF with its enterprise connectors.

Component	Requirement
Base software	iPlanet Application Server 6.0 Unified Integration Framework 6.0 Tuxedo /WS client (version 6.5)
One of these web server:	iPlanet Web Server 4.1 Apache 1.36 (NT only) Microsoft Internet Information Server 4.0 (NT only) iPlanet Application Server Directory Server 4.0 (optional)
One of these web browsers:	Netscape Communicator 4.5 Microsoft Internet Explorer 4.0 (NT only)

UIF

Tuxedo /WS client (version 6.5) must be installed on the same system where the iPlanet Application Server is installed prior to the installation of the Tuxedo Enterprise Connector.

You must have the Tuxedo server configured for the Online Bank application in order to run the provided samples. The Online Bank application ships with the BEA Tuxedo software. The BEA Tuxedo workstation is a GUI-based client workstation application. If this is your first experience with the Tuxedo Enterprise Connector, it is strongly recommended that you familiarize yourself with the BEA Tuxedo Development Guide and the iPlanet Unified Integration Framework Developer's Guide.

Installing the Tuxedo Enterprise Connector

---

The Tuxedo Enterprise Connector product adds functionality to the iPlanet Application Server. Since it operates with the application server, it is also installed in the same directory with the iPlanet Application Server.

The software components installed include the Tuxedo Enterprise Connector, which is a shared object and the Tuxedo client, which is an executable file.

Installation and Configuration

The installation script, installs and configures a set of Tuxedo centered tools and samples, including:

• Tuxedo Enterprise Connector Runtime

• Tuxedo Enterprise Connector Tools

• Tuxedo Management Console

• BEA Jolt Migration Tool

• J2EE based Online Bank Sample Application (TuxBank)

• Online Bank Sample

• SimpApp Sample

• The UIF repository is populated with Tuxedo data types and (optionally) with the Tuxedo online bank data source, in XML format.

Running the Installer

For Windows NT, Unzip the provided file and from a local directory called <instux>, execute the <setup.exe>.

For Solaris, Run <tar -xvf *.tar and execute setup in the instux directory from the command line.

Input

Description

iPlanet Application Server Directory

root directory of iPlanet Application Server 6.0

BEA Tuxedo /WS Directory

BEA Tuxedo /WS client must be installed prior to installing the Tuxedo Connector.

Hostname and port

of /WS listner. Tuxedo Enterprise Connector would be preconfigured with WSNADDR as //<hostname>:<port>

Security Level

One of {NONE, APP_PW, USER_PW/ACL/MANDATORY_ACL}
Please refer BEA Tuxedo Programmer's Guide for more details on security. Tuxedo Connectory would be preconfigured with whatever selection you made here.

Password

For APP_PW and USER_PW/ACL/MANDATORY_ACL, /WS client needs to supply password when connecting to /WS listener on the Tuxedo Server. Tuxedo Enterprise Connector would be preconfigured to use this Password when connecting to WSL.

Usrname, cltname, data

For USER_PW/ACL/MANDATORY_ACL, /WS client needs to pass usrname and data when connecting to /WS listener on the Tuxedo Server. Tuxedo Enterprise Connector would be preconfigured to use this usrname and data when connecting to WSL. "> Install Time Parameter Requirements  
To install the Tuxedo Enterprise Connector, complete the following steps:

1. Read the Readme.txt file on the Installation CD-ROM disk.

2. Run setup.exe/setup.sh from the Installation CD-ROM disk.

3. Set the iPlanet application server directory to the iPlanet application server root directory.

4. Set the Tuxedo /WS Directory to the directory where the Tuxedo/WS client software is installed.

5. Set the hostname and port to the hostname and workstation listener port you intend to connect to.

   This is equivalent to the WSNADDR environment variable you typically set before running your workstation client. WSNADDR is typically constructed as:
   //<hostname>:<port>.

   For instance, if your hostname is scud and your port is 3424. WSNADDR would then be //scud:3424. If necessary, you can change the configuration and specify a different WSNADDR after installation.

6. Set the security level to any of the 3 constants for the kinds of security that a Tuxedo workstation client understands:

   Constant	Type of Authentication
   TPNOAUTH	None
   TPSYSAUTH	System
   TPAPPAUTH	Application

   Refer to the BEA Tuxedo Programmer's Guide for more details on security.

7. Set authentication data (password or usrname, client name and data) to a setting which corresponds to the authentication you specified:

   Constant	Authentication Data
   TPNOAUTH TPSYSAUTH	The workstation client needs to supply a password when connecting to the workstation listener on the Tuxedo Server. The password is passed inside the tpinit datastructure when tpinit() is called.
   TPAPPAUTH	The workstation client must pass values for usrname and data when connecting to a workstation listener on the Tuxedo Server.

Post Installation Issues

---

For Windows NT, set the path to include <tuxedo /ws root>\bin directory.

For Solaris, set LD_LIBRARY_PATH to include <tuxedo /ws root>/lib directory.

The LD_LIBRARY_PATH of the shell environment may be modified, or the script <ias root>/ias/bin/kjs may be used to include this path.

It is highly recommended to have the Tuxedo server configured for these sample applications.

During installation, if you chose to configure the Tuxedo server configured for Online Bank Sample or SimpApp sample. The supplied samples work out of the box, go to:

• samples link (on NT)

• http://<webserver hostname>:<webserver port>/GXApp/TuxBank/index.html

If you need to manually configure your system, refer to the BEA Tuxedo Programmer's Guide.