Jargon ReaderX^TM
Installation Instructions

After developing an application in Jargon Writer, you have several alternatives when deploying it.

• Jargon ReaderX is the ideal deployment product for use with clients running the Windows 95, 98, ME, XP, NT, 2000 and 2003 operating systems. However, because of the ActiveX-based architecture used in Jargon ReaderX, it cannot be used on Unix workstations and other non-Windows clients.

• For non-Windows clients, the Java-based Jargon Reader deployment product can be used, since it is designed to run on any client system that has a Java JRE 1.2 runtime engine.

1. Installation procedures for Jargon ReaderX.

If you are using Jargon ReaderX for deployment, the following files must be installed on your host so that they can be "served" from the host when Jargon ReaderX is started from a link in a web page. See the appropriate "Host Software Installation Instructions" for further details.

• The appropriate middleware and database software for your host environment
• A web server such as IIS or PWS for Windows NT/2000 systems, or apache for Unix systems
• Domain Name Service (DNS) on Unix systems
• The Jargon Software "jsi" host procedures
• The host procedures for your application
• The Jargon ReaderX "cab" and "jar" files
• Web page(s) that will start ReaderX and launch your application
• The xml procedures for your application
• Any image files used in your application
• Any online documentation files used in your application

Install these files in subdirectories under the document root directory for your specific Web server (this will vary). On some unix Web servers, the document root directory may be the "/html" directory. On Windows NT/2000 systems, it is usually "C:\inetpub\wwwroot".

For convenience, you may find it simplest to create a subdirectory structure similar to that used for client directories. For example, if the document root directory is "C:\Inetpub\wwwroot" (on an NT server), you might install an Order Entry system using a structure like this:

C:\Inetpub\wwwroot\jrx\oe_startup.html
C:\Inetpub\wwwroot\jrx\readerx-1-0-0-56.cab
C:\Inetpub\wwwroot\jrx\readerx-1-0-0-56.jar
C:\Inetpub\wwwroot\xml\oe\*.xml
C:\Inetpub\wwwroot\images\oe\*.jpg
C:\Inetpub\wwwroot\doc\*.htm

Modify the various parameter values in your startup HTML page(s) to correctly point to the correct host and directory locations. Remember that the document root directory is omitted inside a URL (it becomes like the "root" directory for the web server). For further details, see the examples and comments in the sample html startup pages provided with the Jargon ReaderX install file.

The Jargon ReaderX software ("cab" or "jar" file),  the application procedures ("xml" files), and any related image files ("jpg" and "gif" files) will be automatically downloaded to the browser on a client system from your Web server. This works the same on your intranet and on the Internet. No special client installation steps are required. The app will be started by clicking on a link in an HTML Web page designed for this purpose. If Jargon ReaderX has never before been used on this client system, the user will be prompted to accept download and installation of the appropriate "cab" or "jar" file for the
browser being used. The download file is about 180KB and downloads as quickly as many web pages.

Notes for startup parameter values:

• There is NO slash at the end of the URL address.

 
• There are NO slashes at the start or end of the script name.

 
• If you are having problems resolving URLs or symbolic host names while testing on an internal network, try using the numeric IP address of the host instead.

If you have questions or problems not covered by this document, see the additional assistance section in the installation instructions index.