If you're installing Archiveopteryx for the first time, these are the steps you have to follow:
If you're upgrading an existing installation, here's what you have to do instead:
These steps are explained in detail below. Any special release-specific considerations will be documented in the web page for that release. The release notes for Archiveopteryx 3.0.7 are available at 3.0.7.
To compile, run make in the archiveopteryx-3.0.7 directory. (You need to have g++ and associated packages installed.) To install, run make install as root in the same directory. Executables and manual pages will be installed under /usr/local/archiveopteryx.
We test the build on Linux and FreeBSD, so you may encounter some errors if you compile elsewhere. We make few demands of the platform, so any errors are likely to be minor, and we'd be happy to help you resolve them. (Given enough demand, we'd be happy to add other platforms to our test ensemble.)
You'll need to have PostgreSQL installed and running before this step. We recommend using the latest 8.x release (but anything later than 8.1.0 should work).
Run lib/installer (in /usr/local/archiveopteryx) to create a Unix user and group for the servers to run as, a PostgreSQL user and a database with the necessary tables, and to generate the configuration file that's good enough to start and test the servers.
Run lib/installer -n to see exactly what commands the installer would run, without running those commands.
Run bin/aox start to start the server. (You should see log output eitber in /usr/local/archiveopteryx/logfile or in syslog.)
If you change anything in the configuration file, you can make the changes take effect with bin/aox restart.
Create some users, e.g. with: bin/aox add user nirmala pwd email@example.com
Archiveopteryx will create a user named nirmala (with password
and accept mail sent to the given address, and store it in a mailbox
named /users/nirmala/INBOX, which can be accessed via IMAP or POP.
Use bin/aox list users to see a
list of users; and aox help for usage
We sometimes change the database schema between releases, so you may need to stop the servers (aox stop) and run aox upgrade schema occasionally. aox show schema will display the current schema version and tell you if it needs to be upgraded. The newly-installed server will also refuse to start until the schema matches the version it expects.
It is safe to run aox upgrade schema when the server is stopped. If it doesn't need to do anything, it will just exit.
We try to keep schema upgrades fast, to minimise downtime.
Very rarely, we may need to make extensive changes to the database. In this case, you will need to run aox update database after you install and start the new server. The server will operate normally as the update proceeds. The release notes for a particular version will always mention it if you need to update the database.
It is safe to run aox update database, whether the server is stopped or running. If it doesn't need to do anything, it will exit. If the process is terminated, it is safe to restart it; it will pick up where it left off.
There are currently no binary packages available, but we hope to see that change soon. (If you're working on Unix/Linux distribution and want to include a Archiveopteryx package, please get in touch with firstname.lastname@example.org.)
If you want to look at the latest development version of Archiveopteryx, or contribute a patch, you need to use the git repository. Anonymous access is available.
If you have problems or questions, please write to email@example.com.
Last modified: 2011-05-17