Agent for SharePoint Guide › Install and Configure the CA SiteMinder Agent for SharePoint › How to Configure the CA SiteMinder Agent for SharePoint › Run the Configuration Wizard

Run the Configuration Wizard

After you install the Agent for SharePoint, run the configuration wizard. The configuration wizard registers the Agent for SharePoint with the Policy Server and performs some administrative tasks for the embedded Apache web server.

Before you run the wizard, verify that the required Policy Server objects exist.

Note: Tomcat uses the nobody user by default because it is the least privileged user.

Important! If you have previously run the configuration wizard on your Agent for SharePoint, create a backup copy of your proxyrules.xml file. The configuration wizard creates a default proxyrules.xml file each time it runs on a computer.

Follow these steps:

1. Open a console window and navigate to the directory Agent-for-SharePoint_home/
2. Enter one of the following commands:
   • Windows: ca-spagent-config.cmd
   • UNIX or Linux: ca-spagent-config.sh

   The wizard starts. The Host Registration screen appears.

   Note: In Windows, you can alternatively navigate to Agent-for-SharePoint_home/install_config_info and double-click ca-spagent-config.exe.

3. Select Yes option to perform host registration if the computer is not registered as a trusted host.
4. As part of the trusted host registration process, respond to the prompts as follows:
   1. Specify the name and password of the SiteMinder administrator and click Next.

      The information you enter must be defined at the Policy Server where the trusted host registers. This screen also includes an optional check box for enabling shared secret rollover.

   2. Specify the name of the Trusted Host and the Host Configuration Object and click Next.

      The name you enter for the trusted host must be unique. The name for the Host Configuration Object must already be defined at the Policy Server where the trusted host is registered.

   3. Enter the IP address of the Policy Server where you want to register the trusted host and click Add. Click Next.

      Note: Include a port number for the Policy Server. For example, 121.111.12.11:44442.

   4. Specify the name and location of the host configuration file, SmHost.conf. The wizard lists the default location. Click Next.
   5. Specify the name of the Agent Configuration Object and click Next. The Agent Configuration Object that you enter must already be defined at the Policy Server where the trusted host is registered.

      Enter the name of the ACO built from the SharePoint2010DefaultSettings ACO template defined in the Policy Server.

   6. Specify the name and location of the Agent Configuration file. The wizard lists the default location. Click Next.
5. Enter the following information for the Apache web server:
   • Server name, in the form server_name.example.com.
   • Web server administrator email address, in the form admin@example.com.
   • HTTP port number. The default is 80.
   • HTTPS (SSL) port number. The default is 443.

   Note: On Solaris or Linux, an additional screen prompts for the name of the user under which Tomcat and Apache run. This user cannot be root.

6. Enter the following configuration information for the Claims Search Web Service:Claims WS HTTP Port.
   • Claims WS SSL Port.

   Note: No default values are provided for the Claims WS HTTP and SSL Ports. However, use a port that is free, which Tomcat can use to host the web application. For UNIX and Linux, the ports must be greater than 1024. Nobody account works with ports above 1024.

7. (Optional) Select the check box if you want to enable the Agent for SharePoint.
8. Review the Configuration Summary.
9. Click Install.

   The files are installed.

10. Click Done to exit the wizard.

Note: If you run the Configuration Wizard again for any reason, SSL must be reinitialized. The installer contacts the Policy Server and attempts to register the Trusted Host to create the host configuration file. If trusted host registration does not succeed, the Agent for SharePoint cannot contact the Policy Server and operate properly.

More information:

Gather CA SiteMinder Agent for SharePoint Configuration Wizard Information

Agent for SharePoint Configuration Wizard Information Worksheet