Installation Guides › Policy Server Installation Guide › Installing the Policy Server on UNIX Systems › How to Install the Policy Server › Run the Installer to Install the Policy Server Using a UNIX Console

Run the Installer to Install the Policy Server Using a UNIX Console

You run the respective UNIX installation executable to install the Policy Server. The installation executables are in the SOA Security Manager kit available on the Technical Support site. They are the following:

• Solaris—ca-soasm-12.1-cr001-sol.bin
• Red Hat Linux—ca-soasm-12.1-cr001-linux.bin

To locate installation kits on the Support site

1. Click Technical Support.
2. Log into CA Support Online.
3. Click Download Center.
4. Search the Download Center for the installation kit you need.

Note: Extract all files and directories in the SOA Security Manager kit to a common location on a local drive and keep them together—the SOA Security Manager installer cannot run without the included supporting files.

If you do not have sufficient rights, add executable permission to the install file by running the following command:

chmod+x ca-soasm-12.1-cr001-os_version.bin

• os_version

  Specifies sol or linux.

Important! If you execute the SOA Security Manager installer across different subnets it can crash. To avoid this problem, install the Policy Server directly on the host system.

Note: Before installing the Policy Server, ensure that the system meets the UNIX requirements and you have gathered the necessary information for the installer.

To run the Policy Server installer using a UNIX console

1. Exit all applications that are running.
2. Enter the following command in a UNIX shell:

   sh ./ca-soasm-12.1-cr001-os_version.bin -i
   

   The installation starts.

   Note: When prompted to select from a list of numbered choices, enter the numbers separated by commas (,). To select none of the features, enter only a comma.

3. Use the gathered system and component information to install the Policy Server and configure Policy Server components. Consider the following when running the installer:
   • When prompted to select features to install, select CA SOA Security Manager Policy Server.
   • When prompted to select the components you want configured:
     • If you plan on using a relational database or an LDAP directory server other than ADAM or Sun Java System Directory Server as a policy store, deselect the Policy Store option. You manually configure a relational database or any other supported LDAP directory server after installing the Policy Server.
     • If you plan on using WS-Security SAML tokens ensure that the Create SM Key Database/Change SM Key Database Password options are selected.

     Note: If you choose to create a key database, you are prompted to install the default CA certificates. Ensure the Import default CA certificates options is selected and install these certificates. You may add additional certificates and private keys to an smkeydatabase after installation. More information on the role of smkeydatabase exists in the Policy Configuration Guide.

   • If you are initializing a policy store, you are prompted to enter a password for the default SOA Security Manager user account. The default account name is SOA Security Manager. This account:
     • is the default Super User account for the FSS Administrative UI. This is not the administrator account for the Administrative UI. You identify a separate administrator account when installing the Administrative UI.
     • is used for all tasks that do not require direct access to the Administrative UI.
   • If you are using IPv6 addresses, ensure your entries include brackets.

     Example: [2001:db8::1428:57ab]

   • When prompted to initialize the LDAP instance do so only to configure a new policy store instance.
   • If you cut and paste path information into the wizard, you must also enter a character before the Next button is enabled.
4. Review the installation settings and proceed.

   The Policy Server and any selected components are installed and configured.

   Note: The FSS Administrative UI was installed during the Policy Server upgrade. The FSS Administrative UI is for managing CA SiteMinder Federation Security Services. Register the FSS Administrative UI with the Policy Sever after upgrading the policy store. More information on registering the FSS Administrative UI exists in Registering the Federation Security Services UI.

5. Review the installation settings and press Enter.

   The Policy Server is installed.

   Note: This may take several minutes.

6. Press Enter.

   The installer closes

7. Reboot the system.

   The Policy Server and selected components are installed and configured.

   Note: If you require the FSS Administrative UI, register it with the Policy Server after installing and registering the Administrative UI. More information on registering the FSS Administrative UI exists in Registering the Federation Security Services UI.

If you experience problems during an installation or upgrade, you can locate the CA_SOA_Security_Manager_r12.1_InstallLog.log file in soa_home/install_config_info/

You can also refer to the ca-ps-details.log file located in soa_home/siteminder/install_config_info to check the status of the installer's auto-configuration of an ADAM or Sun Java System Directory Server policy store.

• soa_home

Specifies the path to where SOA Security Manager is installed.