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

---

Note	This is information as it pertains to installing and operating SellerXpert 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)

When you follow these procedures to install the servers software, you will be able to install SellerXpert with sample data.

What You Should Know About the iPlanet Application Server

---

The iPlanet Application Server (iAS) is the primary engine of SellerXpert. 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.

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:

   # gzcat IWS_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.

    
    
    

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

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 SellerXpert 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 SellerXpert installation. Otherwise, you must manually convert Actuate to run with SellerXpert.

---

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 plan to use to install SellerXpert.

---

---

Note	These steps contain information as it pertains to installing and operating SellerXpert 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 ias60sp2-solaris.tar.gz

   # 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 SellerXpert 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 Domain Name screen displays. Enter the domain name where you are installing the server software. See section , Step 8.

    
    
    

13. The Unix User and Group screen displays. Enter the system user and group name that was created in the section, , Step 9.

    
    
    

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

    
    
    

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

    
    
    

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

    
    
    

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

    
    
    

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

    
    
    

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

    
    
    

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

    
    
    

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

    
    
    

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

    
    
    

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

    
    
    

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

    
    
    

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

    
    
    

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

    
    
    

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

    
    
    

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

    
    
    

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

    
    
    

    This installation will take several minutes.

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 SellerXpert installation, you will need to specify this Oracle user name and password. The SellerXpert 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 18 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.