<< Contents< PreviousNext >Index >> Lutris Technologies, Inc.


 

Appendix B
Using the Multiserver Administration Console

 

 

This appendix introduces the Enhydra Multiserver Administration Console, which you can use to start, stop, add, delete, and modify your applications and servlets.

Launching the Administration Console

To launch the Multiserver Administration Console (the Console), follow these steps:

  1. Type the following command to start the multiserver:
      ./bin/multiserver
      

    If the Console does not start, then your path is not correctly set. See "Setting the PATH Environment Variable" for more information.

  1. In your browser, display the console by entering the following URL:
      http://localhost:8001/
      

  2. The Console displays a password entry dialog box, as shown in Figure B.1. To get started, enter the default username (admin) and password (enhydra).

    [Picture]

    Figure B.1    The Multiserver Administration Console password dialog box

The Enhydra Console will display in your browser, as described in the next section.

The Console Display

Figure B.1 shows the initial view of the Console in a browser window. The Console has two frames:

[Picture]

Figure B.2    The Multiserver Administration Console display

The Control Frame has two components:

The Applications Window

The Applications window contains a list of all of the applications and servlets available in the Enhydra Multiserver. You will see two applications that are initially available:

Use the ADD button to add new applications or servlets to the Multiserver, and the DELETE button to delete applications or servlets from the Multiserver.

Note: To permanently add or delete an application or servlet, you must save the console's state by clicking the SAVE STATE button.

The Console Tool Buttons

Table B.1 describes the function of each console tool button in the Console.

Table B.1    The Console Tool buttons

Button Description
[Picture] Starts the servlet or application that is currently selected in the Applications window. Note that this button is unavailable when the selected application or servlet is already running.
[Picture] Stops the servlet or application that is currently selected in the Applications window. If the application has active users, you are prompted to verify that you want the application stopped. Note that this button is unavailable when the selected application or servlet is not already running.
[Picture] Adds a servlet or application to the Enhydra Multiserver. For more information, see "Adding an Application or Servlet."
[Picture] Removes the servlet or application that is currently selected in the Applications window from the Enhydra Multiserver. For more information, see "Deleting an Application or Servlet."
[Picture] Modifies the configurable attributes of the servlet or application that is currently selected in the Applications window. For more information, see "Modifying the Configuration of An Application or Servlet."
[Picture] Invokes the debugging utility for the servlet or application that is currently selected in the Applications window. When you click this button, the debugging control panel displays, as described in "Debugging an Application or Servlet."
[Picture] Saves the state of the Enhydra Multiserver. For more information, see "Saving the State of The Multiserver."
[Picture] Stops the Enhydra Multiserver.

The Content Frame

This section describes the Content Frame of the Console, which shows you information about the application of servlet that is currently selected in the Applications window. Some of the Console tools also use the Content Frame to display information or to ask you for input.

You can select the information you want displayed in the Content Frame by clicking on one of its two tabs:

Figure B.3 shows a portion of the status display for the Welcome application.

[Picture]

Figure B.3    The status display for a running application

Figure B.4 shows the connection status display for the Welcome application.

[Picture]

Figure B.4    The connection status display for a running application

Using the Console Tools

This section describes how to use the console tools to work with your Enhydra applications and servlets. This section tells you how to:

Adding an Application or Servlet

To add an application or servlet to those that can be managed from the administration console, the application's configuration (.conf) file must be in the Enhydra applications directory. The default location for this directory is <enhydra_root>/apps.

Use the following steps to add an application to the Multiserver:

  1. Click the ADD button. The Multiserver Administration Console displays the Add New Application/Servlet dialog box, which is shown in Figure B.5.

    [Picture]

    Figure B.5    The Add Application dialog box

  2. Select the name of your application from the dropdown list. Your application's name only appears in the list if its configuration file is in the /<enhydra_root>/apps directory.

  3. Click the OK button to add your application to the Multiserver.

If you are adding a servlet instead of an application, you need to enter additional information in the dialog box, including:

Deleting an Application or Servlet

Note: When you remove an application or servlet from the Multiserver, you are not deleting the application or servlet, or its configuration file from your computer. You are simply removing it from the Multiserver's configuration file.

Use the following steps to delete an application or servlet from the Multiserver:

  1. If the application is running, you must first stop it.

  2. Select the application in the Applications window.

  3. Click the DELETE button.

Modifying the Configuration of An Application or Servlet

Use the following steps to modify the configuration of an application in the Multiserver:

  1. Select the application in the Applications window.

  2. Click the MODIFY button. The Content Frame displays the Modify window, as shown in Figure B.6.

    [Picture]

    Figure B.6    The Modify Configuration window

The Modify Configuration window features tabs that you can use to modify the application or servlet. If you are modifying an application, you can choose from among four tabs. Use the:

If you are modifying a servlet, there is only one tab to choose. You can use the Servlet tab to modify the Servlet's configuration options, which are the same options that you specify when adding the Servlet.

Debugging an Application or Servlet

The debugging tool provides you with a window into the operation of a running application or servlet; it traces the flow of requests to and responses from an application or servlet.

Use the following steps to debug an application or servlet in the MultiServer:

  1. Select the application in the Applications window.

  2. Click the DEBUG button. The Debug popup window displays, as shown in Figure B.7.

    [Picture]

    Figure B.7    The Debug popup window

The scrolling area in the window shows the active event list. You can use the debugging buttons as follows:

Saving the State of The Multiserver

When you add or delete applications or servlets with the Console, you are changing the current configuration of the Multiserver. If you want the changes to be retained, you must save the configuration.

Use the following steps to write the current configuration to the Multiserver configuration file:

  1. Click the SAVE STATE button.

  2. Click the OK button in the confirmation dialog box.


Lutris Technologies
http://www.lutris.com
1200 Pacific Ave., Suite 300
Santa Cruz, CA 95060
Voice: (831) 471-9753
Fax: (831) 471-9754
documentation@lutris.com
<< Contents< PreviousNext >Index >>
© 2000 by Lutris Technologies, Inc. All Rights Reserved