ivacld_setup

Syntax

ivacld_setup.exe [–?] [–a adminid] [–d domain_name] [–h host_name] [–i instance_name] –p password [–q] [–r port] [–rspfile response_file] [–t port] –policysvr host_port_rank

Description

The ivacld_setup utility configures the Security Access Manager authorization server on Windows platforms. You can run this utility directly from the command line.

Parameters

–?

Prints a usage statement. (Optional)

–a adminid

Specifies the ID for the administrator of the management domain. The default administrator ID is sec_master. (Optional)

–d domain_name

Specifies the domain name. The default value is Default, which indicates the management domain. (Optional)

–h host_name

Specifies the fully qualified name of the host system for the authorization server. The default value is the local host name. (Optional)

–i instance_name

Specifies the authorization server instance name. The default authorization server instance name is always empty. Enter a unique name to configure each additional authorization server. Instance names can contain all alphanumeric characters; they also can use the hyphen (-) and underscore ( _ ) characters. An instance name cannot begin with a hyphen (-) character. (Optional)

–p password

Specifies the password for the administrator ID, adminid. This parameter is required.

–policysvr host_port_rank

Specifies the policy server host name, port, and rank. The policy server host name is the name of the host on which the policy server runs. The port is the port on which the policy server listens for requests. The rank is an integer value that denotes priority. These three inputs are provided in a string as hostname:port:rank for this value. This value would typically be POLICYSVR_HOST:7135:1 where POLICYSVR_HOST is the host name of the policy server.

–q

Runs the command in silent mode and does not output any message boxes. Writes messages only to stderr. (Optional)

–r port

Specifies the administration request port. The default port is 7137. (Optional)

–rspfile response_file

Specifies the fully qualified path and file name of the response file to use during silent configuration. There is no default response file name. The response file contains stanzas and key=value pairs. For information about using response files, see the "Using response files" appendix in the IBM Security Access Manager for Web Command Reference. (Optional)

–t port

Specifies the port number for the policy server. The default value is 7136. (Optional)

Availability

C:\Program Files\Tivoli\Policy Director\sbin

When you select an installation directory other than the default, this utility is in the \sbin directory under the installation directory (for example: installation_directory\sbin).

Return codes

0

The utility completed successfully.

1

The utility failed. When a utility fails, the software displays a description of the error.

See the IBM Security Access Manager for Web Error Message Reference. This reference provides a list of the Security Access Manager error messages by decimal or hexadecimal codes.