Installation manual
Thanks for choosing Archipel and welcome to the installation manual! This page will explain how to install Archipel, from the nightly build or from the sources.
Archipel requires some central services to be available. They do not have to be running on the same machine.
You can find a binary installer of ejabberd at http://www.process-one.net/en/ejabberd/downloads, or just install it through your system's package manager. It must be at least 2.1.6. At this time, Archipel only supports ejabberd as XMPP server. If you want to integrate your setup in an existing XMPP environment, you can use S2S to connect to other kind of XMPP server. Use ejabberd 2.1.X (or you want to configure multi XMPP server 2.1.6+)
You need to add some modules in ejabberd (mod_admin_extra and (OPTIONAL now) ejabberd_xmlrpc) that may and may not be included into your ejabberd distribution. Then, the default configuration of ejabberd needs some small adjustments and you can find a sample of ejabberd.cfg. It is strongly recommended you use all the options listed here.
Then, follow these instructions:
- Fedora-like (Fedora, CentOS, RHEL): Follow this link
- Gentoo-like : Follow this link
- Debian-like (Debian, Ubuntu): Follow this link
- OpenSUSE-like (11.4, 12.1): Follow this link
- Windows-like (XP,7,2000,2003,2008): Follow this link
Optionally, install this small Python daemon to unlock some extra Archipel functionality, such as Platform Requests.
Follow this link for installation instructions.
The client is a self-contained Web application. You can deliver it through your web server of choice, or you can skip this totally and use our hosted version.
Archipel's master is automatically bundled at new commits. If you just want to use Archipel, you should use the latest nightly build. The nightlies are located at http://nightlies.archipelproject.org. It is very easy to install as you don't need to have the Cappuccino development environment installed.
You can be notified when a new Nightly is published by using this RSS Feed:
Then you can clone the repo. You'll need a recent version of Git (at least 1.6.5) to download all submodules properly.
git clone git://github.com/ArchipelProject/Archipel.git
To get up and running with Archipel, you will need to install the client in your web server. Follow this link : Installation: Client
To set up your hypervisors, you have 2 options :
- You can install Archipel Agent in your existing hypervisor(s) : Installation: Agent
- You can boot your hypervisors with Archipel Node Stateless OS, provided and officially supported by the Archipel project. These are stateless Linux environments booting via your network. It is the most convenient way to set up a large number of Archipel hypervisors.