Installing A New Gemin-i Plus Instance
From Gemin-Wiki
| Table of contents |
New Install
This page will detail everything that needs to be done to make a new installation of Gemin-i Plus on the Gemin-i Servers.
Planning
You will need to think about which of the machines we run the new server should be installed on. Almost certainly it will be whichever of our machines as the lightest load.
buttercup.gemin-i.org currently runs:
- Gemin-i Email
- Website servers
- The dev install of Gemin-i Plus on port 8080
- Gemin-i's CVS archive
bubbles.gemin-i.org currently runs:
- cc4g.gemin-i.org G+ install on port 8080
- globalaction.gemin-i.org G+ install on port 8081
identity.gemin-i.org currently runs:
- The plan identity project G+ install on port 8080
Remember that identity is a virtual machine and can't handle the same loads as the others.
Configure Apache
Presumably you know what the name of the new install will be. We'll pretend it's called X for now. You'll need to set up a website for that install, in /var/www-X/ accessible from http://X.gemin-i.org
Configure the DNS
We use 123-reg.co.uk for most of our DNS stuff. Their configure page will allow you to set up the new name. Select "manage DNS" and add a new CNAME record pointing to the machine you're going to use eg "X CNAME bubbles.gemin-i.org."
IMPORTANT: Don't forget that final . at the end of the name of the machine. It's odd to see it there but it won't work without it.
Make The Directory
You'll have to do most of this stuff as root.
mkdir /var/www-X
Best to put a test index.html file in that directory to so we can check that everything is working right later
vi /etc/www-X/index.html
And write quick HTML page like this one.
<html>
<head>
<title>Test</title>
</head>
<body>
A test page for the website X
</body>
</html>
Edit the apache config
Copy a config file in /etc/apache2/sites-available to create the new config file which we will edit. EG:
cp /etc/apache2/sites-available/cc4g /etc/apache2/sites-available/X
You will also need to put a sym-link in /etc/apache2/sites-enabled to that new file. EG:
cd /etc/apache2/sites-enabled ln -s /etc/apache2/sites-available/X ./004-X
clearly the number at the begining tells apache which order to start the sites up in. You'll just want to pick the numerically next highest after whichever ones are already there.
Now you can edit the config file you just created. The lines you need to change are the ServerName and most of the paths. Usually just doing a search/replace on the name of the site you just copied and the name of the new site should do the trick. EG in VI:
:0,$ s/cc4g/globalaction/g
Restart Apache And Test
/etc/init.d/apache2 restart
Then test that you can see the index file you created earlier as you'd expect at http://X.gemin-i.org or wherever.
Installing Gemin-i Plus
Now you'll switch to the admin user and go through the normal G+ install. You'll want to grab the CVS archive or tarball and unpack it in the /home/admin directory giving it a unique name for that install. For example put it in /home/admin/X-Gemin-iplus if the server is called X
Now do the normal install remembering to use a unique port-number for listening and the /var/www-X directory you just created for the doc-root. Check the Install Guide if you need to.
Things To Watch Out For
- You MUST have mysql 4.1 or higher
- Make sure the DB username and password are right. You CAN share the username and password with other installs if you wish. I do.
- Make sure the DB _NAME_ is unique to this install.
- Make sure the PORT is unique for this install.
- Make sure the WEBROOT is the one you created earlier in /var/www-X
- Make sure the HOSTNME is the name of the new install eg X.gemin-i.org
- Remember to create the backup directory, and do chmod a+w to it so that the web and cron accounts can access it.
- Don't forget to do do proxying to help users behind restrictive firewalls: Install_Guide#Proxying_To_Avoid_Users_Suffering_From_Blocked_Ports
Finished
That should be all you need to do. Log in and check it's all working!
![[Main Page]](/wiki/stylesheets/images/wiki.png)