The backupConfig script

 

The backupConfig script backs up the configuration of your node to a ZIP file. By default, all servers on the node stop before the backup is made so that partially syncronized information is not saved.

The backupConfig script only backs up information for a single instance of WebSphere Application Server. For a more complete backup configuration, it is recommended that you follow the procedures described in Save and restore considerations for WebSphere Application Server.

The backupConfig script is available in WebSphere Application Server and WebSphere Application Server Network Deployment.

To run this script, your user profile must have *ALLOBJ authority. backupConfig is located in:

/qibm/ProdData/WebAS5/base/bin

The syntax of the backupConfig scriptis:

backupConfig [ backup_file ] 
             [ -instance instance ]
             [ -nostop ] 
             [ -quiet ] 
             [ -logfile filename ]
             [ -replacelog ] 
             [ -trace ] 
             [ -username username ]
             [ -password password ] 
             [ -help | -? ]

The parameters of the backupConfig script are:

• backup_file

  Optional. Specifies the fully qualified file name to which the script writes the backup configuration. If you do not specify this parameter, the script creates a file named WebSphereConfig_timestamp.zip in the current working directory, where timestamp is the current date in YYYY-MM-DD format.

  Note: The QEJBSVR profile must have *RWX access to the directory where the backup file is created.

• -instance

  Optional. The value instance specifies the name of the instance for which you want to back up the configuration. The default value is default.

• -nostop

  Optional. If you specify this parameter, the backupConfig script does not to stop the servers before it creates the backup configuration. By default, the script stops the servers before it creates the backup configuration.

• -quiet

  Optional. If you specify this parameter, the script does not display informational messages. The default is to display informational messages while the script runs.

• -logfile

  Optional. The value filename specifies the location and name of the log file for the script. The default value is...

  /QIBM/UserData/WebAS5/edition/instance/logs/backupConfig.log

• -replacelog

  Optional. If you specify this parameter, the script replaces the log file if it exists. By default the script appends to the log file if it exists.

• -trace

  Optional. If you specify this parameter, the script outputs additional trace information to the log file for the script. You should only specify this parameter if errors occur when you try to back up a configuration. The default is to not log additional trace information.

• -username

  Required if security is enabled for the server. The value username specifies the user name for authentication. The script uses this parameter to stop the servers. If you specify the -nostop parameter, you do not need to specify the -username parameter.

• -password

  Required if security is enabled for the server. The value password specifies the password for authentication. The script uses this parameter to stop the servers. If you specify the -nostop parameter, you do not need to specify the -password parameter.

• -help or -?

  Optional. Prints the usage statement for the script.

 

Examples

To back up the configuration for the default instance.

backupConfig /QIBM/UserData/WebAS5/Base/default/myConfig.zip

To back up the configuration for the devinst instance.

backupConfig /QIBM/UserData/WebAS5/Base/devinst/devConfig.zip -instance devinst