Jargon Writer^TM
Installation Instructions

Jargon Writer Installation Steps

1. Install the Java 2 JRE software

Be sure that you have completed the Java Installation (JRE)  step first, before installing Jargon Writer.

Run the Jargon Writer self-installer software. The file will be named something like "jargonwriter.exe". The required client software will be installed automatically when you run the install program and respond to questions as prompted.

The default installation directory is "C:\Jargonsoft". This becomes your Jargon Writer working directory. While you can specify any installation directory that you wish, we recommend using the default or a similar directory on another drive, such as "D:\Jargonsoft", for ease of support. Within this working directory that you select during installation, the following subdirectories will be created:
 

4gl	Used for procedures generated by Jargon Writer for Progress environments
doc	Online Help documents and images
images	Image and other multi-media files used by applications
lib	Jargon Software "jar" and "zip" class files
nt	Zip files of host procedures for Progress NT host environments
oracle	Host procedures, demos and sample apps for Oracle host environments
shell	Shells used when generating Progress 4GL source procedures
system	Jargon Writer startup, configuration and license files
templates	XML templates used when creating a "New" Jargon Writer app.
unix	tar files of host procedures for Progress Unix host environments
xml	Client Application procedure (.xml) files

By default, Jargon Writer help documentation for Sun's Java classes is linked to the online docs at the Sun web site. If you wish to download and install these documentation files on your local client system or intranet, see instructions in the Installing JavaDocs for Java 2 Classes section.

Install the license file (provided to you by your Jargon Software representative) in the "system" subdirectory, replacing the evaluation license file. Also keep a copy of your license file in some other location, in case it accidentally gets overwritten in the system directory.

Modify the "Host adapter" parameters for startup and runtime values in the "system\preferences.ini" file (under your working directory) as needed for your installation. Uncomment the appropriate parameters for your environment's middleware type, and comment out the other choices. Set the Host URL and Script name to the correct values. Refer to the detailed notes in the preferences.ini file for further information about how to assign values for these and other parameters.

If you have several applications with different parameter values, make a copy of preferences.ini and rename it (example: "MyApp.ini"). This is also a good idea even if you only have one application, in order to keep an unmodified copy of the default "preferences.ini" file. Modify the parameters in your new "ini" file, then copy the Jargon Writer desktop shortcut or menu item and add a new parameter to the end of the startup command: " system/MyApp.ini" (by editing the properties of the shortcut or menu item).

Copy the host source procedures to your host system(s) and uncompress them (for "zip" and "tar" files).  See the specific "Host Software Installation Instructions" for your host environment in the installation index for further details.

For Additional Assistance

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