Previous Topic: Policy Server Configuration WizardNext Topic: Configuring LDAP Directory Servers to Store CA SiteMinder® Data

Installation and Upgrade Guides › Policy Server Installation Guide › Installing the Policy Server on UNIX Systems › How to Uninstall the Policy Server

How to Uninstall the Policy Server

Complete the following procedures to uninstall the Policy Server:

  1. Shut down all instances of the Policy Server Management Console.

    Note: More information on shutting down the Policy Server Management Console exists in the Policy Administration Guide.

  2. Set the JRE in the path variable.
  3. Remove Policy Server references from agent host files.
  4. Stop all CA SiteMinder® processes.
  5. Uninstall the Policy Server.
  6. Remove CA SiteMinder® references from IWS.
  7. Remove CA SiteMinder® references from ServletExec/AS.
  8. Remove leftover items.
Remove Policy Server References from Agent Host Files

You remove the Policy Server reference from the SmHost.conf file to prevent unexpected results from the Web Agent once the Policy Server is uninstalled.

To remove the Policy Server reference

  1. Navigate to web_agent_home/config.
    web_agent_home

    Specifies the installation directory of the Web Agent.

  2. Open the SmHost.conf file in a text editor.
  3. Delete the line that begins with "policyserver=".

    Note: This line contains the IP address and port numbers for the Policy Server you are uninstalling.

  4. Save SmHost.conf.

    The SmHost.conf file no longer references the Policy Server you are uninstalling.

Set the JRE in the PATH Variable

You set the JRE in the PATH variable when uninstalling the Policy Server, Web Agent, SDK, or documentation to prevent the uninstallation program from stopping and issuing error messages.

To set the JRE in the PATH variable

  1. Run the following command: 
    PATH=$PATH:<JRE>/bin
    JRE

    Specifies the location of the JRE.

  2. Run the following command: 
    export PATH

    The JRE is set in the PATH variable.

Stop all CA SiteMinder® Processes

You stop all CA SiteMinder® processes to ensure that Policy Server files are safely removed.

To stop all CA SiteMinder® processes

  1. Log into the UNIX system with the smuser account.
  2. Run stop-all, which is located in the /siteminder directory.

    All CA SiteMinder® processes stop.

Uninstall the Policy Server

You uninstall the Policy Server when it is no longer required on the system.

Note:Do not manually remove the installation directories to uninstall this component. Execute the uninstall shell script. If you only remove the installation directories, related registries can be left behind. If you try to re–install this component on this host system, the entries can prevent a successful installation.

Follow these steps:

  1. Log in to the Policy Server host system as the user who installed the Policy Server.

    Note: The user who installed the Policy Server should have the required CA SiteMinder® scripts sourced. If the CA SiteMinder® scripts are not sourced at login, or you logged in as another user, source the following scripts:

    smprofile.ksh
ca_ps_env.ksh
  2. Change to the following directory in a console window: 
    siteminder_home/siteminder/install_config_info/ca-ps-uninstall
    siteminder_home

    Specifies the Policy Server installation path.

  3. Run the following command: 
    ./uninstall

    The uninstallation program appears.

  4. Press Enter.

    A status indicator displays progress.

  5. Change the directory to the one above the CA SiteMinder® installation directory.

    Example: If the CA SiteMinder® installation directory is /export/smuser/ca/siteminder, go to:

    /export/smuser/ca
  6. Enter the following command and press Enter. 
    $ rm -rf siteminder

    The CA SiteMinder® installation directory is removed.

  7. Open the following file from the HOME directory: 
    .profile
  8. Locate and delete the line that contains smprofile.ksh.

    Example:

    ./export/smuser/siteminder/smprofile.ksh
  9. Save the file.

    The Policy Server is uninstalled.

Remove CA SiteMinder® References from IWS

You manually remove CA SiteMinder® references from IWS after uninstalling the Policy Server. CA SiteMinder® references are left in the obj.conf file and the magnus.conf file.

To remove CA SiteMinder® references from IWS

  1. Log into an account that has privileges to access and modify the Web server's configuration.
  2. Go to the following at the Solaris command line. 
    <SunJavaSystem_home>/https-<hostname>/config

    The obj.conf and magnus.conf files appear in the config folder.

  3. Open obj.conf and remove the following lines: 
    NameTrans fn="assign-name" from="/servlet/*" name="<ServletExec_instance name>"
NameTrans fn="assign-name" from="*.jsp*" name="<ServletExec_instance name>"
NameTrans fn="pfx2dir" from="/sitemindermonitor" dir="/<siteminder_installation>/monitor"
NameTrans fn="pfx2dir" from="/sitemindercgi" dir="/<siteminder_installation>/admin" name="cgi"
NameTrans fn="pfx2dir" from="/siteminder" dir="/<siteminder_installation>/admin"
NameTrans fn="pfx2dir" from="/netegrity_docs" dir="/netegrity/netegrity_documents"
<Object name="<ServletExec_instance name>">
Service fn="ServletExecService" group="<ServletExec_instance name>"
</Object>
  4. Save and close the obj.conf file.
  5. Open magnus.conf and remove the following lines: 
    Init fn="init-cgi" SM_ADM_UDP_PORT="44444" SM_ADM_TCP_PORT="44444"
Init fn="load-modules" shlib="/<Servlet_Exec_Install>/bin/ServletExec_Adapter.so" funcs="ServletExecInit,ServletExecService"
Init fn="ServletExecInit" <ServletExec_instance name>.instances="<IP_Address>:<port_number>"
  6. Save and close magnus.conf.
  7. Restart the Web server.

    CA SiteMinder® references are removed from IWS.

    The CA SiteMinder® references no longer appear in IWS.

Remove CA SiteMinder® References from StartServletExec

To remove references from StartServletExec

  1. Log in with an account that has privileges to access and modify the configuration of ServletExec.
  2. At the Solaris command line, go to the /usr/NewAtlanta/ServletExecAS/ServletExec_instance name folder.
  3. Remove the following lines from the StartServletExec script: 
    CLASSPATH=${NA_LIB}/servlet-api.jar:${NA_LIB}/jsp-
api.jar:${NA_LIB}/ServletExec60.jar:${NA_LIB}/ServletExecAdmin.jar:${NA_LIB}/el-
api.jar:${NA_LIB}/jasper-el.jar:${JL}/tools.jar:${NA_LIB}/jstl.jar:${NA_LIB}/appserv-
jstl.jar:${NA_LIB}/activation.jar:${NA_LIB}/mail.jar:${HOMEDIRPATH}/classes:/siteminder_home/monitor/
smmonui.jar:/siteminder_home/lib/smconapi.jar:/siteminder_home/lib/smmonclientapi.jar 
$SENAME $HOMEDIR $MIMEFILE $DOCROOTDIR -allow 127.0.0.1 -port $PORT $SEOPTS" 
$SENAME $HOMEDIR $MIMEFILE $DOCROOTDIR -allow 127.0.0.1 -port $PORT $SEOPTS -addl
"/sitemindermonitor=/siteminder_home/monitor""
    siteminder_home

    Specifies the Policy Server installation path.

  4. Save and close the StartServletExec script.
  5. Restart ServletExec.

    The uninstallation is complete.

Remove Leftover Items

The com.zerog.registry.xml file is left on the system after you uninstall the Policy Server. Remove this file.

You can locate this file at one of the following: