Previous Topic: Dynamic Policy Server ClustersNext Topic: Uninstall a SiteMinder WSS Agent

Web Services Security Guides › CA SiteMinder® Web Services Security Agent Guide for IIS 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

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 the following file with a text editor: 
    agent_home\bin\IIS\WebAgent.conf
    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

    Note: CA SiteMinder® 12.52 Agents for IIS installed on 64-bit Windows operating environments have two WebAgent.conf files. One file is associated with 32-bit Windows applications. The other file is associated with 64-bit Windows applications. Modify both WebAgent.conf files to start or stop the CA SiteMinder® Agent for IIS on all 32-bit and 64-bit applications on a particular IIS 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 the following file with a text editor: 
    agent_home\bin\IIS\WebAgent.conf
    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

    Note: CA SiteMinder® 12.52 Agents for IIS installed on 64-bit Windows operating environments have two WebAgent.conf files. One file is associated with 32-bit Windows applications. The other file is associated with 64-bit Windows applications. Modify both WebAgent.conf files to start or stop the CA SiteMinder® Agent for IIS on all 32-bit and 64-bit applications on a particular IIS 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

Start and Stop SiteMinder WSS Agent Processing

The CA SiteMinder® Web Services Security 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® Web Services Security SDK, which is an API that communicates with the XML SDK server.

Start the CA SiteMinder® Web Services Security XML SDK Server

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

To start the CA SiteMinder® Web Services Security 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® Web Services Security 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® Web Services Security XML SDK Server

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

To stop the CA SiteMinder® Web Services Security 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® Web Services Security 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