Installation Checklist
Jargon ReaderX
Jargon Tunnel Broker
Progress AppServer
For Windows NT/2000

A. CONFIGURATION INFORMATION

Determine or select the values for the following:

HOST NAMES AND IP ADDRESSES

System where Web Server is installed

HostName: _________________________ IP Addr: __________________

System where Tunnel Broker is installed (if different)

HostName: _________________________ IP Addr: __________________

System where AppServer is installed (if different)

HostName: _________________________ IP Addr: __________________

System where database(s) are installed (if different)

HostName: _________________________ IP Addr: __________________

ex: www.jargonsoft.com 137.192.130.20

PORTS

NameServer: _____ (5162 = default)

AppServer: _____ (3090 = default)

Tunnel Admin: _____ (8000 = default)

Tunnel Broker: _____ (8001 = default)

DATABASES

Database PathName ServiceName(-S) Port#

1 __________________________________ _______________ _______

2 __________________________________ _______________ _______

3 __________________________________ _______________ _______

ex: C:\DB\Demo\Sports Sports_Svc 4001

DIRECTORIES (FOLDERS)

[WebRootDir]

Install Value: ___________________________________
Description: web server (IIS/PWS) document root dir.
Default Value: C:\InetPub\wwwroot
Suggested Value: (web server param)

[WebScriptDir]

Install Value: ___________________________________
Description: web server (IIS/PWS) scripts dir.
Default Value: C:\InetPub\scripts
Suggested Value: (web server param)

[ProgressDir]

Install Value: ___________________________________
Description: Dir. where Progress is installed
Default Value: C:\Program Files\Progress
Suggested Value: (same)

[AdminWorkDir]

Install Value: ___________________________________
Description: Progress Explorer admin logs dir.
Default Value: C:\Progress\Wrk (?)
Suggested Value: C:\Progress\Wrk

[BrkrWorkDir]

Install Value: ___________________________________
Description: AppServer broker working dir.
Default Value: "{@WorkDir}" - same as [AdminWorkDir]
Suggested Value: C:\Progress\[BrokerName]

[TunnelDir]

Install Value: ___________________________________
Description: Dir. in which tunnel.zip is extracted
Default Value: (none)
Suggested Value: C:\

[JavaDir]

Install Value: ___________________________________
Description: Dir. in which jre1.3 is extracted
Default Value: C:\Program Files\JavaSoft\JRE\1.3
Suggested Value: C:\Java\JRE130

[WriterDir]

Install Value: ___________________________________
Description: Dir. in which Jargon Writer is installed
Default Value: C:\JargonSoft
Suggested Value: (same)

B: INSTALLATION STEPS

1. INSTALL PROGRESS PRODUCTS

Install the AppServer, NameServer, AdminServer and jre118.

Specify [AdminWorkDir] during install.

2. CREATE DIRECTORIES

Create the following directories:
[BrkrWorkDir]

[TunnelDir]

[JavaDir]

[WebRootDir]\temp (for RDU browser viewing)

[WebRootDir]\jrx (for ReaderX cab file)

[WebRootDir]\xml\demo (for xml files)

[WebRootDir]\xml\images\demo (for jpg/gif files)

3. INSTALL JAVA RUNTIME ENVIRONMENT (JRE)

If you do not already have it, download jre1.3 (or jre1.2) from www.javasoft.com web site.

Run the jre installation program. Extract files into [JavaDir].

4. INSTALL JARGON TUNNEL BROKER.

Unzip tunnel.zip into [TunnelDir].

Read the detailed installation instructions in the [TunnelDir]\tunnel\doc\readme.txt file.

Copy [TunnelDir]\tunnel\win32\scripts\jsihttp.dll to [WebScriptDir] Copy [TunnelDir]\tunnel\win32\system32\jsihttp.ini to C:\WINNT\System32 Edit C:\WINNT\System32\jsihttp.ini (if necessary)

Edit [TunnelDir]\tunnel\system\tunnel.ini (if necessary)

NOTE: be sure to set MaxAgents to value <= max AppServer users

5. INSTALL JARGON HOST PROGRAMS

Unzip demo.zip, jsi.zip and utilprog.zip from [WriterDir]\nt into [BrkrWorkDir] Modify HostType value in [BrkrWorkDir]\jsi\jsi.ini to "AS".

6. CONFIGURE DATABASES AND APPSERVER

Use Progress Explorer (PE) to configure the database server(s), if this has not yet been done.

Make sure databases start in multi-user mode (at least 1 server), with network startup params ("-S [SvcName] -N tcp").

The page writer processes (APW, AIW, BIW) are optional but are normally desirable for better performance in real installations.

Make sure the [SvcName] is defined in the services file: C:\WINNT\System32\drivers\etc\services (entry will look like: "sports_svc 4001/tcp #Sports db svc"

Use Progress Explorer (PE) to connect admin server on localhost by right clicking localhost in tree, then click "Connect". Add a new AppServer broker by right-clicking AppServer in tree, then click "New". Configure the new AppServer broker by right-clicking it in the tree and click "Properties". Broker properties:

leave name as "asbroker1" for first broker, otherwise assign a new broker name
set Working Directory to [BrkrWorkDir]
set max agents to number of licensed AppServer users
set initial agents value to be <= max agents value
set mode to "StateReset" Server properties:
add DB connection params to Server Startup Params (like "-db [dbname] -H [HostName] -S [SvcName] -N tcp" ex: "-db sports -H localhost -S sports_svc -N tcp"

IMPORTANT:
After completing all configuration changes, disconnect the Progress Explorer admin broker, then close Progress Explorer and restart it to make sure the changes take effect properly.

7. INSTALL READERX

Copy ReaderX "cab" and "jar" files into [WebRootDir]\jrx

Copy startup HTML file(s) (ex: tunnel_sports.html) into [WebRootDir]

Edit startup HTML file for correct URLs and startup app name.

To install the Jargon "sports" demo:

Copy demo xml files from [WriterDir]\xml\demo into [WebRootDir]\xml\demo directory

Copy the demo images subdirectory [WriterDir]\images\demo into the [WebRootDir]\xml\images directory

8. START BROKERS AND SERVERS

Start web server (IIS or PWS) if it is not running.

Use PE to start database(s), then check status.

Use PE to start NameServer, then check status.

Use PE to start AppServer broker, then check status.

Note: All of these could be set to autostart at boot time.

From Windows Explorer or from a DOS command prompt window:

navigate to [TunnelDir]\tunnel\win32
run "gui.bat" to start the GUI control panel and start the tunnel broker from there.
Or, run "server.bat" to start it from a DOS command line.
Note: you can use "start gui.bat" to free up the DOS window when starting the GUI control panel from DOS.

9. TESTING

From a client PC with access to the Web Server system, open Internet Explorer or Netscape Navigator and enter the URL of the web server and the HTML startup script.
(ex: "http://www.jargonsoft.com/tunnel_sports.html")
If it works, you’re done. Go celebrate.
Otherwise find out what is wrong and fix it.

10. DEBUG STEPS:

turn on all 3 traces in tunnel.ini and jsihttp.ini
stop tunnel broker, close tunnel GUI admin window, close appserver broker, stop IIS WWW service
rename log files (see below) to start with clean ones
reboot NT
restart all brokers and servers that are not already autostarted at boot time
try running the app again
look at all Jargon and Progress log files in:

c:\winnt\system32\LogFiles
[TunnelDir]\tunnel\logs
[AdminWorkDir]
[BrkrWorkDir]
database ".lg" files

Debugging tips and techniques:

note exact content of any errors displayed on screen
see if web server is running by calling up the site’s home page in IE
see if host task is getting to tunnel broker by looking at tunnel logs and astrace logs
see if host task is getting to appserver by looking at appserver broker.log and server.log
is program getting compile errors? Try compiling in RDU.
is program getting runtime errors? look in the appserver "broker" and "server" logs
does program always return something to the client?
any errors in db.lg files?
any database schema triggers being invoked but not found?
if all else fails, call for help!