Troubleshoot BOA - Internet machines

deadhorsecapableInternet και Εφαρμογές Web

9 Δεκ 2013 (πριν από 3 χρόνια και 11 μήνες)

716 εμφανίσεις

BOA description and howto

nick@internetmachines.co.uk


12
may

2013


Copyright (C) 2012
Nick

Hardiman.


Permission is granted to copy, distribute and/or modify this document


under the terms of the GNU Free Documentation License, Version 1.3


or any later version published by the Free Software Foundation;


with no Invariant Sections, no Front
-
Cover Texts, and no Back
-
Cover Texts.


A copy of the license is included
in the section entitled "GNU


Free Documentation License".


http://www.gnu.org/copyleft/fdl.html



Use this document with care.
These are notes
I wrote about

Omega8’s BOA
, to
help me get to grips with

the system.
This document

is not
the work of
those
clever people


all errors and omissions (and there are many) are all my fault.




This document is in two parts.



The first part is a description.



The second part is a howto cookbook.


Introduction

................................
................................
................................
................................
.......

9

The basics

................................
................................
................................
................................
.......

9

Drupal

................................
................................
................................
................................
...........

10

Aegir

................................
................................
................................
................................
..............

10

Barracuda

................................
................................
................................
................................
....

11

Octopus

................................
................................
................................
................................
........

12

The future

................................
................................
................................
................................
....

12

puppet

................................
................................
................................
................................
......

12

BOA help

................................
................................
................................
................................
...........

12

BOA reference

................................
................................
................................
............................

13

Drupal CMS reference

................................
................................
................................
.............

13

Omega theme reference

................................
................................
................................
.........

14

Hardware and networking

................................
................................
................................
........

14

OS

................................
................................
................................
................................
........................

15

User accounts

................................
................................
................................
................................
.

15

passwords

................................
................................
................................
................................
...

15

OS account

................................
................................
................................
................................
...

16

An octopus account
................................
................................
................................
.............

16

OS administrator account

................................
................................
................................
.....

17

Aegir account

................................
................................
................................
.............................

17

Aegir administrator account

................................
................................
................................

17

Aegir client account

................................
................................
................................
.................

18

MariaDB accounts

................................
................................
................................
....................

18

MariaDB administrator account

................................
................................
.........................

18

Drupal site account

................................
................................
................................
..................

18

Drupal site administrator account

................................
................................
....................

18

BOA Applications

................................
................................
................................
..........................

19

BOA script

................................
................................
................................
................................
...

19

Barracuda Master Installer

................................
................................
................................
...

19

The barracuda script

................................
................................
................................
...............

19

The barracuda configuration file

................................
................................
.......................

20

optional extras

................................
................................
................................
......................

21

Octopus Satellite Installer

................................
................................
................................
.....

21

The octopus script

................................
................................
................................
...................

21

Scripts

................................
................................
................................
................................
...........

22

OCTOPUS.sh.txt

................................
................................
................................
....................

22

/opt/tmp/$_BOA_REPO_NAME/aegir/scripts/AegirSetupA.sh.txt
.................

24

/opt/tmp/$_BOA_REPO_NAME/aegir/scripts/AegirSetupB.sh.txt

.................

24

/opt/tmp/$_BOA_REPO_NAME/aegir/scripts/AegirSetupC.sh.txt

.................

24

octopus configuration file

................................
................................
................................
.....

24

/root/.o1.octopus.cnf

................................
................................
................................
.........

24

Octopus platforms

................................
................................
................................
........................

25

Acquia Drupal

................................
................................
................................
............................

25

CiviCRM

................................
................................
................................
................................
........

25

COD (Conference Organizing Distribution)

................................
................................
...

25

Commerce

................................
................................
................................
................................
...

26

Commons

................................
................................
................................
................................
.....

26

Drupal 6

................................
................................
................................
................................
.......

26

Drupal 7

................................
................................
................................
................................
.......

26

Drupal 8

................................
................................
................................
................................
.......

26

ELMS (E
-
Learning Management System)

................................
................................
.......

26

Feature Server

................................
................................
................................
...........................

27

Managing News

................................
................................
................................
.........................

27

MartPlug

................................
................................
................................
................................
......

27

NodeStream

................................
................................
................................
................................

27

Octopus Video

................................
................................
................................
............................

27

Open Atrium

................................
................................
................................
...............................

27

Open Deals

................................
................................
................................
................................
..

27

Open Outreach

................................
................................
................................
...........................

27

OpenChurch

................................
................................
................................
................................

28

OpenPublic

................................
................................
................................
................................
..

28

OpenPublish

................................
................................
................................
...............................

28

OpenScholar

................................
................................
................................
...............................

28

Panopoly

................................
................................
................................
................................
......

28

Pressflow 6

................................
................................
................................
................................
.

28

ProsePoint

................................
................................
................................
................................
...

28

Videola

................................
................................
................................
................................
..........

28

Ubercart

................................
................................
................................
................................
.......

29

Platform versions

................................
................................
................................
.....................

29

Ægir

................................
................................
................................
................................
....................

30

Aegir service providers

................................
................................
................................
..........

30

Files
................................
................................
................................
................................
................

31

Aegir core Modules
................................
................................
................................
.......................

31

Aegir core modules

................................
................................
................................
..................

31

Aegir contributed Modules

................................
................................
................................
...

31

Hostmaster

................................
................................
................................
.............................

31

remote hosts

................................
................................
................................
..........................

31

drush

................................
................................
................................
................................
..................

32

The drush executable

................................
................................
................................
.............

32

Symlinks
................................
................................
................................
................................
.......

32

drush commands

................................
................................
................................
......................

32

Drush resource configuration files
-

drushrc.php

................................
.......................

33

Drush alias files
-

alias.drushrc.php

................................
................................
..................

33

Use a site alias
-

drush @site
-
alias core
-
status

................................
........................

34

a drush site aliase f
ile
-

@platform_drupal715.alias.drushrc.php

........................

35

site alias files

................................
................................
................................
.........................

35

run drush site
-
alias using the octopus account

................................
.......................

35

drush @hostmaster

................................
................................
................................
.................

36

The aegir crontab

................................
................................
................................
.....................

36

Drush extensions


module.drush.inc

................................
................................
..............

37

drush pro
vision

................................
................................
................................
.........................

37

Profiles

................................
................................
................................
................................
.........

38

Drupal Modules

................................
................................
................................
.............................

38

Extra modules
-

o_contrib_seven

................................
................................
.......................

38

Flags

................................
................................
................................
................................
..........

39

supporting applications
................................
................................
................................
..............

42

Apache Solr search engine

................................
................................
................................
....

42

Apticron

................................
................................
................................
................................
.......

42

Bazaar

................................
................................
................................
................................
...........

43

Bind9 DNS server

................................
................................
................................
.....................

43

csf/lfd (Configserver Security and Firewall/Login Failure Daemon)

..................

43

Files

................................
................................
................................
................................
...........

44

LFD upgrades

................................
................................
................................
........................

44

CSF u
pgrades

................................
................................
................................
.........................

44

Lshell

................................
................................
................................
................................
.............

45

configuration

................................
................................
................................
.........................

45

log

................................
................................
................................
................................
..............

45

Chive web
-
based MySQL administration

................................
................................
........

46

Collectd server monitor

................................
................................
................................
.........

46

MariaDB

................................
................................
................................
................................
.......

46

Databases
................................
................................
................................
................................

46

passwords

................................
................................
................................
..............................

46

backups

................................
................................
................................
................................
...

46

New Relic monitor

................................
................................
................................
..................

46

NginX web server

................................
................................
................................
.....................

46

mixed with

................................
................................
................................
.............................

47

configuration

................................
................................
................................
.........................

47

SSL

................................
................................
................................
................................
.............

47

files

................................
................................
................................
................................
............

47

nginx modules

................................
................................
................................
...........................

47

nginx virtual servers

................................
................................
................................
..........

48

PHP

................................
................................
................................
................................
................

49

PHP
-
FPM (PHP FastCGI Process Manager), AKA PHP53
-
FPM

...............................

49

PHP
-
FPM Process

................................
................................
................................
................

49

PHP
-
FPM configuration file

................................
................................
.............................

50

PHP extras

................................
................................
................................
................................
...

50

APC (Alternative PHP Cache)

................................
................................
..........................

50

phpredis

................................
................................
................................
................................
..

50

mailparse

................................
................................
................................
................................

50

uploadprogress

................................
................................
................................
....................

51

suhosin

................................
................................
................................
................................
....

51

ionCube
................................
................................
................................
................................
....

51

Pure
-
FTPd

................................
................................
................................
................................
...

51

Redis data store

................................
................................
................................
.......................

51

ngx_xss?

................................
................................
................................
................................
........

51

Xdrago
................................
................................
................................
................................
...........

51

Sqlcheck
-

Automated SQL repair

................................
................................
.................

52

/data/disk/arch/sql?

................................
................................
................................
.............

53

pdnsd
proxy DNS server

................................
................................
................................
........

53

spinner

................................
................................
................................
................................
.........

53

Sudo

................................
................................
................................
................................
...............

53

Vnstat

................................
................................
................................
................................
............

53

Webmin Control Panel

................................
................................
................................
...........

53

Wkhtmltopdf

................................
................................
................................
..............................

54

OS changes

................................
................................
................................
................................
.......

54

sysctl.conf

................................
................................
................................
................................
....

54

APT

................................
................................
................................
................................
.................

55

Repositories

................................
................................
................................
...........................

55

preferences

................................
................................
................................
............................

55

File hierarchy

................................
................................
................................
................................
..

56

Aegir files
-

/var/aegir/

................................
................................
................................
.........

56

Customer files
-

/data/disk/(customer)

................................
................................
.........

56

Global files
-

/data/all/

................................
................................
................................
..........

56

Customized applications
-

/opt

................................
................................
.........................

56

Distributions


001, 002, 003, etc.

................................
................................
.....................

57

backup

................................
................................
................................
................................
..........

57

modules

................................
................................
................................
................................
........

57

directory structure

................................
................................
................................
..................

58

symlinks

................................
................................
................................
................................
.......

59

control pan
els

................................
................................
................................
................................
.

59

Security

................................
................................
................................
................................
.............

60

speed

................................
................................
................................
................................
..................

60

Code management

................................
................................
................................
........................

60

MOTD (Message Of The Day)

................................
................................
................................
...

60

Backup

................................
................................
................................
................................
...............

61

MariaDB

................................
................................
................................
................................
.......

61

Drupal

................................
................................
................................
................................
...........

61

Upgrade

................................
................................
................................
................................
............

61

cache

................................
................................
................................
................................
..................

62

Redis Cache

................................
................................
................................
................................
.

62

Boost

................................
................................
................................
................................
.............

62

Speed Booster

................................
................................
................................
............................

63

Block Cache

................................
................................
................................
................................
.

63

Bandwidth optimizat
ion

................................
................................
................................
........

63

Drupal CSS/JS aggregation

................................
................................
..............................

63

Page compression

................................
................................
................................
...............

63

Cache for the general public

................................
................................
................................

63

No cache for developers

................................
................................
................................
........

63

Howtos

................................
................................
................................
................................
..............

64

create a BOA (Barracuda, Octopus, Aegir) system

................................
...........................

64

requirements

................................
................................
................................
.............................

64

Time to complete

................................
................................
................................
......................

65

Create a fresh VM and OS.

................................
................................
................................
..........

65

Brute force attempts on the root password
................................
................................
...

66

Configure DNS.

................................
................................
................................
...............................

66

Create a wildcard hostname.

................................
................................
...............................

66

Install New Relic

................................
................................
................................
............................

67

Install New Relic agent

................................
................................
................................
...........

67

Install the BOA Meta Installer, BOA.sh.txt

................................
................................
...........

68

procedure

................................
................................
................................
................................
....

68

Troubleshoot the BOA meta
-
installer

................................
................................
..............

68

configure barracuda
................................
................................
................................
.....................

69

Install BOA

................................
................................
................................
................................
.......

69

Command line options

................................
................................
................................
...........

69

Examples

................................
................................
................................
................................
.....

70

Transcript of a successful BOA install

................................
................................
..............

70

Troubleshoot BOA install

................................
................................
................................
......

78

Check logs

................................
................................
................................
................................
........

81

barracuda_log.txt

................................
................................
................................
......................

81

install.log

................................
................................
................................
................................
.....

82

install an older version of BOA

................................
................................
................................

84

Use csf/lfd (Configserver Security and Firewall/Login Failure Daemon)

.............

85

Check an IP address


c
sf

g 1.2.3.4

................................
................................
..................

86

remove a temporary block
-

csf
-
tr 1.2.3.4

................................
................................
.....

87

remov
e a permanent block
-

csf
-
a 1.2.3.4

................................
................................
......

87

other csf commands

................................
................................
................................
................

87

use CSF

to allow an IP address.

................................
................................
...........................

87

Procedure

................................
................................
................................
...............................

88

Restart CSF (Configserver
Security and Firewall).

................................
......................

89

Csf/lfd vs. my mail client

................................
................................
................................
.......

90

problem

................................
................................
................................
................................
...

90

Solution

................................
................................
................................
................................
...

92

use the MariaDB command line client

................................
................................
..................

92

Check your e
-
mail

................................
................................
................................
.........................

92

Master login e
-
mail

................................
................................
................................
..................

92

O1 login e
-
mail

................................
................................
................................
..........................

93

LFD alert e
-
mails

................................
................................
................................
......................

93

Customer welcome e
-
mail

................................
................................
................................
....

93

Use the Aegir control panel.

................................
................................
................................
......

98

The Certificate Error

................................
................................
................................
........

103

use SSH as the master user.

................................
................................
................................
....

103

Use the root account.

................................
................................
................................
............

104

Add another Octopus instance

................................
................................
...............................

104

procedure

................................
................................
................................
................................
..

104

Add a client using the boa command

................................
................................
..............

107

run OCTOPUS.sh.txt

................................
................................
................................
...............

107

Add a client using the BARRACUDA.sh.txt and OCTOPUS.sh. scripts
.................

108

What happens to the OS

................................
................................
................................
......

108

Logging

................................
................................
................................
................................
.......

108

Files
................................
................................
................................
................................
..............

108

troubleshoot

................................
................................
................................
.............................

109

User name is already used.

................................
................................
............................

109

Broken Internet connection

................................
................................
..........................

109

Remove an Octopus instance

................................
................................
................................
.

110

manually remove a site

................................
................................
................................
.............

110

Troubleshoot BOA

................................
................................
................................
......................

113

Bug Reports

................................
................................
................................
..............................

113

Upgrade BOA

................................
................................
................................
................................

114

barracuda

................................
................................
................................
................................
..

114

octopus

................................
................................
................................
................................
.......

115

An Apticron alert

................................
................................
................................
....................

116

upgrade repositories

................................
................................
................................
............

117

Upgrade the BOA installers.

................................
................................
...............................

117

Upgrade


barracuda up
-
stable

................................
................................
........................

117

the gory details

................................
................................
................................
...................

118

Check your e
-
mail for LFD warnings.

................................
................................
.............

119

upgrade


octopus up
-
stable o1

................................
................................
.......................

119

troubleshoot

................................
................................
................................
........................

125

upgrade
-

barracuda up
-
stable system

................................
................................
..........

126

avoid changes to the aegir crontab

................................
................................
.................

127

avoid session timeout

................................
................................
................................
...........

127

Change the root password.

................................
................................
................................
......

127

Tune a BOA system
................................
................................
................................
.....................

128

Aegir remote host copy
................................
................................
................................
.............

128

Lfd
-

More e
-
mails

................................
................................
................................
.......................

130

Work with cache

................................
................................
................................
..........................

130

Pdnsd DNS cache

................................
................................
................................
....................

130

An FQDN starting with dev

................................
................................
................................
.

130

Avoid the redis cache

................................
................................
................................
............

131

Avoid the boost cache

................................
................................
................................
...........

131

Purge the speed booster cache

................................
................................
.........................

131

check HTTP headers

................................
................................
................................
.............

131

Use the Aegir control panel.

................................
................................
................................
....

132

Create a password for your administrator account.

................................
.....................

132

The self
-
signed certificate

................................
................................
..............................

134

Log into the Aegir control center as a client

................................
................................
.....

135

Create a password for your new client account.

................................
.............................

136

Create an FQDN called
www.bigsupplies.com

................................
................................
...

138

A DNS wildcard reco
rd

................................
................................
................................
.........

138

procedure

................................
................................
................................
................................
..

139

Create a new site called
www.bigsupplies.com

................................
................................

139

Use Aegir

................................
................................
................................
................................
....

139

What happens in the back end

................................
................................
..........................

141

New Files

................................
................................
................................
................................
...

142

Site

................................
................................
................................
................................
...........

142

shortcut

................................
................................
................................
................................
.

142

drush

alias

................................
................................
................................
............................

142

virtual web server

................................
................................
................................
.............

142

database

................................
................................
................................
................................

142

one
-
time login
................................
................................
................................
..........................

142

Set a site administrator password

................................
................................
.......................

143

troubleshoot

................................
................................
................................
.............................

146

Add a site alias

................................
................................
................................
.............................

146

Disable a site

................................
................................
................................
................................
.

14
7

delete a site

................................
................................
................................
................................
....

147

Delete the site

................................
................................
................................
..........................

147

What happ
ens in the front end?

................................
................................
.......................

148

What happens in the back end?

................................
................................
........................

149

troubleshoot

................................
................................
................................
.............................

149

Create a new client.

................................
................................
................................
....................

149

example: My clients and users

................................
................................
..........................

150

process

................................
................................
................................
................................
.......

150

Create a password for the new client.

................................
................................
............

152

Troubleshoot
................................
................................
................................
............................

155

Remove a client.

................................
................................
................................
...........................

156

Create a basic user.

................................
................................
................................
.....................

156

Check your work.

................................
................................
................................
...............

158

Confirmation e
-
mail

................................
................................
................................
.........

159

Troubleshoot

................................
................................
................................
.......................

160

Add a basic user to a client.

................................
................................
................................
.....

161

Import Drupal from another machine to Aegir

................................
...............................

163

Example: cluster.bigsupplies.com

................................
................................
...................

163

Archive the old site

................................
................................
................................
................

164

Debian and tar

h (the dereference option)

................................
...........................

165

the importance of compression

................................
................................
...................

165

archiving huge sites

................................
................................
................................
..........

166

A huge codebase

................................
................................
................................
................

166

A huge database

................................
................................
................................
.................

166

copy the archive

................................
................................
................................
......................

166

Unpack the archive

................................
................................
................................
................

167

Install a new copy of Drupal using drush dl

................................
................................
.....

168

Example

upgrade to Drupal 7.15

................................
................................
...................

168

Troubleshoot
................................
................................
................................
............................

170

install a new commerce kickstart platform and move an old site to it

..................

170

Upgrade Drupal Commerce

................................
................................
................................

175

Install a new copy of Drupal using drush make

................................
..............................

175

Create a platform.

................................
................................
................................
.......................

176

Troubleshoot
................................
................................
................................
............................

178

Remove a platform

................................
................................
................................
.....................

180

Delete a platform supplied by the BOA distribution

................................
...........

182

Delete a platform in your static directory

................................
...............................

182

Troubleshoot

................................
................................
................................
.......................

182

Manually delete a platform

................................
................................
................................

183

Procedure

................................
................................
................................
................................
..

183

Two platforms


one broken, one not.

................................
................................
...........

184

Restore a platform you deleted by mistake

................................
................................
.

188

Copy a platform

................................
................................
................................
...........................

190

Fix missing available updates information

................................
................................
.......

191

examine permissons problems

................................
................................
..............................

193

Migration warnings

................................
................................
................................
...............

193

add modules and themes to a platform

................................
................................
..............

196

Fill a new site with archived site files

................................
................................
.................

196

Remove a site

................................
................................
................................
................................

197

Use Aegir for a Dev/stage/live workflow

................................
................................
..........

197

Use drush make
-
generate

................................
................................
................................
........

199

Clone a site

................................
................................
................................
................................
.....

200

Cloning a production site

................................
................................
................................
....

200

what happens in the front end?

................................
................................
........................

202

what happens in the back end?

................................
................................
.........................

203

migration from one platform to another

................................
................................
...........

204

Migrate a site

................................
................................
................................
................................

206

Troubleshoot
................................
................................
................................
............................

207

Clean up

................................
................................
................................
................................
..........

207

Migrate a site from one octopus to another

................................
................................
.....

208

Backup a site

................................
................................
................................
................................
.

208

delete old backups

................................
................................
................................
.................

209

Manage your databases

................................
................................
................................
............

210

use SSH to log in as the o1 customer

................................
................................
...................

210

log in as the administrator

................................
................................
................................
.

212

password expiry

................................
................................
................................
.....................

212

copy files using SFTP

................................
................................
................................
.................

213

check your e
-
mail.

................................
................................
................................
..................

213

authenticate with a password

................................
................................
...........................

213

authenticate with a key

................................
................................
................................
........

214

Troubleshoot

................................
................................
................................
.......................

214

Lfd
-

More e
-
mails

................................
................................
................................
.......................

214

Work with the command line interface
................................
................................
..............

214

use SSH to log in as an Aegir client

................................
................................
..................

215

Look around.

................................
................................
................................
.......................

215

Install the ctools module

................................
................................
................................
..........

216

The Aegir client OS account

................................
................................
...............................

216

Download the ctools module

................................
................................
.............................

216

Enable the ctools module.

................................
................................
................................
...

219

Install modules for the Omega theme

................................
................................
.................

219

Download and enable modules
................................
................................
.........................

219

Tips and tricks

................................
................................
................................
.........................

220

Troubleshoot
................................
................................
................................
............................

221

Install the Omega theme

................................
................................
................................
..........

222

have a look around

................................
................................
................................
................

222

Download using drush.

................................
................................
................................
........

223

Troubleshoot
................................
................................
................................
............................

225

Update modules

................................
................................
................................
...........................

226

Drush mup

................................
................................
................................
................................

226

Procedure

................................
................................
................................
................................
..

227

drush mup
--
no
-
core

................................
................................
................................
.............

228

drush mup and database upgrades

................................
................................
.................

228

drush mup and module backups

................................
................................
......................

229




Introduction


BOA

(Barracuda Octopus Aegir)

is an Aegir and Drupal management system for
sysadmins. It adds a LEMP stack to a new virtual machine. LEMP (Linux Nginx
MariaDB PHP) is a dubious acronym based on LAMP (Linux Apache MySQL PHP).


BOA
works as a
Multi
-
Site Manager for designers, and a host
ing system for
administrators. It’s a complex system maintained largely by
omega8.cc

and
Koumbit
.

Barracuda and Octopus have their own projects pages on
drupal.org
.




Barracuda

provides the BOA framework and hosting system
administration tweaks, to make the system faster and more secure.



Octopus

provides a multi
-
tenant hosting system for Aegir users.



Aegir

provides a centra
lized management system to allow an
administrator to easily manage many Drupal platforms and web sites.



The basics



Aegir is a hosting system based on Drupal and Drush
.



BOA is mai
nly a set of installer scripts

designed to make installing complete, h
igh
performance server/system
stack easy. BOA installs all re
quired services, its
own self
-
healing system and on top of it installs one Master and one or more
Satellite Aegir instances.


BOA also allows you to easily upgrade all installed system level lib
raries, tools
and services and all Aegir instances. BOA is an easy to use set of command line
tools to install, manage and upgrade your Aegir system and all its dependencies.


BOA includes many valuable add
-
ons, designed to make your life as a sysadmin
as

easy as possible. BOA development is managed by Omega8.cc only.


BOA was born as a dual
-
core Aegir system installer with two main install scripts:
Barracuda and Octopus, so the BOA acronym correctly refers to both installers
and their goal: to make insta
lling and upgrading complete Aegir system easy
-

in
the exact order as in the acronym.



Drupal


Drupal provides a content management framework for a web site developer. The
drupal developer can build several sites on one machine using Drupal.


The framework powering personal blogs and the biggest sites on the Web, like
The Economist
,
Examiner.com

and
The White House
. A

developer builds a web
site using an online library of modules and themes.


BOA includes twenty ready
-
made Drupal distributions
-

customized copies of
Drupal useful for creating more complex sites with less effort.


Drupal is not an application in eithe
r BOA or Aegir context


it’s the content that
Aegir works on. Drupal is not

managed as

part of
the

BOA or Aegir projects.


Aegir


Aegir is a hosting management system for Drupal sites. Aegir provides a
centralized management system to allow an
administrator to easily manage
many Drupal web sites.


While Aegir in theory supports also multi
-
server installs, it is an incomplete
feature with some serious issues. It is not supported in BOA. For more
information, see
http://drupal.org/node/1305896


Aegir manages sites, not code (modules or core). Aegir can be used to create new
platforms (codebase) with local or remote makefiles, or by uploading code and
adding the platform in the control panel. Aegir can
be used to provision, clone,
rename and migrate sites between different platforms.


For migrations and upgrades, Aegir compares the core and contrib code to make
sure the changes are possible. It reverts everything automatically if there are any
issues. A
egir also runs db upgrades as a part of migration between platforms.
You can't say that Aegir will upgrade the core and contrib modules
-

it doesn't
work that way. For more information, see
http://omega8.cc/managing
-
your
-
code
-
in
-
the
-
aegir
-
style
-
110

and
http://omega8.cc/core
-
conceptions
-
219
.


Aegir provides a centralized management system to allow an administrator to
easily manag
e many Drupal web sites on many machines. It automates manual
tasks such as deploying a new distribution, moving a site between machines and
upgrading core and modules.


Aegir is a hosting system for managing Drupal sites. Aegir is a control center
which
you can use to manage all your hosted sites.


The Aegir control center is a web user interface to help you administer your
Drupal sites, clients, servers and so on.


Different types of account can do different things with the Aegir control panel.
An administrator has full control, a client can manage sites and a user can view
their own account.


The BOA administrator created your Aegir control center for you. This doc
ument
is full of references to my Aegir control panel at this URL.

http://
o1
.
host.internetmachines
.co.uk/


Aegir is installed by to
ols included in the BOA project, but is not
part of BOA.
Aegir is dev
eloped by a team of core developers (four, including omega8cc)
supported by active community.


Barracuda


Barracuda provides the BOA framework and hosting system administration
tweaks, to make the system faster and more secure.


Barracuda includes

a

web

UI for

centralized management
of a BOA system
.

This
is an Aegir control panel.

There are few useful features here


it is not a full
-
featured web hosting control panel.


You install one Aegir Master Instance using

Barracuda and any number of Aegir
Satelli
te Instances using the
Octopus installer.

All these install on the same
machine. Behind the scenes, barracuda adds a LEMP (Linux Nginx MariaDB PHP)
stack to a new virtual machine.


The barracuda script is used on the command line (not a web UI) for

installation
and upgrades.


Running an upgrade using the command barracuda up
-
stable fires all sorts of
processes. Here’s a snippet of a process tree, half
-
way through an upgrade.

host:~#
ps faux

USER PID %CPU %MEM VSZ RSS TTY STAT STAR
T TIME COMMAND



root 2873 0.0 0.0 49176 1140 ? Ss 09:43 0:00 /usr/sbin/sshd

root 4613 0.0 0.0 78968 3468 ? Ss 09:45 0:00
\
_ sshd:
user

[priv]

user

4618 0.0 0.0 78968 1620 ? S 09:45 0:00 |
\
_ sshd:
user@
pts/0

user

4619 0.1 0.1 24584 4796 pts/0 Ss 09:45 0:00 |
\
_
-
bash

root 4736 0.0 0.0 48036 1600 pts/0 S 09:45 0:00 |
\
_ su
-

root 4743 0.0 0.0 21900 2100 pts/0 S 09:45 0:00
|
\
_
-
su

root 4841 0.0 0.0 13152 1324 pts/0 S+ 09:45 0:00 |
\
_ /bin/bash
-
x ./update.sh

root 4854 0.0 0.0 13280 1588 pts/0 S+ 09:45 0:00 |
\
_ /bin/bash /usr/local/bin/b
arracuda up
-
stable

root 4867 0.1 0.0 14444 2812 pts/0 S+ 09:45 0:00 |
\
_ bash /var/backups/BARRACUDA.sh.txt

root 7139 0.3 0.0 13160 1396 pts/0 S+ 09:49 0:00 |
\
_ bash

/opt/tmp/files/spinner busy

root 7209 0.0 0.0 5856 564 pts/0 S+ 09:49 0:00 |
|
\
_ sleep .2

root 7140 0.3 0.0 25804 2856 pts/0 S+ 09:49 0:00 |
\
_ apt
-
get upda
te
-
y

root 7144 0.0 0.0 29420 2124 pts/0 S+ 09:49 0:00 |
\
_ /usr/lib/apt/methods/http

root 7145 0.0 0.0 29420 2156 pts/0 S+ 09:49 0:00 |
\
_ /usr/lib/apt/m
ethods/http

root 7146 0.0 0.0 29420 2148 pts/0 S+ 09:49 0:00 |
\
_ /usr/lib/apt/methods/http

root 7147 0.0 0.0 29420 2116 pts/0 S+ 09:49 0:00 |
\
_ /usr/lib
/apt/methods/http

root 7148 0.0 0.0 29420 2132 pts/0 S+ 09:49 0:00 |
\
_ /usr/lib/apt/methods/http

root 7149 0.0 0.0 29420 2144 pts/0 S+ 09:49 0:00 |
\
_ /u
sr/lib/apt/methods/http

root 7150 0.0 0.0 29420 2160 pts/0 S+ 09:49 0:00 |
\
_ /usr/lib/apt/methods/http

root 7151 0.0 0.0 29420 2164 pts/0 S+ 09:49 0:00 |

\
_ /usr/lib/apt/methods/http

root 7153 0.0 0.0 23084 1780 pts/0 S+ 09:49 0:00 |
\
_ /usr/lib/apt/methods/gpgv




Octopus


Octopus installs the tenant part of the
multi
-
tenant hosting system
. Multi
-
tenant
means a service provider can

offer Aegir syste
ms to many Aegir administrators,
using only one machine.

All installations

co
-
exist safely and securely.
Each

Octopus
installation is called a
satellite
and
provides a complete Aegir
management system.



The f
uture


puppet


http://community.openatria.com/c/node/547


I believe BOA suffers from some architectural issues. Shell scripts have their
place, but they aren't well suited to the management of an
entire server,
especially considering the advent of powerful tools dedicated to that purpose,
such as Puppet. They just aren't robust, modular or re
-
usable. That's why I've
been spending so much time lately on the Aegir Puppet module
(
http://drupal.org/project/puppet
-
aegir
). Hopefully, with their recent efforts
towards .deb packaging for nginx support in Aegir, we'll be able to integrate that
into the Aegir Puppet module, which could then in turn be use
d from within BOA.



BOA help



Join us at



http://groups.drupal.org/boa




http://community.aegirproject.org




http:/
/groups.drupal.org/nginx



Questions? Comments? Please contact us:


http://omega8.cc/support




BOA
reference


BOA documentation is
really not good. It’s limited to collections of videos and
blog posts.


BOA
Video
s



http://www.youtube.com/watch?v=ZLMPlPvAuiE



http://bit.ly/aegir8cc



collections of BOA blog posts



http://omega8.cc/library/development




http://omega8.cc/library/good
-
to
-
know




http://omega8.cc/library/performance




http://omega8.cc/library/tips
-
and
-
tricks




http://omega8.cc/library/problems
-
solutions




http://omega8.cc/faq




http://omega8.cc/the
-
biggest
-
misunderstanding
-
ever
-
122




http://omega8.cc/the
-
best
-
recipes
-
for
-
disaster
-
139




http://omega8.cc/are
-
there
-
any
-
specific
-
good
-
habits
-
to
-
learn
-
116




http://omega8.cc/import
-
your
-
sites
-
to
-
aegir
-
in
-
8
-
easy
-
steps
-
109




http://omega8.cc/managing
-
your
-
code
-
in
-
the
-
aegir
-
style
-
110




http://omega8.cc/speed
-
booster
-
cache
-
boost
-
and
-
advagg
-
108




http://omega8.cc/how
-
to
-
disable
-
all
-
caching
-
and
-
aggregation
-
115




http://omega8.cc/extra
-
modules
-
available
-
in
-
all
-
platforms
-
123




http://omega8.cc/modules
-
enabled
-
or
-
di
sabled
-
automatically
-
117




http://omega8.cc/how
-
to
-
add
-
drupal
-
7
-
platform
-
properly
-
140




http://omega8.cc/where
-
is
-
the
-
ren
ame
-
task
-
129




http://omega8.cc/how
-
to
-
manage
-
aliases
-
and
-
redirects
-
127




Drupal CMS reference


Drupal online documentation is comprehensive. It’s simpler


but more
expensive
-

to wo
rk with a Drupal developer than learn it yourself.


Drupal
User and Builder Guides

1.

Understanding Drupal
,
http://drupal.org/documentation/understand


2.

Installation Guide
,
http://drupal.org/documentation/install


3.

Administration Guide
,
http://drupal.org/documentation/administer


4.

Structure Guide
,
http://drupal.org/documentation/structure


5.

Site Building Guide
,
http://drupal.org/documentation/build


6.

Multilingual Guide
,
http://drupal.org/documentation/multilingual


7.

Theming Guide
,
http://drupal.org/documentation/theme



Drupal
Developer Guides

8.

Developing for Drupal
,
http://drupal.org/documentation/develop


9.

API Reference
,
http://api.drupal.org/


10.

Examples for Developers
,
http://drupal.org/project/examples


11.

Git documentation
,
http://drupal.org/documentation/git



Other

Drupal

information

12.

Glossary
,
http://drupal.org/glossary


13.

Code snippets
,
http://drupal.org/handbook/customization/snippets


14.

Troubleshooting
,
http://drupal.org/Troubleshooting
-
FAQ


15.

FAQs
,
http://drupal.org/node/3
23096


16.

Tutorials and recipes
,
http://drupal.org/node/627198




Omega theme reference


1.

Jake Strawn's Omega Site

http://omega.developmentgeeks.com

2.

Omega framework discussions
http://groups.drupal.org/omega
-
framework

3.

Omega Theme 3.x Help Documentation

http://groups.drupal.org/node/155884

4.

Infor
mational:
http://himer.us/omega960


5.

Documentation:
http://himer.us/omega
-
docs


6.

Project Page:
http://drupal.org/project/o
mega


7.

Issue Queue:
http://drupal.org/project/issues/omega


8.

Usage Stats:
http://drupal.org/project/usage/omega


9.

Twitter:
http://twitter.com/Omeglicon





Hardware and networking


One of these



Xen, VServer, Linux KVM or VMware based VPS or a dedicated box.



VirtualBox VM for localhost install
-

best on Squeeze or Precise



Minimum 512 MB of RAM or
minimum 2 GB of RAM with Solr/Tomcat
enabled.



Talks to

Git

servers

on

port 9418.



32 or 64

bit



OS


A
fresh insta
ll of



Debian 6.0 Squeeze (recommended)



Ubuntu Precise 12.04
LTS



Ubuntu Lucid 10.04


These three distributions have
LTS (Long Term Support)
.
They may not have the
latest features

but they do make the best stable production systems.




User accounts


An account is used to authenticate each user and authorize her to work on the
system. Accounts are required for tasks like managing clients, connecting to the
database and copying files.


BOA contains
these

types of account
.

1.

OS account

-

An OS (Operatin
g System) account is used with the CLI and
file copying applications, such as OpenSSH and Filezilla.

2.

Aegir account



used with the Aegir control
panel
, a web UI.

This
includes
administrator
, account manager and client accounts.

3.

Drupal site accounts



eac
h Drupal site has its own set of accounts,
starting with
admin

(uid 1).

4.

MariaDB accounts



Used by the Drupal system and the Chive database
web UI to manage the database.


Security for all these accounts is pretty basic one factor authentication. The one
f
actor is a password. If you know the password, you’re in. Sometimes the
password is changed to key
-
based authentication.


passwords


Random passwords are generated and stored in text files. The password for the
user
o1
.
smartconsultants

is in these files.


/var/tmp/
o1
.
smartconsultants
.txt

/home/
o1
.ftp/users/
o1
.
smartconsultants



OS account


An OS (Operating System) account is used for SSH work and FTP copying. The
Aegir administrator gets an OS account, and so does every Aegir client. This
mainly means SSH work and FTP copying.


An OS account has attributes like this.



user:
o1
.ftp



pass:
r4nd0m



groups:
users, www
-
data, lshellg, ltd
-
shell



host:
o1
.
host.internetmachines
.co.uk



An OS account is
not

used with



the Aegir control panel



a Drupal web site, or



the MariaDB database server.


An octopus account


BOA is a multi
-
tenant system. Each t
enant gets its own OS account. When you
install BOA, one Octopus account named
o1

is set up automatically.


This o1 name is used to label lots of things in the default Octopus installation.
You will see it repeated in URLs (
https:/
/o1.host.bigsupplies.com
) and
directories (.o1
.octopus.cnf

and /data/disk/o1).


Here are
o1

s accounts.


(from the /
etc/passwd

file)

o1
:x:114:100::/data/disk/
o1
:/bin/false

o1
.ftp:x:997:100::/home/
o1
.ftp:/usr/local/bin/lshell


Here are more
o1

accounts, after I created two more

clients (
smartconsultants

and
bigsupplies
).

o1