![]() ![]() ![]() ![]() |
![]() |
This appendix introduces the Enhydra Multiserver Administration Console, which you can use to start, stop, add, delete, and modify your applications and servlets.
To launch the Multiserver Administration Console (the Console), follow these steps:
If the Console does not start, then your path is not correctly set. See "Setting the PATH Environment Variable" for more information.
- In your browser, display the console by entering the following URL:
http://localhost:8001/
- 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
).
![]()
Figure B.1 The Multiserver Administration Console password dialog box
The Enhydra Console will display in your browser, as described in the next section.
Figure B.1 shows the initial view of the Console in a browser window. The Console has two frames:
- The frame on the left is the Control Frame, which contains the buttons that you use to operate the console tools.
- The frame on the right is the Content Frame. This frame is initially empty. It displays the results of actions that you perform.
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
![]()
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. ![]()
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. ![]()
Adds a servlet or application to the Enhydra Multiserver. For more information, see "Adding an Application or Servlet." ![]()
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." ![]()
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." ![]()
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." ![]()
Saves the state of the Enhydra Multiserver. For more information, see "Saving the State of The Multiserver." ![]()
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:
- Click on the Application or Servlet tab to display status information for the application or servlet. Figure B.3 shows an example of the status display for an application. Note that the status display for a servlet is slightly different.
- Click on the Connections tab to display connection status information for the application or servlet. Figure B.4 shows an example of the connection status display for an application.
Figure B.3 shows a portion of the status display for the Welcome application.
![]()
Figure B.3 The status display for a running application
Figure B.4 shows the connection status display for the Welcome application.
![]()
Figure B.4 The connection status display for a running application
This section describes how to use the console tools to work with your Enhydra applications and servlets. This section tells you how to:
- Add a new servlet or application to the Enhydra Multiserver
- Delete an application or servlet
- Modify the configuration of an application or servlet
- Use the debugging tool
- Save the state of the Multiserver
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:
- Click the ADD button. The Multiserver Administration Console displays the Add New Application/Servlet dialog box, which is shown in Figure B.5.
![]()
Figure B.5 The Add Application dialog box
- 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.
- 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:
- The name of the servlet
- The name of the class to instantiate for the servlet
- Any additional class paths required for the servlet
- The root of the servlet's file system on disk
- Optionally, any initial arguments for the servlet
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:
- If the application is running, you must first stop it.
- Select the application in the Applications window.
- 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:
- Select the application in the Applications window.
- Click the MODIFY button. The Content Frame displays the Modify window, as shown in Figure B.6.
![]()
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:
- Application tab to add additional class paths for the application or servlet
- Sessions tab to modify the application's Session Manager parameters
- Database tab to modify the applications database connection.
- Advanced tab to modify the application's default URL.
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:
- Select the application in the Applications window.
- Click the DEBUG button. The Debug popup window displays, as shown in Figure B.7.
![]()
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:
- Click the PAUSE button to pause the debugging function, which stops the accumulating of events in the scroll list.
- Click the RESUME button to resume the debugging function.
- Click the CLEAR button to clear the list of events.
- Click the FINISH button to halt debugging and close the popup window.
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:
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 |