Create a New Application Server
Make sure that the host identifier
localhost
works by typing ping localhost
on the iSeries command
line. If localhost
does not work, the web server on iSeries will not be able to create new
application servers.
- Start a Web browser and browse to the HTTP Administration Web
page of your iSeries:
http://
iSeriesNetworkName:2001
HTTPAdmin
(If your default port number is not 2001, use the actual port in this URL.)
If you get an error saying that the requested URL could not be retrieved, check that the HTTP Administration Server is running. To do so, use the
IBM Navigator for i
at this URL:http://
iSeriesNetworkName:2001
- Log in and navigate in the left pane to
HTTP Administration
.If its status is not
Started
, right-click it and choose Start Instance → IWADFT.Alternatively, start it using the
CL
command:STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)
After about 30 seconds, you should be able to retry the above link.
.
The right pane of the Navigator lists an entry named - When prompted for a user name and password, enter a valid IBM i user profile name and password, one with adequate privileges to administer an HTTP server.
- On the IBM Web Administration for i page, choose the tab
labeled
Manage
- In the left pane, under Common Tasks and Wizards, click
Create Application Server.
On the right side, an informational page about creating an Application Server appears. Click Next at the bottom of the page.
- Select as your application server type the one under IBM Integrated Web application server for i; it is normally selected by default. Click Next at the bottom of the page.
- Supply a name and description for your application server, for example,
UNIFACE
. Then click Next. - Enter a port number to which the application server will listen.
The application server will reserve 10 consecutive port numbers, so ensure that this range of 10 port numbers does not conflict with the port numbers of Uniface Routers that you might be running. Click Next when you're finished.
A new HTTP server that will run your application server is created.
- Fill in a name, description, and a port number for this new HTTP server.
- When prompted whether the application server will use the default user ID
QLWISVR
, or another one, click Next to proceed. The WRD does not require special permissions so the default ID is fine. - Now you are told what sample applications will be installed on your new application server, click Next.
The last page is a summary of all the input that you have provided so far. It also displays URLs with which the sample application
Eclipse Help
can be accessed. You can use this to test your application server after it has been started, so copy this URL to your clipboard. - Click Finish to start the creation process.
The creation process can take rather a long time, depending on the type of machine you have and its workload. You can monitor its progress using WRKACTJOB; in the QHTTPSVR subsystem, some JVM jobs will be busy creating the application server.
The Application Servers page is automatically displayed, which is regularly refreshing itself. You will see a turning hourglass and a message saying that your server is being created. When it disappears the creation process has finished, and at the top left you will see a green bullet with the text Running, your HTTP server and web application server are now running.
- If for some reason the server was not started, you can start it manually by clicking the green Play button.
The color of the bullet changes to yellow, and the status changes to
Starting
.Starting an application server might take some time. Also, because this page does not refresh automatically, you must click Refresh periodically.
When ‘
tarting
changes toRunning
, the application server is running. - You can now test the Eclipse Help URL you were shown earlier.
Open a new browser and paste (or type) the URL for the
Eclipse Help
application that was shown on the summary page. Assuming you the port number you filled in is 10000, it looks like this:http://
iSeriesNetworkName:10000/help
This URL should produce the first page of the
Eclipse Help
system.