Back up the application server configuration

To back up the configuration of your application server, run the backupConfig script in Qshell. The backupConfig script backs up the configuration of your application server to a ZIP file. By default, the application server stops before the backup is made so that partially synchronized information is not saved. For information on running Qshell scripts, see Configure Qshell to run WebSphere Application Server - Express scripts.

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

Authority

To run this script, your user profile must have *ALLOBJ authority.

Usage

To run the script, follow these steps:

1. On an CL command line, enter the Start Qshell (STRQSH) command.

2. Run the cd command to change to the directory that contains the script:

   cd /QIBM/ProdData/WebASE/ASE5/bin

3. Run the backupConfig script:

   backupConfig -instance instance

   where instance is the name of your application server instance.

Syntax

The syntax of the backupConfig script is:

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

Parameters

The parameters of the backupConfig script are:

• -instance
  This is a required parameter. The value instance specifies the name of the instance for which you want to back up the configuration.

• backup_file
  This optional parameter 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.

• -nostop
  This is an optional parameter. 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.

• -nowait
  This is an optional parameter. If you specify this parameter, the script returns control to the user without waiting for the backup configuration to be created. The default is to wait for the backup configuration to be created.

• -quiet
  This is an optional parameter. If you specify this parameter, the script does not display informational messages. The default is to display informational messages while the script runs.

• -logfile
  This is an optional parameter. The value filename specifies the location and name of the log file for the script. The default value is /QIBM/UserData/WebASE/ASE5/instance/logs/backupConfig.log, where instance is the name of the instance for which you want to back up the configuration.

• -replacelog
  This is an optional parameter. 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
  This is an optional parameter. 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
  This parameter is 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
  This parameter is 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 -?
  This optional paramter prints the usage statement for the script.

Example

backupConfig -instance devinst /QIBM/UserData/WebASE/ASE5/devinst/devConfig.zip

This example backs up the configuration for the devinst instance. The script creates a backup configuration file called devConfig.zip in the /QIBM/UserData/WebASE/ASE5/devinst directory.