Siebel eCollaboration Administration Guide > Setting Up Siebel eCollaboration > Installing the Siebel eCollaboration Server and Related Components >

Installing and Configuring Macromedia (Allaire) JRun

Macromedia (Allaire) JRun is the servlet engine used by eCollaboration. eCollaboration supports JRun 3.0.2a.

Before installing the Siebel eCollaboration server, you must install JRun on the same computer.

To use JRun, you must perform the following tasks:

CAUTION:  If you have an earlier version of JRun, you must uninstall it and delete the physical directory from your computer. You may need to restart your machine to remove the physical directory.

You must download and install Java Developer Kit (JDK) 1.2 or higher before installing JRun. One way of doing so is to download Java™ 2 SDK, Standard Edition, at http://www.sun.com. The SDK contains JDK.

Installing JRun

You must install JRun on the same machine as the eCollaboration server.

To install JRun 3.0.2a

  1. Stop IIS Admin service if it is running.
  2. By default, JRun uses port 8000. Determine whether port 8000 is open. If it is not, determine an open port for JRun to use.
  3. On the Windows Server Ancillary Programs CD-ROM, double-click the jr302.exe file in the Thirdpty\allaire\enu\jrun directory.

    4. The JRun installation wizard's Welcome screen appears.

  4. For each of the screens and dialog boxes shown in the following table, make the recommended entry, and then click Next to continue.

    5. Screen/Dialog Box
    Recommended Entry
    Comment
    Welcome
    No entry.
     
    JRun License Agreement
    Yes.
     
    JRun Product Serial Number
    Enter the serial number JR300E1-5800-6270-1013 from license.txt file in the Thirdpty\allaire\enu\jrun directory on the Windows Server Ancillary Programs CD-ROM.
     
    JRun Installation Folder
    Change the destination folder to a folder at the root level of the server machine, for example C:\JRun.
    Click Browse, and then enter a new folder name or navigate to an existing folder.
    Setup Type
    Full installation.
     
    Program Folder
    Accept the default or specify another folder.
    Setup Status screen is displayed during the subsequent installation.
    Install JRun Services
    Yes, install JRun services.
     
    Select a Java runtime
    Select a Java Development Kit (JDK) version 1.2 or later.
     
    JVM Advisor
    No entry.
    Read the advisory material.
    JRun Management Console
    Accept default port 8000 or enter the number of an open port.
    See Step 2.
    JRun Management Console
    Create and enter an administrative password.
    Record this password and the "admin" user name elsewhere for safekeeping.
    JRun Product Information
    Enter your contact information (optional).
     
    JRun Setup Complete
    Click the "Start the JRun Management Console, I'll configure my Web server later" radio button.
    Click Finish instead of Next.

Configuring JRun

You must use the JRun Management Console to define communication between JRun and to your Web server.

Before configuring JRun, determine the following:

To configure JRun on Windows platforms with the JRun Management Console

  1. Make sure the JRun Admin Server is started and your Web server is stopped. To confirm or make changes, choose Start > Settings > Control Panel, and then double-click Services.
  2. If the JRun Management Console login page is not already displayed, choose Start > Programs > JRun 3.0 > JRun Management Console.

    3. The JRun Management Console login page appears in your browser.

  3. Log in with user name = admin and password = the administrative password you created in the To install JRun 3.0.2a procedure. If the JRun Quick Start Product Tour browser window appears, close it.

    4. The JRun Application Management Console and Server Administrator page appears.

  4. Click the connector wizard tab.

    5. The Connector Wizard Step 1 frame appears.

  5. Make the following entries for Step 1 of the Connector Wizard, and then click Next.

    6. Field
    Description
    JRun Server Name
    Choose JRun Default Server.
    Web Server Type
    Enter your Web server type.
    Web Server Version
    Enter the version of your Web server. The picklist is dependent on your Web server type.
    Web Server Platform
    Select the platform on which your server runs. The picklist is dependent on your Web server type.

    The following dialog box warns you to stop your Web server and the World Wide Web Publishing Service. These services should already be stopped, so click OK.

    The Connector Wizard Step 2 frame appears.

  6. Make the following entries for Step 2 of the Connector Wizard, and then click Next.

    7. Field
    Description
    JRun Server IP Address
    This is the IP address where JRun resides. The default is the IP address for the local host. If JRun and the Web server are on the same machine, accept the default. If they are on different machines, enter the IP address of the JRun server machine.
    JRun Server Connector Port
    Enter the number of an open port that the JRun server will use to listen for connections from the Web server.

    The Connector Wizard Step 3 frame appears.

  7. Make the following entries for Step 3 of the Connector Wizard, and then click Next.

    8. Field
    Description
    PWS Scripts Directory or IIS Scripts Directory
    Enter the full path to the scripts directory as it was configured when the Web server was installed, for example C:\inetpub\scripts.
    Install as a Global Filter
    Check.

    The Connector Wizard Step 4 frame appears, indicating successful completion.

  8. Click Done, and then log out of the JRun Management Console.

 Siebel eCollaboration Administration Guide 
 Published: 24 June 2003