Installing JRun

When installing the online version of Generator, the installer also installs Live Software JRun into a subfolder within the Macromedia folder. In Windows, the subfolder is Macromedia\Generator 2; on UNIX systems, the subdirectory is Macromedia\Generator2 (with no space preceding the numeral 2). Generator installs the JRun.dll file into your Web server's Scripts directory and overwrites any JRun.dll file that may already exist in that directory.

On UNIX systems, JRun is either compiled into Apache or specified as a module for Netscape Enterprise.


 
Administering JRun

JRun has an administrative tool for monitoring and logging its activities. For example, you can record any errors or warnings that JRun may issue. The two tabs on the JRun Admin dialog box that pertain to Generator are the Generator and Mappings tabs. For more information on the other JRun Admin tool tabs, refer to the JRun documentation. (You can visit the Live Software Web site at www.livesoftware.com to obtain the documentation.)

To use the JRun Admin tool:

1 Choose Start > Programs > Macromedia Generator 2 > JRun Administration.
2 Select jsm-default, then click Configure.
3 Select jse, then click Service Config.
4 Click the Mappings tab to view which Generator servlet displays a particular file type.
5 Click the Generator tab and select logging options.
Note: When running Generator in a production environment, you should set the logging level to None or Errors.
Choose None to turn the logging option off.
Choose Warnings to record any warnings that JRun may issue when Generator runs. These warnings provide information about any non-fatal errors.
Choose Errors to record any errors that Generator may issue. This setting provides less detailed information than Warnings.
Choose Verbose to record all warnings and errors that Generator may issue when it runs the Generator servlets.
6 Click the Aliases tab to display configuration information for JRun and Generator servlets.
7 Click Save All.

You can view any changes you make to the Generator page of the JRun Admin dialog box in Macromedia\Generator\logs\generator.log.


 
Debugging JRun's Activities

If you configure Generator to log administrative information, you can use any text editor to view the logged information in the files located in Macromedia\Generator\logs\. In these files, you can view information about the application's processes, such as whether a movie is being properly generated or whether the server can connect to the data source.

For example, you could view the JrunServletEvent.log to check whether JRun initialized the Generator servlets. This sample portion of the log file tells you that the different servlets have been properly initialized:

Fri Apr 02 15:18:32 PST 1999: com.livesoftware.jrun.plugins.ssi.JRunSSI: init
Fri Apr 02 15:18:33 PST 1999: FlashGenerator: init
Fri Apr 02 15:18:33 PST 1999: GifGenerator: init
Fri Apr 02 15:18:33 PST 1999: PngGenerator: init
Fri Apr 02 15:18:33 PST 1999: JpegGenerator: init

This sample portion of the log file tells you that JRun could not preload the servlets:

Wed Apr 21 17:36:01 PDT 1999: Could not pre-load servlet 'FlashGenerator'.
Wed Apr 21 17:36:02 PDT 1999: Could not pre-load servlet 'GifGenerator'.
Wed Apr 21 17:36:02 PDT 1999: Could not pre-load servlet 'PngGenerator'.
Wed Apr 21 17:36:02 PDT 1999: Could not pre-load servlet 'JpegGenerator'.