Restore the application server configuration

The restoreConfig script restores the configuration of a node. To run this script, you must have a backup copy of the configuration. If the configuration directory already exists, the script renames it before restoring the configuration. For information on running Qshell scripts, see Configure Qshell to run WebSphere Application Server - Express scripts.

Note: The restoreConfig script only restores information for a single instance of WebSphere Application Server - Express. For a more complete restoration of your 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 restore your application server configuration, follow these steps:

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

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

   cd /QIBM/ProdData/WebASE/ASE5/bin

3. Run the restoreConfig script:

   restoreConfig backup_file -instance instance

   where backup_file is the name of the configuration file that you created with the backupConfig script and instance is the name of the instance to which you want to restore the configuration.

Syntax

The syntax of the restoreConfig script is:

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

Parameters

The parameters of the restoreConfig script are:

• backup_file
  This is a required parameter. The value backup_file specifies the fully qualified name of the backup configuration that you want to restore. This file is generated when you run the backupConfig script.

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

• -nostop
  This is an optional parameter. If you specify this parameter, the restoreConfig script does not to stop the servers before it restores the configuration. By default, the script stops the servers before it restores the configuration.

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

• -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/restoreConfig.log, where instance is the name of the instance for which you want to restore 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 restore 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

restoreConfig -instance myAppSvr /QIBM/UserData/WebASE/ASE5/myAppSvr/myConfig.zip

This example restores the configuration for the myAppSvr instance. The script uses the configuration file called myConfig.zip in the /QIBM/UserData/WebASE/ASE5/myAppSvr directory.