Agent Guide › Install the SiteMinder Agent for WebLogic › Register a Trusted Host Using the Registration Tool › smreghost Command Arguments

smreghost Command Arguments

This following is a complete list of valid arguments for the smreghost tool.

• -i policy_server_IP_ address:port

  Indicates the IP address of the Policy Server where you are registering this host. Specify the port of the authentication server only if you are not using the default port.

  If you specify a port number, which can be a non-default port, that port is used for all three Policy Server servers (authentication, authorization, accounting), however, the unified server responds to any Agent request on any port. For example, if you specify port 55555, the policy server entry in the SmHost.conf file will show the following:

  "policy_server_ip_address,5555,5555,5555"

  Example: (IPv4) 127.0.0.1,55555

  Example: (IPv6) [2001:DB8::/32][:55555]

• -u administrator_username

  Indicates Name of the SiteMinder administrator with the rights to register a trusted host.

• -p Administrator_password

  Indicates the password of the Administrator who is allowed to register a trusted host.

• -hn hostname_for_registration

  Indicates the name of the host to be registered. This can be any name that identifies the host, but it must be unique. After registration, this name is placed in the Trusted Host list in the Administrative UI.

• -hc host_config_object

  Indicates the name of the Host Configuration Object configured at the Policy Server. This object must exist on the Policy Server before you can register a trusted host.

• -sh shared_secret

  Specifies the shared secret for the Web Agent, which is stored in the SmHost.conf file on the local web server. This argument changes the shared secret on only the local web server. The Policy Server is not contacted.

• -rs

  Specifies whether the shared secret will be updated (rolled over) automatically by the Policy server. This argument instructs the Policy Server to update the shared secret.

• -f path_to_host_config_file

  (Optional) Indicates the full path to the file that contains the registration data. The default file is SmHost.conf. If you do not specify a path, the file is installed in the location where you are running the smreghost tool.

  If you use the same name as an existing host configuration file, the tool backups up the original and adds a .bk extension to the backup file name.

• -cf FIPS mode

  Specifies one of the following FIPS modes:

  • COMPAT--Specifies non-FIPS mode, which lets the Policy Server and the Agents read and write information using the existing SiteMinder encryption algorithms. If your organization does not require the use of FIPS-compliant algorithms, the Policy Server and the Agents can operate in non-FIPS mode without further configuration.
  • MIGRATE--Specifies FIPS-migration mode, which is used when you are upgrading an earlier version of SiteMinder to full-FIPS mode. The Policy Server and the Agents continue to use the existing SiteMinder encryption algorithms as you migrate your environment to use only FIPS 140-2 approved algorithms.
  • ONLY--Specifies full-FIPS mode, which requires that the Policy Server and Web Agents read and write information using only FIPS 140-2 algorithms.

  Important! A SiteMinder installation that is running in Full FIPS mode cannot interoperate with, or be backward compatible to, earlier versions of SiteMinder, including all agents, custom software using older versions of the Agent API, and custom software using PM APIs or any other API that the Policy Server exposes. You must re-link all such software with the corresponding versions of the respective SDKs to achieve the required support for Full FIPS mode.

  If this switch is not used, or you use the switch without specifying a mode, the default setting is used.

  Default: COMPAT

  Note: More information on the FIPS Certified Module and the algorithms being used; the data that is being protected; and the SiteMinder Cryptographic Boundary exists in the Policy Server Administration Guide.

  Note: Stop the WebSphere profile before registering the SiteMinder Agent in FIPS-migratation mode.

• -cp cryptographic_provider

  (Optional) Indicates the name of the cryptographic provider you are using for encryption. If you do not specify a value the default is assumed.

  Default: ETPKI

• -o

  Overwrites an existing trusted host. If you do not use this argument, you will have to delete the existing trusted host with the Administrative UI before using the smreghost command. We recommend using the smreghost command with this argument.

smreghost Command Examples

The following examples show valid smreghost commands for different host registration scenarios.

Register a Host Example

smreghost -i 123.123.1.1 -u SiteMinder -p mypw -hn hostA
          -hc DefaultHostSettings

Register a Host in FIPS-only Mode Example

smreghost -i 123.123.1.1 -u SiteMinder -p mypw -hn hostA
          -hc DefaultHostSettings -cf ONLY

Reregister a Host Example

smreghost -i 123.123.1.1 -u SiteMinder -p mypw -hn hostA

          -hc DefaultHostSettings -o