docs.roxen.comBack to normal mode
DocsRoxen2.1Administrator ManualAdministration Interface
Copyright © 2001, Roxen Internet Software
Suggestions, comments & compliments
manuals@roxen.com

Admin Tab

The administration interface settings are located at the Admin tab as well as the Administration Interface site under the Sites tab. Even though it is possible to change any settings in the Administration Interface site, only the URLs variable should ever be changed. Changes to the Administration Interface site can make it impossible to configure your Roxen server.

The Admin tab contains four tabs; Starpage, Update, Your settings and Users. Startpage contains a welcome message and news downloaded by the update client.

Your settings contains the settings for this administration interface user. These settings control what information is shown in the interface, as well as its layout.

Users contains the accounts for all users who have access to the administration interface as well as their security privileges.

Creating an Administration Interface

The administration interface is created as part of the installation process described on the Software installation page of the Installing chapter. It is also possible to run the administration interface creation script, roxen/server/create_configinterface, manually.

Site Settings


Administration interface site settings

It is possible to change all site settings of the administration interface site. However the only setting that should ever be changed is the site URL or URLs. By default the site is mounted on its own port. It can however be hard to remember the port number, and hard to reach the port through a firewall. Sometimes this is a good thing, sometimes it makes the administration harder.

One way would be to create a whole new web site for the administration interface, https://admin.company.com/. But it might be too much trouble to get an IP number for the administration interface (remember a https port needs its own IP number). Another way is to mount the administration interface on the web site itself. For example https://www.company.com/admin/.

When changing the URLs of the admin interface, don't remove the old URL until you've made sure that the new one works. Otherwise you might not be able to configure your Roxen server anymore. If that should happen you might need to restore the settings from a backup file, or edit the configuration files manually.

The configuration file for the admin interface is usually roxen/configurations/Administration_Interface. The most recent backup file is roxen/configurations/Administration_Interface~. After the configuration interface settings are restored, restart the server by killing it's process. You can get its process id by running grep pid roxen/logs/debug/default.1.

In Windows you would instead first stop the Roxen service and then start it again, kill the Roxen console and run Roxen again, or end the Roxen process using the Task Manager.


holt manual $ grep pid roxen/logs/debug/default.1
: ** 2000-09-20 07:54 pid: 15469 ppid: 15460 uid: wing
8:00:00 : ** 2000-09-20 08:00 pid: 15469 ppid: 15460 uid: wing
holt manual $ kill 15469
holt manual $
Restarting the Roxen process form the command line

Users


Admin / Users tab

Several users can have access to the administration interface, with their own password and different privileges. The users are administrated on the Users tab. Here it is possible to create new users, change a users password or change her privileges.

To log in as another user click on the user button in the top right corner.

Your Settings


Admin / Your settings tab

Each administration interface user has a number of configurable settings that control the layout of the administration interface. It is possible to customize how the information in key parts of the interface, such as the module list, is presented. It is also possible to change theme, to get a different layout.

It is not possible to change the settings for another user. To do that you first have to log on as that user by clicking on the user button in the top right corner.


Administration interface with new theme