Table of ContentsView in Frames

Parameters used to configure the client and server

The following table lists and describes the parameters you can use to configure the client and server.

Parameter Setting Description
SC_AGENT host name or IP_address:port Snap Creator can to perform tasks on remote hosts. A task is either a defined plug-in (parameter APP_NAME) or a command specified with the parameters _CMD (for example, NTAP_SNAPSHOT_CREATE_CMD01).

To specify a remote host, enter its name or IP address, followed by a colon and the port the Snap Creator Agent is listening on. On the remote host, start the Snap Creator Agent by running the command: <path to scAgent_v<#>>/bin/snapcreator --start-agent <port>

SC_CLONE_ TARGET host name or IP_address of the clone target:port Snap Creator has the capability to perform clone operations. Using the action cloneVol in combination with {PRE|POST}_CLONE_CREATE_CMDxx, you can handle the storage objects on the remote side (for example, mounting/unmounting file systems).

To specify a clone target, enter its name or IP address, followed by a colon and the port the Snap Creator Agent is listening on.

SC_AGENT_ TIMEOUT Time (in seconds)

Default: 300 seconds

Specifies the timeout in seconds. The implemented client/server architecture uses a timeout mechanism. This means that if the client does not respond in the specified interval, the server fails with a timeout message. However, the task on the client is not aborted and requires further investigation. On a server with high load or known long-running tasks such as own scripts or complex SnapDrive operations, it might be necessary to extend the timeout and adapt this value to your own requirements.

Set this parameter to the maximum time that an operation can take (for example, if quiesce takes 1800 minutes, this must be set to 1800).

Note: Some plug-ins have specific SC_AGENT_TIMEOUT value requirement.
SC_AGENT_WATCHDOG_ENABLE (Y|N)

For all plug-ins, the default setting is Y. However, for the VIBE plug-in, the default setting is N, and it should always be N

Enables or disables the Agent Watchdog process.

If enabled (N), when the Agent receives a quiesce request, the watchdog process starts. The watchdog process uses the SC_AGENT_UNQUIESCE_TIMEOUT as timeout to unquiesce the application.

If disabled (N), the watchdog process will unquiesce the application, but it uses the OPERATION_TIMEOUT_IN_MSEC from scAgent/etc/agent.properties (default: 1 hour).

Note: SC_AGENT_WATCHDOG_ENABLE is deprecated for use with Snap Creator Agent 4.1, and applicable only for use with Agent 4.0.
SC_AGENT_UNQUIESCE_TIMEOUT Time (in seconds) Only used when SC_AGENT_WATCHDOG_ENABLE=Y.

This optional setting specifies the timeout, in seconds. If the communication with the agent is not possible and an application is in the quiesce state, the agent automatically returns the application into its normal mode of operation without communication from the server. If this setting is not set, then the unquiesce timeout is set to whatever the SC_AGENT_TIMEOUT is, plus five seconds.

SC_TMP_DIR (Y|N) Allows you to use a user-defined, alternate temporary directory to store Snap Creator-related files. The user creates the directory and manages the user access. The plug-ins use temporary files to interact with the database. The temporary files are created in the host's default temp directory, which has write access to all the users. If the directory is full, Snap Creator displays an error while creating the temporary files.
SC_AGENT_LOG_ENABLE (Y|N) Enables logging on the agent. Snap Creator Server sends operations to the agent. If something happens before the agent sends a callback to the server, the messages could be lost. This allows agent messages to be logged on the agent so that they are never lost.