Installing JRun
Installing JRun

After installing JRun

Perform the following steps to get started using JRun.

To start using JRun:

1. Read the JRun 4 Release Notes located at jrun_root/readme.htm.
2. Start a JRun server.

   For more information, see "Starting and stopping JRun servers".

3. (Optional) Log in to the JRun Management Console.

   For more information, see "Starting the JMC". For usage information, see the JMC Online Help.

4. (Optional) Configure the connection between JRun and an external web server (such as Apache or IIS).

   For more information, see Chapter 3, "Connecting JRun to External Web Servers".

Starting and stopping JRun servers

JRun provides utilities to start, stop, and perform other functions on the JRun servers. This section describes these utilities for Windows and UNIX platforms.

You can start and stop JRun servers using the following techniques:

• JRun server launcher
• Command line

For more information, see JRun Administrator's Guide.

Using the JRun server launcher

The JRun server launcher is a Java Swing application that you can use to start, stop, and restart JRun servers. You execute the launcher by running the jrun.exe file (Windows) or the jrun executable (UNIX), in the jrun_root/bin directory. The launcher contains buttons to start, stop, and restart JRun servers.

• (Windows) Select Start > Programs > Macromedia JRun 4 > JRun Launcher.

  The JRun Launcher window appears:

  

• Select a JRun server and click Start, Stop, or Restart.

Using the command line

You can start JRun using the jrun.exe and jrun shell script command-line utilities. Use the following syntax:

jrun {options} {server-name}

The following table describes the options:

Option	Description
-start	Starts JRun.
-stop	Stops JRun.
-restart	Restarts JRun.
-status	Displays status information for all JRun servers or for a specified JRun server.
-nohup	Starts JRun in a separate process.
-config path-to-jvm.config	Specifies a path to the JVM configuration file. Overrides the default, jrun_root/bin/jvm.config, to determine the JVM configuration.
-version	Displays the JRun version number (primarily for OEM use).
-build	Displays the JRun build number (primarily for OEM use).
-info	Displays additional information (primarily for OEM use).

Starting the JMC

The JRun Management Console is a web application that provides a browser-based interface for configuring JRun. To use the JMC, you must install Netscape Communicator 4.77 or 6.x, Internet Explorer 5.5 or later, or Mozilla .096 or later.

To launch the JMC:

1. Start the admin JRun server.

   For more information, see "Starting and stopping JRun servers".

2. Start the JMC in UNIX or Windows by opening the following URL in your web browser: http://localhost:8000.

   Note:   This procedure assumes that you are connecting to the JMC on the default JWS port 8000. If not, substitute 8000 with the admin JRun web server port number, located in the jrun_root/servers/admin/SERVER-INF/jrun.xml file, in the following lines:

     <service class="jrun.servlet.http.WebService" name="WebService">
     <attribute name="port">8000</attribute>
     <attribute name="interface">*</attribute>
     </service>
   

   The JMC login window appears:

   

3. Enter your user name and password, and click Login.

   Note:   You set your user name and password during JRun installation (see ).

   The Welcome to JRun window appears:

   

   In the Available Servers table, you can edit, start, and stop JRun servers.

4. Use the icons or click the server name for additional server information.
5. To get online Help, click the Help icon in the top JMC menu bar.