136 lines
6.5 KiB
HTML
136 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>Migrate from a WebSphere Application Server - Express Version 5.0.x instance</title>
|
|
</head>
|
|
|
|
<BODY>
|
|
<!-- Java sync-link -->
|
|
<SCRIPT LANGUAGE="Javascript" SRC="../../../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
|
|
|
|
<h3><A NAME="migexpressnew"></A>Migrate from a WebSphere Application Server - Express Version 5.0.x instance</h3>
|
|
<p>Tools for migrating administrative configurations are provided for WebSphere Application Server -
|
|
Express Version 5.0.x to be upgraded to WebSphere Application Server - Express Version 5.1.</p>
|
|
<p>
|
|
Before performing the instructions on this page, do the steps in
|
|
<a href="migplan.htm">Step 1: Plan your migration</a>.</p>
|
|
<p>
|
|
A summary of the product migration process is as follows:</p>
|
|
<ol>
|
|
<li><a href="#crtv5inst">Create a Version 5.1 instance to receive the WebSphere Application Server -
|
|
Express Version 5.0.x configuration</a>.</li>
|
|
<li><a href="#savev5config">Save the WebSphere Application Server - Express Version 5.0.x configuration</a>.</li>
|
|
<li><a href="#rstv5tov5">Restore the WebSphere Application Server - Express Version 5.0.x configuration into a Version 5.1 instance</a>.</li>
|
|
<li><a href="#startv5inst">Start the Version 5.1 instance that receives the WebSphere Application Server - Express Version 5.0.x</a>.</li>
|
|
</ol>
|
|
|
|
<p><a name="crtv5inst"></a><strong>Create a Version 5.1 instance to receive the WebSphere Application Server - Express Version 5.0.x configuration</strong></p>
|
|
<p>See <a href="../admin/guicrtapp.htm">Create a new application server</a> in the <em>Administration</em> topic for details on how to create a WebSphere Application Server - Express instance. The name of your WebSphere Application Server - Express Version 5.1 instance must be identical to the Version 5 instance that is to be migrated. </p>
|
|
|
|
<p><a name="savev5config"></a><strong>Save the WebSphere Application Server - Express Version 5.0.x configuration</strong></p>
|
|
<p>
|
|
Perform the following steps to save the WebSphere Application Server - Express Version 5.0.x:</p>
|
|
<ol>
|
|
<li>Enter the following command from the CL command line:
|
|
<pre>STRQSH</pre>
|
|
<p>This starts the Qshell environment so that you can run WebSphere Application Server scripts.</p>
|
|
</li>
|
|
|
|
<li>Run the WasPreUpgrade script with the following parameters:
|
|
<p><strong>Express Version 5.0.x:</strong>
|
|
<pre>
|
|
/QIBM/ProdData/WebASE51/ASE/bin/WASPreUpgrade
|
|
<em>myBackupDirectory</em>
|
|
/QIBM/UserData/WebASE/ASE5/<em>5.xExpressInstanceName</em>
|
|
-instance <em>5.xExpressInstanceName</em>
|
|
</pre>
|
|
<p>
|
|
where:
|
|
<ul>
|
|
<li><em>myBackupDirectory</em>(required parameter) is the fully qualified path to the
|
|
integrated file system directory where the WasPreUpgrade migration tool stores the saved configuration
|
|
and files. The directory is created if it does not already exist. It is also the directory where the
|
|
WasPreUpgrade migration tool writes a log file called WasPreUpgrade.log that chronicles the steps
|
|
taken by WasPreUpgrade.</li>
|
|
<li><em>5.xExpressInstanceName</em> (required parameter) is the name of the WebSphere Application Server - Express Version 5.1 instance to which you are migrating the configuration. This parameter must be identical to the Version 5.0.x instance that is to be migrated. </li>
|
|
</ul>
|
|
</p>
|
|
|
|
<p>
|
|
For a full explanation of the WasPreUpgrade migration tool and parameters,
|
|
see <a href="qshmigpre.htm">The WASPreUpgrade script</a>.
|
|
</p>
|
|
</li>
|
|
</ol>
|
|
|
|
|
|
<p><a name="rstv5tov5"></a><strong>Restore the WebSphere Application Server - Express Version 5.0.x configuration into a Version 5.1 instance</strong></p>
|
|
|
|
<p>
|
|
Perform the following steps to restore the WebSphere Application Server - Express Version 5.0.x configuration into a Version 5.1 instance:</p>
|
|
|
|
<ol>
|
|
<li>Enter the following command from the CL command line:
|
|
<pre>STRQSH</pre>
|
|
<p>This starts the Qshell environment so that you can run WebSphere Application Server scripts.</p>
|
|
</li>
|
|
|
|
<li>Run the WasPostUpgrade script with the following parameters:
|
|
<pre>
|
|
/QIBM/ProdData/WebASE51/ASE/bin/WASPostUpgrade
|
|
<em>myBackupDirectory</em>
|
|
-instance <em>51_instance_name</em>
|
|
[-portBlock <em>port_starting_number</em>]
|
|
</pre>
|
|
<p>Supported arguments include:</p>
|
|
<ul>
|
|
<li><p><strong>backupDirectoryName</strong><br>
|
|
where <em>myBackupDirectory</em> (required parameter) is the fully qualified path to the integrated
|
|
file system directory where the the WasPreUpgrade migration tool had previously been used to save
|
|
the WebSphere Application Server - Express Version 5.0.x instance configuration.
|
|
</p>
|
|
</li>
|
|
<li><p><strong>-instance</strong><br>
|
|
This is a required parameter. The value <em>51_instance_name</em> specifies the name of the WebSphere
|
|
Application Server - Express Version 5.1 instance to which the script migrates your configuration. This parameter must be identical to the Version 5 instance that is to be migrated.
|
|
</p>
|
|
</li>
|
|
<li><p><strong>-portBlock</strong>
|
|
<br>This is an optional parameter. The value <em>port_starting_number</em> specifies the first of a block of 10-15 consecutive port numbers that are not in use on the iSeries server where the migration is being performed. It is recommended that you always specify the -portBlock parameter if you do not want your instance's ports to conflict with the default instance's ports. </p>
|
|
<p>
|
|
For a full explanation of the WasPostUpgrade migration tool and parameters,
|
|
see <a href="qshmigpost.htm">The WASPostUpgrade script</a>.</p>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ol>
|
|
|
|
<p><a name="startv5inst"></a><strong>Start the Version 5.1 instance that receives the WebSphere Application Server - Express Version 5.0.x</strong></p>
|
|
<p>
|
|
Perform the following steps to start the Version 5.1 instance that receives the WebSphere Application Server - Express Version 5.0.x:</p>
|
|
|
|
<ol>
|
|
<li>Start the QASE51 subsystem if it is not already started. Enter this command from the CL command line:
|
|
<pre>STRSBS QASE51/QASE51</pre>
|
|
</li>
|
|
<li>Enter the following command from the CL command line:
|
|
<pre>STRQSH</pre>
|
|
<p>
|
|
This starts the Qshell environment so that you can run WebSphere Application Server scripts.</p>
|
|
</li>
|
|
<li>Run the startServer script with the following parameters:
|
|
<pre>
|
|
/QIBM/ProdData/WebASE51/ASE/bin/startServer -instance <em>51InstanceName</em>
|
|
</pre>
|
|
<p>
|
|
where <em>51InstanceName</em> is the name of the Version 5.1 instance created in an earlier step. </p>
|
|
</li>
|
|
</ol>
|
|
|
|
|
|
</body>
|
|
</html>
|