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

86 lines
5.8 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!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>Back up the application server configuration</title>
</head>
<BODY>
<!-- Java sync-link -->
<SCRIPT LANGUAGE="Javascript" SRC="../../../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
<h3><a name="qshbkupcfg"></a>Back up the application server configuration</h3>
<p>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 <a href="qshadm.htm">Configure Qshell to run WebSphere Application Server - Express scripts</a>.</p>
<p><strong>Note:</strong> 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 <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 run the script, follow these steps:</p>
<ol>
<li><p>On the CL command line, enter the Start Qshell (STRQSH) 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 backupConfig script:</p>
<pre>backupConfig -instance <em>instance</em></pre>
<p>where <em>instance</em> is the name of your application server instance.</p></li>
</ol>
<p><strong>Syntax</strong></p>
<p>The syntax of the backupConfig script is:</p>
<pre>backupConfig -instance <em>instance</em> [ <em>backup_file</em> ]
[ -nostop ] [ -nowait ] [ -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 backupConfig script are:</p>
<ul>
<li><p><strong>-instance</strong><br>
This is a required parameter. The value <em>instance</em> specifies the name of the instance for which you want to back up the configuration.</p></li>
<li><p><strong><em>backup_file</em></strong><br>
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_<em>timestamp</em>.zip in the current working directory, where <em>timestamp</em> is the current date in YYYY-MM-DD format.</p>
<p><strong>Note:</strong> The QEJBSVR profile must have *RWX access to the directory where the backup file is created.</p></li>
<li><p><strong>-nostop</strong><br>
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.</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 backup configuration to be created. The default is to wait for the backup configuration to be created.</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/backupConfig.log, where <em>instance</em> is the name of the instance for which you want to back up 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 back up 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>backupConfig -instance devinst /QIBM/UserData/WebASE51/ASE/devinst/devConfig.zip</pre>
<p>This example backs up the configuration for the devinst instance. The script creates a backup configuration file called devConfig.zip in the /QIBM/UserData/WebASE51/ASE/devinst directory.</p>
</body>
</html>