Previous Topic: System RequirementsNext Topic: General Considerations


Installation Considerations

This section contains the following topics:

System Locale Must Match the Language of Installation and Configuration Directories (169863)

Considerations for Localized Installations

Installation on Windows

Installation on UNIX in GUI mode

Installation on UNIX in Console Mode

Unattended Installation on Windows

Unattended Installation on UNIX

Uninstallation of the SDK

System Locale Must Match the Language of Installation and Configuration Directories (169863)

To install and configure a CA SiteMinder® component to a non-English directory, set the system to the same locale as the directory. Also, make sure that you installed the required language packages so the system can display and users can type localized characters in the installer screens.

For the details on how to set locale and required language packages, refer to respective operating system documents.

Considerations for Localized Installations

When installing the SiteMinder SDK on a system with a non-English operating system, remember that the smpolicyapi is an UTF-8 based API . The library expects UTF-8 encoded strings as input. It returns UTF-8 encoded strings as output parameters.

Installation on Windows

No special accounts or privileges are required to install the CA SiteMinder® SDK. Instructions for installing a first version of the SDK and upgrading from an existing version are the same.

Do not install the CA SiteMinder® SDK in the installation path with the Policy Server or Web Agent. The SDK can possibly have different versions of the same support libraries.

To install the SDK

  1. Close all programs.
  2. Download the SDK from the CA Technical Support site.
  3. Navigate to the win32 directory and run the following program:
    ca-sdk-12.52-win32.exe
    

Follow the wizard.

Windows Server 2008 System Considerations

For Windows Server 2008, the User Account Control feature helps prevent unauthorized changes to your system. When the User Account Control feature is enabled on the Windows Server 2008 operating environment, prerequisite steps are required before doing any of the following tasks with a CA SiteMinder® component:

Note: For more information about which CA SiteMinder® components support Windows Server 2008, see the CA SiteMinder® Platform Support matrix.

To run CA SiteMinder® installation or configuration wizards on a Windows Server 2008 system

  1. Right–click the executable and select Run as administrator.

    The User Account Control dialog appears and prompts you for permission.

  2. Click Allow.

    The wizard starts.

To access the CA SiteMinder® Policy Server Management Console on a Windows Server 2008 system

  1. Right–click the shortcut and select Run as administrator.

    The User Account Control dialog appears and prompts you for permission.

  2. Click Allow.

    The Policy Server Management Console opens.

To run CA SiteMinder® command–line tools or utilities on a Windows Server 2008 system

  1. Open your Control Panel.
  2. Verify that your task bar and Start Menu Properties are set to Start menu and not Classic Start menu.
  3. Click Start and type the following in the Start Search field:
    Cmd
    
  4. Press Ctrl+Shift+Enter.

    The User Account Control dialog appears and prompts you for permission.

  5. Click Continue.

    A command window with elevated privileges appears. The title bar text begins with Administrator:

  6. Run the CA SiteMinder® command.

More information:

Contact CA Technologies

Installation on UNIX in GUI mode

No special accounts or privileges are required to install the CA SiteMinder® SDK. Instructions for installing a first version of the SDK and upgrading from an existing version are the same.

Do not install the CA SiteMinder® SDK in the same path as the Policy Server or Web Agent. The SDK can possibly have different versions of the same support libraries.

Note: When installing the SiteMinder SDK on Linux systems, be sure that you have the appropriate 32.bit C runtime library for your operating environment (that is, libstdc++.so.6). You can obtain this library by installing the following rpm:

On UNIX, the installation executable file is ca-sdk-12.52-platform.bin.

You can install the SDK in GUI mode or console mode.

To Install the SDK in UNIX GUI Mode

  1. Close all programs.
  2. Download the SDK from the CA Technical Support site.
  3. In a UNIX shell, navigate to the directory that corresponds to your platform (solaris, aix, linux, or hpux).
  4. Enter the following command:
    sh ./ca-sdk-12.52-OS.bin
    
    OS

    Replace OS with sol, aix, linux, suse, or hp.

    For example, on Solaris platforms, the command is:

    sh ./ca-sdk-12.52-sol.bin
    
  5. Follow the wizard.

Installation on UNIX in Console Mode

No special accounts or privileges are required to install the CA SiteMinder® SDK. Instructions for installing a first version of the SDK and upgrading from an existing version are the same.

Do not install the SDK in the installation path with the Policy Server or Web Agent. The SDK can possibly have different versions of the same support libraries.

Note: When installing the SiteMinder SDK on Linux systems, be sure that you have the appropriate 32.bit C runtime library for your operating environment (that is, libstdc++.so.6). You can obtain this library by installing the following rpm:

On UNIX, the installation executable file is ca-sdk-12.52-platform.bin.

You can install the SDK in GUI mode or console mode.

To Install the SDK in UNIX Console Mode

  1. Close all programs.
  2. Download the CA SiteMinder® SDK from the CA Technical Support site.
  3. In a UNIX shell, navigate to the directory that corresponds to your platform (solaris, aix, linux, or hpux).
  4. Enter the following command:
    sh ./ca-sdk-12.52-platform.bin -i console 
    
    platform

    Replace platform with sol, aix, linux, suse, or hp.

    For example, on Solaris platforms, the command is:

    sh ./ca-sdk-12.52-sol.bin -i console
    

Follow the wizard.

Unattended Installation on Windows

After the CA SiteMinder® SDK has been manually installed, you can install it on the same system, or a different system, using the silent installation mode. An unattended installation uses one command that points to a properties file for installation preferences. The default properties template file (sdk-installer.properties in the install_config_info folder) can be modified to suit your requirements.

To install the SDK in silent mode on Windows

  1. Navigate to the directory where the SDK executable is located.
  2. Enter the following command at a command prompt:
    ca-sdk-12.52-win32.exe -f sdk-installer.properties -i silent
    
    -f

    Specifies the name of the SDK installer properties file. If the properties file is not in the same directory as the installation executable file, specify the relative path to the properties file.

    -i

    Specifies the installation mode.

The installation is complete.

Unattended Installation on UNIX

After the CA SiteMinder® SDK has been manually installed, you can install it on the same system, or a different system, using the silent installation mode. An unattended installation uses one command that points to a properties file for installation preferences. The default properties template file (sdk-installer.properties in the install_config_info folder) can be modified to suit your requirements.

To install the SDK in silent mode on UNIX

  1. Navigate to the directory where the SDK executable is located.
  2. Enter the following command at a command prompt:
    sh ./ca-sdk-12.52-platform.bin -f sdk-installer.properties -i silent
    
    -f

    Specifies the name of the SDK installer properties file. If the properties file is not in the same directory as the installation executable file, specify the relative path to the properties file.

    -i

    Specifies the installation mode.

    The installation is complete.

Uninstallation of the SDK

To uninstall the SiteMinder SDK from the UNIX console

  1. In a console window, navigate to the install_config_info/ca-sdk-uninstall directory within the SDK installation—for example:

    /export/ca/sdk/install_config_info/ca-sdk-uninstall

  2. Run the following command:
    ./uninstall -i console
    
  3. When prompted, press Enter to begin the uninstallation.

    Note: When you are uninstalling the SDK in UNIX, make sure the JRE is in the PATH variable. If the JRE is not in the PATH variable, the following error occurs:

    No Java virtual machine could be found from your PATH environment variable. You must install a VM prior to running this program.

To set the JRE in your PATH, run the following two commands:

  1. PATH=$PATH:JRE_location/bin

    For example: PATH=$PATH:/usr/bin/jdk141/jre/bin

  2. export PATH

To uninstall the SiteMinder SDK from Windows:

  1. From the Control Panel, double-click Add/Remove Programs.
  2. Select SiteMinder SDK 12.52 and click Change/Remove.

Follow the screen prompts, and click Close when done.