ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzam5_5.4.0.1/rzam5websphere50express.htm

130 lines
8.0 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="concept" />
<meta name="DC.Title" content="Configure your WebSphere Application Server, Express Edition, Version 5.0" />
<meta name="abstract" content="Create and configure an HTTP server using WebSphere Application Server Express Edition for your wireless network." />
<meta name="description" content="Create and configure an HTTP server using WebSphere Application Server Express Edition for your wireless network." />
<meta name="DC.Relation" scheme="URI" content="rzam5webappserver.htm" />
<meta name="DC.Relation" scheme="URI" content="http://www.ibm.com/eserver/iseries/products/websphere" />
<meta name="DC.Relation" scheme="URI" content="rzam5configure.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2005, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2005, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzam5websphere50express" />
<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 your WebSphere Application Server, Express Edition,
Version 5.0</title>
</head>
<body id="rzam5websphere50express"><a name="rzam5websphere50express"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Configure your WebSphere Application Server, Express Edition,
Version 5.0</h1>
<div><p>Create and configure an HTTP server using WebSphere<sup>®</sup> Application Server Express
Edition for your wireless network.</p>
<p>The following tasks will help you set up iSeries™ Navigator for Wireless to run
using WebSphere Application
Server (WAS) 5.0 Express Edition:</p>
<div class="section"><h4 class="sectiontitle">Requirements</h4><p>Before you begin, you must have QSECOFR
authority and the following installed:</p>
<ul><li>IBM<sup>®</sup> HTTP
Server (5722-DG1)</li>
<li>WebSphere 5.0.1
and above</li>
</ul>
<div class="note"><span class="notetitle">Note:</span> The following instructions will create a new instance of an HTTP
Server; you cannot use the following instructions to set up iSeries Navigator
for Wireless on an existing HTTP Server.</div>
<p>The following instructions
assume you have configured and are running WebSphere already. If you have not
yet set up WebSphere,
go to WebSphere at
http://www.ibm.com/eserver/iseries/products/websphere for complete prerequisite
details (including Java™). The WebSphere Administrative Console program
installed on a PC (that is, Windows NT<sup>®</sup> on the TCP/IP network)
should be used in the setup and configuration.</p>
<p>If you are a new WebSphere user,
make the <span class="uicontrol">Hello World</span> servlet application functional
by following the configuration steps on the WebSphere homepage. This setup process
helps you to become familiar with WebSphere, and it verifies that the
installation and configuration are successful.</p>
</div>
<div class="section"><h4 class="sectiontitle">Start the WebSphere subsystem</h4><p>Make sure the QASE5
subsystem is running. If it is not running, run the following command:</p>
<pre>STRSBS QASE5/QASE5</pre>
</div>
<div class="section"><h4 class="sectiontitle">Create your Web application server</h4><p>Running the following
command will set up iSeries Navigator for Wireless to run using WebSphere 5.0
Express Edition as the servlet engine. It will create an instance of WebSphere named &lt;<em>WASInstanceName</em>&gt;
and an IBM HTTP
Server (powered by Apache) named &lt;<em>HTTPInstanceName</em>&gt; that listens
for requests on port &lt;<em>port number</em>&gt;. Make sure that subsystem QEJBAS5
is running before trying this command. Items in [brackets] are optional, and
if you do not specify a value, a default value will be used. Replace items
in &lt;<em>italics</em>&gt; with your own information:</p>
<pre>CALL QSYSDIR/QYPVSETUP '-wasversion 5722IWE [-wasinstance &lt;<em>WASInstanceName</em>&gt;]
[-httpinstance &lt;<em>HTTPInstanceName</em>&gt;] [-port &lt;<em>port number</em>&gt;]'</pre>
<p>The
parameters in the command above are defined as follows:</p>
<dl><dt class="dlterm">-wasversion 5722IWE</dt>
<dd>Specifies that Websphere 5.0 Express Edition will be used to run iSeries Navigator
for Wireless.</dd>
<dt class="dlterm">-wasinstance &lt;<em>WASInstanceName</em>&gt;</dt>
<dd>Specifies the name of the WebSphere instance that will be created
to run iSeries Navigator
for Wireless. The instance that is specified cannot exist yet, otherwise there
will be an error when the command is run. If you do not specify an instance
name, the name of the instance will be MCP.</dd>
<dt class="dlterm">-httpinstance &lt;<em>HTTPInstanceName</em>&gt;</dt>
<dd>Specifies the name of the HTTP instance used to run the WebSphere servlet
engine. If you do not specify an instance name, the default is MCP. When specifying
an instance name, the name cannot include spaces and must be less than 10
characters long.</dd>
<dt class="dlterm">-port &lt;<em>port number</em>&gt;</dt>
<dd>Specifies the first number of a block of 6 ports. The HTTP Server will
listen for requests on &lt;<em>port number</em>&gt;, and the application server
listens on &lt;<em>port number</em>&gt; + 1 through &lt;<em>port number</em>&gt; + 5.
If you do not specify a port number, the default is 8110 for the HTTP Server
and 8111 - 8115 for the application server.</dd>
</dl>
</div>
<div class="section"><h4 class="sectiontitle">Start the WebSphere application server</h4><p>To start
your application server, you need to run this command from the QSHELL command
line:</p>
<pre>/QIBM/ProdData/WebASE/ASE5/bin/startServer &lt;<em>WASInstanceName</em>&gt; -instance &lt;<em>WASInstanceName</em>&gt;</pre>
<p>The
port number for the admin console of this instance of the WebSphere application
server will be displayed once the application server has started.</p>
</div>
<div class="section"><h4 class="sectiontitle">Start your HTTP Server</h4><p>After you start your application
server, you need to start your HTTP Server by running the following command:</p>
<pre>STRTCPSVR SERVER(*HTTP) HTTPSVR(&lt;<em>HTTPInstanceName</em>&gt;)</pre>
<p>Now that you have finished setting up your web application
server, you can continue to configure your wireless environment.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzam5webappserver.htm" title="Set up iSeries Navigator for Wireless to run using an ASF Jakarta Tomcat servlet engine, or a WebSphere Application Server (WAS). You can find set up instructions here for WAS 5.0 Base Edition and WAS 5.0 Express Edition.">Choose a Web application server</a></div>
</div>
<div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="rzam5configure.htm" title="Modify your web application server and firewall configuration so that iSeries Navigator for Wireless will run properly.">Configure your wireless environment</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="http://www.ibm.com/eserver/iseries/products/websphere" target="_blank">http://www.ibm.com/eserver/iseries/products/websphere</a></div>
</div>
</div>
</body>
</html>