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

Apache Configuration

Next, we need to configure the Apache server itself to pass the XMLRPC calls from Up2date clients to Current and serve our Current's data files. This is where Current can start causing problems in a production system, which is why we strongly recommend you not try this on an active, production web server.

We're not going to go into a great deal of detail about Apache's configuration, but we will touch on the sections of that file that affect Current. If you need more information about configuring Apache please see the Apache Documentation.

First, and most important, you must have the mod_python module installed and functioning. Since Current is written in Python, for mod_python, not having it just doesn't make sense. Secondly, you must have SSL support enabled and functioning for your Apache server.

You should take note of where Apache expects to find the SSL server certificate and key files; in modern Red Hat style distributions, these locations are /etc/httpd/conf/ssl.crt/server.crt for the server certificate and /etc/httpd/conf/ssl.key/server.key for the server key. You will need to know these directories when you go to generate the server certificate and key using cinstall.

This configuration step has been greatly simplified with the create_apache_config command to cinstall, so it no longer needs to be discussed in great detail. Make sure that you have completed the previous sections and have your current.conf in good order before you run the cinstall command above. It will create an Apache configuration file, normally /etc/httpd/conf.d/current.httpd.conf, that will be loaded the next time you start Apache.

Once you've completed all the above configuration steps, you should be able to start the Apache server normally. Once the channels are configured, the database populated, and the clients properly configured, everything should Just Work(TM). If it doesn't work, or if anything in this documentation is unclear, please submit a bug report / question to the mailing list. Database creation, channel configuration, database population, and client configuration will be covered later.