ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzatz_5.4.0.1/51/admin/qshrestcfg.htm

84 lines
5.7 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=utf-8">
<LINK rel="stylesheet" type="text/css" href="../../../rzahg/ic.css">
<title>Restore the application server configuration</title>
</head>
<BODY>
<!-- Java sync-link -->
<SCRIPT LANGUAGE="Javascript" SRC="../../../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
<h3><a name="qshrestcfg"></a>Restore the application server configuration</h3>
<p>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 <a href="qshadm.htm">Configure Qshell to run WebSphere Application Server - Express scripts</a>.</p>
<p><strong>Note:</strong> 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 <a href="snrmain.htm">Backup and recovery considerations for WebSphere Application Server - Express</a>.</p>
<p><strong>Authority</strong></p>
<p>To run this script, your user profile must have *ALLOBJ authority.</p>
<p><strong>Usage</strong></p>
<p>To restore your application server configuration, follow these steps:</p>
<ol>
<li><p>On the CL command line, run the STRQSH (Start Qshell) command.</p></li>
<li><p>Run the cd command to change to the directory that contains the script:</p>
<pre>cd /QIBM/ProdData/WebASE51/ASE/bin</pre></li>
<li><p>Run the restoreConfig script:</p>
<pre>restoreConfig <em>backup_file</em> -instance <em>instance</em></pre>
<p>where <em>backup_file</em> is the name of the configuration file that you created with the backupConfig script and <em>instance</em> is the name of the instance to which you want to restore the configuration.</p></li>
</ol>
<p><strong>Syntax</strong></p>
<p>The syntax of the restoreConfig script is:</p>
<pre>restoreConfig <em>backup_file</em> -instance <em>instance</em> [ -nostop ] [ -quiet ]
[ -logfile <em>filename</em> ] [ -replacelog ] [ -trace ] [ -username <em>username</em> ]
[ -password <em>password</em> ] [ -help | -? ]</pre>
<p><strong>Parameters</strong></p>
<p>The parameters of the restoreConfig script are:</p>
<ul>
<li><p><strong><em>backup_file</em></strong><br>
This is a required parameter. The value <em>backup_file</em> specifies the fully qualified name of the backup configuration that you want to restore. This file is generated when you run the backupConfig script.</p></li>
<li><p><strong>-instance</strong><br>
This is a required parameter. The value <em>instance</em> specifies the name of the instance to which you want to restore the configuration.</p></li>
<li><p><strong>-nostop</strong><br>
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.</p></li>
<li><p><strong>-nowait</strong><br>
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.</p></li>
<li><p><strong>-quiet</strong><br>
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.</p></li>
<li><p><strong>-logfile</strong><br>
This is an optional parameter. The value <em>filename</em> specifies the location and name of the log file for the script. The default value is /QIBM/UserData/WebASE51/ASE/<em>instance</em>/logs/restoreConfig.log, where <em>instance</em> is the name of the instance for which you want to restore the configuration.</p></li>
<li><p><strong>-replacelog</strong><br>
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.</p></li>
<li><p><strong>-trace</strong><br>
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.</p></li>
<li><p><strong>-username</strong><br>
This parameter is required if security is enabled for the server. The value <em>username</em> 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.</p></li>
<li><p><strong>-password</strong><br>
This parameter is required if security is enabled for the server. The value <em>password</em> 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.</p></li>
<li><p><strong>-help</strong> or <strong>-?</strong><br>
This optional paramter prints the usage statement for the script.</p></li></ul>
<p><strong>Example</strong></p>
<pre>restoreConfig -instance myAppSvr /QIBM/UserData/WebASE51/ASE/myAppSvr/myConfig.zip</pre>
<p>This example restores the configuration for the myAppSvr instance. The script uses the configuration file called myConfig.zip in the /QIBM/UserData/WebASE51/ASE/myAppSvr directory.</p>
</body>
</html>