ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzatz_5.4.0.1/51/migration/wsamigrate.htm

283 lines
10 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>Migrate from wscp to wsadmin</title>
</head>
<BODY>
<!-- Java sync-link -->
<SCRIPT LANGUAGE="Javascript" SRC="../../../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
<h4><a name="wsamigrate"></a>Migrate from wscp to wsadmin</h4>
<p>The wscp tool was a part of the administration repository support in WebSphere Application Server Version 3.5. You can use the WebSphere Application Server - Express scripting client program, wsadmin, to do the same kinds of things wscp did, and more. You can use the JACL scripting language for scripts, but the elements specific to wsadmin are different from those available in wscp. This article shows how to create WebSphere Application Server - Express scripts that perform actions similar to those performed by wscp. Automatic conversion of scripts between the two releases is difficult.</p>
<p>Configuration commands for wscp</p>
<ul>
<li>create</li>
<li>list</li>
<li>modify</li>
<li>remove</li>
<li>show</li>
<li>showall</li>
<li>install</li>
<li>uninstall</li>
<li>all SecurityConfig commands</li>
<li>all SecurityRoleAssignment commands</li>
<li>clone</li>
<li>removeClone</li>
</ul>
<p>Other commands exist to provide ../admin/help for configuration commands. These commands include <tt>attributes</tt>, <tt>containment</tt>, and <tt>../admin/help</tt>.</p>
<p>Operation commands for wscp</p>
<ul>
<li>start</li>
<li>stop</li>
<li>show (for runtime attributes)</li>
<li>testConnection</li>
<li>all DrAdmin commands</li>
<li>regenPluginCfg</li>
</ul>
<p>To convert wscp commands to wsadmin commands, follow these steps:</p>
<ol>
<li><p>Find the corresponding configuration wsadmin WebSphere Application Server - Express object type for each configuration command. Use the AdminConfig create, list, modify, remove, show, and showAttribute commands to perform the same type of operations in WebSphere Application Server - Express that you performed in Version 3.5. Use this table to determine the corresponding types:</p>
<table border="1" cellspacing="2" cellpadding="2">
<tr>
<th>wscp command</th>
<th>WebSphere Application Server - Express wsadmin configuration type</th>
</tr>
<tr>
<td>ApplicationServer</td>
<td>Server</td>
</tr>
<tr>
<td>Context</td>
<td><em>Not applicable</em></td>
</tr>
<tr>
<td>DataSource</td>
<td>DataSource</td>
</tr>
<tr>
<td>Domain</td>
<td><em>Not applicable</em></td>
</tr>
<tr>
<td>EnterpriseApp</td>
<td>ApplicationDeployment</td>
</tr>
<tr>
<td>GenericServer</td>
<td>Server</td>
</tr>
<tr>
<td>J2CConnectionFactory</td>
<td>J2CConnectionFactory</td>
</tr>
<tr>
<td>J2CResourceAdapter</td>
<td>J2CResourceAdapter</td>
</tr>
<tr>
<td>JDBCDriver</td>
<td>JDBCProvider</td>
</tr>
<tr>
<td>JMSConnectionFactory</td>
<td>JMSConnectionFactory</td>
</tr>
<tr>
<td>JMSDestination</td>
<td>JMSDestination</td>
</tr>
<tr>
<td>JMSProvider</td>
<td>JMSProvider</td>
</tr>
<tr>
<td>MailSession</td>
<td>MailSession</td>
</tr>
<tr>
<td>Module</td>
<td>ModuleDeployment</td>
</tr>
<tr>
<td>Node</td>
<td>Node</td>
</tr>
<tr>
<td>ServerGroup</td>
<td>ServerCluster</td>
</tr>
<tr>
<td>URL</td>
<td>URL</td>
</tr>
<tr>
<td>URLProvider</td>
<td>URLProvider</td>
</tr>
<tr>
<td>VirtualHost</td>
<td>VirtualHost</td>
</tr>
</table>
<p></p></li>
<li><p>Use the online help command of the AdminConfig object to determine the WebSphere Application Server - Express attribute names. For example: attributes, defaults, parents, required, or types. These examples illustrate the use of this command:</p>
<ul>
<li>This example lists the attributes available for the Server object type:
<pre>$AdminConfig attributes Server</pre></li>
<li>This example lists the types you can configure:
<pre>$AdminConfig types</pre></li>
<li>This example lists the objects which contain the DataSource object type:
<pre>$AdminConfig parents DataSource</pre></li>
</ul><p></p></li>
<li><p>Convert application installation commands:</p>
<ol>
<li>Run the installInteractive command on the AdminApp object from an interactive wsadmin session.</li>
<li>Locate message WASX7278I in the wsadmin.traceout log file and use the data in the message to construct an installation command for your application.</li>
</ol><p></p></li>
<li><p>Convert operational commands. Use this table to determine how to convert operational commands:</p>
<table border="1" cellspacing="2" cellpadding="2">
<tr>
<th>wscp 3.5 action</th>
<th>wsadmin WebSphere Application Server - Express object and command</th>
<th>wsadmin WebSphere Application Server - Express MBean</th>
<th>wsadmin WebSphere Application Server - Express Operation</th>
</tr>
<tr>
<td>server start</td>
<td>AdminControl startServer</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>server stop</td>
<td>AdminControl stopServer</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>application start</td>
<td>AdminControl invoke</td>
<td>ApplicationManager</td>
<td>startApplication</td>
</tr>
<tr>
<td>application stop</td>
<td>AdminControl invoke</td>
<td>ApplicationManager</td>
<td>stopApplication</td>
</tr>
<tr>
<td>check run-time attribute</td>
<td>AdminControl getAttribute</td>
<td><em>mbean</em></td>
<td><em>attribute</em></td>
</tr>
<tr>
<td>check run-time attributes</td>
<td>AdminControl getAttributes</td>
<td><em>mbean</em></td>
<td><em>list of attributes</em></td>
</tr>
<tr>
<td>regenPluginCfg</td>
<td>AdminControl invoke</td>
<td>PluginCfgGenerator</td>
<td>generate</td>
</tr>
<tr>
<td>testConnection</td>
<td>AdminControl testConnection</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>enable security</td>
<td>securityon command in securityProcs.jacl</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>disable security</td>
<td>securityoff command in securityProcs.jacl</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
</tr>
</table>
<p></p></li>
</ol>
<p>These help topics provide examples of migrating wscp commands to wsadmin commands. They are specific to migrating from WebSphere Application Server Version 4.0, but there are applicable to migrating from Version 3.5 also.</p>
<ul>
<!--<li><a href="../admin/help/rxml_mservergroup.html">Example: Migrating - Creating a server group</a> <img src="../admin/help.gif" width="18" height="15" align="absbottom" alt="Go to ../admin/help documentation"></li>
<li><a href="../admin/help/rxml_mclone.html">Example: Migrating - Cloning a server group</a> <img src="../admin/help.gif" width="18" height="15" align="absbottom" alt="Go to ../admin/help documentation"></li>
<li><a href="../admin/help/rxml_mstartgroup.html">Example: Migrating - Starting a server group</a> <img src="../admin/help.gif" width="18" height="15" align="absbottom" alt="Go to ../admin/help documentation"></li>
<li><a href="../admin/help/rxml_mstopgroup.html">Example: Migrating - Stopping a server group</a> <img src="../admin/help.gif" width="18" height="15" align="absbottom" alt="Go to ../admin/help documentation"></li>
<li><a href="../admin/help/rxml_mlistgroup.html">Example: Migrating - Listing configured server groups</a> <img src="../admin/help.gif" width="18" height="15" align="absbottom" alt="Go to ../admin/help documentation"></li>
<li><a href="../admin/help/rxml_mlistrun.html">Example: Migrating - Listing the running server groups</a> <img src="../admin/help.gif" width="18" height="15" align="absbottom" alt="Go to ../admin/help documentation"></li>-->
<li><a href="../admin/help/rxml_mregen.html">Example: Migrating - Regenerating the node plug-in configuration</a> <img src="help.gif" width="18" height="15" align="absbottom" alt="Go to help documentation"></li>
<!--<li><a href="../admin/help/rxml_mstopnode.html">Example: Migrating - Stopping a node</a> <img src="../admin/help.gif" width="18" height="15" align="absbottom" alt="Go to ../admin/help documentation"></li>
<li><a href="../admin/help/rxml_mcreateserv.html">Example: Migrating - Creating an application server</a> <img src="../admin/help.gif" width="18" height="15" align="absbottom" alt="Go to ../admin/help documentation"></li>
<li><a href="../admin/help/rxml_mstartserver.html">Example: Migrating - Starting an application server</a> <img src="../admin/help.gif" width="18" height="15" align="absbottom" alt="Go to ../admin/help documentation"></li>-->
<li><a href="../admin/help/rxml_mstopserv.html">Example: Migrating - Stopping an application server</a> <img src="help.gif" width="18" height="15" align="absbottom" alt="Go to help documentation"></li>
<!--<li><a href="../admin/help/rxml_mtransport.html">Example: Migrating - Modifying the embedded transports in an application server</a> <img src=".help.gif" width="18" height="15" align="absbottom" alt="Go to help documentation"></li>-->
<li><a href="../admin/help/rxml_mvhost.html">Example: Migrating - Modifying the virtual host</a> <img src="help.gif" width="18" height="15" align="absbottom" alt="Go to help documentation"></li>
<li><a href="../admin/help/rxml_mrestartserv.html">Example: Migrating - Modifying and restarting an application server</a> <img src="help.gif" width="18" height="15" align="absbottom" alt="Go to help documentation"></li>
<li><a href="../admin/help/rxml_mping.html">Example: Migrating - Pinging running servers for the current state</a> <img src="help.gif" width="18" height="15" align="absbottom" alt="Go to help documentation"></li>
<li><a href="../admin/help/rxml_mremoveserv.html">Example: Migrating - Removing an application server</a> <img src="help.gif" width="18" height="15" align="absbottom" alt="Go to help documentation"></li>
<li><a href="../admin/help/rxml_minstallapp.html">Example: Migrating - Installing an application</a> <img src="help.gif" width="18" height="15" align="absbottom" alt="Go to help documentation"></li>
<li><a href="../admin/help/rxml_mjdbc.html">Example: Migrating - Installing a JDBC driver</a> <img src="help.gif" width="18" height="15" align="absbottom" alt="Go to help documentation"></li>
<li><a href="../admin/help/rxml_mtestdata.html">Example: Migrating - Testing the DataSource object connection</a> <img src="help.gif" width="18" height="15" align="absbottom" alt="Go to help documentation"></li>
<li><a href="../admin/help/rxml_msecurity.html">Example: Migrating - Enabling security</a> <img src="help.gif" width="18" height="15" align="absbottom" alt="Go to help documentation"></li>
<li><a href="../admin/help/rxml_mdisable.html">Example: Migrating - Disabling security</a> <img src="help.gif" width="18" height="15" align="absbottom" alt="Go to help documentation"></li>
</ul>
</body>
</html>