Protege Client Server Tutorial Administration

From Protege Wiki
Revision as of 12:43, February 13, 2009 by TaniaTudorache (talk | contribs)

Jump to: navigation, search

Protege Server Administration

This page describes the administration of the Protege server. It describes the Protege Server Administration user interface and gives instruction on how to stop (shut down) a server project for maintenance purpose, how to cancel a scheduled shutdown and to start a server project. It also shows how to kill other user sessions.

This page is part of the Protege client-server tutorial.

The Server Admin user interface

The Server Admin user interface allows the control of the Protege server in a user-friendly way. A user with the appropriate permissions (see the Policy section in the server configuration page can start or stop server projects for maintenance without shutting down the server, she may kill other users' sessions (e.g., zombie sessions), or may shut down the server. The Server Admin user interface provides also useful statistics about the server work load.

The user interface is composed of three tabs:

  • Projects Tab
  • Sessions Tab
  • Server Control Tab

The Server Admin interface can be started in the Server login panel by selecting the Administer server check box as shown in the figure below.

AdminServer login.png

To refresh the information displayed in the tabs, you need to click on the Refresh button. The information is not refreshed automatically.

The Projects Tab

The Projects tab provides information about the available projects on the server.

ServerAdmin Projects.png

The Remote Projects table shows each project with its status and connected sessions. The status of a project is one of:

  • READY - The project is ready to use and can be opened by the Protege clients.
  • SHUTTING_DOWN - The project has been scheduled for shutting down. New Protege clients will not be able to open this project. The shut down can be canceled at this point.
  • CLOSED_FOR_MAINTENANCE - The project is shut down on the server. New Protege clients will not be able to open this project.

The sessions column shows what sessions (i.e, Protege clients) are connected to the project.

Stopping (shut down) a server project

To stop a server project you need the permissions: Administer Server or Stop Remote Project, which can be configured in the metaproject. See the server configuration page for more details on how to do this.

If you have the appropriate permissions, you can stop a server project by selecting the project in the table and clicking on the "X" icon at the top right corner of the Remote Projects table. A dialog will come up. Set the time in minutes of when to shutdown the project and click on the OK button

ServerAdim stopProject.png

Once you have clicked OK, the status of the project will be changed from READY to SHUTTING_DOWN. The server will send repeated notification messages to all the clients that have that particular project open (in the screenshot: Collaborative Pizza) to announce them that the project will be shut down. The notifications that the clients will get look like this:

ServerAdmin stopClientMessage.png

When the last notification is sent, the Protege clients will close the remote project automatically. At this point, the status of the project is CLOSED_FOR_MAINTENANCE. You need to click on the Refresh button to see the new status.

Canceling a scheduled shutdown of a server project

To cancel a scheduled project shutdown,

Starting a project

Read more about the Protege multi-user support in the Protege client-server tutorial.