backup

Purpose

Use this command to back up the SAG configuration data that is stored in an SAG database, and to make a snapshot of the SAG database.

Note: This command does not back up the SAG-configuration data stored in the FTM SWIFT database.

This command calls the SAG backup command, which is described in SWIFT Alliance Gateway: Administration and Operations Guide. It exports the tables that comprise an SAG database to a local file with the file extension dmp, and generates a log file with the file extension log.

Note: The SAG owner must have read-write authority for the destination directory. The default user ID of the SAG owner is SWNET. For more information about users and roles, see Planning user groups and users.

Required access rights:	CT: DnfSAGopcfg CO: <SAG name> attr: backup
Predefined roles that provide required access rights:	SagOperator
Issue for OU:	DNFSYSOU
Issue to service:	DNFSAGOP

Format

Parameters

-sag sag

Name of the SAG.

-destination destination

Base file name of the backup without extension. If no path is specified, the backup files are created in the SAG installation directory. If a relative path is specified, the backup files are created in the specified subdirectories of the SAG installation directory.

On Windows, you must escape each backslash (\) that is used as directory separator with a second backslash. For example, the following command causes the backup files backup3.dmp and backup3.log to be written to the directory c:\temp:

backup -sag SAG1 -destination c:\\temp\\backup3

-mode

The request processing mode. Possible values:

async: The request processing mode is asynchronous. You receive a response immediately after the command is passed to the SAG, but this response does not indicate whether the SAG was able to execute the command. To determine whether the command was successfully executed, check whether the log file was created the destination directory on the SAG.
sync: The request processing mode is synchronous. You receive a response only after the SAG attempts to execute the command. The response indicates whether the command was successfully executed.

Examples

The following command backs up the configuration data for SAG1 to the file backup1.dmp, and creates the log file backup1.log, in the installation directory of the SAG SAG1.

INST1.DNFSYSOU.DNFSAGOP>b -sag SAG1 -destination backup1

On AIX®, RHEL x86, or Solaris, the following command backs up the configuration data for SAG1 to the files backup2.dmp, and creates the log file backup2.log, in the directory /opt of the SAG.

INST1.DNFSYSOU.DNFSAGOP>b -sag SAG1 -destination /opt/backup2

On Windows, the following command backs up the configuration data for SAG1 to the file backup3.dmp, and creates the log file backup3.log, in the directory C:\temp:

INST1.DNFSYSOU.DNFSAGOP>b -sag SAG1 -destination C:\\temp\\backup3