The following scenario shows how to deploy a typical JSF handler
application to the i5/OS integrated
web application server.
Create a server instance in i5/OS if
one is not available. This example uses the name EGLi501 for the server
instance:
- Access the remote i5/OS Admin
Console GUI from a browser. Authorization may be required for the
access.
- The IBM Web Administration for i5/OS screen
is displayed.
- Select Create Application Server from Common
Tasks and Wizards. Click Next.
- On the Select Application Server Version and Type screen, select i5/OS
integrated web application server. Click Next.
- On the Specify Application Server Name screen, enter an Application
Server Name such as EGLi501. Click Next.
- On the Specify Internal Ports screen, click Next to
accept the default port numbers.
- On the Create a New HTTP Server screen, note the port number to
invoke the server instance during an application test. Click Next to
accept the default values.
- On the Specify User ID screen, click Next to
accept the default port numbers.
- On the Sample Application screen, click Next.
- On the Summary screen, click Finish.
If the applications to be installed on the server perform database
I/O, define a connection ID for each database by following these steps:
- From the i5/OS Admin Console
GUI, select the server instance where you want to install the application
(EGLi501 in this example).
- Select Manage Database Connections under
Resource Configuration.
- On the Manage Database Connections screen, click Create.
- On the Specify Database Connection Type screen, select the appropriate
connection type from the Database connection type pull-down
menu. Enter a unique identifier (or *Default) for Connection
ID. Your application must use the Connection ID as the
datasource when accessing information from the database. Click Next.
- On the Specify Database Connection Information screen, provide
the following information:
- The appropriate value for Database location (LOCAL
is the default).
- A library name for the DB2® database
for Schema name.
- The Connection User ID and Password if
required.
Click Next.
- On the JNDI Name screen, click Next to
accept the default name.
- On the Summary screen, click Finish.
- The Manage Database Connections screen displays the database connection
you just created, which you can edit or delete.
Copy the WAR file to the i5/OS environment
by following these steps:
- Map a network drive on your local system to access the remote i5/OS system:
>> net use z: \\lp11ut8.rchland.ibm.com\root
- Create a directory in i5/OS to
store the WAR file. For example, make a folder in the network drive
z:
>> md eglwars
- Copy the local WAR file to the remote i5/OS system:
>> copy d:\genout\EglWebProj.war z:\eglwars
Use the following steps to install an application WAR or WAB file
to the server instance:
- On the Manage All Servers screen, select the server instance (EGLi501
in this example), and click Manage Details.
- On the Manage Integrated Web Application Server screen, click Manage
Installed Applications.
- On the Manage Installed Applications screen, click Install.
- On the Install New Application screen, enter the path name of
the application WAR or WAB file, or click Browse to
navigate to the file. Click Next.
- On the Provide options to perform the install screen, click Next to
accept the default values.
- On the Context Root Port Mapping screen, click Next to
accept the default values.
- On the Summary screen, click Finish.
Test a JSF handler with the web application server by entering
the URL for the JSF application into a browser in the following form:
http://hostName:portNum/contextRoot/pageName.faces
- hostName
- The host name for the i5/OS system.
- portNum
- The port ID for the server instance.
- contextRoot
- The context root of the installed application.
- pageName
- The name of the JSF page to be displayed.
The following considerations apply to running test cases in the
browser: