Installation and Upgrade Guides › Policy Server Installation Guide › Troubleshooting › Policy Server Troubleshooting

Policy Server Troubleshooting

The following sections detail common problems you may experience with the Policy Server during installation and the proposed solutions.

NETE_PS_ALT_CONF_FILE Environment Variable on Solaris

After installing the Policy Server on Solaris, the nete_ps_env.ksh script may have the following entry:

export NETE_PS_ALT_CONF_FILE=/export/siteminder/config/.siteminder.conf

The NETE_PS_ALT_CONF_FILE environment variable is used by the stop-all and start-all scripts, which stop and start the Policy Server’s service. The .siteminder.conf file is a temporary, run-time file created by these scripts and has no affect your SiteMinder configuration.

Do not modify the NETE_PS_ALT_CONF_FILE environment variable.

Policy Server Fails to Start After Installation

Valid on Windows and UNIX Systems

Symptom:

I have installed the Policy Server, but it is not starting.

Solution:

You may have the wrong JRE version installed. Make sure you have the correct JRE version.

Note: For a list of supported CA and third-party components, refer to the SiteMinder r12.0 SP3 Platform Support Matrix on the Technical Support site.

More information:

Locate the Platform Support Matrix

SiteMinder Environment Variables are not set in the Profile File

Valid on UNIX

Symptom:

The Policy Server was installed without adding the SiteMinder environment variables (smprofile.ksh) to the .profile file. I need to set the SiteMinder environment variables manually.

Solution:

To add the SiteMinder environment variables

1. Log in to the Policy Server host system.
2. Open a shell and navigate to siteminder_home.

   siteminder_home

   Specifies the Policy Server installation path.

3. Run the following command:

   smprofile.ksh
   

   The SiteMinder environment variables are set.

Winsock error 10054 message

Valid on Windows

Symptom:

When I try to log into the Policy Server, I receive the "Unable to proceed, winsock error 10054" message.

Solution:

One of the following could be the cause of the problem:

• The policy store does not contain the proper SiteMinder schema. Make sure you imported the correct SiteMinder schema.
• The Policy Server is not running. To start this server, use the Status tab on the Policy Server Management Console.

  Important! If you are accessing this graphical user interface on Windows Server 2008, open the shortcut with Administrator permissions. Use Administrator permissions even if you are logged in to the system as an Administrator. For more information, see the release notes for your SiteMinder component.

• The Policy Server is not connected to the policy store properly. Using the Data tab on the Policy Server Management Console, click Test Connection to make sure the policy store connects successfully. If it does not, reenter the data source information values on the Data tab by pointing the Policy Server at the policy store.

Working with a SiteMinder License

Symptom:

• I am currently using the Policy Server evaluation license and want to acquire and add a permanent license.
• I have a SiteMinder license, but cannot find it.
• I have a SiteMinder license, but do not know how to update it with a new product key.

Solution:

To request a SiteMinder license

1. Go to the Technical Support site.
2. Click CA Licensing Inquires. This link is located under Address Licensing Needs.

   The CA Customer Care site opens in a new window.

3. Click Licensing Issue Request. This link is located under Contact Us.

   An online request form opens in a new window.

4. Complete the required information and click Submit.

To add a permanent SiteMinder license to a Policy Server

1. Request a SiteMinder license.
2. Access the Policy Server host system.
3. Do one of the following:
   • (Windows) Navigate to siteminder_home\license
   • (UNIX) Navigate to siteminder_home/license

     siteminder_home

     Specifies the Policy Server installation path.

4. Copy the license.dat file to the license directory.
5. Restart the Policy Server.

To find an existing SiteMinder license

1. Log into the Technical Support site.
2. Click Licensing. Licensing is located on the left side under Support.

   The CA Licensing screen appears.

3. Click View Licenses. View Licenses is located under SiteMinder and Identity Manager Licenses.

   All license details, including the respective key, appear.

To apply a SiteMinder license key to the license file

1. Access the Policy Server host system.
2. Do one of the following:
   • (Windows) Navigate to siteminder_home\license
   • (UNIX) Navigate to siteminder_home/license

     siteminder_home

     Specifies the Policy Server installation path.

3. Open the license.dat file.
4. Copy and paste the license key acquired from the Support site into the license file.
5. Save the license file
6. Restart the Policy Server.