Installation and Upgrade Guides › Web Agent Installation Guide › Configure a Domino Web Agent › Configure a Domino Web Agent on Windows Systems › Run the Configuration Wizard for a Domino Web Agent on Windows

Run the Configuration Wizard for a Domino Web Agent on Windows

Before you configure the Agent, you may want to register the system where the Agent is installed as a trusted host; however, you can do this at a later time.

web_agent_home

Indicates the directory where the SiteMinder Agent is installed.

Default (Windows 32-bit installations of SiteMinder Web Agents only): C:\Program Files\CA\webagent

Default (Windows 64-bit installations [SiteMinder Web Agents for IIS only]): C:\Program Files\CA\webagent\win64

Default (Windows 32-bit applications operating on 64-bit systems [Wow64 with SiteMinder Web Agents for IIS only]): C:\Program Files (x86)\webagent\win32

Default (UNIX/Linux installations): /opt/ca/webagent

To configure a Domino Web Agent

1. If necessary, start the Web Agent Configuration Wizard.

   The default method is to select Start, Programs, SiteMinder, Web Agent Configuration Wizard. If you’ve placed the Wizard shortcut in a non-default location, the procedure will be different.

   Important! If you are running this wizard on Windows Server 2008, run the executable file with administrator permissions. Use these permissions even if you are logged in to the system as an administrator. For more information, see the release notes for your SiteMinder component.

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

   For information on registering the trusted host, see 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 C:\Lotus\Domino\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--replaces the existing configuration of server instance with the new one.
      • Preserve--keeps the existing web server's configuration without changing it.

      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, then click Next.

   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 where you installed the Domino Web server root directory.
   2. Set the EnableWebAgent parameter to YES.
   3. Save the file.

More Information

Agent Configuration Parameters Required for Domino Web Agents

Register Your System as a Trusted Host on UNIX

Configure the CGI Directory and CGI URL Path Settings on Windows Operating Environments (Optional)

To configure appropriate cgi-bin (ScriptAlias) settings for the Domino Web Agent, navigate to Internet Protocols tab for your server configuration in the Domino Administrator and configure the following settings:

• CGI directory: domino\html\cgi-bin
• CGI URL path: /cgi-bin

Configure Alias Settings to Enable HTML Forms Authentication Schemes (Optional)

To configure the Domino Web Agent to support HTML Forms authentication schemes perform the following tasks:

1. Create a subdirectory named "siteminderagent" in the Domino document root (\domino\html\) directory.
2. Copy all the subdirectories of agent_home\samples to the siteminderagent directory you created in Step 1.

   agent_home

   Specifies the SiteMinder Web Agent installation path.

3. To support X.509 Client Certificate and HTML Forms authentication schemes, additionally create a directory named "certoptional" in the siteminderagent directory you created in Step 1 and also copy all the subdirectories of agent_home\samples into it.