Barracuda and Octopus: Aegir and Drupal distributions installers (BOA)

This documentation has moved to GitHub. Please, check at https://github.com/omega8cc/boa/tree/master/docs for up-to-date instructions!

What is BOA?

Barracuda and Octopus are bash scripts to install and upgrade, tuned for high performance, Aegir master and satellite instances, respectively, with all related system services.

Drupal distributions are optionally installed as platforms on the Aegir satellite instances.

Do I need to install Octopus?

Yes!

While you can setup your system with just Barracuda, Octopus based sites have additional optimizations that the base system does not have. You need both layers.

You can have multiple Octopus installations - o1, o2, o3, etc.. - each with their own set of domains.

Getting Started

Start with a completely vanilla Debian or Ubuntu server (or VPS). Do not install anything special - the automated BOA scripts will do this for you.

If you are using AWS for hosting, use the LTS from cloud.ubuntu.org/ami

Login via SSH and as root run the below command. Do not run this command under sudo.

wget -q -U iCab http://files.aegir.cc/BOA.sh.txt

bash BOA.sh.txt

This will prepare your server with the barracuda and octopus install/update scripts.

Then to install everything in one hit

boa in-stable public server.mydomain.org my@email o1

The o1 is the octopus user name. You can change this to what ever you want.

It's best point your DNS records prior to running the above installer. By default BOA will setup the following two Aegir hostmaster sites on your server:

• master.server.mydomain.org
• o1.server.mydomain.org

Point both of these to your servers IP address.

Running Updates

Do not run apt-get update on your system. There is custom source code and settings. Rather, use the update scripts

barracuda up-stable

and

octopus up-stable all

See also:

• Install docs
• Barracuda and Octopus readme and docs
• BOA Drupal group
• BOA Wiki
• GitHub Page
• GitHub Issue Queue