85 lines
6.5 KiB
HTML
85 lines
6.5 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>The WASPreUpgrade script</title>
|
||
|
|
</head>
|
||
|
|
|
||
|
|
<BODY>
|
||
|
|
<!-- Java sync-link -->
|
||
|
|
<SCRIPT LANGUAGE="Javascript" SRC="../../../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
|
||
|
|
|
||
|
|
<h3><a name="qshmigpre"></a>The WASPreUpgrade script</h3>
|
||
|
|
|
||
|
|
<p>The <strong>WASPreUpgrade</strong> script is a migration tool for migrating the configuration and applications of previous WebSphere Application Server and WebSphere Application Server - Express versions to a WebSphere Application Server - Express V5.1 application server node. The script is located in the /QIBM/ProdData/WebASE51/ASE/bin directory.</p>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<p><strong>Authority</strong></p>
|
||
|
|
<p>To run this script, your user profile must have *ALLOBJ authority.</p>
|
||
|
|
|
||
|
|
<p><strong>Syntax</strong></p>
|
||
|
|
<p>The syntax of the WASPreUpgrade script is:</p>
|
||
|
|
|
||
|
|
<pre>WASPreUpgrade <em>backupDirectory</em> <em>currentWASDirectory</em> <em>administrationNodeName</em> -instance <em>instance</em>
|
||
|
|
[ -nameServiceHost <em>host_name</em> [ -nameServicePort <em>port_number</em> ] ]
|
||
|
|
[ -traceString <em>trace_spec</em> [ -traceFile <em>file_name</em> ] ]</pre>
|
||
|
|
|
||
|
|
<p><strong>Parameters</strong></p>
|
||
|
|
<p><strong>The parameters of the WASPreUpgrade script are:</strong></p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li><p><strong><em>backupDirectory</em></strong>
|
||
|
|
<br>This is a required parameter and must be the first parameter that you specify. The value <em>backupDirectory</em> specifies the name of the directory where the script stores the saved configuration and files. This is also the directory from which the WASPostUpgrade tool reads the configuration and files. For example, if you are migrating a configuration from WebSphere Application Server Version 3.5, you could specify the /home/was35_instancename/backup directory. If the directory does not exist, the WASPreUpgrade script creates it.</p></li>
|
||
|
|
|
||
|
|
<li><p><strong><em>currentWASDirectory</em></strong>
|
||
|
|
<br>This is a required parameter and must be the second parameter that you specify. The value <em>currentWASDirectory</em> specifies the name of the instance root directory for instance that you want to migrate. For Version 3.5.x this is /QIBM/UserData/WebASStd/<em>instance</em>, where <em>instance</em> is the name of the instance you want to migrate. For WebSphere Application Server - Express Version 5.0.x this is /QIBM/UserData/WebASE/ASE5/<em>instance</em>, where <em>instance</em> is the name of the instance you want to migrate.</p></li>
|
||
|
|
|
||
|
|
<li><p><strong><em>administrationNodeName</em></strong>
|
||
|
|
<br>This parameter is required and must be the third parameter that you specify. The value <em>administrationNodeName</em> specifies the name of the node that contains the administrative server for the previous version of the product. The value of this argument is case-sensitive and must match the node name given in the topology tree on the <strong>Topology</strong> tab of the administrative console for the previous version. The WASPreUpgrade tool uses this parameter to call the XMLConfig tool.</p></li>
|
||
|
|
|
||
|
|
<li><p><strong>-instance</strong>
|
||
|
|
<br>This is a required parameter. The value <em>instance</em> specifies the name of the WebSphere Application Server - Express V5.1 instance to which you are migrating the configuration.</p></li>
|
||
|
|
|
||
|
|
|
||
|
|
<li><p><strong>-nameServiceHost</strong>
|
||
|
|
<br>This is a required parameter if you are migrating from Version 3.5.x. The value <em>host_name</em> specifies the TCP/IP host name of the iSeries server. If you do not specify this parameter, the default host name is localhost.</p></li>
|
||
|
|
|
||
|
|
<li><p><strong>-nameServicePort</strong>
|
||
|
|
<br>This is a required parameter if you are migrating from Version 3.5.x. The value <em>port_number</em> specifies specifies the bootstrap port for the administrative server for the instance from which you are migrating. If you do not specify this parameter, the default value is 900.</li>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<li><p><strong>-traceString</strong>
|
||
|
|
<br>This is an optional parameter. The value <em>trace_spec</em> specifies the trace information that you want to collect. To gather all trace information, specify <tt>"*=all=enabled"</tt> (with quotation marks). The default is to not gather trace information. If you specify this parameter, you must also specify the -traceFile parameter.</p></li>
|
||
|
|
|
||
|
|
<li><p><strong>-traceFile</strong>
|
||
|
|
<br>This is an optional parameter. The value <em>trace_file</em> specifies the name of the output file for trace information. If you specify the -traceString parameter but do not specify the -traceFile parameter, the script does not generate a trace file.</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p><strong>Logging</strong></p>
|
||
|
|
<p>The WASPreUpgrade tool displays status to the screen while it is running. It also saves a more extensive set of logging information in the WASPreUpgrade.log file. This file is located in the <em>backupDirectory</em> directory, where <em>backupDirectory</em> is the value specified for the backupDirectory parameter.</p>
|
||
|
|
|
||
|
|
<p><strong>Security</strong></p>
|
||
|
|
<p>The WASPreUpgrade script uses the XMLConfig script to export configuration data from WebSphere Application Server Version 3.5 Standard Edition. If WebSphere security is enabled, ensure that the properties are configured properly in the sas.client.props property file for the Version 3.5 instance before running the WASPreUpgrade script or the script fails when it attempts to invoke the XMLConfig script.</p>
|
||
|
|
<!-- The following section in the Version 3.5 product information describe how to configure the sas.client.props property file. Follow the instructions that describe how to configure automatic authentication.</p>
|
||
|
|
<ul>
|
||
|
|
<li><strong>Version 3.5 Standard Edition:</strong><a href="http://www.ibm.com/servers/eserver/iseries/software/websphere/wsappserver/docs/as400v35std/docs/admauth.html" target="_">Authenticating to the administrative server</a> <img src="www.gif" width="18" height="15" alt="Link outside Information Center" border="0"></li>
|
||
|
|
</ul -->
|
||
|
|
|
||
|
|
|
||
|
|
<p><strong>Examples</strong></p>
|
||
|
|
|
||
|
|
<p><strong>Migrate from WebSphere Application Server Version 3.5.x Standard Edition</strong></p>
|
||
|
|
|
||
|
|
<p>This example illustrates how to migrate from WebSphere Application Server Version 3.5.x Standard Edition. The backup directory is named /home/was35_instancename/WebASAdv, and the instance root of the previous version is /QIBM/UserData/WebASAdv/default. The administrative server is contained in myNode.</p>
|
||
|
|
|
||
|
|
<pre>> WASPreUpgrade /home/was35_instancename/WebASAdv /QIBM/UserData/WebASAdv/default MYISERIES</pre>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
</body>
|
||
|
|
</html>
|