Configuring the Broker and Server › Broker and Server Communication › Start the Server (UNIX, Linux, and zLinux) › Agent Options (UNIX, Linux, and zLinux)

Agent Options (UNIX, Linux, and zLinux)

Note: The instances of Linux in this section refer to both the Linux and zLinux operating environments.

The following CA Harvest SCM agent start options are available for both the multi-user agent and the single-user agent.

Important! The option names for agntd are case-sensitive. Verify that you enter these settings carefully and correctly.

-help

Displays the help content to start and use the agent.

-verbose

Prints log message on the window.

-homedir=SCM home dir

Specifies the agent location. This location must have /log subdirectory.

-port=port number

Connects to the port on which the agent is running.

-cmfile=command file

Parses a PEC command file.

-cm=[i , a]

Specifies the preferred connect method (to accept or initiate) to create the direct connections between the product's server, client, and agent. The following options are available:

i

Initiates connection

a

Accepts connection

-usr

Specifies the system login name (single-user mode only).

-pwd

Specifies the password (single-user mode only).

-eh

Specifies the dfo filename that contains the encrypted single user agent username and password (single-user mode only). You must create the dfo file using the svrenc command with the –f option. For more information about the svrenc command, see the Command Line Reference Guide.

Note: The -eh option is mutually exclusive with the -usr option.

-shutdown

Terminates the specified agent on the local computer.

Note: The agent shutdown can be controlled by the broker shutdown. The broker shutdown option, -shutdown=all, shuts down all agent processes that are visible in the RTserver network.

-timeout=int

Specifies the agent idle timeout in minutes. When the idle timeout is reached, the agent shuts down (single-user mode only).

-lockdir=lock directory

Specifies that agntd only has access to this directory and its subdirectories.

Note: Relative lock directories (for example, ../../user01/CA SCM) cannot be specified. If the product detects a relative -lockdir specification, the file agent will not start.

-pwdmethod=string

Allows users to use one of two methods, “prompt” or “random,” for establishing the single-user agent password.

• If -pwdmethod=prompt, the default method, the agent will prompt the user at start up to enter a password.
• If -pwdmethod=random, the agent will display the randomly generated password that must be used to log in to the agent.

-enforcepatchversion=flag

Enforces the client and agent to be at the same patch level. The following option settings are available:

• (Default) "0" means that the client can log in to an agent at a different patch level.
• "1" means that the client cannot log in to an agent that is at a different patch level.

Note: Clients and agents at different patch levels may not operate correctly. It is recommended that your client and agent installations have the same patch level.

-enforcepatchversionmsg=customized error message for enforcepatchversion

Appends a customized message to the standard error message when "‑enforcepatchversion=1" is specified in the HAgent.arg file.

-enforcehiddenpswd=flag

To enforce hiding of passwords from command-line utilities.

"0" means that hiding of passwords from command-line utilities is not enforced. "1" means that hiding of passwords from command-line utilities is enforced.

The default option setting is "0".

Note: On the startup of the server or file agent process, if the enforcement of hiding of passwords on command lines is not turned on, a message will be printed to the server or file agent log that this enforcement is disabled.

-enforcehiddenpswdmsg=customized error message for enforcehiddenpswd

Appends a customized message to the standard error message when enforcing the hiding of passwords from command-line utilities.

-umask=a three digit octal number

Controls log file permissions. If not set to a valid octal digit, this value is ignored without an error message, and log files have read/write permissions for all users.

On UNIX/Linux environments, the shell's umask value affects the file permission bits for check-out files and directories, CA Harvest SCM daemon logs (Broker, Server, and Agent logs), and signature files. Multi-user agents require a umask value to clear the UNIX/Linux group's write bit (for example, a umask octal value of 002 instead of a typical default 022) where the Shared Working Directory option is used at check-out. Prior to starting a multi-user agent, the UNIX/Linux shell umask needs to be set to clear the group's write bit to allow users to check-out and replace read-only files that are not owned. After you change the umask value and restart the agent, signature files and subdirectories for existing check-out paths will not have their bits updated, only signature files and subdirectories on newly created check-out paths will be updated. Check-outs may still fail on already existing check-out paths, unless the group’s write bit is manually cleared for the path’s subdirectories and signature files.

Note: For more information about the shared working directory option, see the Administrator Guide.

-trlvl=int

Specifies a trace mode or no trace. The value of int must be 0, 1, 2, or 3. If an int value is not specified or if you specify a value not in the range, the trace turns off automatically. Each trlvl mode is distinct and does not include information from other trace modes.

0

Specifies no trace.

1

Traces direct connect creation, thread creation, and login operations.

2

Traces file input/output operations and only displays if a function related to file input/output fails.

3

Traces the invocation of hexecp.

-trace

Display PEC-related trace messages.

Important! If you are using LDAP authentication, configure the agent to use LDAP authentication.

More information:

External Authentication Configuration

The Agent Trace Facility