System Management Services 1.2 man pages


	www.sun.com	docs.sun.com \| \| \|

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

System Administration

setdatasync(1m)

DESCRIPTION
OPTIONS
EXTENDED DESCRIPTION
EXAMPLES
EXIT STATUS
ATTRIBUTES
SEE ALSO

NAME

setdatasync - modify the data propagation list used in data synchronization

SYNOPSIS

setdatasync [-i interval] schedule filename

setdatasync cancel filename

setdatasync push filename

setdatasync backup

setdatasync -h

setdatasync enables you to specify a user-created file to be added to or removed from the data propagation list. This list identifies the files to be copied from the main to the spare system controller (SC) as part of data synchronization for automatic failover. The specified user file and the directory in which it resides must have read and write permissions for the user on both SCs.

Note – Data synchronization uses the available disk space under the /var/opt/SUNWSMS directory to copy files from the main SC to the spare. If you have files to be copied that are larger than the /var/opt/SUNWSMS directory, those files cannot be propagated. For example, if the data synchronization backup file (ds_backup.cpio) gets larger than the available space in /var/opt/SUNWSMS, you must reduce the size of this backup file before data propagation can occur. The size of the sms_backup.cpio file gives you an indication of the size of the data synchronization backup file.

To create more disk space you can remove the following files:

/var/opt/SUNWSMS/adm/platform/messages.x
/var/opt/SUNWSMS/adm/domain_id/messages.x
/var/opt/SUNWSMS/adm/domain_id/post/files

where x is the archive number of the file. Because these files are propagated from the new main SC to the spare after a failover, remove these files on both the main and spare SC.

The data synchronization process checks the user-created files on the main SC for any changes. If the user-created files on the main SC have changed since the last propagation, they are repropagated to the spare SC. By default, the data synchronization process checks a specified file every 60 minutes; however, you can use setdatasync to indicate how often a user file is to be checked for modifications.

Note – After a file is propagated from the main SC to the spare, the file is repropagated to the spare only when the file on the main SC is updated. If you remove a propagated file from the spare SC, that file will not be automatically repropagated until the corresponding file on the main SC has been changed.

You can also use setdatasync to do the following:

Propagate a specified file to the spare SC without adding the file to the data propagation list.
Resynchronize the SC configuration files on the main and spare SCs.

OPTIONS

The following options are supported.

backup: Backs up the main SC using smsbackup(1M), moves the backup data from the main to the spare SC, and restores the backup data on the spare SC. For more information, see smsbackup(1M).
cancel filename: Removes (cancels) the specified file from the data propagation list, which means the specified file will no longer be propagated to the spare SC. This option does not actually remove the specified file from the spare SC. The file name must contain the absolute path and cannot be a symbolic link to another file.
-h: Help. Displays usage descriptions. Note – Use alone. Any option specified in addition to -h is ignored.
-i interval: Indicates how often the specified file is to be checked for modifications. The default interval is 60 minutes. The interval can range from 1 to 1440 minutes (24 hours).
push filename: Propagates (pushes) the specified file to the spare SC without adding it to the data propagation list. The file name must contain the absolute path and cannot be a symbolic link to another file.
schedule filename: Adds the specified file to the data propagation list. The file name must contain the absolute path and cannot be a symbolic link to another file. During data synchronization, the file is propagated to the same absolute path on the spare SC.

EXTENDED DESCRIPTION

Group Privileges Required

You must have platform administrator, platform operator, platform service, domain administrator, or domain configurator privileges to run this command.

Refer to Chapter 2 in the System Management Services (SMS) 1.2 Administrator Guide for the Sun Fire 15K/12K Systems for more information.

EXAMPLES

Example 1. Propagate a User File From Main to Spare Every 30 Minutes

The path to the user-specified file must be an absolute path and cannot contain a symbolic link.

sc0:sms-user:> setdatasync -i 30 schedule /path/filename

Example 2. Remove File Name From Data Propagation List

The path to the user-specified file must be an absolute path and cannot contain a symbolic link.

sc0:sms-user:> setdatasync cancel /path/filename

EXIT STATUS

The following exit values are returned:

0: Successful completion
>0: An error occurred.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

Attribute Types	Attribute Values
Availability	SUNWSMSop