WebLogic Domino Service Setup Guide

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Installation

This chapter describes how to install the WebLogic Domino Service on the various supported platforms.

Note: The BEA_HOME directory refers to the directory where products are installed and WEBLOGIC_DOMINO_SERVICE_HOME refers to the directory the WebLogic Domino Service is installed.

This chapter contains the following sections:

 

Installation Prerequisites

The WebLogic Domino Service installer is a component and included as part of the WebLogic Portlets for Groupware Integration install bundle.

Installation Methods

The installation program supports the following methods for installing the WebLogic Domino Service software:

Graphical Mode

Graphical-mode installation is an interactive, GUI-based method for installing WebLogic Domino Service. For instructions for using this method, see Installing Using Graphical-Mode Installation.

Note: If you want to run graphical-mode installation, the console attached to the machine on which you are installing the software must support a Java-based GUI. All consoles for Windows systems support Java-based GUIs, but not all consoles for UNIX systems do. If you attempt to start the installation program in graphical mode on a system that cannot support a graphical display, the installation program automatically starts console-mode installation.

Console Mode

Console-mode installation is an interactive, text-based method for installing WebLogic Domino Service, from the command line, on either a UNIX system or a Windows system. For instructions for using this method, see Installing Using Graphical-Mode Installation.

 

Installing Using Graphical-Mode Installation

Perform the following steps to install the WebLogic Domino Service using the Graphical-Mode Installation. You can install on either Windows or UNIX.

Starting the Installation Program in Graphical-Mode on Windows

If you are installing WebLogic Domino Service on a Windows system that supports more than one monitor, you must disable all but one monitor before starting the installation program.

To start the installation in graphical mode on a Windows system:

  1. Log in to the Windows system.
  2. Obtain the WebLogic Domino Service installer. This installer is available from the WebLogic Portlets for Groupware Integration product bundle and can be found in the following directory:

    3. GROUPWARE_PORTLETS_HOME/service/domino_service

  3. Go to the directory that contains the installation file and invoke the installation procedure by entering the following command:

    4. java -jar wl_domino_service_setup-43.jar

    Note: The installation program begins to install WebLogic Domino Service.
  4. Proceed to Running the Installation Program.

Starting the Installation Program in Graphical-Mode on UNIX Platforms

If you are installing WebLogic Domino Service on a Windows system that supports more than one monitor, you must disable all but one monitor before starting the installation program.

To start the installation in graphical mode on a Windows system:

  1. Log in to the Windows system.
  2. Obtain the WebLogic Domino Service installer. This installer is available from the WebLogic Portlets for Groupware Integration product bundle and can be found in the following directory:

    3. GROUPWARE_PORTLETS_HOME/service/domino_service

    Go to the directory that contains the installation file and invoke the installation procedure by entering the following command:

    java -jar wl_domino_service_setup-43.jar

Note: The installation program begins to install WebLogic Domino Service.
  1. Proceed to “Running the Installation Program” on page 2-3.

Running the Installation Program

The installation program prompts you to enter specific information about your system and configuration. For instructions on responding to the prompts during installation, see Table 1.

Table 1 Running the Installation Program
In this window…
Perform the following action…
Welcome
Click Next to proceed with the installation. You may cancel the installation at any time by clicking Exit.
Choose BEA Home Directory
Specify the BEA Home directory that will serve as the central support directory for all Oracle products installed on the target system.
If you already have a BEA Home directory on your system, you can select that directory (recommended) or create a new BEA Home directory.
If you choose to create a new directory, the WebLogic Domino Service installation program automatically creates the directory for you.
The files in the BEA Home directory are essential to ensuring that the software operates correctly on your system.
Choose Install Type
Select the option button for the type of installation you want to perform:
  • Complete — All the software components and binaries provided with WebLogic Domino Service are installed on your system.
  • Custom — You select software components to be installed.
Choose Components

Note: This window is displayed only if you selected Custom installation in the Choose Install Type window.

Specify the components to be installed by selecting or clearing the appropriate check boxes. This window displays a tree view of all the components available for installation. In an initial installation, all components are selected.
Choose Product Directory
Specify the directory in which you want to install the WebLogic Domino Service software and click Next. You can accept the default product directory (BEA_HOME\wlpmapi43) or create a new product directory. If you choose to create a new directory, the installation program automatically creates the directory for you.
Choose Lotus Domino Program Directory
Specify the directory in which your Lotus Domino server is installed.
Choose Lotus Domino Data Directory
Specify the directory in which your Lotus Domino server data is installed.
Choose Shortcut Location
Specify the location for the shortcuts to Oracle product components.
Status
Read the information displayed about Oracle products and services.
Installation Complete
Click Done to exit the installation program.

 

Installing Using Console-Mode Installation

Perform the following steps to install the WebLogic Domino Service using the Console-Mode Installation. You can install on either Windows or UNIX.

Start Console-Mode Installation on Windows

To start the installation in console mode on a Windows system:

  1. Log in to the target Windows system.
  2. Obtain the WebLogic Domino Service installer. This installer is available from the WebLogic Portlets for Groupware Integration product bundle and can be found in the following directory:

    3. GROUPWARE_PORTLETS_HOME/service/domino_service

  3. Open an MS-DOS command prompt window.
  4. Go to the directory that contains the installation file and invoke the installation procedure by entering the following command:

    5. java -jar wl_domino_service_setup-43.jar -mode=console

Note: The installation program begins to install WebLogic Domino Service.
  1. Proceed to “Running the Console-Mode Installation” on page 2-6.

Start Console-Mode Installation on UNIX

Complete the following steps to start the installation in console mode:

  1. Log in to the target UNIX system.
  2. Open a shell window.
  3. Obtain the WebLogic Domino Service installer. This installer is available from the WebLogic Portlets for Groupware Integration product bundle and can be found in the following directory:

    4. GROUPWARE_PORTLETS_HOME/service/domino_service

  4. Launch the installation by entering the following commands:

    5. chmod a+x wl_domino_service_setup-43.bin -mode=console
    ./wl_domino_service_setup-43.bin -mode=console

    The installation program begins to install WebLogic Domino Service.

  5. Proceed to Running the Console-Mode Installation.

Running the Console-Mode Installation

To complete the console-mode installation process, respond to the prompts in each section by entering the number associated with your choice or by pressing Enter to accept the default. To exit the installation process, press exit (or x, for short) in response to any prompt. To review or change your selection, enter previous (or p, for short) at the prompt. To proceed to the following window, enter next (or n, for short).

Note: The sample console text and directory pathnames in this section use Windows conventions (backslashes) for pathnames, for example C:\bea\wlpmapi43. When entering pathnames on a UNIX system, use the UNIX convention (forward slashes) in pathnames, for example, /home1/bea/wlpmapi43. The following procedure steps you through the installation program. Use this procedure after you have started the installation program in console mode as described in the previous sections.
  1. At the Welcome prompt, type next (or n for short) or press Enter to continue with the installation process.

    2. The Choose BEA Home directory prompt is displayed.

  2. Specify the BEA Home directory that will serve as the central support directory for all Oracle products installed on the target system.

    3. The installation program displays the following prompt:

    Choose BEA Home Directory:
    --------------------------
    *BEA home choice
    1¦Create a new BEA Home [C:\bea]
    2¦Use an existing BEA Home [D:\beahome1]
    Enter index number to select OR [Exit][Previous][Next]>

    Note: Instead of typing complete words when you want to enter [Exit], [Previous], and [Next], you can use the following one-letter shortcuts: x, p, and n, respectively.
  3. Do one of the following:
    • To use an existing BEA Home directory, type 2 or next (or n for short), or press Enter.
    • If you have more than one BEA Home directory on your system, an additional prompt will display the directories. Type the number associated with the desired BEA Home directory.
    • To create a new BEA Home directory, type 1, then at the prompt, enter the full path of the BEA Home directory, for example C:\beahome2. If you specify a directory that does not exist, the installation program creates it for you.
  4. Whether you accept the existing BEA Home directory or choose to create a new BEA Home directory, you are prompted to confirm your selection, as shown in the following sample:

    5. Choose BEA Home Directory:
    --------------------------
    *BEA home choice
    ->1¦Yes, Use this BEA home directory [C:\bea]
    2¦No, return to BEA home directory selection
    Enter index number to select OR [Exit][Previous][Next]>

  5. On the command line, type 1 or press Enter to accept your selection. Otherwise, type 2 to return to the Choose BEA Home Directory panel where you can modify your entry.
  6. After you have selected your BEA Home directory and confirmed your selection, the Choose Install Type prompt is displayed.
  7. Specify the type of installation you want to perform by entering the number associated with the install type, as shown in the following text:

    8. Choose Install Type:
    --------------------
    ->1¦Complete
    2¦Custom Installation

    9. Do one of the following:

    • Type 1 or press Enter to choose a complete installation.
    • Type 2 to choose a custom installation. The Choose Components prompt is displayed.
  8. Specify the directory in which you want to install the WebLogic Domino Service software. Select the default product directory (BEA_HOME\wlpmapi43) or create a new product directory. If you specify a new directory, the installation program automatically creates it for you.

    9. The choices displayed in this section are as follows:

    Choose Product Directory:
    -------------------------
    Product Installation Directory= [C:\bea\wlpmapi43]
    Input new Product Installation Directory OR [Exit][Previous][Next]>

  9. Do one of the following:
    • Press Enter or type next (or n for short) to accept the current selection.
    • Enter the full path to the directory in which you want to install the WebLogic Domino Service software and press Enter.
  10. You are prompted to confirm your selection as shown in the following text:

    11. Choose Product Directory:
    -------------------------
    ->1| Yes, use this product directory [C:\bea\wlpmapi43]
    2| No, select another product directory
    Enter index number to select OR [Exit][Previous][Next]>\
    Verify that your entry is correct, then type 1 or press Enter to proceed with the installation. Otherwise, type 2 to return to the Choose Product Directory panel where you can modify your entry.

  11. Specify the Lotus Domino Program directory where your Lotus Domino server is installed.
  12. Specify the Lotus Domino Data directory where your Lotus Domino server exists.
  13. Specify the location for the shortcuts to Oracle product components, samples and tools.
  14. Press Enter or type Exit to exit the installation program.

 

Verifying the Installation

Check the following items to verify that the WebLogic Domino Service was installed:

The following files were added to the LOTUS_DOMINO_HOME directory:

The following Notes database and template was added to the LOTUS_DOMINO_DATA directory:

 

Configuring the Lotus Domino Server

Perform the following steps to configure the Lotus Domino server that will host the WebLogic Domino Service:

  1. Open the Lotus Administrator client application and open the server where the WebLogic Domino Service is installed.
  2. Edit the server document for the server where the WebLogic Domino Service is installed.
  3. Select Internet Protocols > HTTP tab.
  4. Under the DSAPI section, add the WebLogic Domino Service to the DSAPI filter file names field.
    • For Windows, add czdo_service.dll.
    • For UNIX, add libczdo_service.so.
      • Note: If entries exist in this field, append WebLogic Domino Service to the end, separated by a semicolon (;), with no carriage returns or whitespaces. For example: ndolextn.dll;czdo_service.dll.
  5. Save the server document.
  6. If the Lotus Domino server is started, enter the following tell commands from the Lotus Domino server console to restart the HTTP task:

    7. tell http quit

    load http

    Note: If the Lotus Domino server is not started, start the server.
    Note: Replication of server document to the Lotus Domino server might be needed to ensure that the WebLogic Domino Service is installed correctly.
  7. To verify the WebLogic Domino Service was installed and configured correctly, you should see the following message from within the Lotus Domino server console:

    8. 10/09/2003 04:19:27 PM JVM: Java Virtual Machine initialized
    10/09/2003 04:19:28 PM HTTP Server: Java Virtual machine loaded
    10/09/2003 04:19:28 PM WebLogic Domino Service (version x.x.x): loaded
    10/09/2003 04:19:28 PM HTTP Server: DSAPI WebLogic Domino
    Service
    Loaded successfully
    10/09/2003 04:19:29 PM HTTP Server: Started


  Back to Top       Previous  Next