Chapter 2   Installation


This chapter describes how to install and configure the iPlanet Application Server Enterprise Connector for Tuxedo. This chapter covers the following topics:

• About Installation

• Check the Packaging

• Hardware and Software Requirements

• Preparing to Install

• Installing the Tuxedo Enterprise Connector

• Configuring the Installation

• Copying files in Webless Installation

• Verifying the Installation

• Uninstalling

• Troubleshooting

About Installation

---

The Tuxedo Enterprise Connector installation procedure adds the following components to your system:

• Tuxedo Enterprise Connector software

• Sample applications

• Documentation

See Appendix A "Installed Components", for information about where the installation procedure copies files to your system.

Upgrade or Reinstall Issues

If upgrading an earlier version or reinstalling the current version of the Tuxedo Enterprise Connector the installation procedure overwrites the currently installed files. Uninstalling the current version is not required.

Installation of multiple enterprise connectors for multiple EISs (CICS, R/3, PSFT, and Tuxedo) on the same iPlanet Application Server is allowed.

---

Note	To avoid problems with overwriting files in use, stop the iPlanet Application Server before installing software. Always backup the system prior to installation including the UIF repository content.

---

Check the Packaging

---

The Tuxedo Enterprise Connector package includes the following items:

• One iPlanet Application Server Unified Integration Framework Install CD-ROM containing installation software, online documentation, and a README.txt file

• One iPlanet Application Server Enterprise Connector for Tuxedo Install CD-ROM containing installation software, online documentation, and a README.txt file

• One iPlanet Application Server Enterprise Connector Administrator's Guide

• One iPlanet Application Server Enterprise Connector Developer's Guide

• One iPlanet Unified Integration Framework Developer's Guide

Hardware and Software Requirements

---

The following table lists the hardware and software requirements for installing and running Tuxedo Enterprise Connector.

        

Component	Requirement
Computer and Operating System	One of the following systems: Intel Pentium microprocessor running Microsoft Windows NT version 4.0 with Service Pack 5 Sun SPARC running Solaris 2.6 Sun SPARC running Solaris 8
Memory	Per CPU: 128 MB minimum; 256 MB recommended
Available disk space	Total disk space: 200 MB on NT, 400 MB on Solaris, 800 MB on Solaris if installing both NetDynamics and iPlanet Application Server 6.0
CD-ROM drive	CD-ROM drive
Network software	TCP/IP
Browser software	One of the following web browsers: Netscape Communicator 4.5 Microsoft Internet Explorer 4.0 (NT only)
EIS	Tuxedo 6.5

  

Preparing to Install

---

Before installing the Tuxedo Enterprise Connector complete the following steps:

• Verify the Tuxedo server is properly configured, and has all the prerequisite software installed and running as described in "Hardware and Software Requirements".

• Verify the connectivity between the Tuxedo /WS and Tuxedo /T system before proceeding with the installation. The Tuxedo system comes with the simpapp sample application to help verification.

• Before installing the Tuxedo Enterprise Connector, stop the iPlanet Application Server if it is running. Without stopping the application server the installation program may not be able to overwrite files currently in use.

• Read the Tuxedo Enterprise Connector Release Notes for any last minute updates.

Installing the Tuxedo Enterprise Connector

---

This section describes how to install the Tuxedo Enterprise Connector on the iPlanet Application Server. This section covers the following topics:

• Windows NT Installation

• Unix-based Installation

Windows NT Installation

Verify the following software is installed before installing the Tuxedo Enterprise Connector:

• iPlanet Application Server 6.0 SP1

• Unified Integration Framework 6.0 SP1

• Tuxedo Workstation Client software 6.5

You must be logged in to Windows NT as the administrator to install the Tuxedo Enterprise Connector. To install the Tuxedo Enterprise Connector complete the following steps:

1. Read the README.txt file on the CD-ROM.

2. Copy NT/instux.zip from the CD-ROM into a temporary local directory.

3. Unzip instux.zip, then run setup.exe.

4. Read the Welcome message and click on the Next button.

Figure 2-1    Welcome Window

5. Read the License Agreement, click on the Yes button to agree and continue.

Figure 2-2    Software License Agreement Window

6. Read the Location of Installation window, choose an installation directory and click on the Next button.

   The iPlanet Enterprise Connector for Tuxedo must be installed in the same directory as the installed iPlanet Application Server.

   If the installer detects that the iPlanet Application Server and/or the UIF software is not installed, a message is displayed indicating the installation cannot continue. Click OK to exit Setup and install the required software.

Figure 2-3    Location of Installation Window

7. Read the Components to Install window, select the Enterprise Connector for TUXEDO 6.0 SP1 (Service Pack 1) checkbox and click on the Next button.

Figure 2-4    Components to Install Window

8. Read the Location of Tuxedo Workstation client software window and specify the directory where the Tuxedo Workstation Client software has been installed and click on the Next button.

   The Tuxedo Workstation Client software must be installed prior to installing the Tuxedo Enterprise Connector. The installer validates the directory specified and displays an error message if its an invalid Tuxedo directory. In order to proceed, a valid Tuxedo workstation directory must be specified.

Figure 2-5    Location of Tuxedo Workstation Window

9. Reads the Tuxedo Server Configuration window and specify the host name, port number and security level. When completed click on the Next button.

   Set the host name and port number to the hostname and workstation listener port intended to connect to Tuxedo system. This is equivalent to the WSNADDR environment variable set before running a workstation client. WSNADDR is constructed as //<hostname>:<port>. This information is mandatory because the Tuxedo Enterprise Connector connects to the Tuxedo system via the Tuxedo Workstation client.

   Set the security level to any of the three constants based on security level configured on the Tuxedo system. This is determined by the SECURITY parameter value in the RESOURCES section of the Tuxedo configuration file. Consult the Tuxedo system administrator to obtain the configured security level.

   If the Tuxedo system is configured with SECURITY it is necessary to pass the security information. The information is passed to the BEA Tuxedo system via a TPINIT buffer while the Tuxedo Enterprise Connector is attaching to the Tuxedo system.

   
   

   
   
   

   Constant	Type of Authentication
   NONE	The security level is configured to NONE. No additional information is needed by the Tuxedo Workstation client to connect to Tuxedo system. This is the default value used by the installer. If this option is selected the installer doesn't prompt for additional information.
   APP_PW	The security level is configured to APP_PW. This security level requires every client to provide an application password as part of joining the Tuxedo system. When this option is selected during installation, the installer prompts for an application password. The information is passed inside the TPINIT data structure when tpinit() is called by the Tuxedo Enterprise Connector.
   USER_AUTH/ACL/MANDATORY_ACL	The security level is configured to USER_ACL, ACL or MANDATORY_ACL. These levels require an application password as well as user specific data (user name, client name, and user password) which is passed to an authentication service before the client attaches to Tuxedo system. When this option is selected during installation, the installer prompts for an application password, user name, client name and user password. This information is passed inside the TPINIT data structure when tpinit() is called by the Tuxedo Enterprise Connector.

Please refer BEA Tuxedo Programmer's Guide for more details on security levels.

Figure 2-6    Tuxedo Server Configuration Window

10. (Optional) If the Security Level is set to APP_PW specify an application password and click on the Next button.

Figure 2-7    Client Authentication Information Window (for APP_PW option only)

11. (Optional) If the Security Level is set to USER_AUTH/ACL/MANDATORY_ACL specify an application password, user name, client name, and user password. When completed click on the Next button.

Figure 2-8    Client Authentication Information Window (for USER_ACL/ACL/MANDATORY_ACL option only)

12. Read the Configuration Summary window and review the setting to determine if they are correct. When complete press the Install button.

Figure 2-9    Configuration Summary Window

13. (Optional) These are the possible warning window(s) that can appear, if the installer detects that the Tuxedo Enterprise Connector is already installed. Choose Yes to overwrite the existing adapter type and all sample datasource definitions shipped with Tuxedo connector. Repository nodes bsp.adapterTypes.Tuxedo, bsp.dataSources.Tuxedo-OnlineBank, and bsp.dataSources.Tuxedo-SimpApp are overwritten by the installer. The user defined datasources are not overwritten. Select No if you are simply adding another iPlanet Application Server instance to an existing cluster.

Figure 2-10    Warning Windows

14. Read the Completion of Installation window which is displayed when all files are installed. Click on the Finish button. The Tuxedo Enterprise Connector is now installed.

    Configure your installation by setting the environment variables described in "Configuring the Installation".

    The machine must be rebooted and start the iPlanet Application Server before using the Tuxedo Enterprise Connector.

Figure 2-11    Completion of Installation Window

Unix-based Installation

Verify the following software is installed before installing the Tuxedo Enterprise Connector:

• iPlanet Application Server 6.0 SP1

• Unified Integration Framework 6.0 SP1

• Tuxedo Workstation Client software 6.5

The following procedure describes how to install the Tuxedo Enterprise Connector on Unix-based machines:

1. Insert the Tuxedo Enterprise Connector Install CD-ROM into the CD-ROM drive.

2. Mount the CD-ROM, for example, /cdrom/cdrom0.

3. Read the README.txt file on the CD-ROM.

4. Copy the Solaris/instux.tar file from the CD-ROM into a temporary directory.

5. Untar the instux.tar file and run the ./setup command.

6. Follow the instructions of the installation program. During installation, press the following key sequences for:

   CTRL+B to back up to the previous screen.

   CTRL+C to cancel the installation program. This results in an incomplete installation. To install again, rerun the installation program from the beginning.

7. The following welcome screen appears either press enter or type Yes to continue.

   iPlanet E-Commerce Solutions, A Sun-Netscape Alliance iPlanet Server Products Installation/Uninstallation ---------------------------------------------------------------- Welcome to the iPlanet Server Products installation program This program will install iPlanet Server Products and the iPlanet Console on your computer. It is recommended that you have "root" privilege to install the software. Tips for using the installation program: - Press "Enter" to choose the default and go to the next screen - Type "Control-B" to go back to the previous screen - Type "Control-C" to cancel the installation program - You can enter multiple items using commas to separate them. For example: 1, 2, 3 Would you like to continue with installation? [Yes]:

8. The following license agreement screen appears. If you agree with the terms of the license agreement either press enter or type Yes to continue.

   iPlanet E-Commerce Solutions, A Sun-Netscape Alliance iPlanet Server Products Installation/Uninstallation ---------------------------------------------------------------- BY INSTALLING THIS SOFTWARE YOU ARE CONSENTING TO BE BOUND BY AND ARE BECOMING A PARTY TO THE AGREEMENT FOUND IN THE LICENSE.TXT FILE. IF YOU DO NOT AGREE TO ALL OF THE TERMS OF THIS AGREEMENT, PLEASE DO NOT INSTALL OR USE THIS SOFTWARE. Do you agree to the license terms? [No]:

9. Press enter or type 1 to select "iPlanet Servers" as the item to install.

   iPlanet E-Commerce Solutions, A Sun-Netscape Alliance iPlanet Server Products Installation/Uninstallation ---------------------------------------------------------------- Select the items you would like to install: 1. iPlanet Servers Installs iPlanet Servers with the integrated Netscape     Console onto your computer. 2. iPlanet Console Installs iPlanet Console as a stand-alone Java application on your computer. To accept the default shown in brackets, press the Enter key. Select the component you want to install [1]:

10. Specify the iPlanet Application Server installation directory. This is the iAS root directory.

    The iPlanet Enterprise Connector for Tuxedo must be installed under the same directory the iPlanet Application Server is installed in.

    iPlanet E-Commerce Solutions, A Sun-Netscape Alliance iPlanet Server Products Installation/Uninstallation ---------------------------------------------------------------- This program will extract the server files and install them into a directory you specify. That directory is called the server root in the product documentation and will contain the server programs, the Administration Server, and the server configuration files. To accept the default shown in brackets, press the Enter key. Install location [/iPlanet/iAS6]:

11. The "iPlanet Server Products components" screen appears. Select the "Enterprise Connector for TUXEDO 6.0 SP1" to install and press enter.

    iPlanet E-Commerce Solutions, A Sun-Netscape Alliance iPlanet Server Products Installation/Uninstallation ---------------------------------------------------------------- iPlanet Server Products components: Components with a number in () contain additional subcomponents which you can select using subsequent screens. 1. Enterprise Connector for TUXEDO 6.0 SP1 (2) Specify the components you wish to install [All]:

12. The "Enterprise Connector for TUXEDO 6.0 components" screen appears. Press enter to install all components.

    iPlanet E-Commerce Solutions, A Sun-Netscape Alliance iPlanet Server Products Installation/Uninstallation ---------------------------------------------------------------- Enterprise Connector for TUXEDO 6.0 SP1 components: Components with a number in () contain additional subcomponents which you can select using subsequent screens. 1. Connector Core Components 2. Online Docs Specify the components you wish to install [1, 2]:

13. Specify the fully qualified domain name of the computer where the Tuxedo Enterprise Connector is being installing and press the Enter key.

    iPlanet E-Commerce Solutions, A Sun-Netscape Alliance iPlanet Server Products Installation/Uninstallation ---------------------------------------------------------------- Enter the fully qualified domain name of the computer on which you're installing server software. Using the form <hostname>.<domainname> Example: eros.airius.com. To accept the default shown in brackets, press the Enter key. Computer name [horse.red.iplanet.com]:

14. Specify the Unix user and group name under which your Tuxedo Enterprise Connector will run.

    The user and group name must have already been set up prior to running an installation.

    iPlanet E-Commerce Solutions, A Sun-Netscape Alliance iPlanet Server Products Installation/Uninstallation --------------------------------------------------------- Choose a Unix user and group to represent the iPlanet server in the user directory. The iPlanet server will run as this user. It is recommended that this user should have no privileges in the computer network system. The Administration Server will give this group some permissions in the server root to perform server-specific operations. If you have not yet created a user and group for the iPlanet server,create this user and group using your native UNIX system utilities. To accept the default shown in brackets, press the Return key. System User [nobody]: root System Group [nobody] : other

15. The Enter Tuxedo Workstation Directory screen appears. Specify the Tuxedo Workstation client installation directory and press Enter to continue.

    The Tuxedo Workstation Client software must be installed prior to installing the Tuxedo Enterprise Connector. The installer validates the directory specified and displays an error message if its an invalid Tuxedo directory. In order to proceed, a valid Tuxedo workstation directory must be specified.

    iPlanet E-Commerce Solutions, Sun-Netscape Alliance Enterprise Connector for TUXEDO Installation/Uninstallation ------------------------------------------------------------- The following information is needed in order to connect iAS Tuxedo Connector to the Tuxedo backend system. You will be prompted to give the Tuxedo Workstation Client Directory, Host Name and Port Number of workstation listener process, Security Level and related authentication parameters. Enter the directory where Tuxedo Workstation has been installed. Tuxedo Workstation Directory [/usr/tuxedo]:

16. The installer prompts for host name, port number and security level parameters.

    Specify the host name and port number to the hostname and workstation listener port you intend to connect to the Tuxedo system. This is equivalent to the WSNADDR environment variable you typically set before running the Tuxedo workstation client. WSNADDR is constructed as //<hostname>:<port>. This information is mandatory because the Tuxedo Enterprise Connector connects to the Tuxedo system via the Tuxedo workstation client.

    Specify the security level to any of the three constants based on security level configured on the Tuxedo system. This is determined by the SECURITY parameter value in the RESOURCES section of the Tuxedo configuration file. Consult the Tuxedo system administrator to obtain the configured security level.

    If the Tuxedo system is configured with SECURITY it is necessary to pass the security information. The information is passed to the BEA Tuxedo system via a TPINIT buffer while the Tuxedo Enterprise Connector is attaching to the Tuxedo system.

    
    

    
    
    

    Constant	Type of Authentication
    NONE	The security level is configured to NONE. No additional information is needed by the Tuxedo Workstation client to connect to Tuxedo system. This is the default value used by the installer. If this option is selected the installer doesn't prompt for additional information.
    APP_PW	The security level is configured to APP_PW. This security level requires every client to provide an application password as part of joining the Tuxedo system. When this option is selected during installation, the installer prompts for an application password. The information is passed inside the TPINIT data structure when tpinit() is called by the Tuxedo Enterprise Connector.
    USER_AUTH/ACL/MANDATORY_ACL	The security level is configured to USER_ACL, ACL or MANDATORY_ACL. These levels require an application password as well as user specific data (user name, client name, user password) which is passed to an authentication service before the client attaches to Tuxedo system. When this option is selected during installation, the installer prompts for an application password, user name, client name and user password. This information is passed inside the TPINIT data structure when tpinit() is called by the Tuxedo Enterprise Connector.

iPlanet E-Commerce Solutions, Sun-Netscape Alliance Enterprise Connector for TUXEDO Installation/Uninstallation ---------------------------------------------------------------- Please enter workstation listener process Host Name. Host Name:

iPlanet E-Commerce Solutions, Sun-Netscape Alliance Enterprise Connector for TUXEDO Installation/Uninstallation ---------------------------------------------------------------- Please enter workstation listener process Port Number. Port Number:

iPlanet E-Commerce Solutions, Sun-Netscape Alliance Enterprise Connector for TUXEDO Installation/Uninstallation ---------------------------------------------------------------- Please enter the Security Level at which you wish to access the Tuxedo domain. 1.NONE 2.APP_PW 3.USER_AUTH/ACL/MANDATORY_ACL Security Level[1]:

17. (Optional) The following screen is displayed if the Security Level is set to APP_PW. Enter the application password and press the Enter key.

    iPlanet E-Commerce Solutions, Sun-Netscape Alliance Enterprise Connector for TUXEDO Installation/Uninstallation ---------------------------------------------------------------- Please enter the Security Level at which you wish to access the Tuxedo domain. 1.NONE 2.APP_PW 3.USER_AUTH/ACL/MANDATORY_ACL Security Level[1]: 2 Please enter Application Password. Application Password:

18. (Optional) Installer prompts for the application password, user name, client name, and data (user password) if the Security Level is set to USER_AUTH/ ACL/MANDATORY_ACL. Enter the application password, user name, client name, and user password and press the Enter key.

    iPlanet E-Commerce Solutions, Sun-Netscape Alliance Enterprise Connector for TUXEDO Installation/Uninstallation ---------------------------------------------------------------- Application Password: User Name [raju]: Client Name [iastuxadapter]: Data (User Password):

19. Press Enter key to continue.

    iPlanet E-Commerce Solutions, Sun-Netscape Alliance Enterprise Connector for TUXEDO Installation/Uninstallation ---------------------------------------------------------------- Finished with gathering of information. Next, the Enterprise Connector for Tuxedo files will be extracted. After that, the configuration and registration based on your responses will begin. Please hit ENTER to continue:

20. (Optional) The following warning screen(s) appears, if the installer detects that the Tuxedo Enterprise Connector is already installed. Choose Yes to overwrite the existing adapter type and all sample datasource definitions shipped with Tuxedo connector. Repository nodes bsp.adapterTypes.Tuxedo, bsp.dataSources.Tuxedo-OnlineBank, and bsp.dataSources.Tuxedo-SimpApp are overwritten by the installer. The user defined datasources are not overwritten. Select No if you are simply adding another iPlanet Application Server instance to an existing cluster.

    The repository already contains a TUXEDO adapter definition. This will overwrite the existing adapter type and all sample datasource definitions for the TUXEDO adapter. Do *not* overwrite if you are simply adding another iAS instance to an existing cluster. Do you wish to overwrite ? Confirm? [No]:

    The repository already contains a TUXEDO adapter definition. This will overwrite the existing adapter type and all sample datasource definitions for the TUXEDO adapter. Do *not* overwrite if you are simply adding another iAS instance to an existing cluster. Do you wish to overwrite ? PLEASE RE-CONFIRM ! Confirm? [No]:

21. When all files are installed, the Completion of Installation screen appears. Press Return to continue. The Tuxedo Enterprise Connector installed.

    Configure your installation by setting the environment variables described in "Configuring the Installation".

    You must restart the iPlanet Application Server before using the Tuxedo Enterprise Connector.

Configuring the Installation

---

To configure the Tuxedo Enterprise Connector set and verify the environment variables, as shown below. Refer to BEA Tuxedo documentation for additional information.

Windows NT

• Add <tuxedo /ws rootdir>\bin to path environment variable.

• Add <tuxedo /ws rootdir>\locale\C to NLSPATH environment variable.

• Set TUXDIR environment variable to Tuxedo workstation client installation root directory.

Unix-based

• Add <tuxedo /ws rootdir>/lib to LD_LIBRARY_PATH environment variable.

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

• Add <tuxedo /ws rootdir>/locale/C to NLSPATH environment variable.

• Set TUXDIR environment variable to Tuxedo workstation client installation root directory.

  
  

  ---

  Note	There is no need to set the following Tuxedo environment variables: WSNADDR WSDEVICE These variables are set internally by the Tuxedo Enterprise Connector based on information provided during installation or while creating a new datasource using the Tuxedo Management Console.

  ---

  
  

It is highly recommended to have the Tuxedo Server (Tuxedo /T system) configured for both simple application and bank application to run the samples supplied with Tuxedo Enterprise Connector.

Copying files in Webless Installation

---

In a webless installation, the web server and iPlanet Application Server reside on separate machine. In this configuration mode the Tuxedo Enterprise Connector installation procedure will not automatically copy the HTML and image files pertaining to connector samples to web server document root directory. In order to run the samples shipped with Tuxedo Enterprise Connector, a set of HTML and image files must be copied manually from the iPlanet Application Server instance to web server instance. To do this, perform the following steps:

1. Create the tuxSamples directory under the web server document root directory. For example, <iWS installdir>/docs/tuxSamples.

2. Copy index.html file from <iAS rootdir>/ias/APPS/adapters/tux/htmldocs/tuxSamples directory to <iWS installdir>/docs/tuxSamples directory on web server machine.

3. Create TuxBank directory under <iWS installdir>/docs/GXApp directory on web server machine.

4. Create images directory under <iWS installdir>/docs/GXApp/TuxBank directory on web server machine.

5. Create TuxSimpApp directory under <iWS installdir>/docs/GXApp directory on web server machine.

6. Copy sindex.html file from <iAS rootdir>/ias/APPS/adapters/tux/htmldocs/GXApp/TuxSimpApp to <iWS installdir>/docs/GXApp/TuxSimpApp.

7. Copy bindex.html file from <iAS rootdir>/ias/APPS/adapters/tux/htmldocs/GXApp/TuxBank to <iWS installdir>/docs/GXApp/TuxBank.

8. Copy all image files under <iAS rootdir>/ias/APPS/adapters/tux/htmldocs/GXApp/TuxBank/images directory to <iWS installdir>/docs/GXApp/TuxBank/images directory.

Verifying the Installation

---

To verify the Tuxedo Enterprise Connector installation, complete the following steps:

1. Verify the Tuxedo server (the Tuxedo /T) has been properly installed and configured according to the instructions in the BEA Tuxedo documentation.

2. Verify the workstation listener is running on the Tuxedo server.

3. On the Tuxedo server, run the Tuxedo Simple Application (simpapp) server program, according to the instructions in the BEA Tuxedo documentation. This program offers the TOUPPER service, which converts the input string to upper case and returns it to the client.

4. Verify the Tuxedo workstation client software (Tuxedo /WS) has been properly installed and configured according to the instructions in the BEA Tuxedo documentation. The Tuxedo /WS software must be installed on the system where the iPlanet Application Server is installed.

5. Verify the connection between the Tuxedo server and Tuxedo workstation client software by running the sample application simpapp provided by the Tuxedo system.

6. Verify the environment variables are set correctly as described in "Configuring the Installation".

7. Verify the iPlanet Application Server engines (kas, kxs, and kjs) are running.

8. Start the Tuxedo Connector Sample application.

   Windows NT: From the Start/Programs menu, choose iPlanet Application Server 6.0 / TUXEDO Connector 6.0 - Sample Applications entry.

   Unix: Visit http://<hostname:port>/tuxSamples/index.html URL. Where hostname is your web server's hostname. Example, http://horse:80/tuxSamples/index.html.

   Figure 2-12 shows the Tuxedo samples index HTML page.

Figure 2-12    Tuxedo Samples Index HTML Page

Click the "Simple Tuxedo Application calling simpapp Tuxedo service" link. The input form for sample as shown in Figure 2-13.

Figure 2-13    Simple Tuxedo Application Input Form

Enter bonjou! (or any string) and click the Submit button. A successful message with the entered string in uppercase is displayed, as shown in Figure 2-14. If not, see "Troubleshooting".

Figure 2-14    bonjou! Test

Uninstalling

---

This section describes how to uninstall the Tuxedo Enterprise Connector from an iPlanet Application Server. It contains the following topics:

• Uninstalling from Windows NT

• Uninstalling from Unix-based Platform

• Deleting the Repository Content

• Unregistering the Tuxedo Extension

Uninstalling from Windows NT

Perform the following steps to uninstall the iPlanet Application Server Enterprise Connector for Tuxedo from a Windows NT system:

1. Choose Uninstaller from the Windows NT Start menu's Programs - iPlanet Application Server 6.0 entry. Figure 2-15 shows the iPlanet Uninstall window.

Figure 2-15    iPlanet Uninstall Window

2. Deselect all components except Enterprise Connector for TUXEDO 6.0 SP1, then click the Uninstall button.

   While deselecting the components for the Tuxedo Enterprise Connector, the uninstaller checks for dependencies between components.

   Deselect the components in the following order:

   • Netscape Server Products Core Components

   • Administration Services

   • Netscape Directory Suite

   • iPlanet Application Server 6.0

   • UIF 6.0 SP1

   • Enterprise Connectors other than Tuxedo, if present

   Deselect the subcomponents for iPlanet Application Server 6.0 in the following order:

   • Application Server 6.0 Core Binaries

   • Web Connector plug-in Component

   • Administrator Tool

   • Deployment Tool

   • Core Server Component

The iPlanet Enterprise Connector for Tuxedo has been removed.

If you do not follow the above order of deselection, alert messages are displayed and you may not be able to deselect the desired option.

Uninstalling from Unix-based Platform

Perform the following steps to uninstall the iPlanet Application Server Enterprise Connector for Tuxedo on Unix-based system:

1. Go to the iPlanet Application Server installation directory and type ./uninstall. The following screen is displayed.

   iPlanet E-Commerce Solutions, A Sun-Netscape Alliance iPlanet Server Products Installation/Uninstallation ---------------------------------------------------------------- The following are the SuiteSpot components currently installed on your machine: Components with a number in () contain additional subcomponents which you can select using subsequent screens. 1. iPlanet Server Family Core Components (3) 2. iPlanet Directory Suite (2) 3. Administration Services (2) 4. iPlanet Application Server Suite (4) 5. UIF 6.0 SP1 (2) 6. Enterprise Connector for TUXEDO 6.0 SP1 (2) Select the components you wish to uninstall (default: all) [All]:

2. Select the Enterprise Connector for TUXEDO 6.0 SP1 entry. The following screen is displayed:

   iPlanet E-Commerce Solutions, A Sun-Netscape Alliance iPlanet Server Products Installation/Uninstallation ---------------------------------------------------------------- The following are the Enterprise Connector for TUXEDO 6.0 components currently installed on your machine: Components with a number in () contain additional subcomponents which you can select using subsequent screens. 1. Connector Core Components 2. Online Docs Specify the components you wish to uninstall [1, 2]:

3. Select all subcomponents.

The iPlanet Enterprise Connector for Tuxedo has been removed.

Deleting the Repository Content

The uninstaller does not automatically delete the repository content related to the Tuxedo Enterprise Connector. Use the UIF Repository browser to delete the following nodes:

• bsp.adapterTypes.Tuxedo

• bsp.dataSources.<tux_ds_name>

where <tux_ds_name> is name of Tuxedo datasource.

In addition to the above repository content, the uninstaller may not delete the following files and directories:

• <iAS InstallDir>/APPS/TuxBank

• <iAS InstallDir>/APPS/TuxSimpApp

Unregistering the Tuxedo Extension

The uninstaller does not automatically unregister the Tuxedo extension in iPlanet Registry database.

To unregister, perform the following steps:

1. Open the iPlanet Registry Editor by typing kregedit at the command line.

2. Open the following key:

   SOFTWARE\iPlanet\Application Server\6.0\CCS0\Extensions\TuxedoAdapterExt\cTuxedoAdapterExt\ENABLED

3. Set the value to 0 and click OK to save your changes.

Troubleshooting

---

If a problem occurs during installation or if you cannot run the sample application:

• Review the system configuration as described in "Hardware and Software Requirements".

• Verify the iPlanet Application Server is installed properly.

• Verify the iPlanet Unified Integration Framework is installed properly.

• Verify the Tuxedo workstation client is installed properly.

• Verify the connection between the Tuxedo server and Tuxedo workstation is working correctly.

• Verify the installation steps were completed correctly, as described in "Installing the Tuxedo Enterprise Connector".

• Verify the configuration steps were completed correctly, as described in "Configuring the Installation".

• Check the kas, kxs, and kjs engines logs for additional information.

Review the following list for possible problems and suggested action(s):

Installer unable to detect the iPlanet Application Server or Unified Integration Framework components	Check iPlanet Application Server and Unified Integration Framework software has been installed prior to installing the Tuxedo Enterprise Connector
Invalid Tuxedo Directory	Not a valid Tuxedo workstation client installation root directory. Check Tuxedo client software has been installed prior to installing the Tuxedo Enterprise Connector
Insufficient memory	Close other open programs
Network connection failed	See your network administrator
Insufficient disk space	Remove unnecessary files from the target volume
Unable to load Tuxedo Enterprise Connector extension	Check the LD_LIBRARY_PATH for <tuxedo /ws rootdir>/lib directory on Solaris. Check the path environment variable for <tuxedo /ws rootdir>\bin directory on NT.
Unable to locate DLL	Check the <tuxedo /ws rootdir>\bin directory is included in path environment variable
Cannot run the sample applications	Check the Tuxedo Connector and Tuxedo system configuration
Cannot open message catalog LIBWSC_CAT error message	Check the NLSPATH environment variable is set correctly
Tuxclient error:WorkerProcess Init() failed error message	Check the Tuxedo Server is up and running and WSNADDR is set correctly
Tuxedo Workstation client tpinit() failed error message	Check the Tuxedo Server is up and running and WSNADDR is set correctly