Previous     Contents     Index     Next     
iPlanet BuyerXpert 4.5 Installation Guide



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 follow before installing iPlanet BuyerXpert.
Note For detailed information on these software programs, see:

http://docs.iplanet.com/docs/manuals/index.html


The following sections are contained in this chapter:

When you follow these procedures to install the servers software, you are able to install iPlanet BuyerXpert with sample data.



What You Should Know About the iPlanet Application Server


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


Application Server Components

The components that install with the iPlanet Application Server are described as follows:

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

  • 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 can be 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 has 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:

    #tar xvf iws60sp2-solaris.tar

    # ./setup

    The Welcome screen displays.



  2. Press Enter to continue.

    The Licensing Agreement screen displays.



  3. Enter Yes to continue

    The Installation Type screen displays.



  4. Press Enter to accept a typical installation.

    The Extracting Server Files screen displays.



  5. Enter the location where you want to install iWS.

    The installer creates this directory.

    The Web Server Component screen displays.



  6. Press Enter to specify all the components.

    The Additional Web Server Components screen displays.



  7. Press Enter to specify all the components listed.

    The Domain Name screen displays:



  8. Read the instructions

  9. Verify that this is the correct computer name.

  10. Press Enter.

  11. If the computer name is not correct, enter the correct domain name.

  12. Press Enter.

    The Choosing a UNIX User and Group screen displays.



  13. Choose the default only if you want iWS to use the displayed UNIX user and group to run iWS.

  14. Press Enter to accept the default, or enter a UNIX user and group.

    The iWS Administration Server User Name screen displays.



  15. Press Enter to accept the default, or enter a new iWS username.

    The Administrative User Name and Password screen displays.



  16. Enter a password.

  17. Enter the password again.

  18. This password is used to access the administration of iWS.

    The Administration Server Port Number screen displays.



  19. Enter your iWS administration server port number, or use the default port number 8888.

    The Web Server Port Number screen displays.



  20. Enter your iWS port number, or accept the default.

    The Content Root for the Web Server screen displays.



  21. Press Enter to accept the default, which is the location of the documents for iWS.

    The Java Support screen displays.



  22. If you want to use the JDK that is provided, press Enter.

  23. Enter Y if you want to use your own JDK.


    Note iPlanet BuyerXpert does not run from the Java Development Kit (JDK) that is installed with this step and is not affected by what you select from this screen.


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



  24. Press Enter to continue.

    The installation of iWS is complete.


    Tip If you have your browser caching mechanism set to Never, the most up-to-date contents do not always display.

    Setting a no cache directive in iWS (to tell the browser not to cache the pages) solves this problem.

    To set this:

    1. Go to the admin server of iWS.

    2. Select the right instance of iWS and click Manage Server.

    3. Click Content Management.

    4. Click Cache Control Directives (last item in the menu on the left).

    5. Set the Directives to No Cache.

    6. Click OK.

    7. Click Save and Apply.

    8. Check that the directive has been saved correctly.




Installing Actuate

See the Actuate installation instructions that are 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 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 need to manually convert Actuate to run with BuyerXpert.




Note Make sure you are the right user and in the right group before installing iAS. You must install iAS as the same user that you use to install BuyerXpert.



Note For detailed information on installing iAS, see:

http://docs.iplanet.com/docs/manuals/index.html


"> Installing iPlanet Application Server (iAS)
Note Make sure you are the right user and in the right group before installing iAS. You must install iAS as the same user that you use to install BuyerXpert.



Note For 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 pae65_complete_ux.zip

    # cd installer

    # ./setup

    The Welcome screen displays.



  2. Press Enter to continue.

    The Licensing Agreement screen displays.



  3. Enter Yes to continue.

    The Install Items screen displays.



  4. Press Enter to accept the iPlanet servers.

    The Installation Type screen displays.



  5. Press Enter to accept a typical installation.

    The Extract Server Files screen displays.



  6. Enter /export/IAS65, or enter the location where you want to install iAS.

    The Server Products screen displays.



  7. Press Enter, because BuyerXpert needs all the components listed.

    The Server Family Core Components screen displays.



  8. Press Enter to specify all the components listed.

    The Directory Suite Components screen displays.



  9. Press Enter to specify all the components listed.

    The Administrative Services screen displays.



  10. Press Enter to specify all the components listed.

    The Application Server Suite Components screen displays.



  11. Press Enter to specify all the components listed.

    The Process Manager 6.5 Components screen displays.



  12. Press Enter to specify all the components listed.

    The Domain Name screen displays.



  13. Enter the domain name where you are installing the server software.

    See section Installing iPlanet Web Server (iWS).

    The UNIX User and Group screen displays.



  14. Enter the system user and group name that was created in the section, Installing iPlanet Web Server (iWS).

    If you already applied the latest patches, answer y to continue installing IAS6.5.

    The Configuring Server screen displays.



  15. Enter Yes to register this software, or press Enter if you do not want to register the software.

    The Store Directory Server screen displays.



  16. Press Enter to continue.

    The Directory Server Network Port screen displays.



  17. Enter 10000, or enter a different port number.

    The Directory Server Identifier screen displays.



  18. Press Enter to accept the default.

    The Administrator ID screen displays.



  19. Enter your administrator ID.

  20. Enter your password.

  21. Enter your password again.

    The Directory Tree Suffix screen displays.



  22. Enter a suffix for this installation (for example, o=bxinstall.com), or, use the default value.

    The Directory Manager Distinguished Name (DN) screen displays.



  23. Press Enter to accept the default Directory Manager DN.

  24. Enter your password.

  25. Enter your password again.

    The Administration Domain screen displays.



  26. Enter your domain, or accept the default.

    The Administration Server Port screen displays.



  27. Enter 10001, or enter your port number.

    The Administration Server screen displays.



  28. Press Enter to accept the default.

    The Product Key screen displays.



  29. Enter your product key (iAS serial number).

    The Web Server Instance screen displays.



  30. Enter the web server instance location where iWS is installed.

    The next screen displays with this message: Configuring the iPlanet Web Server.



  31. Press Enter to continue.

    The Administration Server Username and Password screen displays.



  32. Enter your administration server username.

  33. Enter your password.

  34. Enter your password again.

    The Enable Internationalization screen displays.



  35. Enter Yes to enable international support for iAS.

    The Finished with Gathering of Information screen displays.



  36. Press Enter to continue.

    The Process Manager Administrator User ID screen displays.



  37. Enter the user ID of the Process Manager administrator, or press Enter to accept the default.

    The Finished with Gathering of Information screen displays.



    The installer has finished gathering information.

  38. Press Enter to continue.

    The Extracting Netscape core components, Server Core components, and Core Java classes screen displays.



    This installation takes several minutes.


    Tip To find out the 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 again to reload configuration files that were loaded during iAS installation.

  1. Run startconsole from IWS_ROOT.

    The browser launches and the login screen displays.



  2. Enter the username you created.

  3. Enter the password you created.

    The Manage Servers screen displays.



  4. Click the server name (located next to Select a Server).

  5. Click Manage.

    The Server On/Off screen displays.



  6. Click Server Off.

    A Warning message displays: Manual edits not loaded.

  7. Apply the changes by clicking Load Configuring Files.

    The Server On/Off screen displays with the 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

    The Database Connectivity Setup screen displays.



  2. Enter the location where iAS is installed.

    The Driver Installation screen displays.



  3. Press Enter to continue.

    The Configuring with Oracle screen displays.



  4. Enter Y to configure iAS with Oracle.

    The Oracle Connectivity screen displays.



  5. Enter your Oracle home directory.

    The Configure iAS with Sybase Connectivity screen displays.



  6. Press Enter to continue.

    The Informix connectivity screen displays.



  7. Press Enter to continue.

    The db2 connectivity screen displays.



  8. Press Enter.


Creating an iPlanet Directory Server (LDAP) Instance

  1. Start console using the following command:

    % IAS-ROOT/startConsole

    The LDAP login screen displays.



  2. Enter your password.

  3. Click OK.

    This is the password you specified in the iAS installation

    The Server Group screen displays.



  4. Choose the Server Group.

  5. Click Object.

  6. Choose Create Instance of Netscape Directory Server from the drop-down menu.

    The Create New Instance screen displays.



  7. Enter 20000, or your specific port number, In the network port number field.

  8. Enter a Base suffix. For example, o=iplanet.com.

  9. Create a password.

  10. Enter the password again to confirm.

  11. Click OK.


    Note The network port number and root DN password are required entries when installing iPlanet BuyerXpert.


    The Status screen displays.



  12. Click OK.

  13. Exit from the iAS administrative server.



Configuring the Process Manager

You should have already run the db_setup.sh script for iAS. Create a 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.

  3. Enter your iAS password.



  4. Select Create New Cluster.

    The Create Cluster screen displays.



  5. Enter a Cluster Display Name.

  6. Scroll down to the Corporate User Directory section.



  7. Enter your Host Name.

  8. Enter 20000 in the Port Number field.

    This is the network port number that you created in Chapter 3, Section Creating an iPlanet Directory Server (LDAP) Instance.

  9. Specify the Base 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.

  10. Scroll down to the Configuration Directory section.



  11. Enter the iAS directory server network Port Number.

  12. Enter the bind password (your iAS password).

  13. Scroll down to the Database Information section.



  14. Select Oracle from the DB Server Type drop-down menu.

  15. Enter your Oracle SID in the Database Server Identifier field.
    Note Leave the Database field blank. That field is marked with a *.


  16. Enter the Oracle database User ID that was created earlier.

  17. Enter the Oracle Password that was created earlier.

    Scroll down to get the email screen.


    Note The database user account is fixed for the life of the installation and is where specific application and configuration tables are stored.

    Do not assign the same location where you store the BuyerXpert data.


    The Mail Server Information screen displays.



  18. Enter your SMTP email Server name, or use the default.

  19. Enter your SMTP Port number, or use the default.

  20. Enter your SMTP reply to email address, or use the default.

    The Event User Information screen displays.



  21. Create a new Event User name.

  22. Create a new Event User Password.

  23. Click Create Cluster.

    Verify that your file looks like the following:



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

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

  26. Find the following line in that file:

    # add your lines below here:

  27. Add the lines copied in Step 24 to just below the # add your lines below here: line.

  28. Save the file.


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

Last Updated June 10, 2002