ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzamy_5.4.0.1/50/admin/qshcrtplugininst.htm

75 lines
5.2 KiB
HTML
Raw 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>Configure a remote HTTP topology</title>
</head>
<BODY>
<!-- Java sync-link -->
<SCRIPT LANGUAGE="Javascript" SRC="../../../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
<h3><a name="qshcrtplugininst"></a>Configure a remote HTTP topology</h3>
<p>In a remote HTTP topology, the application server and the HTTP server are hosted on separate machines or logical partitions. Your application server connects to the new HTTP server instance to receive client requests.</p>
<p>This figure shows an example of a remote HTTP topology:</p>
<p align="center"><img src="rzaiz544.gif" width="432" height="158" alt="Example remote HTTP topology" border="0"></p>
<p>In this sample topology, Machine A hosts the Web server and receives HTTP requests from clients. The Web server uses HTTP or HTTPS protocol to forward the requests to the application server on Machines B.</p>
<p>To create an HTTP server instance on a machine or logical partition that does not host your application server, use the crtplugininst script in Qshell. For information on running Qshell scripts, see <a href="qshadm.htm">Configure Qshell to run WebSphere Application Server - Express scripts</a>.</p>
<p>Before you can run the script, you must install the *BASE option of WebSphere Application Server - Express (5722IWE *BASE) on the machine or logical partition that hosts your Web server instance. When you install the *BASE option, the QEJBSVR profile is created on the machine. The script also requires that one of these profiles is also on the machine:</p>
<ul>
<li><strong>QTMHHTTP</strong> if you are using IBM HTTP Server for i5/OS as your Web server</li>
<li><strong>QNOTES</strong> if you are using Domino as your Web server</li>
</ul>
<p>The crtplugininst script creates and configures the directory structures that the Web server plugins use to find a plugin-cfg.xml file generated by your application server instance. After the plugin-cfg.xml file has been generated on your application server system with the correct configuration information, you must move the file from the system that hosts your application server to the system that hosts your HTTP server instance. After you move the plugin-cfg.xml file to the Web server machine, you must run the crtplugininst script one more time to set up the appropriate access authorities for the plugin.</p>
<p>To point to the location of the HTTP server instance, the configuration file uses a host alias within the virtual host that you choose. For information on configuring a virtual host, see <a href="guimngvhsts.htm">Manage virtual hosts for your application server</a>.</p>
<p><strong>Authority</strong></p>
<p>To run this script, your iSeries user profile must have *ALLOBJ authority.</p>
<p><strong>Usage</strong></p>
<p>Run the crtplugininst script on the machine or logical partition that hosts your HTTP server instance.</p>
<ol>
<li><p>On the CL command line, enter 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/WebASE/bin</pre></li>
<li><p>Run the crtplugininst script:</p>
<pre>crtplugininst -instance <em>instance</em></pre>
<p>where <em>instance</em> is the name of your application server instance.</p></li>
<li><p>After the script runs, copy the plugin-cfg.xml file from your application server instance to the system that hosts your HTTP server instance. For example, for an application server named myAppSvr, the file is located in the /QIBM/UserData/WebASE/ASE5/myAppSvr/config/cells directory. Copy the file to the /QIBM/UserData/WebASE/ASE5/myAppSvr/config/cells directory on the machine or logical partition that hosts your Web server.</p></li>
<li><p>Run the crtplugininst script again. Specify the same value for the -instance parameter. When the script is finished, it displays this message:</p>
<pre>The Creation of a WebSphere Application Server - Express plugin instance completed successfully.</pre></li>
</ol>
<p><strong>Note:</strong> Whenever you regenerate the Web server plugin configuration for your application server, you must copy the new plugin-cfg.xml file to the Web server machine. After you copy the new plugin-cfg.xml file to the Web server machine, you must run the crtplugininst script to ensure that the new file has the correct authorities.</p>
<p><strong>Syntax</strong></p>
<p>The syntax of the script is shown below.</p>
<pre>crtplugininst -instance <em>instance</em></pre>
<p>where <em>instance</em> is the name of your WebSphere Application Server - Express application server instance.
<p>The script creates a directory structure based on the value that you specify for the -instance parameter. For example, for an instance named myAppSvr, the crtplugininst creates these directories:</p>
<ul>
<li>/QIBM/UserData/WebASE/ASE5/myAppSvr</li>
<li>/QIBM/UserData/WebASE/ASE5/myAppSvr/config</li>
<li>/QIBM/UserData/WebASE/ASE5/myAppSvr/config/cells</li>
<li>/QIBM/UserData/WebASE/ASE5/myAppSvr/logs</li>
<li>/QIBM/UserData/WebASE/ASE5/myAppSvr/etc</li>
</ul>
</body>
</html>