Previous Topic: How Common Agent Connection Requests WorkNext Topic: Snapshot and Direct I/O Support  (UNIX Only)


Configurable Options

Options are used to optimize and customize the operation of the client agent. However, none of these options are required for the client agent to run. A complete list of options are available for use when starting the UNIX, Linux, or Mac OS X client agents as shown in the following table.

Note: These options should be carefully set by administrators having UNIX, Linux, or Mac OS X knowledge. If you do not understand what an option or parameter means, do not set the feature unless instructed to do so by a Arcserve Technical Support representative.

Option

Description

-ALLOW
<network address> <host address>

Use this option with Single User mode, with the -S or -NOPASSWORD option, to define the IP addresses of computers that are authorized to access the client agents without requiring validation.

-ALLOW N:172.16.0.0(255.255.255.0) H:172.31.255.255

In this example, N denotes a network address and H denotes a host IP address. You can set an optional subnet mask.

Option

Description

-b bufsize

Defines the disk I/O buffer size in bytes. Options are 16384 to 65536 bytes; the default is 65536 bytes.

-c n

Specifies the sleep time while waiting, in milliseconds (ms). Options are zero (0) to 1000 ms; the default is 50 ms.

-CAUSER USER

Defines Single User mode. Used with the -S or NOPASSWORD option to set the Allow or Deny list on a per-user basis.

For example:

-CAUSER A: USER1 N: USER2

In this example, A means –ALLOW and N corresponds to -DENY.

Option

Description

-DENY
<network address> <host address>

Use this option with Single User mode, with the -S or NOPASSWORD option, to define the IP addresses that are not allowed access to the client agents.

For example:

-DENY N:172.16.0.0(255.255.255.0) H:172.31.255.255

In this example, N denotes a network address and H denotes a host’s IP address. You can set an optional subnet mask.

Option

Description

-l

Causes the client agent to check for advisory locks. The default is mandatory locks only.

-m maxbuf

Sets the number of buffers allocated for I/O. Options are 2 to 1024 buffers; the default is 128.

-NOPASSWORD

Specify this option if you need to use either the -ALLOW, -DENY, or -CAUSER options. This option is the same as the -S option in Single User mode with no password required.

-P n

Specifies the default time out, followed by a variable number (n), which is user-defined and measured in minutes (0 to 10). The default is 5 minutes.

For example, the option -P 10 assigns a wait time period for the backup or restore pre-script of 10 minutes.

Note: An error occurs if you use the -P option without defining a number n.

Option

Description

-Prebackup
filename

-Postbackup
filename

-Prerestore
filename

-Postrestore filename

Executes the default pre-scripts and post-scripts associated with the type of backup or restore job being run. The filename is optional and if is not specified, uag_pre_backup will be treated as the filename.

-S

Enables the Single User mode option. In Single User mode, user credentials are not checked against valid user IDs and passwords. Instead, access is granted based on the -ALLOW, -DENY, or -CAUSER options. For more information see the specific option.

-s async|
nonblocking

Sets socket I/O to asynchronous, nonblocking mode.

-s bufsize

Specifies the size of the socket buffer. Options are 4096 to 65536. The default is system dependent.

-s SocketMode

Specifies to use socket mode for backup operations.

-sparse

Differentiates between sparse file and regular file operations.This option increases the efficiency of sparse file backups and restores.

Note: Quota files are always treated as sparse files in backup and restore operations, regardless of whether you specify –sparse.

-verbose or -v

Places the system in verbose mode to enable the entry of detailed debugging messages at the console.