Chapter 2   Installation


This chapter describes how to install and configure UIF on the iPlanet Application Server.

The following topics are included in this chapter:

• Summary of Installation Tasks

• Checking Your Package

• Checking Hardware and Software Requirements

• Preparing to Install

• Installing UIF

• Uninstalling UIF

• Troubleshooting Your Installation

• Upgrade or Reinstall Issues

• Cluster Installations

Summary of Installation Tasks

---

To install UIF, complete the following tasks:

• Complete pre-installation tasks as needed, as described in "Preparing to Install".

• Install UIF according to the instructions for your target platform in "Installing UIF".

Checking Your Package

---

The UIF package is included with your iPlanet enterprise connector which includes the following items:

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

• One iPlanet Application Server Enterprise Connector Install CD-ROM contain installation software, online documentation, and 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.

Checking Hardware and Software Requirements

---

The following table lists the hardware and software requirements for installing and running UIF.  

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 the 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)
Other software	iPlanet Application Server 6.0 SP1 The iPlanet Application Server must be installed prior to installing UIF.

Preparing to Install

---

Before you install UIF complete the following steps:

1. Verify that the target system is properly configured and has all the prerequisite software installed and running, as described in "Checking Hardware and Software Requirements".

2. Before you install UIF, stop the iPlanet Application Server if it is currently running. The installation program may not be able to overwrite files that are currently in use.

3. Read the UIF Release Notes for any last minute updates.

Installing UIF

---

The UIF installation procedure adds the following components to your system:

• UIF software

• Documentation

This section describes how to install UIF on the iPlanet Application Server. It contains the following topics:

• Installing on Windows NT

• Installing on Unix

Installing on Windows NT

The iPlanet Application Server 6.0 SP1 is necessary software that must be installed before starting the UIF installation.

You must be logged on to Windows NT as a user with administrator privileges to install UIF.

To install UIF complete the following steps:

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

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

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

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

Figure 2-1    Welcome Window

5. The next window that appears is the Software License Agreement. Use the scroll bar or the Page Down key to read the License Agreement. Click on the Yes button if you agree.

Figure 2-2    Software License Agreement Window

6. The next window that appears is the Location of Installation. Choose your installation directory by clicking on the Browse button and navigate to the desired directory.

   Click the Next button after making your selection.

   
   

   ---

   Note	UIF must be installed in the same directory as the iPlanet Application Server.

   ---

   
   

   If installer detects that iPlanet Application Server software is not installed, a message is displayed indicating that you cannot continue with installation. Click OK to exit Setup.

Figure 2-3    Location of Installation Window

7. The Components to Install window appears. Select the UIF 6.0 SP1 checkbox or click on the Change button to select the desired components to install.

   Click the Next button after making your selection.

Figure 2-4    Components to Install Window

8. Review the Configuration Summary. If it is correct, press the Install button.

Figure 2-5    Configuration Summary Window

9. The installer displays these warning messages if you have already installed UIF, and you are reinstalling or upgrading UIF.

Figure 2-6    BSP Tree Overwrite Warning Messages

10. When all files are installed, the Completion of Installation window displays. Click on Finish.

    UIF has installed correctly and the system must now be rebooted to restart all iPlanet Application Server engines.

Figure 2-7    Completion of Installation Window

Installing on Unix

The iPlanet Application Server 6.0 SP1 is necessary software that must be installed before starting the UIF installation.

The following procedure describes how to install UIF on Unix:

1. Insert the UIF Install CD-ROM into the CD-ROM drive.

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

3. Copy Solaris/insbsp.tar from the Installed CD-ROM into a temporary directory.

4. Untar insbsp.tar, then run ./setup command.

5. Follow the instructions of the installation program. During installation, press:

   CTRL+B to back up to the previous screen within an installation section.

   CTRL+C if you need to exit the installation. This results in an incomplete installation. If you want to install again, you must run the installation program from the beginning.

6. The following welcome screen appears. 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]:

7. The following license agreement screen appears. If you agree with the terms of the license agreement, 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]:

8. Press enter or specify 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 iPlanet     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]:

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

   UIF must be installed in the same directory as the iPlanet Application Server.

   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]:

10. The following "iPlanet Server Products components" screen appears. Select "UIF6.0SP1" to install.

    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. UIF6.0SP1 (1) Specify the components you wish to install [All]:

11. The following "UIF6.0SP1 components" screen appears. Press enter to install all the components.

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

12. Specify fully qualified domain name of the computer on which you are 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]:

13. Specify the Unix user and group name under which UIF runs.

    You should have already set up this user and group name prior to running this 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

14. Press Enter key to continue.

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

15. The installer displays these warning messages if you have already installed UIF, and you are reinstalling or upgrading UIF.

    iPlanet E-Commerce Solutions, Sun-Netscape Alliance Unified Integration Framework Installation/Uninstallation ---------------------------------------------------------------- The repository already contains a BSP tree. Overwriting this will delete *all* adapter and datasource definitions currently existing. Do *not* overwrite if you are simply adding another iAS instance to an existing cluster. Do you wish to overwrite ? Confirm? [No]: y

    iPlanet E-Commerce Solutions, Sun-Netscape Alliance Unified Integration Framework Installation/Uninstallation ---------------------------------------------------------------- The repository already contains a BSP tree. Overwriting this will delete *all* adapter and datasource definitions currently existing. 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]: y

16. When all files are installed, the Completion of Installation screen appears. Press Return to continue. The system displays the following message:

    GO to <iplanet installation directory> & type startconsole to begin managing your servers.

Uninstalling UIF

---

This section describes how to uninstall UIF from your iPlanet Application Server. It contains the following topics:

• Uninstalling on Windows NT

• Uninstalling on Unix

Uninstalling on Windows NT

Perform the following steps to uninstall UIF from a Windows NT:

1. Choose Uninstaller from Windows NT Start menu's Programs - iPlanet Application Server 6.0 entry. The following iPlanet Uninstall window is displayed:

Figure 2-8    iPlanet Uninstall Window

2. Deselect all components except UIF 6.0 SP1, then click Uninstall button.

   While deselecting the components for UIF, 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

   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

UIF has been removed.

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

Uninstalling on Unix

Perform the following steps to uninstall UIF from a Unix:

1. Go to 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 iPlanet components currently installed on your machine: Components with a number in () contain additional subcomponents which you can select using subsequent screens. 1. iPlanet Server Products Core Components (3) 2. iPlanet Directory Suite (2) 3. Administration Services (2) 4. iPlanet Application Server Suite (4) 5. UIF 6.0 SP1(2) Select the components you wish to uninstall (default: all) [All]:

2. Select the UIF6.0SP1 entry. The following screen is displayed:

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

3. Select all subcomponents.

UIF has been removed.

Troubleshooting Your Installation

---

If a problem occurs during installation:

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

• Verify that iPlanet Application Server is installed properly.

• Verify that iPlanet Unified Integration Framework is installed properly.

• Verify that you completed the installation steps correctly, as described in "Installing UIF".

• Check the logs of KAS, KXS, and KJS engines for additional information.

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

 

Installer unable to detect iPlanet Application Server components	Check iPlanet Application Server software has been installed prior to installing UIF
Insufficient memory	Close other open programs
Network connection failed	See your network administrator
Insufficient disk space	Remove unnecessary files from the target volume

 

Upgrade or Reinstall Issues

---

If you are upgrading an earlier version or if you are reinstalling the current version of UIF, the installation procedure simply overwrites the installed files. You do not need to uninstall them first. Please refer to your iPlanet Application Server Enterprise Connector Administrator's Guide for details on backing up your earlier repository contents and upgrade issues.

---

Note

In all cases, to avoid problems with overwriting files that might be in use, stop the iPlanet Application Server before installing software. Also, backup the system prior to installation including the UIF repository content. UIF repository contents can be backed up by using the UIF Repository Browser. Use UIF Repository Browser export functionality to export the Adapter type and Data Source definitions to XML files.

---

Cluster Installations

---

A cluster is a group of iPlanet Application Servers connected in the same network that synchronize data. Data is shared by all servers in the cluster which is stored in an iPlanet Directory Server. In most cases, each server in the cluster share common Directory Server.

UIF and Enterprise Connector Clusters

In a server cluster, all iPlanet Application Servers, UIF, and enterprise connector instances share the same LDAP instance and configuration node.

• Although the UIF repository is shared across all iPlanet Application Servers in a cluster, each server in the cluster may or may not have an enterprise connector installed. If a server does not have an enterprise connector installed, it sees no datasource for the missing connector type. All servers with a given enterprise connector installed see the same set of datasources for that type.

• The UIF Repository Browser is used from any iPlanet Application Servers, UIF, and enterprise connector instances to manage the cluster's LDAP BSP (UIF) node.

• The Enterprise Connector Management Console is used to configure the enterprise connector, User Management and Data Mining for all cluster instances.

For details about webless and cluster installations refer to the iPlanet Application Server Installation Guide for details.