Sun ONE logo     Previous      Contents     Index      Next     
iPlanet Process Manager, Version 6.5 Installation Guide



Chapter 3   Installing on Solaris

This chapter describes the procedure for installing Process Manager on Solaris (Unix) systems. For information about which Solaris platforms are supported with Process Manager, see the Release Notes.

On Unix systems, you can install all Process Manager components or you can choose to install just the Process Builder component. If you choose to install all Process Manager components, the Unix installer uses an install command that acts upon a file containing a set of predefined install options. If you choose to install just the Process Builder, you install by unzipping the Process Builder component and its supported JDK using an extraction program.

This chapter has the following sections:

Before Installing

Before installing Process Manager 6.5 on Solaris make sure:

Upgrading from Previous Process Manager Versions

Process Manager 6.5 has no upgrade option. If you have a previous version of iPlanet Application Server with iPlanet Process Manager, you must uninstall the previous version before you install.

Before you uninstall previous versions of Process Manager, read the application migration section in the Process Manager Release Notes.

Before you uninstall previous versions of the iPlanet Application Server or iPlanet Directory Server, refer to the Release Notes for each product for migration issues.

Installing All Components

Before you install Process Manager, see the section "Getting Ready to Install" which explains important concepts and information required to properly install and configure iPlanet Application Server.

To install the Process Manager components using the installation wizard, follow these steps:

Log on

To install Process Manager and its components, perform the following steps:

  1. Log on to the system in one of two ways:

    • as the same user or as a member of the same group that installed the Web Server with which your iPlanet Application Server will interface

      • If you install as a regular user, and elect to configure the iPlanet Application Server for automatic startup, you will have to log on again as the root user after you install to enable automatic startup.

    • as the root user before installing iPlanet Application Server

      • Do this if you want to install iPlanet Application Server so that it starts up automatically when you boot your system.

  2. At the shell prompt, run the setup command contained in the installation media.

    3. The installation process starts.

    During installation you can back up to previous screens or exit the installation process by pressing the following key combinations:

    • CTL+B to back up to the previous screen within an installation section. An installation section is defined by the title at the top of the screen. For example, "iPlanet Server Products," "iPlanet Directory," and "Application" are names of sections within the installation program. You cannot use CTL+B to go back to a screen in a different section than the one you are currently in.

    • CTL+C 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.

  3. When prompted, press Enter to accept the default [yes] to continue with the installation.

  4. When prompted, type yes to accept the Software License Agreement.

Select Components to Install

  1. When prompted, press Enter or specify 1 to select "iPlanet Servers" as the item to install.

  2. Specify 2 to select an installation type of Typical.

  3. Specify a target installation directory as the base directory within which all components are installed. Do not include spaces in the path name.

  4. When prompted for the components you want to install, do one of the following:

    5. To install iPlanet Process Manager, iPlanet Application Server, and iPlanet Directory Server

    1. When prompted to install the iPlanet Server Products components, press Enter to select all components listed:

      • Server Core Components

      • iPlanet Directory Suite

      • Administration Services

      • iPlanet Application Server Suite

      • iPlanet Process Manager 6.5

    2. When prompted to install the Server Core Components components, press Enter to select all components listed.

    3. When prompted to install the iPlanet Directory Suite components, press Enter to select all components listed.

    4. When prompted to install the Administration Services components, press Enter to select all components listed.

    5. When prompted to install iPlanet Application Server Suite components, press Enter to select all components listed.

    6. When prompted to install Process Manager 6.5 components, press Enter to select all components listed.

    To install iPlanet Process Manager and iPlanet Application Server without iPlanet Directory Server

    1. When prompted to install the iPlanet Server Products components, type 4, 5 and Press Enter.

    2. When prompted to install iPlanet Application Server Suite components, press Enter to select all components listed.

    3. When prompted to install Process Manager 6.5 components, press Enter to select all components listed and go to the section "Enter Application Server and Web Server Information".

    To install only iPlanet Process Manager Server and Process Builder

    This installation requires that a compatible version of iPlanet Application Server is already installed on your machine. For more information, see the Process Manager Release Notes.

    1. When prompted to install the iPlanet Server Products components, type 5 and Press Enter.

    2. When prompted to install Process Manager 6.5 components, press Enter to select all components listed and go to the section "Enter Information for Process Manager".

    To install Process Manager without the Web Connector, for a webless install

    A webless installation is an installation of Process Manager and the Application Server on a machine separate from the one where the Web Server is installed.

    Once your webless installation is complete, you must install the Web Connector plug-in on the machine that contains your Web Server instance. For details on installing the Web Connector plug-in on the Web Server machine, see the iPlanet Application Server Installation Guide.

    You must also update some files on the Web Server instance you plan to use with your webless installation of Application Server. For more information, see "Configuring After a Webless Installation".

    1. When prompted to install the iPlanet Server Products components, type 4,5 and press Enter.

    2. When prompted to install the iPlanet Application Server Suite components, type 2,3,4,5 and press Enter.

      3. This installs all iPlanet Application Server Suite components except for the Web Connector Component.

    3. When prompted to install Process Manager 6.5 components, press Enter to select all components listed and go to the section"Enter Application Server and Web Server Information".

    4. Install the Web Connector plug-in on the machine that contains your Web Server instance.

      5. For details on installing the Web Connector plug-in on the Web Server machine, see the iPlanet Application Server Installation Guide.

    To install Process Manager Server only

    This installation requires that a compatible version of iPlanet Application Server is already installed on your machine. For more information, see the Process Manager Release Notes.

    1. When prompted to install the iPlanet Server Products components, type 5 and press Enter.

    2. When prompted to install Process Manager 6.5 components, type 1 and press Enter to select all components listed and go to the section "Enter Information for Process Manager".

    To install Process Builder only

    If you want to install Process Builder only, do not use the setup install command.

    The installation media contains a zipped installation of Process Builder that includes an installation of the supported JDK. For more information, see "Installing Process Builder Only".

Enter Directory Server Information

  1. When prompted to specify the fully qualified domain name for the host system, press Enter to accept the default or type in another domain name.

  2. When prompted to specify the Unix user under which your iPlanet Application Server and Directory Server installations will run, press Enter to accept the default user, or enter a user defined in the directory server and press Enter.

    3. You should have already set up this user prior to running the installation program. Specify a user that has no privileges elsewhere on the system, so as to avoid access to restricted servers, such as the configuration Directory Server, from iPlanet Application Server.

  3. When prompted to specify the Unix group under which your iPlanet Application Server and Directory Server installations will run, press Enter to accept the default group, or enter a group defined in the Directory Server and press Enter.

    4. You should have already set up this group prior to running the installation program.

  4. When prompted if you want to use an existing Directory Server for your configuration directory, press Enter to accept the default [no]. This means that you want to use the Directory Server you are installing as part of this installation as your configuration directory.

    5. You can type yes to use another directory if you are not installing a Directory Server during this installation process.

  5. When prompted if you want to use an existing Directory Server for your users and groups directory, press Enter to accept the default [no]. You can type yes to use another directory if you are not installing a Directory Server during this installation process.

    • If you are installing Directory Server with this installation of iPlanet Application Server, specify this Directory Server as the configuration Directory Server. Only specify an existing Directory Server as the configuration Directory Server if you are not installing Directory Server with this installation of iPlanet Application Server.

    • If you are installing Directory Server with this installation of iPlanet Application Server, specify this Directory Server as the storage server. Only specify an existing Directory Server as the storage server if you are not installing Directory Server with this installation of iPlanet Application Server.

    If you specify an existing installation as the storage Directory Server, enter the following information:

    • Host name and port number of the machine where Directory Server is installed

    • Login ID to the machine where Directory Server is installed in "Bind As"

    • Password to the machine where Directory Server is installed

    • Top level domain name in Suffix

      • If your domain is iplanet.com, you would enter dc=iplanet,dc=com.

  6. Enter the port number to be used by the Directory Server you are installing. The default value is 389.

  7. When prompted for the Directory Server identifier, enter the host name of the Directory Server machine.

  8. Enter the administrator ID and password for the configuration Directory Server.


    9. Note

    This is the Administrator ID and password required to uninstall iPlanet Application Server and Directory Server. Make a note of this information, as you will need it if you uninstall either of these products.

  9. When prompted for the suffix, enter the top level domain name.

  10. Enter the Directory Manager distinguished name (DN) and password. The default value for the distinguished name is cn=Directory Manager


    11. Note

    It is good practice to use your own port number, such as 10000 or 20000, so you won't forget it. If you want to use the randomly generated port number, be sure to make note of the port number for later use.

  11. Enter the administrative domain.

  12. Enter the port number for the Directory Server Administration Server.

    13. This is required for using the Console to administer the Directory Server.

  13. When prompted to specify the user the Administration Server will run as, press Enter to accept the default [root].

This completes the Directory Server portion of the installation process. All steps that follow install iPlanet Application Server.

Enter Application Server and Web Server Information

  1. If you installed Directory Server earlier during this installation process, type yes to configure iPlanet Application Server with this Directory Server.

    2. If you did not install Directory Server earlier during this installation process, provide the following information about the already existing Directory Server that you want iPlanet Application Server to be configured with:

  2. Enter the product key of iPlanet Application Server.

    3. Refer to the Welcome letter you received with the product for the correct key.

  3. Enter a full path of a web server instance to be used or enter cgi if you are using CGI.

  4. Press Enter to continue.

  5. If prompted to enable the web server user to access the registry and plug-in libraries, press Enter to accept the default [y].

    6. You are only prompted for this information if you belong to a different group than the one used to install the web server.

  6. If prompted to continue with the iPlanet Application Server installation despite needing to change some file permissions, press Enter to accept the default [y].

    7. You are only prompted for this if you belong to a different group than the one used to install the web server.

  7. When prompted for the Server Administrator username and password, enter the username and password to log on to the iPlanet Application Server Administrator tool or press Enter to accept the default [admin].

  8. When prompted if you want to change ownership of iPlanet Application Server files to the user:group you specified earlier, press Enter to accept the default [n].

  9. Choose whether to enable I18N.

    10. If you want to run multi-lingual applications you need to enable I18N.

Enter Information for Process Manager

  1. Enter the administrative user(s) for Process Manager or press Enter to accept the default [admin].

    2. This user should exist in the corporate directory. You can enter more than one user ID by separating the IDs with commas. All users you list in this field will have administrative use of Process Manager.

  2. Press Enter to complete the installation.

Installing Process Builder Only

You can install Process Builder as a stand-alone tool on your system. Note that if you install Process Manager 6.5, Process Builder is installed by default; you do not need to install Process Builder separately. However, if you want to install only Process Builder, perform the following steps:

  1. Locate the Solaris_Builder.zip file in the installation media.

  2. Using an extraction tool, extract the zipped file to a directory location on your machine where you want to place the Process Builder.

  3. Change directories to the builder directory within the location you specified.

  4. Call the command ./Builder.sh &

    5. Process Builder appears.

Previous      Contents     Index      Next     
Copyright 2002 Sun Microsystems, Inc. All rights reserved.


816-6355-10

Last Updated August 20, 2002