Previous Topic: SiteMinder Policy Server Pre-Installation StepsNext Topic: Install and Verify the SiteMinder Policy Server


Configure the SiteMinder Policy Server Properties File

Set the parameters for the SiteMinder Policy Server installation.

You need the following information to complete the SiteMinder Policy Server parameters.

General Information:
From your Oracle installation:
From your CSP DSA installation:
From the CA Directory properties file:

Follow these steps:

  1. Navigate to /tmp/properties.sh.
  2. In the properties.sh file, set the following parameters.
    _Environment

    Leave as the default, VMWare

    _oracle_schema_user

    Set to CamAdmin. This is an Oracle database user ID you previously created with DBA and Connect privileges.

    _oracle_schema_password

    The password for the oracle_schema_user, CamAdmin. Enter the same password you entered when you created the CamAdmin user in the Oracle database.

    _db_server

    Host name of the Oracle database server. For an Oracle RAC setup, use the RAC host name.

    _database_name

    Oracle database SID or Service name. For an Oracle RAC setup, use the service name.

    _ps_tablespace_filename

    Enter a name for the Oracle tablespace file for the Policy Server, in one of the following formats.

    • For an Oracle RAC setup, enter only the tablespace file name. Do not include the file name extension:

      <name_of_PS_tablespace_file>

    • For a non-RAC setup, enter the full path to the tablespace file. Include the file name extension:

      <path_to_PS_tablespace_file>/<name_of_PS_tablespace_file.dbf>

    Make a note of this value so you can use it later during the installation process.

    _ps_tablespace_filesize

    The size of the table space for the SiteMinder Policy Server database. We recommend an initial size of 1000MB.

    _ps_ha_hosts

    For a high-availability deployment, enter the host name where you plan to install the second SiteMinder Policy Server.

    Note: If you have three or more instances of SiteMinder Policy Server, separate the entries with commas. For example: PolicyServer2, PolicyServer3. Do not include the host name on which you are currently installing.

    In a single-instance deployment, leave this parameter blank.

    _ps_db_user

    A user name for the database user for the Policy Server database. Create any user name.

    Make a note of this user name so you can use it later during the installation process.

    _ps_db_password

    A password for the database user for the SiteMinder Policy Server database. Create any password.

    Make a note of this password so you can use it later during the installation process.

    _ps_tablespace_name

    Table space name for the Policy Server database. Create any table space name.

    Make a note of this name so you can use it later during the installation process.

    _aa_db_user

    A user name for the Advanced Authentication database. Create any user name.

    Make a note of this user name so you can use it later during the installation process. Use the same value for _im_webfort_user when you install the Identity Management Server.

    _aa_db_password

    A password for the aa_db_user. Create any password.

    Make a note of this password so you can use it later during the installation process. Use the same value for _im_webfort_password when you install the Identity Management Server.

    _aa_tablespace_filename

    Enter a name for the Oracle tablespace file for the Advanced Authentication database, in one of the following formats.

    • For an Oracle RAC setup, enter only the tablespace file name. Do not include the file name extension:

      <name_of_AA_tablespace_file>

    • For a non-RAC setup, enter the full path to the tablespace file. Include the file name extension:

      <path_to_AA_tablespace_file>/<name_of_AA_tablespace_file.dbf>

    _aa_tablespace_filesize

    The size of the file for the table space for the Advanced Authentication database. We recommend an initial size of 1000MB.

    _aa_tablespace_name

    The name of the Advanced Authentication table space.

    _aa_tomcat_user

    The name of a user who starts the Advanced Authentication Tomcat service. Leave as the default, root.

    _ps_encryption_key

    An encryption key for the Policy Server. Enter any string for the encryption key.

    Note: This key is used in encryption processes by the SiteMinder policy server. Choose a string that fulfills typical password best practices.

    _ps_admin_password

    A password for the default SiteMinder user. Create any password.

    Make a note of this password so you can use it later during the installation process. Use the same value for _generic_password when you install the Identity Management Server.

    _sm_audit_cleanup_days

    Leave as the default, 10.

    _ps_license_data

    Enter the path on your local system or in a file share to the license.dat file for your SiteMinder Policy Server. Enter the path in the following format:

    <path_to_license.dat_file>/license.dat

    _dir_webservices_username

    User name for Web Services. Leave as the default, dsaweb.

    _dir_webservices_password

    Enter the same password you entered for _dir_webservices_password in the properties file for the first CA Directory instance.

    _csp_console

    Set to false if you are installing a SiteMinder Policy Server.

    Note: This parameter allows you to install a CSP Console through this installer. Set this to False to prevent a CSP Console from installing.

    Important! Set this to true only once for your entire deployment. You only need one CSP Console instance, even in a high-availability deployment.

    We recommend that you install a CSP console on a system separate from your SiteMinder Policy Server.

    _csp_deploy_dsa

    Set to false if you are installing a SiteMinder Policy Server.

    Note: This parameter allows you to install a CSP DSA through this installer. Set this to False to prevent a CSP Console from installing.

    Important! Set this to true only once for your entire deployment. You only need one CSP DSA instance, even in a high-availability deployment.

    We recommend that you install a CSP DSA on the same system on which you install the CSP Console. Install the CSP Console and CSP DSA on a system separate from your SiteMinder Policy Server.

    _csp_dir_webservices_port

    Port used by Web Services. Leave as the default, 9080, unless you cannot use this port in your environment. If you must change the web services port, enter a new port number.

    Note: If you must change the web services port, use the same port for web services on all servers.

    _csp_dir_webservices_username

    User name for Web Services. Leave as the default, dsaweb.

    _csp_dir_webservices_password

    Enter the same password you entered for _dir_webservices_password in the properties file for the first CA Directory instance.

    _csp_id

    Leave as the default, cacsp.

    _csp_dir_host

    Enter the host name of the system where you plan to install the CSP DSA.

    _csp_dir_port

    Port used for CSP DSA. Leave as the default, 50000, unless you cannot use this port in your environment. If you must change the web services port, enter a new port number.

    Note: If you must change the CSP DSA port, use the same port for the CSP DSA on all SiteMinder Policy Servers.

    _csp_dir_password

    The administrator password for the default user cspadmin in the CSP DSA. Create any password.

    Make a note of this password for future use.

    Note: The installation automatically creates the cspadmin user name. You choose the password to apply to this account.

    _csp_webservice_cfg_id

    Leave as the default, cspwebservice.

    _csp_webservice_cfg_secret

    Leave as the default. Internal use, do not change.

    _aa_dsn_name

    Required. The ODBC data source name. Enter any name for the data source.

    _aa_tws_base_url

    Required. Enter the URL for Tenant Web Sevices, using the following format:

    http://<internal_host:internal_tomcat_port>/tenant-services/cm/tenantws

    • For a non-high-availability deployment, the internal host is the fully-qualified domain name of the SiteMinder Policy Server.
    • For a high-availability deployment, use the fully-qualified domain name of the SiteMinder Policy Server load balancer.
    • The port number is 9090 by default.
    aa_im_base_url

    Required. Enter the base URL for the Identity Management Server, using the following format:

    https://<external_host>/iam/im/

    • For a non-high-availability deployment, the external host is the fully-qualified domain name of the Secure Proxy Server.
    • For a high-availability deployment, use the fully-qualified domain name of the Secure Proxy Server load balancer.
    • If your Secure Proxy Server is not using the https protocol, begin the base URL with http://

    This information is used for browser redirect.

    _aa_tws_config_id

    Required. The configuration id for Tenant Web Services. The default value, tenantwebservices, is pre-populated.

    If you want to use a different value, you must update the value here and in the Identity Management Server properties file.

    _aa_tws_shared_secret

    Required. The plain shared secret used by Tenant Web Services. The default value, firewall, is pre-populated.

    We recommend that you change this value. Enter any value.

    Note: You must update the value here and in the Identity Management Server properties file.

    _aa_tomcat_host_address

    Required. Enter the internal host address.

    • For a non-high-availability deployment, the internal host is the fully-qualified domain name of the SiteMinder Policy Server.
    • For a high-availability deployment, use the fully-qualified domain name of the SiteMinder Policy Server load balancer.
    _shim_aaui_host_port

    Required. Enter the external host address, i.e., the domain exposed to the outside world. Supply the host name even though the parameter name ends with _port.

    • For a non-high-availability deployment, the external host is the fully-qualified domain name of the Secure Proxy Server.
    • For a high-availability deployment, use the fully-qualified domain name of the Secure Proxy Server load balancer.
    _shim_sm_webagent_host_port

    Required. Enter the external host address, i.e., the domain exposed to the outside world. Supply the host name even though the parameter name ends with _port.

    • For a non-high-availability deployment, the external host is the fully-qualified domain name of the Secure Proxy Server.
    • For a high-availability deployment, use the fully-qualified domain name of the Secure Proxy Server load balancer.
    _tws_imdb_user

    Required. A user name in the Identity Management data store. Enter any user name.

    Make a note of this user name so you can use it later during the installation process. Use the same value for _im_db_user when you install the Identity Management Server. This user is created during Identity Management installation.

    _tws_imdb_pwd

    A password for the user defined in _tws_imdb_user. Enter any password.

    Make a note of this password so you can use it later during the installation process. Use the same value for _im_db_password when you install the Identity Management Server.

    _tws_im_ws_host

    Enter the host name of the system where you plan to install the Identity Management Server. This is used in TWS for accessing the web services deployed in the Identity Management Server.

    _haprefimps

    Enter the host name of the primary IdentityMinder Provisioning Server. This is the first Provisioning Server you installed.

    _hafoimps

    Enter the host name of the secondary or failover IdentityMinder Provisioning Server. This is the second Provisioning Server you installed.

    _advanced_auth

    Set to true to enable advanced authentication.

    USER_INSTALL_DIR

    Default location of your SiteMinder installation. For example: /opt/CA.

    JAVA64_LOCATION

    Location of an existing 64-bit JRE if preinstalled. Set this parameter if you choose to install your JRE separately. In this case, symbolically link /opt/java64 to your JRE.

    However, instead of installing a JRE separately, the system installer can do this automatically. We recommend that you download a JRE and allow the system to install it.

    See the JAVA64_KIT parameter.

    JAVA64_KIT

    Location of a 64-bit JRE that you download to the local system or to a file share. If this parameter is set, the server kit will install this JRE automatically.

    USER_JAVA64

    Leave blank for installation. This parameter is intended for upgrades, not installation.

    JAVA32_LOCATION

    Location of an existing 32-bit JRE if preinstalled. Set this parameter if you choose to install your JRE separately. In this case, symbolically link /opt/java32 to your JRE.

    However, instead of installing a JRE separately, the system installer can do this automatically. We recommend that you download a JRE and allow the system to install it.

    See the JAVA32_KIT parameter.

    JAVA32_KIT

    Location of a 32-bit JRE that you download to the local system or to a file share. If this parameter is set, the server kit will install this JRE automatically.

    USER_JAVA32

    Leave blank for installation. This parameter is intended for upgrades, not installation.

    JBOSS_KIT

    Enter the file path, on the local system or a file share, of the JBoss to install. The JBoss kit should be in zip file format. JBOSS can be either the community version the or Enterprise Application Platform (EAP).

    _ntp_server

    IP address or host name of the NTP server to use to synchronize the server time.

    _aa_report_tablespace_filename

    Required. The path for the orcl_aa_report.dbf file, in the following format:

    <Path on Oracle Server>/orcl_aa_report.dbf

    _aa_report_tablespace_filesize

    Required. The size of the file for the table space for Advanced Authentication reports. Leave as the default, 20M.

    AA_CATALINA_LOG_DIR

    Leave as the default, $USER_INSTALL_DIR/AdvancedAuth/Tomcat/logs

    This is the location of catalina.log.

  3. Back up the properties.sh file. Rename it to a logical name, for example, policyserver1properties.sh.

    Note: This file is critical for upgrades. We recommend that you back up this file. This file contains passwords, so be sure to save it in a secure location.

    Important! The original properties.sh file resides in a temp folder. If the server is shut down, the properties.sh file is discarded. Therefore, rename and back up this file before proceeding with any further installation or use of the system.