Installation guide

5. SERVLETEXEC APPLICATION SERVER (WINDOWS)
ServletExec 4.1 Installation Guide 55
Several lines must be added to obj.conf for each server for which ServletExec/AS is
installed (the location of these lines within the obj.conf file is very important):
1. Add the following lines to the beginning of obj.conf before the other Init
directives:
Init fn=”load-modules”
shlib="<path>/bin/nsapi/ServletExec_Adapter.dll"
funcs="ServletExecInit,ServletExecService"
Init fn=”ServletExecInit” <instance-name>.instances="127.0.0.1:8888"
where <path> is the full path to the ServletExec/AS installation directory; by default,
this is C:\Program Files\New Atlanta\ServletExec AS.
Note:
The first Init directive will normally appear on a single line within the
obj.conf file. It’s shown as spanning three lines here for formatting reasons. It
may span three lines within obj.conf, in which case the second and third lines
must begin with a tab or space character). In general, the format of the second
Init directive is:
Init fn=ServletExecInit <instance-name>.instances="<addr>:<port>"
where <instance-name>, <addr>, and <port> are the name, IP address, and port
number of the ServletExec/AS instance to which HTTP requests will be forwarded.
Important—iWS 6.0 or Higher Users
If you’re using iWS 6.0 or higher, you must add the Init directives to the
magnus.conf file rather than the obj.conf file.
2. The following directives must be added after the <Object name=default> directive:
<Object name="<instance-name>">
Service fn="ServletExecService" group="<instance-name>"
</Object>
In general, an Object directive must be added to obj.conf for every
ServletExec/AS instance to which the web server adapter will forward
requests. The
Object directives have the form...
<Object name="<instance-name>">
Service fn="ServletExecService" group="<instance-name>"
</Object>
where <instance-name> is the name of the ServletExec/AS instance.
3. Lines similar to the following must be added within the <Object
name=default>
directives:
NameTrans fn="assign-name" from="/servlet/*" name="<instance-name>"
NameTrans fn="assign-name" from="*.jsp*" name="<instance-name>"
These NameTrans directives define URL prefix and suffix mappings that cause
HTTP requests to be forwarded to a ServletExec/AS instance for processing.
Figure 16 shows a complete obj.conf file for NES 3.6 with the ServletExec/AS
directives highlighted.