These instructions contain important information about installing iPlanet Application Server, Enterprise Pro Edition, Version 6.0, SP3 (iAS EPE). Read this document carefully before you begin installing iPlanet Application Server and its bundled components.
An electronic version of these installation instructions can be found at the iPlanet documentation web site: http://docs.iplanet.com/docs/manuals/
These installation instructions contain the following sections:
iPlanet Application Server, Enterprise Pro Edition, Version 6.0, SP3 contains four bundled iPlanet products. These products are:
You may have previously installed versions of any one of the products bundled with this release of iAS EPE on your machine or network, which may or may not affect your installation strategy. The following scenarios can help you to install the products in the correct order. Be sure to follow installation instructions for your particular operating system and read the Release Notes.
Currently Installed Product(s)
To Upgrade to iAS EPE 6.0, SP3 on NT or Solaris
Currently, there is no upgrade path for versions of iAS and iPM below 6.0, SP2. If you have installed versions of either iAS 6.0, SP1 or iPM 6.0, SP1, you must uninstall these versions and follow "Scenario 1: Clean Install." After installing all necessary software, you must redeploy any previously deployed iPM applications.
If you are performing an upgrade using either "Scenario 2: iPM Version Upgrade" or "Scenario 3: iAS and iPM Version Upgrade," you do not need to redeploy or reregister iPM applications. The software upgrade installation preserves all iPM applications that are already registered with iAS.
Perform a Clean Install when you do not have any previously installed versions of the iAS EPE bundled products. Note that it is important to install the bundled software components in the correct order, as follows:
It is important to note that the Process Manager installation includes a unified install of the Application Server. Be sure to read the Release Notes for each piece of software before installing.
The iWS Release Notes and Installation Guide are located at the following url: http://docs.iplanet.com/docs/manuals/enterprise.html#41
The installation disk for iPM contains a unified install, which includes the installation of both iAS and iPM.
The iAS Release Notes and Installation Guide are located at the following url: http://docs.iplanet.com/docs/manuals/ias.html#sp3
The iAS EPE 6.0, SP3 Release Notes contain specific information about iPM 6.0, SP3. In it you will find explanations of bugs found or fixed in the iPM 6.0, SP3 release. Use the iPM 6.0, SP2 documentation as your source of information for using and administering iPlanet Process Manager with iAS EPE. For information specific to iAS 6.0, SP3 and UIF 6.0, SP2 see the Release Notes for each product. You can locate these documents at http://docs.iplanet.com
The iAS UIF Release Notes and Developer's Guide are located at the following url: http://docs.iplanet.com/docs/manuals/ias.html#uifsp2
The Installation Instructions for iAS UIF are located in the UIF Developer's Guide. The iAS UIF must be installed on the same machine or network cluster as the Application Server.
Perform an iPM Version Upgrade when you have iAS 6.0, SP3 and iPM 6.0, SP2 installed on your machine or network.
If you have iAS 6.0, SP3 and iPM 6.0, SP2 installed on your machine or network, you must install the patch for iAS 6.0, SP3 before installing iPM 6.0, SP3.
The iAS EPE 6.0, SP3 Release Notes contain specific information about iPM 6.0, SP3. In it you will find explanations of bugs found or fixed in the iPM 6.0, SP3 release. Use the iPM 6.0, SP2 documentation as your source of information for using and administering iPlanet Process Manager with iAS EPE. For information specific to iAS 6.0, SP3 and UIF 6.0, SP2 see the Release Notes for each product. You can locate these documents at http://docs.iplanet.com
Choosing to upgrade preserves all iPM applications that are already registered with iAS. You do not need to redeploy or reregister these applications.
During the upgrade process, the current version of the preferences.ini file is backed up in the builder directory. This backup copy, named preferences.ipm.n, contains your previously installed cluster and corporate directory information. n is a number in a sequence beginning with 0—the highest number indicates the latest file. You must copy this information to the new preferences.ini file.
To copy the information from the backup file (preferences.ipm.n) to the new preferences.ini file, see the section "Updating the preferences.ini File."
The iAS UIF Release Notes and Developer's Guide are located at the following url: http://docs.iplanet.com/docs/manuals/ias.html#uifsp2
The Installation Instructions for iAS UIF are located in the UIF Developer's Guide. The iAS UIF must be installed on the same machine or network cluster as the Application Server.
The installer searches for and finds the installation path of iPM 6.0, SP2. By default, the installer does not select iPM components to install.
Choosing to upgrade preserves all iPM applications that are already registered with iAS. You do not need to redeploy or reregister these applications.
During the upgrade process, the current version of the preferences.ini file is backed up in the builder directory. This backup copy, named preferences.ipm.n, contains your previously installed cluster and corporate directory information. n is a number in a sequence beginning with 0—the highest number indicates the latest file. You must copy this information to the new preferences.ini file.
To copy the information from the backup file (preferences.ipm.n) to the new preferences.ini file, see the section "Updating the preferences.ini File."
The iAS UIF Release Notes and Developer's Guide are located at the following url: http://docs.iplanet.com/docs/manuals/ias.html#uifsp2
The Installation Instructions for iAS UIF are located in the UIF Developer's Guide. The iAS UIF must be installed on the same machine or network cluster as the Application Server.
Perform an iAS and iPM Version Upgrade when you have iAS 6.0, SP2 and iPM 6.0, SP2 installed on your machine or network.
The iAS EPE 6.0, SP3 Release Notes contain specific information about iPM 6.0, SP3. In it you will find explanations of bugs found or fixed in the iPM 6.0, SP3 release. Use the iPM 6.0, SP2 documentation as your source of information for using and administering iPlanet Process Manager with iAS EPE. For information specific to iAS 6.0, SP3 and UIF 6.0, SP2 see the Release Notes for each product. You can locate these documents at http://docs.iplanet.com
Installer recognizes that the installation is an upgrade and prompts you for confirmation of the upgrade for both iAS and iPM.
Choosing to upgrade preserves all iPM applications that are already registered with iAS. You do not need to redeploy or reregister these applications.
During the upgrade process, the current version of the preferences.ini file is backed up in the builder directory. This backup copy, named preferences.ipm.n, contains your previously installed cluster and corporate directory information. n is a number in a sequence beginning with 0—the highest number indicates the latest file. You must copy this information to the new preferences.ini file.
To copy the information from the backup file (preferences.ipm.n) to the new preferences.ini file, see the section "Updating the preferences.ini File."
The iAS UIF Release Notes and Developer's Guide are located at the following url: http://docs.iplanet.com/docs/manuals/ias.html#uifsp2
The Installation Instructions for iAS UIF are located in the UIF Developer's Guide. The iAS UIF must be installed on the same machine or network cluster as the Application Server.
The installer searches for and finds the installation path of iPM 6.0, SP2. By default, the installer does not select any iAS and iPM components to install.
Installer recognizes that the installation is an upgrade and prompts you for confirmation of the upgrade for both iAS and iPM.
Choosing to upgrade preserves all iPM applications that are already registered with iAS. You do not need to redeploy or reregister these applications.
During the upgrade process, the current version of the preferences.ini file is backed up in the builder directory. This backup copy, named preferences.ipm.n, contains your previously installed cluster and corporate directory information. n is a number in a sequence beginning with 0—the highest number indicates the latest file. You must copy this information to the new preferences.ini file.
To copy the information from the backup file (preferences.ipm.n) to the new preferences.ini file, see the section "Updating the preferences.ini File."
The iAS UIF Release Notes and Developer's Guide are located at the following url: http://docs.iplanet.com/docs/manuals/ias.html#uifsp2
The Installation Instructions for iAS UIF are located in the UIF Developer's Guide. The iAS UIF must be installed on the same machine or network cluster as the Application Server.
During the upgrade process, the current version of the preferences.ini file is backed up in the builder directory. This backup copy, named preferences.ipm.n, contains your previously installed cluster and corporate directory information. n is a number in a sequence beginning with 0—the highest number indicates the latest file. You must copy this information to the new preferences.ini file.
The cluster and corporate directory information should resemble the following:
cluster = ldap://cn=Directory Manager:CRYPT{encrypted_password}@machine_name:389/cn=myCluster, o=NetscapeRoot
corp_dir = ldap://machine_name:389/ou=People, o=siroe.com
If you have problems with iPlanet Application Server, contact iPlanet customer support using one of the following mechanisms:
So that we can best assist you in resolving problems, please have the following information available when you contact support:
Useful iPlanet information can be found at the following Internet locations:
Last Updated September 18, 2001