Install IBM Business Solutions

After you check for prerequisite applications and options, use these steps to install IBM Business Solutions.  The installation consists of installing the IBM Tivoli Directory Server version 6.1, IBM HTTP Server version v7.0, the Web server plug-ins for IBM WebSphere Application Server version 7.0,  and the two application enterprise archive (EAR) files: IBM Welcome Page V1.1 and IBM Telephone Directory V5.2.  

IBM Tivoli Directory Server v6.1 is a Lightweight Directory Access Protocol (LDAP) server that provides a persistent storage for directory information and is used specifically with IBM Business Solutions.  IBM HTTP Server v7.0 is provided with WebSphere Application Server Express v7.0 and provides HTTP functionality.  The Web server plug-ins for IBM WebSphere Application Server v7.0 is also provided with WebSphere Application Server Express v7.0.  The product provides an installation of the HTTP plug-in that is used to connect the Web server with WebSphere Application Server Express v7.0.   Together, IBM HTTP Server v7.0 and WebSphere Application Server Express v7.0 create a topology for IBM Business Solutions.

 

Install IBM Tivoli Directory Server v6.1 for Windows and UNIX Operating Systems

Install IBM HTTP Server v7.0

Install the plug-in for IBM WebSphere Application Server v7.0

Install the IBM Business Solutions applications

Configuring IBM Business Solutions

Start and Stop IBM Tivoli Directory Server

 

 

Installing IBM Tivoli Directory Server v6.1 for Windows and UNIX Operating Systems

Install IBM Tivoli Directory Server v6.1, which is included with the Business Solutions CD. IBM Tivoli Directory Server contains a number of files that describe the installation and configuration steps.  These files are contained in the doc directory of the Business Solutions CD.  The following steps assume a typical configuration.  In the typical configuration, you set up the administrator password and create a DB2 database which is used to store the directory information.  An embedded version of DB2 is provided with the IBM Tivoli Directory Server v6.1 to provide persistent storage.  

  1. Run the install_tds.bat file, which is located in the tdsV6.1/itds directory.
  2. Select Language from the pull-down language menu.
  3. Click OK on the language panel..
  4. Click Next on the installation panel.
  5. Click Accept the license agreement. Click Next.
  6. Select the location to install IBM Tivoli Directory Server. Click Next.
  7. You must select Custom type install. Click Next. A feature list is displayed. IBM Tivoli Directory Server attempts to identify components that are already installed or are not present. If a compatabile version of DB2 is already present, this version is used as the persistent data store for LDAP information.
  8. We recommend that you uncheck: Click Next on the installation panel.
  9. For Windows operating systems (ONLY):

    Enter the user ID and password that the IBM Tivoli Directory Server uses to connect to the DB2 database
    
    • Enter User ID (This userID must have administrative authority)
    • Enter Password
    • Enter confirm password
    Click Next on the installation panel.

  10. Select Websphere Application server to deploy Web Administraiton tools we recommend you select :
  11. A summary screen is displayed, which lists your configured options. Click Install to start the installation.
  12. You will see a panel with message, "Installing DB2: the background install may take up to 20 minutes: please wait"

The IBM Tivoli Directory Server Instance Administration Tool is displayed after installation. Use this tool to configure the instance of IBM Tivoli Directory Server to which IBM Business Solutions connects.

  1. On the tool, click Create.
  2. Select the Create a new directory server instance radio button.
  3. Click Next.
  4. Specify the following information:
  5. Click Next:
  6. Select the DB2 instance to use from the pull-down menu. Tip: You need to have a user ID with the same name as the DB2 instance (i.e.db2inst1). This name is not db2admin by default. Define a new user that matches the instance in DB2. By default, the instance name is DB2. You can check your DB2 instance by starting the DB2 Control Center, which is provided with DB2. As an example, if you have the default DB2 instance name of DB2, then you create a DB2 user on Windows or UNIX operating systems.
  7. Select Listen on all configured IP Addresses. Click Next.
  8. Accept the default ports. If you modify the ports, make note of the port numbers because you need this information to configure the Business Solutions connections to LDAP.
  9. Accept the default check boxes for:
  10. Click Next.
  11. Configure Administrator DN and password
  12. Specify the administrative distinguished name. Note this user ID and password because you need this information during the configuration of the Business Solutions application. Click Next.
  13. Configure database
  14. Configure the database by specifying the user name, password, and the name of the database to create. This ID becomes the default user ID when DB2 is installed. This value is normally db2inst1. Click Next.
  15. Database options take defaults
  16. Specify the database installation location. The default is the C directory. Click Next.
  17. Click Finish.
  18. A Results list box is displayed, which tracks the progress of the IBM Tivoli Directory Server instance.

 

Install Note: Because the installation of IBM Tivoli Directory Server v6.1 can vary for some Operating Systems, you may refer to the IBM Tivoli Directory Server Information Center. In the left content pane under Directory Server, expand the topic titled, Installation and Configuration Guide, and click on the instructions for your operating system.

 

Installing IBM HTTP Server v7.0

 

NOTE: At this point, you should install WebSphere Application Server v7.0 before proceeding.

Insert the WebSphere Application Server - Express Supplements CD or DVD and proceed with the the installation:

  1. Start the Launchpad and click Launch the installation wizard for IBM HTTP Server.
  2. Proceed through the installation, making note of the administrator user ID and password because you need this information to configure the plug-in later. The plug-in establishes the connection between IBM HTTP Server and WebSphere Application Server.

Installing the plug-in for IBM WebSphere Application Server v7.0

Now, the IBM HTTP Server v7.0 is installed.  The next step is to configure the plug-in.  If you have not already installed WebSphere Application Server v7.0, then do so now.  Install the plug-in on the HTTP server to redirect Uniform Resource Locator (URL) requests to the application server to handle.  In this case, you are redirecting URL requests for the Web programs that IBM Business Solutions for Express v7.0 uses. If you have not already done so, you need to associate an HTTP Web server to WebSphere Application Server and generate the necessary plug-in:

If a web server has not been created yet, follow these instructions:

  1. Access the WebSphere Application Server administrative console by going to http://<hostname>:9060/ibm/console. Port 9060 is the default administrative port.
  2. In the left menu, click Servers > Server Types > Web Servers.
  3. If a Web server is not defined, create a new Web server association.
  4. Specify the Web server, type, host name, and platform. Click Next.
  5. On the Select Web server template, click Next.
  6. On Enter the Properties for the new Web server, specify the user name and password that you used when you initially installed IBM HTTP Server.
  7. On the Confirm new Web Server panel, click Finish.
  8. Click Save to save the configuration change to the master configuration file.

If a plug-in has not yet been generated, follow these steps:

  1. Select the name of the Web server just created and click Generate Plug-in.
  2. After the plug-in is generated:
  3. Select the name of the Web server just created and click Propogate Plug-in.
  4. Click Save to save the configuration change to the master configuration file.
  5. Troubleshooting Tip: If you receive an error message that a connection to the IBM HTTP administrative server cannot be established, then check if the administrative service has started.

Installing the Business Solution applications

Start WebSphere Application Server v7.0 now if you have not already done so. You have two Web applications to install: 



The applications are installed through the WebSphere Application Server administrative console.

  1. Access the WebSphere Application Server administrative console by going to http://<hostname>:9060/ibm/console. Port 9060 is the default administrative port.
  2. In the left menu, click Applications > Application Types > WebSphere enterprise applications.
  3. In the Preparing for the application installation panel, browse to the location of the IBM Telephone Directory v5.2.ear file. The file is located in the root directory of the Business Solutions CD. Click Next.
  4. On the Select Installation Option panel, click Next.
  5. On the Map Module to Server panel, hold down the Ctrl key and click both server1 and webserver1 to select both servers. Check IBM Telephone Directory v5.2 and click Apply to map to both the Application Server and the web server. Then click Next.
  6. On the Summary panel, click Finish.
  7. Select Save to save the configuration changes to the master configuration file.
  8. Repeat the installation steps for the IBM Welcome Page v1.1.ear file.
  9. In the left menu, click Enterprise Applications. By default, the applications are not started after installation. A list of installed applications is displayed. Select IBM Telephone Directory v5.2 and IBM Welcome Page v1.1. Click Start. The applications indicate that they have started.


Configuring IBM Business Solutions


Before starting the IBM Tivoli Directory Server v6.1, we need to added the following suffix to the directory server instance:
User DN: dc=com
Now the two Business Solutions applications are installed and are ready for you to configure.

  1. Start IBM Tivoli Directory Server v6.1 if you have not already done so. Access IBM Business Solutions to complete the configuration:
  2. http://your_server:9080/ibm-bizApps/welcome/home.do

     

    The Business Solutions are not configured after initial installation. You are prompted for an Internet Protocol (IP) or host name location of your LDAP server and the Administrator login information.  The login is the same Administrator user ID and password that you used when you initially configured IBM Tivoli Directory Server v6.1.  The application attempts to authenticate with the directory server.   If you are unable to log in, you cannot complete the configuration.

    If you have problems connecting to Tivoli Directory Server v6.1, ensure that the server is running.  As noted previously, on Windows operating systems, you need to start two services. Refer to the Tivoli Directory Server v6.1 documentation that is provided on the CD or visit the IBM Tivoli Directory Server Information Center for additional information.

     

    Specify or confirm the following information in their corresponding fields in the form to set up the directory server and change properties for all business applications (The information in the fields assumes that your LDAP server, WebSphere Application Server v7.0, and IBM HTTP Server with the plugin are all configured on the same machine):

    Current login information:
    Directory Server: ldap://127.0.0.1:389/
    User DN: cn=root

    Server Properties:
    Server type: IBM Directory Server
    Hostname: 127.0.0.1
    LDAP ports allowed: (check Standard) 389
    Authentication realm: IBM Business Solutions
    Authentication port: (select Standard)

    User entry properties:
    Parent DN: cn=users, dc=com
    Naming Attribute: cn
    Object class: inetOrgPerson

    Group entry properties:
    Parent DN: cn=groups, dc=com
    Naming attribute: cn
    Object class: groupOfUniqueNames
    Member attribute: uniqueMember

    Administrator properties:
    Name: Administrator
    Password: (specify a password)
    Confirm password: (confirm password)

    Group: Administrators
    Authentication Realm: IBM Business Solutions - Administrators
    Contact Information:

     

  3. Enter the DN directory information for the users and groups that correspond to the structure of your directory server.
  4. The configuration property files are created and written to the following directory:

    <your_server_location>/profiles/<your_profile_name>/ibs/<your_server_name>

    When you delete the files in this directory, you clear the configuration information for the applications.

     

  5. Modify the httpd.conf file for IBM HTTP Server v7.0 to add the load module for LDAP.  The application generates a configuration file called apache20.inc, which is located in the <WAS_ROOT>/profiles/<your_profile_name>/ibs/<your_server_name> directory. This file includes a set of include directives.  The directives specify that before displaying certain pages that are contained for a URL address, authenticate with the LDAP server.  The pages are the administration pages for Business Solutions.  When you access the administrative pages for Business Solutions, you need to enter the correct user ID and password information.  The information is stored in the directory server.  The user ID and password is the same as the one you created when you installed Tivoli Directory Server v6.1.  You can add additional user IDs and passwords later that are specific to IBM Business Solutions so that you do not have to use the Tivoli Directory Server v6.1 user ID and password. 
  6. Add the following entries to the httpd.conf file that is used by IBM HTTP Server.

    For Windows operating systems:

    LoadModule "ibm_ldap_module your_web_server_installation_location\modules\IBMModuleLDAP.dll" Include "<your_server_location>\profiles\<your_profile_name>\ibs\<your_server_name>\apache20.inc"

    For Linux and UNIX operating systems:

    LoadModule ibm_ldap_module your_web_server_installation_location/modules/mod_ibm_ldap.so Include <your_server_location>/profiles/<your_profile_name>/ibs/<your_server_name>/apache20.inc


Start and Stop IBM Tivoli Directory Server


For Windows operating systems:

You may need to start two Windows services before you can access IBM Tivoli Directory Server v6.1:
  • IBM Tivoli Directory Administration Daemon v6.1. Automatically starts and handles administrative functions for the directory server.
  • IBM Tivoli Directory Server v6.1. The LDAP server. Start this service before running the Business Solutions applications.

  • For Start from Services Folder:
  • Click IBM Tivoli Directory Admin Daemon V6.1 - <instancename>. Then click Action -> Start. Click IBM Tivoli Directory Server Instance V6.1 - <instancename>. Then click Action -> Start.
  • For Stop from Services Folder:
  • Click IBM Tivoli Directory Admin Daemon V6.1 - <instancename>. Then click Action -> Stop. Click IBM Tivoli Directory Server Instance V6.1 - <instancename>. Then click Action -> Stop.

    For Linux and UNIX operating systems:

    To start the directory server instance using the command line, go to the sbin subdirectory of the directory where you installed IBM Tivoli Directory Server

  • IBM Tivoli Directory Server v6.1. The LDAP server. Start before running the Business Solutions applications.
  • Start: idsslapd -I <instanceName> (i.e. db2inst1)
    Stop: idsslapd -I <instanceName> -k (i.e. db2inst1)

    Continue

    Next: Verify Installation and setup