Administering HTTP Server Instances on the IBM i Server to use with CA 2E's Web Option.

Products

• CA 2E

Issue/Introduction

The document describes how to create and delete HTTP Server instances for use with CA 2E's Web Option. It shows what is actually created, how they are used and how to delete them.

Environment

CA 2E Web Option

Resolution

An HTTP Server instance can be created during Web Option initialization when command YINZW2EENV is run.

You can also run the command YCRTW2EHTP to create a new HTTP Server instance at any time.

If you prompt the command, you see this

The name of your Web Option Environment Library needs to be supplied; by default the HTTP Server Instance is given the same name. I have supplied values to create an HTTP Server instance HTTPTEST, linked to my Web Option environment library DUNST85W using port 8500

Message W2C0013 confirms that the HTTP server instance was created

This creates 2 things: a member in file QUSRSYS/QATMHINSTC and a directory attached to folder /www

The member in file QUSRSYS/QATMHINSTC has a single record confirming this is using the Apache server and describing the location of the configuration file httpd.conf in directory /www/httptest/conf

With a WRKLNK 'www/httptest' you can see the directory

Option 5 displays its sub-directories

In the conf directory is the httpd.conf STMF (stream file)

With option 5 you can view the file and see references to port 8500, my CA 2E Toolkit library Z1SY,...

...Web Option Environment library DUNST85W and Web Option documents folder zwebopt.

Start the HTTP Server instance using STRTCPSVR in the normal way

Then start the Web Option server using YSTRW2ESVR

To delete the HTTP Server instance HTTPTEST, stop the Web Option server with YENDW2ESVR

Stop the HTTP server instance using ENDTCPSVR

Remove the HTTPTEST member from QUSRSYS/QATMHINSTC

Use WRKLNK 'www/httptest' then option 5 to see the sub-directories

Option 5 for each sub-directory

Delete any documents using option 4

In my case there were no documents in /www/httptest/htdocs

Delete any documents using option 4

Now the sub-directories can be deleted

And finally the directory itself

So the HTTP Server instance has now been completely deleted.

Additional Information

Note that you can also Start, Stop and Delete HTTP server instances using the IBM Web Administration page, accessible in a browser using the following link:

http://servername:2001/HTTPAdmin

You will be prompted to enter a valid IBM i profile and password. Once you have signed in, to see the list of available HTTP servers, you should click on the All Servers tab.

You will then see the list of HTTP Servers, along with buttons to Start, Stop and Delete a server instance.