IBM Books [Return to Library] [Contents] [Previous Topic] [Bottom of Topic] [Next Topic] [Help]

User's Guide


Configuring the Netscape Web servers

When you have installed the gateway files for your operating system, you need to configure your Web server to find and recognize the Gateway files. You need to perform the tasks which are described in detail below: The CGI interface, configuration files, and documentation paths are all configured using the Netscape Admin Server. The NSAPI interface requires you to edit some Web server files.

In the following procedures gateway_dir is the path to the Gateway files directory for your installation, and docs_dir is the path to the documentation files directory for your installation.


Configuring for the CGI interface

  1. Start the Netscape Admin Server
  2. Display the Netscape Server Selector page. The default location for this page is at port 8304 on the host machine, but this may have been changed in your local configuration.
  3. Select the server you want to change
  4. Select Programs from the menu bar
  5. Select CGI directory from the left hand index
  6. Add your CGI directory information by entering the following data in the form that is displayed:

    PlatformField nameData
    AIX, HP_UX, SolarisURL prefixdmq-bin
    CGI directorygateway_dir/dmqcgi
    OS/2,Windows/NTURL prefixdmq-bin
    CGI directorygateway_dir\dmqcgi.exe

  7. Click on OK
  8. Click on Save and Apply
  9. Click on OK in the confirmation window
  10. Select CGI File Type from the left hand index
  11. Select the Wildcard button
  12. type *.mqf in the displayed window
  13. Select YES to activate CGI as a filetype
  14. Click on OK
  15. Click on OK in the confirmation window

Configuring for the Gateway Configuration files

  1. Repeat steps 1-5 of the CGI configuration
  2. Add your Configuration file directory information by entering the following data in the form that is displayed:

    PlatformField nameData
    AIX,HP-UX,SolarisURL prefixdmq-bin/dmqcnf
    CGI directorygateway_dir/dmqcnf
    OS/2,Windows/NTURL prefixdmq-bin/dmqcnf.exe
    CGI directorygateway_dir\dmqcnf.exe

  3. Click on OK
  4. Click on Save and Apply
  5. Click on OK in the confirmation window

Configuring for the Gateway documentation files

  1. Repeat steps 1,2, and 3 of the CGI configuration
  2. Select Content mgmt from the menu bar
  3. Select Additional Document Directories from the list on the left hand side of the page
  4. Enter the following information in the form that is displayed:

    Field nameData
    URL prefixdmq
    Map to Directorydocs_dir

  5. Select OK
  6. Select Save and apply

Configuring for the NSAPI interface

To configure for the NSAPI interface you need to edit three of the Web server files: Make sure that you edit the files that are in your Web server directory. This is typically a sub-directory with a name like '\httpd-hostname'. Do not edit the files in the '\admserv' directory.

Edit each of the files as described below:
Note:For installations on OS/2 and Windows/NT platforms all occurrences of '/' should be replaced by '\'.

MIME.TYPES
Add the line
     type=mqseries/form exts=mqf
Mapping an extension of 'mqf' to an 'mqseries/form' type.

OBJ.CONF
Add the following line
     Service method="(GET|POST)" type="mqseries/form" fn="DMQNSAPI"
between <Object name=default> and </Object> Mapping the 'mqseries/form' type to a service method of 'GET|POST' and the 'DMQNSAPI' function

MAGNUS.CONF
For OS/2 and WindowsNT add the line
     Init fn=load-modules shlib=install_dir\bin\dmqnsapi.dll funcs="DMQNSAPI"
where install_dir is the directory in which you chose to install the MQSeries Internet Gateway.
For AIX add
     Init fn=load-modules shlib=/usr/lpp/mqm/lib/libdmqnsapi_r.a funcs="DMQNSAPI"
For HP-UX add
     Init fn=load-modules shlib=/opt/mqm/lib/libdmqnsapi_r.sl funcs="DMQNSAPI"
FOR Solaris add
     Init fn=load-modules shlib=/opt/mqm/lib/libdmqnsapi_r.so funcs="DMQNSAPI"
To load the MQSeries Internet Gateway functions

When you have edited the files, go to your server page in the Netscape Admin server as described in Configuring for the CGI interface above, and select System Settings from the menu bar. A message is displayed asking you if you want to apply the manual changes that you have just made. Select the Apply button which is near the top of the page.

Note: If you make a mistake during this configuration, it may prevent your complete Web server from starting, not just the NSAPI interface.


Additional procedures for AIX, HP_UX, & Solaris

The default user name for most servers is 'nobody'. To maintain security, this name must be changed using the following procedures:
  1. Select View Server Settings from the menu bar
  2. Select User
  3. Change the username field to your new name
  4. Select Save and apply

You can use a name that already exists in your mqm group, or you can create a new one specifically for your Web server, and add it to the group.


Where next?

When your Web server configuration is complete, the gateway is ready for use.

Configuring other Web servers

To Configure another Web server, click on the name of the server name in the following list:

[Return to Library] [Contents] [Previous Topic] [Top of Topic] [Next Topic] [Help]


[ Home | Order | Search | Contact IBM | Legal ]
(C) IBM Corporation 1997. 1999. All Rights Reserved