265 lines
18 KiB
HTML
265 lines
18 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?>
|
||
<!DOCTYPE html
|
||
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||
<html lang="en-us" xml:lang="en-us">
|
||
<head>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||
<meta name="security" content="public" />
|
||
<meta name="Robots" content="index,follow" />
|
||
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
||
<meta name="DC.Type" content="task" />
|
||
<meta name="DC.Title" content="Configure WebSphere Application Server V5.1 for iSeries" />
|
||
<meta name="abstract" content="This example is for users that are not familiar with the Web serving environment. It describes all the steps necessary to get iSeries Access for Web running in a WebSphere Application Server V5.1 for iSeries environment. It also describes how to verify that the setup is working." />
|
||
<meta name="description" content="This example is for users that are not familiar with the Web serving environment. It describes all the steps necessary to get iSeries Access for Web running in a WebSphere Application Server V5.1 for iSeries environment. It also describes how to verify that the setup is working." />
|
||
<meta name="DC.Relation" scheme="URI" content="rzammservxmpbeg.htm" />
|
||
<meta name="DC.Relation" scheme="URI" content="../clfinder/finder.htm" />
|
||
<meta name="copyright" content="(C) Copyright IBM Corporation 2003, 2006" />
|
||
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2003, 2006" />
|
||
<meta name="DC.Format" content="XHTML" />
|
||
<meta name="DC.Identifier" content="rzammxmpbeg51be" />
|
||
<meta name="DC.Language" content="en-us" />
|
||
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
||
<!-- US Government Users Restricted Rights -->
|
||
<!-- Use, duplication or disclosure restricted by -->
|
||
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
||
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
||
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
||
<title>Configure WebSphere Application Server V5.1 for iSeries</title>
|
||
</head>
|
||
<body id="rzammxmpbeg51be"><a name="rzammxmpbeg51be"><!-- --></a>
|
||
<img src="./delta.gif" alt="Start of change" /><!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
<h1 class="topictitle1">Configure WebSphere Application Server V5.1 for iSeries</h1>
|
||
<div><p>This example is for users that are not familiar with the Web serving
|
||
environment. It describes all the steps necessary to get iSeries™ Access
|
||
for Web running in a WebSphere<sup>®</sup> Application Server V5.1 for iSeries environment.
|
||
It also describes how to verify that the setup is working.</p>
|
||
<div class="section">Configuring your Web serving environment consists of these steps: <ul><li>Start the IBM<sup>®</sup> Web
|
||
Administration for iSeries interface (also known as IBM HTTP Server
|
||
for iSeries).
|
||
See step <a href="#rzammxmpbeg51be__was51start">1</a>.</li>
|
||
<li>Create an HTTP web server and a WebSphere Application Server V5.1
|
||
for iSeries .
|
||
See step <a href="#rzammxmpbeg51be__was51create">2</a>.</li>
|
||
<li>Configure iSeries Access
|
||
for Web. See step <a href="#rzammxmpbeg51be__was51config">3</a>.</li>
|
||
<li>Start the web environment. See step <a href="#rzammxmpbeg51be__was51startweb">4</a>.</li>
|
||
<li>Use a browser to access iSeries Access for Web. See step <a href="#rzammxmpbeg51be__was51access">5</a>.</li>
|
||
</ul>
|
||
<strong>Steps to configure the Web serving environment: </strong></div>
|
||
<ol><li id="rzammxmpbeg51be__was51start"><a name="rzammxmpbeg51be__was51start"><!-- --></a><span>Start the IBM Web Administration for iSeries interface. </span><ol type="a"><li><span>Start a 5250 session to the server.</span></li>
|
||
<li><span>Sign on with a user profile that has at least these special
|
||
authorities: *ALLOBJ, *IOSYSCFG, *JOBCTL, and *SECADM.</span></li>
|
||
<li><span>Run the following server command to start the web administration
|
||
interface job: STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)</span></li>
|
||
<li><span>Minimize the 5250 session.</span></li>
|
||
</ol>
|
||
</li>
|
||
<li id="rzammxmpbeg51be__was51create"><a name="rzammxmpbeg51be__was51create"><!-- --></a><span>Create an HTTP web server and a WebSphere Application
|
||
Server V5.1 for iSeries :</span><ol type="a"><li class="substepexpand"><span>Open a browser to: http://<<em>server_name</em>>:2001</span></li>
|
||
<li class="substepexpand"><span>Log in with a user profile that has, at least these special
|
||
authorities: *ALLOBJ, *IOSYSCFG, *JOBCTL, and *SECADM.</span></li>
|
||
<li class="substepexpand"><span>Select <span class="uicontrol">IBM Web Administration for iSeries</span>.</span></li>
|
||
<li class="substepexpand"><span>Select the <span class="uicontrol">Setup</span> tabbed page.</span></li>
|
||
<li class="substepexpand"><span>Under Common Tasks and Wizards, select <span class="uicontrol">Create Application
|
||
Server</span>.</span></li>
|
||
<li class="substepexpand"><span>The Create Application Server page opens. Select <span class="uicontrol">Next</span>.</span></li>
|
||
<li class="substepexpand"><span>Select <span class="uicontrol">WebSphere Application Server V5.1 (base) for
|
||
iSeries</span> then select <span class="uicontrol">Next</span>.</span></li>
|
||
<li class="substepexpand"><span>The Specify Application Server Name page opens. For <span class="uicontrol">Application
|
||
server name</span>, specify iwa51base. This will be the name of
|
||
the WebSphere Express
|
||
Web application server. Select <span class="uicontrol">Next</span>.</span></li>
|
||
<li class="substepexpand"><span>The Select HTTP Server Type page opens. Select <span class="uicontrol">Create
|
||
a new HTTP server (powered by Apache)</span> then select <span class="uicontrol">Next</span>. </span></li>
|
||
<li class="substepexpand"><span>The <strong>Create a new HTTP server (powered by Apache)</strong> page
|
||
opens. </span> <ul><li>For <span class="uicontrol">HTTP server name</span>, enter IWA51BASE</li>
|
||
<li>For Port, specify 2040.</li>
|
||
</ul>
|
||
Select <span class="uicontrol">Next</span>.</li>
|
||
<li class="substepexpand"><span>The <span class="uicontrol">Specify Internal Ports Used by the Application
|
||
Server</span> page opens. For <span class="uicontrol">First port in range</span>,
|
||
change the default value to 21040. Select <span class="uicontrol">Next</span>. </span></li>
|
||
<li class="substepexpand"><span>The <span class="uicontrol">Select Business and Sample Applications</span> page
|
||
opens. Select <span class="uicontrol">Next</span> until the <span class="uicontrol">Summary</span> page
|
||
opens. </span></li>
|
||
<li class="substepexpand"><span>Select <span class="uicontrol">Finish</span>.</span></li>
|
||
<li class="substepexpand"><span>The web page is re-displayed with the <span class="menucascade"><span class="uicontrol">Manage</span> > <span class="uicontrol">Application Servers</span></span> tabbed page active.
|
||
Under <span class="uicontrol">Instance/Server</span>, iwa51base/iwa51base – WAS, V5.1
|
||
(base) is listed with a status of <span class="uicontrol">Creating</span>. </span> From this Web page, you can manage the WebSphere application server. <p>Use
|
||
the refresh icon next to the <span class="uicontrol">Creating</span> status to refresh
|
||
the page, if the page does not periodically refresh.</p>
|
||
</li>
|
||
<li class="substepexpand"><span>When the status is updated to <span class="uicontrol">Stopped</span>,
|
||
select the green icon next to <span class="uicontrol">Stopped</span> to start the WebSphere application
|
||
server. The status will be updated to <span class="uicontrol">Starting</span>. Use
|
||
the refresh icon next to the <span class="uicontrol">Starting</span> status to refresh
|
||
the page if the page does not periodically refresh.</span> iSeries Access
|
||
for Web requires that the WebSphere application server is running before
|
||
it can be configured.<div class="p"><div class="important"><span class="importanttitle">Important:</span> </div>
|
||
Wait for the status
|
||
to be updated to <span class="uicontrol">Running</span> before moving to the next
|
||
step.</div>
|
||
</li>
|
||
<li class="substepexpand"><span>Minimize the browser window</span></li>
|
||
</ol>
|
||
</li>
|
||
<li id="rzammxmpbeg51be__was51config"><a name="rzammxmpbeg51be__was51config"><!-- --></a><span>Configure iSeries Access for Web.</span><ol type="a"><li class="substepexpand"><span>Restore the 5250 session window.</span></li>
|
||
<li class="substepexpand"><span>To see the WebSphere application server running, run the server
|
||
command: WRKACTJOB SBS(QEJBAS51)</span></li>
|
||
<li class="substepexpand"><span>Verify that IWA51BASE is listed as a job running under the QEJBAS51
|
||
subsystem. iSeries Access
|
||
for Web requires the WebSphere application server is running before
|
||
it can be configured.</span></li>
|
||
<li class="substepexpand"><span>Verify the Web application server is ready: </span> <ol type="i"><li>Enter option #5 on your IWA51BASE job.</li>
|
||
<li>Enter option #10 to display the job log.</li>
|
||
<li>Press F10 to display detailed messages.</li>
|
||
<li>Verify the message <span class="uicontrol">Websphere application server iwa51base ready</span> is
|
||
listed. This message indicates that the application server is fully
|
||
started and is ready for Web serving.</li>
|
||
<li>Press F3 until you return to a command line.</li>
|
||
</ol>
|
||
</li>
|
||
<li class="substepexpand"><span>iSeries Access
|
||
for Web provides commands to configure the product. Two different commands
|
||
are provided, a CL command and a QShell script command. Both commands
|
||
provide and perform the same function. Use whichever version you prefer.</span> <ul><li><strong>To use the CL command, follow these steps:</strong><ol type="i"><li>Configure iSeries Access
|
||
for Web for your Web application server by using the following command:
|
||
<pre>QIWA2/CFGACCWEB2 APPSVRTYPE(*WAS51) WASINST(iwa51base) </pre>
|
||
These
|
||
are the parameters used: <dl><dt class="dlterm">APPSVRTYPE</dt>
|
||
<dd>Tells the command which Web application server to configure. </dd>
|
||
<dt class="dlterm">WASINST</dt>
|
||
<dd>Tells the command which instance of the Web application server to configure.</dd>
|
||
</dl>
|
||
For help on this command and the parameters, press F1.<div class="note"><span class="notetitle">Migration Note:</span> If you are already using iSeries Access
|
||
for Web within another Web application server, refer to <a href="rzammnewconsid.htm">New
|
||
Web application server considerations</a>. This topic discusses additional
|
||
CFGACCWEB2 command parameters that can be input to migrate user data from
|
||
an existing configuration to this new configuration.</div>
|
||
</li>
|
||
<li>Several messages similar to these will be displayed: <ul class="simple"><li><tt class="msgph">Configuring iSeries Access for Web.</tt></li>
|
||
<li><tt class="msgph">Preparing to perform the configuration changes.</tt></li>
|
||
<li><tt class="msgph">Calling WebSphere to perform the configuration changes.</tt></li>
|
||
<li><tt class="msgph">iSeries Access for Web command has completed. </tt></li>
|
||
<li><tt class="msgph">The WebSphere instance application server must be stopped and
|
||
then started to enable the configuration changes.</tt></li>
|
||
</ul>
|
||
</li>
|
||
<li>Press F3 or Enter when the command completes to exit the display session.</li>
|
||
</ol>
|
||
</li>
|
||
<li><strong>To use the QShell script command, follow these steps:</strong><ol type="i"><li>Start the QShell environment using the following server command: QSH</li>
|
||
<li>Make the iSeries Access
|
||
for Web directory the current directory. Run this server command:
|
||
<pre>cd /QIBM/ProdData/Access/Web2/install </pre>
|
||
</li>
|
||
<li>Configure iSeries Access
|
||
for Web for the Web application server previously created: <pre>cfgaccweb2 -appsvrtype *WAS51 -wasinst iwa51base</pre>
|
||
These
|
||
are the parameters used: <dl><dt class="dlterm">-appsvrtype</dt>
|
||
<dd>Tells the command which Web application server to configure. </dd>
|
||
<dt class="dlterm">-wasinst</dt>
|
||
<dd>Tells the command which instance of the Web application server to configure.</dd>
|
||
</dl>
|
||
For help on this command and the parameters, specify the -?
|
||
parameter. <div class="note"><span class="notetitle">Migration Note:</span> <img src="./delta.gif" alt="Start of change" />If you
|
||
are already using iSeries Access for Web within another Web application
|
||
server, refer to <a href="rzammnewconsid.htm">New Web application server
|
||
considerations</a>. This topic discusses additional CFGACCWEB2 command
|
||
parameters that can be input to migrate user data from an existing configuration
|
||
to this new configuration.<img src="./deltaend.gif" alt="End of change" /></div>
|
||
</li>
|
||
<li>Several messages similar to these will be displayed: <ul class="simple"><li><tt class="msgph">Configuring iSeries Access for Web.</tt></li>
|
||
<li><tt class="msgph">Preparing to perform the configuration changes. </tt></li>
|
||
<li><tt class="msgph">Calling WebSphere to perform the configuration changes.</tt></li>
|
||
<li><tt class="msgph">iSeries Access for Web command has completed. </tt></li>
|
||
<li><tt class="msgph">The WebSphere instance application server must be stopped and
|
||
then started to enable the configuration changes.</tt></li>
|
||
</ul>
|
||
</li>
|
||
<li>Press F3 when the command completes to exit the QShell session.</li>
|
||
</ol>
|
||
</li>
|
||
</ul>
|
||
</li>
|
||
<li class="substepexpand"><span>If the command were to fail or indicate an error, refer to the
|
||
log files:</span> <dl><dt class="dlterm">/QIBM/UserData/Access/Web2/logs/cmds.log</dt>
|
||
<dd>High level, cause and recovery information; translated.</dd>
|
||
<dt class="dlterm">/QIBM/UserData/Access/Web2/logs/cmdstrace.log</dt>
|
||
<dd>Detailed command flow for IBM Software Service; English only. </dd>
|
||
</dl>
|
||
</li>
|
||
<li class="substepexpand"><span>After successfully configuring iSeries Access for Web, the WebSphere application
|
||
server must be restarted to load the changes to its configuration. This
|
||
will be done later.</span></li>
|
||
<li class="substepexpand"><span>Signoff the 5250 session window and close the window. </span></li>
|
||
</ol>
|
||
</li>
|
||
<li id="rzammxmpbeg51be__was51startweb"><a name="rzammxmpbeg51be__was51startweb"><!-- --></a><span>Start the Web environment.</span><ol type="a"><li class="substepexpand"><span>Return to the browser window that is open to the <span class="uicontrol">IBM
|
||
Web Administration for iSeries server management</span> page.</span></li>
|
||
<li class="substepexpand"><span>The <span class="menucascade"><span class="uicontrol">Manage</span> > <span class="uicontrol">Application
|
||
Servers</span></span> tabbed page should be active. Under Instance/Server
|
||
is listed <span class="uicontrol">iwa51base/iwa51base – WAS, V5.1 (base)</span> with
|
||
a status of <span class="uicontrol">Running</span>. Stop and restart the WebSphere application
|
||
server: </span> <ol type="i"><li>Select the red icon next to the <span class="uicontrol">Running</span> status
|
||
to stop the WebSphere server.
|
||
Select the refresh icon next to the <span class="uicontrol">Stopping</span> status
|
||
to refresh the page if the page does not periodically refresh.</li>
|
||
<li>When the status is updated to <span class="uicontrol">Stopped</span>, select the
|
||
green icon next to <span class="uicontrol">Stopped</span> to start the WebSphere application
|
||
server.</li>
|
||
<li>The status will be updated to <span class="uicontrol">Starting</span>. Select
|
||
the refresh icon next to the Starting status to refresh the page if it does
|
||
not periodically refresh. <div class="important"><span class="importanttitle">Important:</span> Wait for the status to be
|
||
updated to Running before moving to the next step.</div>
|
||
iSeries Access for
|
||
Web will load and start as the WebSphere application server starts.</li>
|
||
</ol>
|
||
</li>
|
||
<li class="substepexpand"><span>Select the HTTP Servers tabbed page.</span></li>
|
||
<li class="substepexpand"><span>Under <span class="uicontrol">Server</span>, select IWA51BASE - Apache.
|
||
The current status of this Apache HTTP server should be <span class="uicontrol">Stopped</span>. </span> Select the green icon next to the status to start the HTTP server. The
|
||
status is updated to <span class="uicontrol">Running</span>.</li>
|
||
<li class="substepexpand"><span>Close the browser window.</span></li>
|
||
</ol>
|
||
</li>
|
||
<li id="rzammxmpbeg51be__was51access"><a name="rzammxmpbeg51be__was51access"><!-- --></a><span>Use a browser to access iSeries Access for Web</span><ol type="a"><li class="substepexpand"><span>Open a browser to either of the following addresses to access iSeries Access
|
||
for Web:</span> <p>http://<<var class="varname">server_name</var>>:2040/webaccess/iWAHome<br />
|
||
http://<<var class="varname">server_name</var>>:2040/webaccess/iWAMain</p>
|
||
</li>
|
||
<li class="substepexpand"><span>Log in using an i5/OS™ user ID and password. The initial
|
||
load of iSeries Access
|
||
for Web might take a few seconds. WebSphere Application Server is loading Java™ classes
|
||
for the first time. Subsequent loads of iSeries Access for Web will be faster.</span></li>
|
||
<li class="substepexpand"><span>The iSeries Access for Web Home or Main page displays.</span></li>
|
||
<li class="substepexpand"><span>Close the browser window.</span></li>
|
||
</ol>
|
||
</li>
|
||
</ol>
|
||
<div class="section">By following the above steps, you completed these tasks:<ul><li>Created a WebSphere Web
|
||
application server named iwa51base.</li>
|
||
<li>Created an HTTP server named IWA51BASE.</li>
|
||
<li>Configured iSeries Access for Web for the WebSphere application
|
||
server.</li>
|
||
<li>Stopped and restarted the WebSphere application server and HTTP
|
||
web server. iSeries Access for Web started when the WebSphere application
|
||
server started.</li>
|
||
<li>Verified that iSeries Access for Web can be accessed from a Web
|
||
browser.</li>
|
||
</ul>
|
||
<p><img src="./delta.gif" alt="Start of change" />In this example, only the <span class="cmdname">CFGACCWEB2</span> command
|
||
is used to configure iSeries Access for Web. For more information about
|
||
using all the iSeries Access
|
||
for Web CL commands, use the CL command finder. <img src="./deltaend.gif" alt="End of change" /></p>
|
||
</div>
|
||
</div>
|
||
<div>
|
||
<div class="familylinks">
|
||
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzammservxmpbeg.htm" title="These examples provide step-by-step instructions for setting up a complete Web serving environment.">Examples for configuring a new Web application server environment</a></div>
|
||
</div>
|
||
<div class="relinfo"><strong>Related information</strong><br />
|
||
<div><a href="../clfinder/finder.htm">CL command finder</a></div>
|
||
</div>
|
||
</div>
|
||
<img src="./deltaend.gif" alt="End of change" /></body>
|
||
</html> |