[[PageOutline(2-5, Table of Contents, floated)]]

= Parrot =

parrot.webarch.net is a 1GB RAM Xen Debian Squeeze virtual server running Transition Network WordPress sites. It has the [https://webarch.net/docs/wsh Webarch Secure Hosting] scripts installed. 

This server is due to be upgraded from LennyToSqueeze on ticket:535 in May 2013.

The install and initial configuration of this server was tracked on ticket:537.

== Websites ==

See WordPress.

== SFTP Access ==

When a new WordPress site is added to the server a email is sent containing the SFTP username and password. The directory structure that you see when you login is as follows:

{{{
/home/username
              /logs     <- access and error logs, rotated daily, kept for 28 days
              /private  <- a place to keep private data, for example .htpasswd files
              /sites
                    /default <- the DocumentRoot for the default site 
                                (additional sites can be added)
}}}

== PhpMyadmin Access ==




== Console Access ==

There is a Xen shell available for console access, see wiki:XenShell.

== Munin Stats ==

There are munin stats for the server available here

* https://penguin.transitionnetwork.org/munin/transitionnetwork.org/parrot.transitionnetwork.org/

== Adding a New WordPress Site ==

The server has been set up with the Webarch Secure Hosting scripts, see http://webarch.net/docs/wsh for some documentation of this.

To add a site run the {{{curses-create-user}}} script as root:

{{{
sudo -i
cruses-create-user
}}}

The curses interface can be navigated using tab, arrow keys and the space bar on your keyboard.

This will ask you for the following things:

* '''Create a new user''' -- enter the username for SFTP / MySQL and the WordPress admin, this should be short and made up of lowercase letters and numbers
* '''Select product''' -- pick ''' 5  medium+wordpress''' and this will create the site, database and install WordPress
* '''Users email address''' -- enter the email address that the SFTP, MySQL and WordPress login details are to be sent to

That's it!

== Maintaining WordPress sites ==

This can be done using the {{{wp}}} command line tool, see WordPress#wp.

For site specific notes on maintenance see the page for each site listed on WordPress#WordPressSites

== Updates ==

All systems updates are recorded on ticket:218.

There is a script in {{{/usr/local/bin}}} called {{{a-up}}} which can be used to update the system via aptitude, the advantage of using this script is that it writes things that are changed to the {{{/root/Changelog}}} and the time spent doing the updates can then be reported via ticket:218, see AptitudeUpdateScript for a copy of {{{a-up}}} and the {{{logchange}}} script it uses to update the {{{Changelog}}}. 

== Tickets ==

Current Parrot tickets:

[[TicketQuery(status=accepted|new|assigned|reopened&component=Parrot server,order=id,desc=1,format=table,col=summary|owner|reporter)]]

Closed Parrot tickets: 

[[TicketQuery(status=closed&component=Parrot server,order=id,desc=1,format=table,col=summary|owner|reporter)]]

== SSL Certs ==

There is a ticket regarding what do to for HTTPS for the server ticket:540.

The server has a copy of the *.transitionnetwork.org wild card certificate installed and this is used for https://parrot.transitionnetwork.org/ 

The server also has a dedicated IP address for the https://intransitionmovie.com/ site and SSL certificate.

All the other sites use a free http://cacert.org/ certificate, see ticket:540#comment:1 for a list of domains. To get rid of the security warnings that you will get if you don't have the CAcert root installed you need to install the root cert from http://www.cacert.org/index.php?id=3 to do this using Windows simply click http://www.cacert.org/certs/CAcert_Root_Certificates.msi and for Firefox and Chrome click https://www.cacert.org/certs/root.crt