Previous Topic: Manage Web Agents with Multiple Web Server InstancesNext Topic: User Protection

Web Agent Guides › Web Agent Configuration Guide › Starting and Stopping Web Agents

Starting and Stopping Web Agents

More information:

WebAgent.conf File Locations

Enable a Web Agent

Configure your agent parameters and then enable the agent to protect the resources on the web server.

Note: No resources are protected until you also define policies in the SiteMinder Policy Server.

Follow these steps:

  1. Open the WebAgent.conf file with a text editor.

    Note: Agents for IIS installed on 64-bit operating environments have two WebAgent.conf files. One file for 32-bit Windows applications. The other file is for 64-bit Windows applications. Modify both WebAgent.conf files when starting or stopping the Agent for IIS.

  2. Change the value of the EnableWebAgent parameter to yes.
  3. Save and close the WebAgent.conf file.
  4. Restart the web server (the web server itself, not the computer on which it runs).

    The Web Agent is enabled.

Disable a Web Agent

To stop the Web Agent from protecting the resources on your web server and stop communicating with the Policy Server, disable the Web Agent.

Follow these steps:

  1. Open the WebAgent.conf file with a text editor.

    Note: Agents for IIS installed on 64-bit operating environments have two WebAgent.conf files. One file for 32-bit Windows applications. The other file is for 64-bit Windows applications. Modify both WebAgent.conf files when starting or stopping the Agent for IIS.

  2. Change the value of the EnableWebAgent parameter to no.
  3. Save and close the WebAgent.conf file.
  4. Restart the web server (the web server itself, not the computer on which it runs).

    The Web Agent is disabled.

More information:

WebAgent.conf File Locations

Starting or Stopping Most Apache-based Agents with the apachectl Command

Starting or stopping most Apache-based agents with the apachectl command on UNIX or Linux operating environments requires setting the environment variables for the product first.

Note: The Apache-based agents do not support the apachectl -restart option. This procedure does not apply to Apche-based IBM HTTP servers. Use this procedure instead.

Follow these steps:

  1. For UNIX/Linux operating environments, set the environment variables by running the following script: 
    ./ca_wa_env.sh
  2. Use one of the following commands: 
    apachectl -stop

    apachectl -start