Chapter 3   Installing iPlanet Servers Software


This chapter provides installation procedures for the iPlanet Web Server (iWS) and the iPlanet Application Server (iAS) software that you must install before installing BuyerXpert.

---

Note	This is information as it pertains to installing and operating BuyerXpert only; for detailed information on these software programs, see: http://docs.iplanet.com/docs/manuals/index.html

---

The following sections are contained in this chapter:

• What You Should Know About the iPlanet Application Server

• Installing iPlanet Web Server (iWS)

• Installing Actuate

• Installing iPlanet Application Server (iAS)

• Configuring the Process Manager

When you follow these procedures to install the servers software, you will be able to install BuyerXpert with sample data. If you do not wish to use sample data but your own data, see the BuyerXpert Deployment Guide for instructions.

What You Should Know About the iPlanet Application Server

---

The iPlanet Application Server (iAS) is the primary engine of BuyerXpert. The Application Server goes one-step further than the web-enablement functionality of the Web Server by providing powerful transaction processing features, and integrates with existing information systems and applications.

Application Server Components

The following describes the components that install with the iPlanet Application Server:

• The Application Server includes the Administration Server, the Web Connector plug-in used to communicate between the iPlanet Application Server and the Web Server, and the Deployment Tool.

• The Console provides the common user interfaces for all iPlanet server products. It allows you to perform common server administration functions such as stopping and starting servers, installing new server instances, and managing user and group information. The Console can be installed by itself (standalone) on any machine on your network and used to manage remote servers.

• The Administration Server is a common front-end to all iPlanet servers. It receives communications from the Console, and sends them on to the appropriate iPlanet server. Your site will have at least one Administration Server for each server root in which you have installed an iPlanet server.

• The Directory Server is iPlanet's LDAP implementation. The Directory Server runs as the slapd service on an NT machine, and ns-slapd on Solaris. This server manages the directory databases and responds to client requests.

Note	Before installing iWS, make sure you are in the right user and group. If not, create the user and group.

---

"> Installing iPlanet Web Server (iWS)

---

Note	Before installing iWS, make sure you are in the right user and group. If not, create the user and group.

---

---

To install iWS:

1. Unpack the iWS distribution and run the setup executable to launch the installer:

   # gzcatIWS_tar_file.tar.gz|tar xvf -

   #./setup

2. The Welcome screen displays. Press Enter to continue.

3. The Licensing Agreement screen displays. Type Yes to continue.

   
   
   

4. The Installation Type screen displays. Press Enter to accept a typical install.

   
   
   

5. The Extracting Server Files screen displays. Type the location where you want to install iWS. The installer will create this directory.

   
   
   

6. The Web Server Component screen displays. Press Enter to specify all the components.

   
   
   

7. The Additional Web Server Components screen displays. Press Enter to specify all the components listed.

   
   
   

8. When this screen displays, read the instructions, verify that this is the correct computer name and press Enter. If it is not, enter the correct domain and press Enter.

   
   
   

9. The Choosing a Unix User and Group screens display. The default should be chosen only if you want iWS to use the displayed Unix user and group to run iWS. Press Enter to accept the default or enter a Unix user and group.

   
   
   

10. The iWS Administration Server User Name screen displays. Press Enter to accept the default, or enter a new iWS username (buyer is the example shown).

    
    
    

11. Create a password and enter it twice. This password will be used to access the administration of iWS.

    
    
    

12. At the next screen, type your iWS administration server port number. You can use the default port number, 8888.

    
    
    

13. At the next screen, enter your iWS port number. The default shown is 8080.

    
    
    

14. The LDAP Directory Server screen displays. If other iPlanet products have been installed on this network, you can unify the administration of the separate servers by typing Y and entering the necessary information.

    Press Enter if you do not want to register this directory server.

    
    
    

15. At the next screen, press Enter to accept the default, which is the location of the documents for iWS.

    
    
    

16. The Java Support screen displays. BuyerXpert does not run from the Java Development Kit (JDK) that is installed with this step and will not be affected by what you select from this screen. Press Enter if you want to use the JDK provided. Type Y if you want to use your own JDK.

    
    
    

17. At the end of installation, the following messages display:

    
    
    

18. Press Enter to continue.

The iWS is now running.

---

Tip

If you have your browser caching mechanism set to Never, the most up-to-date contents do not always display. Seting a no cache directive in iWS (to tell the browser not to cache the pages) solves this problem. To set this: Go to the admin server of iWS. Select the right instance of iWS and click Manage Server. Click Content Management. Click Cache Control Directives (last item in the menu on the left). Set the Directives to No Cache and click OK. Click Save and Apply and check that the directive has been saved correctly.

---

Installing Actuate

---

See the Actuate installation instructions, located on the iPlanet CommerceXpert Actuate Desktop Products ReportCast CD. There are two PDF files in the directory actuate_4/manuals/directory named reportcast-unix-install.pdf and server-unix-install.pdf.

---

Note	In order for the BuyerXpert installation script to configure the Actuate instance, it is recommended that you install Actuate on the same machine and with the same user as the BuyerXpert installation. Otherwise, you must manually convert Actuate to run with BuyerXpert.

---

Note	Make sure you are in the right user and group before installing iAS. You must install iAS as the same user you use to install BuyerXpert. See the BuyerXpert Deployment Handbook if you are installing iAS as root.

---

---

Note	These steps contain information as it pertains to installing and operating BuyerXpert only. For more detailed information on installing iAS, see: http://docs.iplanet.com/docs/manuals/index.html

---

"> Installing iPlanet Application Server (iAS)

---

Note	Make sure you are in the right user and group before installing iAS. You must install iAS as the same user you use to install BuyerXpert. See the BuyerXpert Deployment Handbook if you are installing iAS as root.

---

---

Note	These steps contain information as it pertains to installing and operating BuyerXpert only. For more detailed information on installing iAS, see: http://docs.iplanet.com/docs/manuals/index.html

---

---

To install iAS:

1. Unzip and set up the iAS file:

   # unzip pae60sp1_iassp2_solaris.zip

   # cd installer

   #./setup

2. The Welcome screen displays. Press Enter to continue.

3. The Licensing Agreement screen displays. Type Yes.

   
   
   

4. The Install Items screen displays. Press Enter to accept iPlanet servers.

   
   
   

5. The Installation Type screen displays. Press Enter to accept a typical installation.

   
   
   

6. The Extract Server Files screen displays. Type /export/IAS60 or the location you want to install iAS.

   
   
   

7. The Server Products screen displays. Since BuyerXpert will need all the components listed, press Enter.

   
   
   

8. The Server Family Core Components screen displays. Press Enter to specify all the components listed.

   
   
   

9. The Directory Suite Components screen displays. Press Enter to specify all the components listed.

   
   
   

10. The Administrative Services screen displays. Press Enter to specify all the components listed.

    
    
    

11. The Application Server Suite Components screen displays. Press Enter to specify all the components listed.

    
    
    

12. The Process Manager Components screen displays. Press Enter to specify all the components listed.

    
    
    

13. The Domain Name screen displays. Enter the domain name where you are installing the server software. See section Installing iPlanet Web Server (iWS), Step 8.

    
    
    

14. The Unix User and Group screen displays. Enter the system user and group name that was created in the section, Installing iPlanet Web Server (iWS), Step 9.

    
    
    

15. The Configuring Server screen displays. Type Yes if you want to register this software or press Enter if you do not.

    
    
    

16. The Store Directory Server screen displays. Press Enter to continue.

    
    
    

17. The Directory Server Network Port screen displays. Type 10000 or other port number.

    
    
    

18. The Directory Server Identifier screen displays. Press Enter to accept the default.

    
    
    

19. The Administrator ID screen displays. Enter your administrator ID, your password, and the password again.

    
    
    

20. The Directory Tree Suffix screen displays. Enter a suffix for this installation, for example, o=bxinstall.com.

    
    
    

21. The Directory Manager Distinguished Name (DN) screen displays. Press Enter to accept the default Directory Manager DN, then enter your password and the password again.

    
    
    

22. The Administration Domain screen displays. You must use iplanet.com.

    
    
    

23. The Administration Server Port screen displays. Type 10001 or your port number.

    
    
    

24. The Administration Server screen displays. Press Enter to accept the default.

    
    
    

25. At the next screen, enter your product key (iAS serial number).

    
    
    

26. The Web Server Instance screen displays. Enter the web server instance location where iWS is installed.

    
    
    

27. The next screen displays with this message: Configuring the iPlanet Web Server. Press Enter to continue.

    
    
    

28. The Administration Server Username and Password screen displays. Enter your administration server username, your password, and the password again.

    
    
    

29. The Enable Internationalization screen displays. Type Yes to enable international support for iAS.

    
    
    

30. When this screen displays, press Enter to continue.

    
    
    

31. The Process Manager Administrator User ID screen displays. Enter the user ID of the Process Manager administrator or press Enter to accept the default.

    
    
    

32. The installer has finished gathering information. Press Enter to continue.

    
    
    

33. This installation will take several minutes.

    
    

    ---

    Tip	To find out the what version of iAS you are running, type ./version in the IAS_ROOT/ias/bin directory.

    ---

    
    

Reloading Configuration Files

iWS needs to be stopped and started to reload configuration files that were loaded during iAS installation.

1. Run startconsole from IWS_ROOT.

2. The browser is launched and the login screen displays. Enter the username and password you created in Step 11.

   
   
   

3. The Manage Server screen displays. Click the server name (located next to Select a Server) and then click Manage.

   
   
   

4. The Server On/Off screen displays with this message: Click Server Off.

   
   
   

5. A message displays Warning: manual edits not loaded. Apply the changes by clicking Load Configuring Files.

6. The Server On/Off screen displays with this message: The server is currently on.

   
   
   

Checking iAS Installation

1. After completing the iAS installation, you can check to see if iAS is installed properly by executing a sample fortune program:

   http://hostname:port/GXApp

   For example,

   http://colonial:8080/GXApp

2. Click Access New iAS Sample Application.

3. Under Sample Application, click Fortune.

4. From the Fortune page, you can check your fortune and verify that iAS is installed properly.

Enabling the Database with iAS

1. Set up the database session script:

   % cd IAS_HOME/ias/bin

   % ./db_setup.sh

2. The Database Connectivity Setup prompt displays. Enter the location where iAS is installed (shown as /export/IAS60 in the example).

   
   
   

3. The Driver Installation screen displays. Press Enter to continue.

   
   
   

4. The Configuring with Oracle prompt displays. Type Y to configure iAS with Oracle.

   
   
   

5. The Oracle prompt displays. Enter your Oracle home directory.

   
   
   

6. The next Oracle prompt displays. Enter your Oracle SID that you wish to connect to.

   
   
   

7. The Sybase prompt displays. Press Enter to continue.

   
   
   

8. The Informix prompt displays. Press Enter to continue.

   
   
   

9. The db2 prompt displays. Press Enter to continue.

   
   
   

10. The next prompt displays. Type Y to configure the Resource Manager.

    
    
    

11. The next prompt displays. Press Enter to accept the default.

    
    
    

12. The next prompt displays. Press Enter to accept the default.

    
    
    

13. The next prompt displays. Press Enter to accept the default.

    
    
    

14. The next prompt displays. Enter the database server name (the machine where Oracle is installed).

    
    
    

15. The next prompt displays. Enter the database user name and password.

    
    

    ---

    Note	During BuyerXpert installation, you will need to specify this Oracle user name and password. The BuyerXpert installer will create this user in Oracle.

    ---

    
    

    
    
    

16. The next prompt displays. Press Enter to enable the Resource Manager.

    
    
    

Creating an iPlanet Directory Server (LDAP) Instance

1. Start console using this command:

   % IAS-ROOT/startConsole

2. When this screen displays, enter your password and click OK. This is the password you specified in Step 19 of the iAS installation.

   
   
   

3. Choose the Server Group, located on the left side of the screen. Click Object, then from the drop-down menu, choose Create Instance of Netscape Directory Server.

   
   
   

4. The Create New Instance window displays.

   
   
   

5. In the network port number field, type 20000 or your specific port number.

6. Create a password and then re-enter it again to confirm.

   
   

   ---

   Note	The network port number and root DN password will be required entries when installing SellerXpert.

   ---

   
   

7. Click OK. The following screen displays. Click OK.

   
   
   

8. Exit from the iAS administrative server.

Configuring the Process Manager

---

You should have already run the db_setup.sh script for iAS. You will first create another user in ORACLE_SID in addition to the one that you created to store BuyerXpert data.

Creating Another Oracle User

To create another Oracle user:

% sqlplus system/manager@oracle_SID

SQL>create user pm identified by pm

SQL>default tablespace TSO1 temporary tablespace temp

SQL>quota unlimited on TSO1

SQL>quota 0 on system;

SQL>grant connect, resource to pm

To configure the Process Manager:

1. Enter the URL:

   http://machine-name.domain-name:iWS-port-number/Administrator.apm

2. Enter your iAS user ID and password.

3. Select create new cluster and the Cluster Information screen displays.

   
   
   

4. In the Cluster Name field, type the name of your choice.

   
   
   

5. Scroll down to the Corporate User Directory Information part of the screen.

   
   
   

6. In the Host Name field, type your host name.

7. In the Port field, type 20000. This is the network port number that you created in Chapter 3, Section Creating an iPlanet Directory Server (LDAP) Instance, Step 5.

8. In the User Directory Base DN field, specify the DN for the root directory. For example, enter o=iplanet.com if your BuyerXpert configuration setting directory root DN is set to o=iplanet.com.

9. Scroll down to the Configuration Directory Information.

10. Enter the iAS directory server network port.

    
    
    

11. Type the bind password (your iAS password).

12. Scroll down to display the Database Screen.

    
    
    

13. Select DB Server Type, then select Oracle.

14. In the DB Server Identifier field, type your Oracle SID.
    

    ---

    Note	The Database field (displayed with a *) should be kept blank.

    ---

    
    

15. Type the Oracle database user ID and the password that was created earlier.

    
    

    ---

    Note	This database user account is fixed for the life of the installation. Specific application and configuration tables are stored here, so do not give it the same location as where you store BuyerXpert data.

    ---

    
    

16. The Mail Server Information screen displays.

    
    
    

17. Type your SMTP e-mail server name.

18. Type your SMTP port number.

19. Type your SMTP reply to e-mail address (optional).

20. The Event User Information screen displays.

    
    
    

21. Create a new cluster user name and password.

22. Click Create Cluster.

23. After the cluster has been created, from any text editor, copy the lines that start with # Begin Cut -------------- to the end (End Cut ------).

24. Open the iAS installation dir/builder/preferences.ini file.

25. Find this line in that file:

    # add your lines below here:

26. Add the lines copied in Step 23 to just below this line.

27. Verify that your file looks like the following:

    
    
    

28. Save the file.