|
Overview
This document provides a quick checklist for installing Progress Software's
Webspeed or AppServer middleware products with Jargon Software products
on a Windows server, including Windows NT, 2000 and 2003 operating systems
with the IIS (Internet Information Server) version 5 or 6 web server.
This checklist uses the following names in examples. Substitute your
own specific host, service and database names where applicable.
"WinHost" - host name for the Windows server
"Host2" - host name for server that has the Progress database(s).
(Could be same as WinHost)
"MyDB" - database name on Host2
"MySvc" - service name (mapped to a port number) for MyDB access
1. Install the Webspeed or AppServer CD on WinHost in the default directory
(usually under C:\Program Files).
- Standard install
- Allow "ALL" users to access
- "Yes" to virtual directories
- Set default working directory to C:\Webspeed\Wrk or C:\Progress\Wrk (for log files)
- Set specific working directories for each Webspeed or Appserver broker (for your application)
2. Use Progress Explorer to add and configure Webspeed or AppServer.
Note: You can also use a text editor to directly edit the "ubroker.properties"
file, if necessary. The AppServer and NameServer properties file (ubroker.properties)
stores all component configurations managed by the PROGRESS Explorer administration
framework.
For AppServer configurations, these components include the AppServer
and the NameServer. There is one copy of this file for each PROGRESS installation.
So, if you install the NameServer on a separate machine, it has its own
copy of the ubroker.properties file.
The AdminServer reads and updates this file according to your instructions
using the PROGRESS Explorer and management utilities. In order for the
AdminServer to access it, this file must reside in the properties subdirectory
of the PROGRESS installation directory. For general information on the
content of the ubroker.properties and how to manage it, see the PROGRESS
System Administration Guide.
Unique broker name
Set as default service
Starting, threshold and maximum number of WebSpeed agents or AppServer
servers, etc.
Host & agent port numbers (check services file for unused ones)
Ensure that "-weblogerror" is in the AgentParams for WebSpeed
Add "-pf MyDB.pf" to AgentParams for database connection parameters (see
step 3)
Log file names/directory locations
To set up a connection to MyDB on Host2:
- Create MyDB.pf on WinHost in your working directory with contents like:
"-db MyDB -H Host2 -S MySvc -N tcp"
- On WinHost, in the C:\Winnt\system32\drivers\etc directory:
- Add "Host2" entry to HOSTS file
- Add a "MySvc" entry to SERVICES file (use a unique port#)
- On Host2, add the same entries to the hosts and services files on that
system (unix: /etc/hosts and /etc/services)
3. If using AppServer, install the Jargon Tunnel Broker on WinHost.
4. Install the "jsi/", "demo32/", "util/" and <application dir>
host programs on WinHost under your working directory:
- Edit jsi\jsi.ini and set HostType to "WS" (Webspeed) or "AS" (Appserver)
- Also in jsi.ini, set the UseBldBlks (Building Blocks) option to TRUE or FALSE
as appropriate
- Test compile all programs (see the
Compiling Strategies document)
5. Install Jargon Reader files on server:
See the installation instructions provided with your
Jargon Reader install file.
6. Test your app thoroughly, fix any problems
For Additional Assistance
If you have questions or problems not covered by this document,
see the additional assistance section
in the installation instructions index.
|