Login | Register
My pages Projects Community openCollabNet
Project highlights: Stable Version: 1.6.1, Development Version: 1.7.6

Chapter 2. Configuration Guide

Common Server Configuration

The first task in configuring Current is to configure to common (or global) area of the server; this is the main section of the current.conf configuration file. This configuration is fairly straightforward; you can start with the example configuration file, and modify it to suit your needs.

The new configuration file in versions 1.5 and greater is significantly shorter than in previous versions. There are no longer individual channel entries. Instead, there are database parameters which must be correct, and a few essential constants needed by the Current server.

Database Configuration

Configuring Current for a specific database is covered in the next section called Setting Up Your Database. This includes all configuration variables that begin with “db”.

Logging

Logging is very important for Current. This log file will have important information in it about what the server is doing for each client. It will also have important information regarding any problems and errors that the Current server may experiance. There are two variables that affect logging.

The “log_file” variable should be set to the absolute path of a file where all logs will be written. The default is /var/log/current.log. The “log_level” variable indicates the verbosity of the logs. The lowest value is 0 where only death or life proplems are logged. 10 is the highest. I would recommend a setting of 1. I normally develop with a setting of 4. Settings greater than 5 are not currently used.

Apache Configuration

The “apache_config_file>” variable defines where the cinstall command will put Current's Apache configurations. The default value of /etc/httpd/conf.d/current.httpd.conf is the proper location for Red Hat style distributions.

The “access_type” variable defines how cinstall sets the permissions on the Current log file and the directories that Apache will serve Current's data from. This can be set to “user” for the Apache user to own these files. The variable can be set to “group” which will put all these files in the Apache group on your system. The value “all” can be used set world writable permissions. This is a security risk and is not recommended. Finally, you may use “none” to do nothing. Setting the proper permissions in this case must be done manually.

The “access_arg” is the user or group that permissions will be given to as described above. This should normally be “apache

Current Specific Configuration

The following configuration variables and values affect the internal operation of Current or control aspects of the Current/Up2date interaction. The “current_dir” variable is very important. This defines a location in your file system that Current can use for serving out channels, and packages. The default value is /export/current . The cinstall program will create these directories if they do not yet exist.

The remaining variables need to be defined, however the value associated with them is less important. The “welcome_message” and “privacy_statement” are strings sent to the Up2date client. You may wish to define these to reflect your organization's policies. The “server_id” and “server_secret” variables aid in the security of the interaction between Current and Up2date. Both should be set to some arbitrary text and the latter should never be made public. I would suggest a random MD5 sum for the secret.