Administration Server - Introduction


What is the Admin Server?
Configuration of Zeus applications is primarily performed through the Administration (or Admin) Server. The Admin Server is built around standard web protocols enabling Zeus applications to be configured through any web browser. The Admin server provides an easy interface to the installed Zeus applications, allowing you to quickly and easily perform common administrative tasks.

Running the Admin Server
The Zeus installation directory contains a script called start-zeus. This script will start up the Admin Server, reporting the URL which it can be contacted on. Also it will attempt to start up any installed Zeus applications. For example:

leda# /usr/local/zeus/start-zeus 
Initializing Zeus Application Framework.  (C) 1995 - 2001 Zeus Technology Limited
Zeus Admin Server - (C) 1995 - 2001 Zeus Technology Limited
Version 3.4, Build date: Feb  6 2001 12:42:50
INFO:sendfile: Linux 2.2 sendfile driver
 INFO:Zeus Admin Server started
 INFO:Version 3.4, Build date: Feb  6 2001 12:42:50
 INFO:http://leda.cam.zeus.com:9091
 INFO:Zeus Admin Server running
Zeus Web Server - (C) 1995 - 2001 Zeus Technology Limited
Version 3.4, Build date: Apr  2 2001 12:34:03
 INFO:sendfile: Linux 2.2 sendfile driver
 INFO:Zeus Web Server started
 INFO:Version 3.4, Build date: Apr  2 2001 12:34:03
 INFO:Zeus Web Server running
leda#
Here the start-zeus script started up the Admin Server on port 9090, and also started the installed Zeus Web Server.
Note, the Admin Server should be started as root if any of the Zeus applications require access to root services, e.g. bindng to ports less than 1024.

Stopping the Admin Server
The Admin Server can be shut down in two different ways. You can either shut it down from the command-line using the script called stop-zeus available in the Zeus installation directory. This script will close down the Admin Server, and any Zeus applications that are currently running. For example:
leda# /usr/local/zeus/stop-zeus 
Zeus Admin Server stopped
Zeus Web Server stopped
Note, if you started the Admin Server as root, you will need root privileges to close it down.
Alternatively, the Admin Server can be shut down using your web-browser in the Admin Controller.

Viewing the Admin Server in your Browser
The Admin Server is itself a web server, albeit a very specialised one. To view the Admin Server pages and configure your site you will need to run a web browser. The browser need not be on the same machine as you run the server. The Zeus Admin server has been tested to work correctly with Netscape version 2 and Microsoft Internet Explorer version 3 and above.
The server is accessed in the same way you would access any web site. All you need to do is type the Admin Server URL into the Location field of your web browser.
The Admin Server URL will be http://server-machine:port/ Where the server name is the host name of the machine you're running the server on. The default port number is 9090, and was determined as being free when the Admin Server was first installed. The URL is displayed in the output of the start-zeus described above.
The Admin Server front page will display a list of the installed Zeus applications and should look something like this:

The front page allows you to configure any of the installed Zeus applications, or the Admin Server itself. To configure the Admin Server click on the admin cog to enter the Admin Controller.