Previous Topic: Dynamic Policy Server ClustersNext Topic: Operating System Tuning for Agents

Web Services Security Guides › CA SiteMinder WSS Agent Guide for Apache-based Web Servers › Starting and Stopping SiteMinder WSS Agents

Starting and Stopping SiteMinder WSS Agents

This section contains the following topics:

Enable a SiteMinder WSS Agent

Disable a SiteMinder WSS Agent

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

Start and Stop SiteMinder WSS Agent Processing

More information:

WebAgent.conf File Locations

Enable a SiteMinder WSS 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 CA SiteMinder® Policy Server.

Follow these steps:

  1. Open one of the following files (as appropriate for your operating system) with a text editor:
    agent_home

    Indicates the directory where the SiteMinder WSS Agent is installed on your web server.

  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 SiteMinder WSS Agent is enabled.

Disable a SiteMinder WSS Agent

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

Follow these steps:

  1. Open one of the following files (as appropriate for your operating system) with a text editor:
    agent_home

    Indicates the directory where the SiteMinder WSS Agent is installed on your web server.

  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 SiteMinder WSS 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

Start and Stop SiteMinder WSS Agent Processing

The CA SiteMinder WSS XML SDK server is a process that must be running so the SiteMinder WSS Agent can process requests. The XML SDK Server is started automatically at system startup. This section describes how to start and stop it manually.

Note: Do not confuse the XML SDK server with the CA SiteMinder WSS SDK, which is an API that communicates with the XML SDK server.

Start the CA SiteMinder WSS XML SDK Server

The CA SiteMinder WSS XML SDK server process must be running for the SiteMinder WSS Agent to process requests.

To start the CA SiteMinder WSS XML SDK server on Windows

  1. Open the Services dialog.
  2. Right-click the TxMinder XML SDK Service entry and then click Start in the menu that opens.

To start the CA SiteMinder WSS XML SDK server on UNIX

  1. Open a command window.
  2. Navigate to agent_home.
    agent_home

    Indicates the directory where the SiteMinder WSS Agent is installed on your web server.

    Default (Windows 32-bit SiteMinder WSS Agent installations: C:\Program Files\CA\Web Services Security\webagent

    Default (Windows 64-bit SiteMinder WSS Agent installations: C:\Program Files\CA\Web Services Security\webagent\win64

    Default (Windows 32-bit SiteMinder WSS Agent installations operating on 64-bit systems: C:\Program Files (x86)\CA\Web Services Security\webagent\win32

  3. Enter the following command: 
    . ./ca_wa_env.sh
  4. Navigate to agent_home/bin
  5. Enter the following command: 
    tmxmlsdkserver -start
Stop the CA SiteMinder WSS XML SDK Server

The CA SiteMinder WSS XML SDK server process must be running for the SiteMinder WSS Agent to process requests.

To stop the CA SiteMinder WSS XML SDK server on Windows

  1. Open the Services dialog.
  2. Right-click TxMinder XML SDK Service entry and then click Stop in the menu that opens.

To stop the CA SiteMinder WSS XML SDK server on UNIX

  1. Open a command window.
  2. Navigate to agent_home.
    agent_home

    Indicates the directory where the SiteMinder WSS Agent is installed on your web server.

    Default (Windows 32-bit SiteMinder WSS Agent installations: C:\Program Files\CA\Web Services Security\webagent

    Default (Windows 64-bit SiteMinder WSS Agent installations: C:\Program Files\CA\Web Services Security\webagent\win64

    Default (Windows 32-bit SiteMinder WSS Agent installations operating on 64-bit systems: C:\Program Files (x86)\CA\Web Services Security\webagent\win32

  3. Enter the following command: 
    . ./ca_wa_env.sh
  4. Navigate to agent_home/bin
  5. Enter the following command: 
    tmxmlsdkserver -stop