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

Chapter 1. Installation Guide


This document will guide you through the steps required to install a functioning 1.6-series Current Server. Regular maintenance of the server will be covered later; the beginning portions of this document will only cover the steps required to get to a point where you have a valid Current server instance responding to client registration and update requests.

Please note that Current (and up2date itself) are moderately advanced systems administration topics. If you aren't comfortable with tar, RPM, general systems administration, and similar topics, you probably shouldn't be using this software. Although we want as large a user base as possible, and we hate discouraging people, this software can very easily destroy data and disable systems if it is not set up and used correctly.

You should also note that Current is still in very active development, most especially with the 1.7 series; the 1.6 series has proven relatively stable, so if you require stability, you should probably use a 1.6.x release. If you elect to proceed with the development version, you should be prepared to encounter bugs, and willing to report them to the mailing list.

Bug reports should include any and all tracebacks, the version of up2date (or rhn_register) and Current you are experiencing the problems with, and wherever possible log extracts showing the failure. You may also be asked to submit your config file for the server and details on what packages are in your database(s).

Between full releases (1.4 to 1.6 or similar), the release notes or README will include any changes or minor incompatibilities. You should definitely review the example config file (current.conf) between snapshots for changes, and you will almost certainly need to recreate your databases. As of 1.0, Current records database versions, and will complain if you attempt to run the server with an out-of-date database.