This chapter introduces the server configuration file (server.cfg), which contains all the configuration settings for RealServer. When you want to change an aspect of server operation, you must edit the configuration file. A default server configuration file is created in the Real\Server directory on Windows NT, and in the pnserver directory on UNIX during installation.
The configuration file stores pairs of configuration options and their settings. This is a plain-text file, but settings are case-sensitive such as:
LocalHost Matisse LiveFilePassword fauvist EncoderTimeout 30
After making changes to the server configuration file, restart the server so that the changes can take effect.
There are three tools you can use to edit the configuration file:
With the RealServer Administration page, you can access the Java Performance Monitor automatically.
You can edit the configuration file using the Java Performance Monitor or the System Manager only when the server is running. With a text editor, you can edit the configuration file whether the server is running or not.
Refer to the appropriate section below for editing procedures for each editing tool.
The Java-based Performance Monitor is a graphical tool for configuring and monitoring a RealServer while the RealServer is running. For a discussion of how to start the Java Performance Monitor and connect it to the server, see Using RealServer.
To use the Java Performance Monitor to change RealServer configuration settings:
Restart the RealServer to cause the new configuration settings to take effect.
System Manager is a graphical tool under Windows and a command-line tool under UNIX (rssm).
For a discussion of starting the System Manager, see Using RealServer.
For instructions on using rssm, see Server Commands.
To use the System Manager to change RealServer configuration settings under Windows:
Restart the server for the new configuration settings to take effect.
You can edit the configuration file with any text editor. When RealServer is not running, editing the configuration file with a text editor is the only way to change settings.
kill -HUP 'cat pnserver.pid'