backupConfig command

The backupConfig command is a simple utility to back up the configuration of your node to a file. By default, all servers on the node stop before the backup is made so that partially synchronized information is not saved. For more information about where to run this command, see the Using command tools article. If you do not have root authority, specify a path for the backup file in a location where you have write permission. The backup file will be in zip format and a .zip extension is recommended.

The backupConfig command does not save authorities which may have been granted to the profile's config directory structure. The restoreConfig command sets the owner of the directory structure and its contents to QEJBSVR and restores private authorities to the QTMHHTTP and QNOTES user profiles (if they exist). It does not restore any other private authorities which may have been granted.

Syntax

The command syntax is as follows:

backupConfig <backup_file> [options]

Note: The QEJBSVR user profile must have *WX authority to the directory path specified in backup_file. If no path is specified, QEJBSVR must have *WX authority to the current working directory.

Parameters

The following options are available for the backupConfig command:

-nostop

Tells the backupConfig command not to stop the servers before backing up the configuration.

-quiet

Suppresses the progress information that the backupConfig command prints in normal mode.

-logfile <fileName>

The location of the log file to which information gets written.

-profileName

Defines the profile of the Application Server process in a multi-profile installation. The -profileName option is not required for running in a single profile environment. The default for this option is the default profile.

-replacelog

Replaces the log file instead of appending to the current log.

-trace

Generates trace information into the log file for debugging purposes.

-username <name>

The user name for authentication if security is enabled in the server. Acts the same as the -user option.

-user <name>

The user name for authentication if security is enabled in the server. Acts the same as the -username option.

-password <password>

The password for authentication if security is enabled in the server.

-help

Prints a usage statement.

-?

Prints a usage statement.

Usage scenario

The following example demonstrates correct syntax:

backupConfig

backupConfig /home/mydir/myprofileBackup.zip -profileName myprofile

This example creates file myprofileBackup.zip under directory /home/mydir for profile myprofile.

backupConfig myBackup.zip -nostop