Chapter 3   Installing on Unix


This chapter describes the procedure for installing Process Manager on Solaris (Unix) systems. Process Manager can be installed on Solaris 2.6 and Solaris 8.

The Unix installer uses an install command that acts upon a file containing a set of predefined install options.

This chapter has the following sections:

• Getting Ready

• Installing All Components

• Upgrading from Process Manager 6.0 to SP 1

• Webless Installation

• Setting up Database Connectivity

Getting Ready

---

Before installing Process Manager 6.0 Engine on Solaris make sure:

• your system meets all the hardware, operating system and memory requirements discussed in the section "Platform Requirements" in Chapter 1 "Preparing for Installation"

• you have access to a database

Installing All Components

---

Before you install Process Manager, see the section "Getting Ready to Install" in Chapter 1 "Preparing for Installation" 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

• Select Which Components to Install

• Enter Directory Server Information

• Enter Application Server and Web Server Information

• Enter Information for Process Manager

Log on

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

1. Log on to the system 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.

2. For Unix systems, decide if you want to install iPlanet Application Server so that it starts up automatically when you boot your system. If you decide yes, then log on to the system as the root user before installing iPlanet Application Server.

3. Insert the Install CD-ROM into the CD-ROM drive.

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

5. At the shell prompt, run the following command:

      /cdrom/cdrom0/solaris/setup

   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, "Netscape Server Products," "Netscape 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.

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

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

Select Which 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:

   To install Process Manager and iPlanet Application Server along with Directory Server, press Enter. This selects all the following components.

   • Netscape Server Products Core Components

   • Netscape Directory Suite

   • Administration Services

     This installs the Administration Services and Console, allowing you to administer your Netscape servers from the same machine as the Console.

   • iPlanet Application Server 6.0 Suite

     This installs iPlanet Application Server, iPlanet Application Server Administrator, the Web Connector plug-in used to communicate between application server and the web server, and Deployment Manager.

   • Process Manager 6.0

   The first three components (Netscape Server Products Core Components, Netscape Directory Suite, Administration Services) install Directory Server software. The fourth component installs iPlanet Application Server and its associated components. The last component installs Process Manager 6.0 and its associated components.

   To install Process Manager and iPlanet Application Server without Directory Server, type 4, 5 (a iPlanet Application Server and Process Manager-only installation), and go to the section "Enter Application Server and Web Server Information."

   To install only Process Manager, type 5 and go to the section "Enter Information for Process Manager."

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

6. When prompted to install the Directory Suite components, press Enter to select all of components listed.

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

8. When prompted to install iPlanet Application Server Suite components, press Enter if you want to install all the listed components.
   • Web Connector Component

   • Core Server Component (iPlanet Application Server without the Web Connector plug-in)

   • Administrator Component (iPlanet Application Server Administrator)

   • Deployment Manager

   If you want to install iPlanet Application Server without the Web Connector plug-in, specify 2 (Core Server Component) and 3 (Administrator Component).

9. When prompted to install Process Manager Components, press Enter if you want to install all the listed components.
   • iPlanet Process Manager Server (this is the engine software)

   • iPlanet Process Manager Builder

   For a webless installation, type 2, 3, 4 at the iPlanet Application Server Suite Components prompt. Do not install the iPlanet Application Server Web Connector Component.

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 if the default is not correct for any reason.

2. When prompted to specify the Unix user and group under which your iPlanet Application Server and Directory Server installations will run, press Enter to accept the default user [nobody] and press Enter again to accept the default group [nobody]. You can also type in another user and group.

   You should have already set up this user and group 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 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.

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

4. 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

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

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

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

   Important: 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.

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

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

   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 write it down somewhere handy.

10. Enter the administrative domain.

11. Enter the port number for the Directory Server Administration Server. This is required for using the Console to administer the Directory Server.

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

    This is the last step of 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.

   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:

   • Server identifier

   • Host name

   • Port number

   • Username (same value you entered in Step 9)

   • User password (same value you entered in Step 9)

2. Enter the product key of iPlanet Application Server. The product key is available in the Welcome letter you received with the product.

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. When prompted to enable the web server user to access the registry and plug-in libraries, press Enter to accept the default [y]. You are only prompted for this information if you belong to a different group than the one used to install the web server.

6. When prompted if you want to continue with the iPlanet Application Server installation despite needing to change some file permissions, press Enter to accept the default [y]. 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 or not to enable I18N. If you want to run multi-lingual applications you will need it, otherwise not.

Enter Information for Process Manager

1. Enter the administrative user(s) for Process Manager or press Enter to accept the default [admin]. 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.

Upgrading from Process Manager 6.0 to SP 1

---

You must uninstall Process Manager 6.0 in order to upgrade to the Service Pack 1 release. Follow the installation steps described earlier and select the components you wish to upgrade.

You must upgrade the Application Server components to Service Pack 1 before you upgrade the Process Manager.

Webless Installation

---

For a production purposes,you may have elected to install the Process Manager and the Application Server on a separate machine from the Web server. Once you have completed the webless installation, you must:

• Copy a directory from the machine where you installed the Process Manager to the Web Server machine.

• Update the obj.conf file.

To copy the directory:

1. Go to the machine where the Web Server is installed.

2. Create a directory with the name iPlanet/iPM6.

3. Assuming you installed Process Manager in an iPlanet/iPM6 directory, copy the following directories from the machine where you have installed the Process Manager to the Web Server machine directory you just created.

   iPlanet/iPM6/bpm/html
   iPlanet/iPM6/bpm/resources

   In addition, if your Process Manager application uses any resources such as images or HTML files, copy the directory, for example:

   iPlanet/iPM6/bpm/applications/MyApp/images

   You must copy the directory for each application that relies on any resources.

To update the obj.conf file:

1. Go to the machine where the Web Server is installed.

2. Open the obj.conf file located in:

   webserverlocation/https instance name/conf/obj.conf

3. Copy the following lines under the <object name=default> section:

   Change the pathname following the dir directive to match the pathname where you copied the files.

   NameTrans fn="pfx2dir" from="/Administrator.apm" dir="/iPlanet/iPM6/bpm/html/Administrator.apm/en"
   NameTrans fn="pfx2dir" from="/Business.apm" dir="/iPlanet/iPM6/bpm/html/Business.apm/en"
   NameTrans fn="pfx2dir" from="/Express.npm" dir="/iPlanet/iPM6/bpm/html/Express.npm/en"
   NameTrans fn="pfx2dir" from="/PMResources" dir="/iPlanet/iPM6/bpm/resources"
   NameTrans fn="pfx2dir" from="/BPM" dir="/iPlanet/iPM6/bpm/Applications"

4. Additionally, if the following isn't already in your obj.conf file, add it:

   Service method=(GET|HEAD|POST) type=*~magnus-internal/* fn=send-file

5. Restart the Web Server.

Setting up Database Connectivity

---

After installing Process Manager 6.0, you need to establish database connectivity as follows:

1. Go to your iPlanet Application Server root directory at

      /export/home/ipm/ias/bin

2. Run the db-setup script:

      ./db-setup.sh

3. It will ask which database you want to use with Process Manager. (Process Manager 6.0 supports Oracle and Sybase).

4. When you choose which database, db-setup asks you for some configuration parameters. Enter the requested parameters.

5. You will be asked if you want the configuration and resource managers. Consult your iPlanet Application Server documentation to determine if this is required for your environment.

6. You can now begin using Process Manager 6.0.