Installation and Upgrade Guides › Web Agent Installation Guide › Configure a Domino Web Agent › How to Configure a Domino Web Agent on UNIX Systems › Configure Domino Web Agents in GUI or Console Mode

Configure Domino Web Agents in GUI or Console Mode

These instructions are for GUI and Console Mode configuration. The steps for the two modes are the same, with these exceptions for Console Mode:

• You may be instructed to select an option by entering a corresponding number. For example, to select the Apache Web Server, you enter a 1, which corresponds to this server.
• Press ENTER after each step to proceed through the process instead of "clicking Next," as stated in the following procedure.
• All passwords that you enter are displayed in clear text. To workaround this issue, run the installation in GUI or unattended mode.

The prompts for each mode will help guide you through the process.

1. If necessary, start the Configuration Wizard.
   1. Open a console window.
   2. Navigate to web_agent_home/install_config_info
   3. Enter one of the following commands:

      GUI mode: ./ca-wa-config.bin

      Console mode: ./ca-wa-config.bin -i console

   Note: If you chose to configure the Web Agent immediately after the installation, SiteMinder automatically starts the Configuration Wizard.

2. If you have already done host registration, skip to the next step. Otherwise, select the option to skip host registration, then click Next.

   To register the trusted host, go to the installation chapter for your platform.

3. In the Select the Web server(s) dialog box, select the radio button for the Domino Web Sever and click Next.
4. In the Domino Web Server Path dialog box, specify the location of the notes.ini file, such as /local/notesdata, then click Next.

   Note: The installation automatically writes the path to the WebAgent.conf in the notes.ini file.

5. Select the web server instances that you want to configure with Web Agents.

   If you have already configured a server with a Web Agent and you are running the Configuration Wizard to configure additional web servers instances, the Wizard displays the Select One or More Instances to Overwrite dialog box. This dialog box lists the web servers that you have previously configured.

   1. Select one of the following:

      Overwrite—to overwrite the server instance configuration.

      Preserve—to preserve the web servers configuration.

      Important! If you uncheck a previously configured server, the Web Agent will be removed from this server.

   2. Click Next.
6. In the Agent Configuration Object field, enter the name of the Agent Configuration Object for this web server instance.

   This name must match an Agent Configuration Object already defined at the Policy Server. For example, to use the default enter DominoDefaultSettings.

7. In the Web Server Configuration Summary dialog box. Confirm that the configuration settings are correct, then click Install.

   The Web Agent files are installed.

8. Click Done when the installation is complete.
9. Enable the Web Agent:
   1. Open the WebAgent.conf file, located in the Domino web server root directory.
   2. Set the EnableWebAgent parameter to Yes.
   3. Save the file.
10. If your Domino web server runs on AIX, you must enable run time linking after configuring your agent (you only need to do this once) with the following steps:
    1. Run the following commands:

       cd domino_server_path/lotus/notes/latest/ibmpow
       /usr/bin/rtl_enable ./http -brtl
       mv ./http ./http.orig
       mv ./http.new ./http
       

    2. Start the Domino web server.