Installing Hotaru with Subversion
Well it’s time for another Hotaru post, this time I’m going to be showing you the best way to install and keep the CMS up to date.
Like many open source software projects, Hotaru maintains a subversion repository of its code base.
In Hotaru’s case, the subversion repo is located at http://my-svn.assembla.com/svn/HotaruCMS/.
Now the great thing when a project runs a subversion repository is that we can download the source with only one command.
With the pace of Hotaru development being so quick at the moment, the following method will not only save you effort when installing the app for the first time, but will also make keeping your installation current painless.
This tutorial assumes you are using a linux server and have command line access and the svn subversion tool installed.
Installing Hotaru with svn
I said it was a one line install right? Well I wasn’t lying, here’s all you need to do :
svn co http://my-svn.assembla.com/svn/HotaruCMS/trunk public_html/
Let’s break the above command down.
‘svn’ stands for subversion.
‘co’ means ‘check out’ and that is what we are doing, checking out a versioned branch of the code.
Then we have the Hotaru subversion URL with /trunk added to the end. This means we will be downloading the latest stable code. If you leave off /trunk then you would download the entire subversion repository, with probably tens of thousands of files. You don’t want to be doing this! Yes, I have done this accidentally in the past.
Finally we have ‘public_html/’ at the end of the command. This is the directory where you want to install Hotaru to. In my case I had previously changed my working directory to just above the web root, and I want to install Hotaru in the public_html folder.
Once you enter the command the files will be downloaded and you can run the install as normal from example.com/install/install.php
Updating Hotaru with svn
The process for updating your installation with subversion is very similar.
Just do :
svn update http://my-svn.assembla.com/svn/HotaruCMS/trunk public_html/
and run example.com/install/upgrade.php – that’s it!
So now that you know this, I hope I will save you the hassle of downloading the source .zip, unpacking and uploading everytime there is a Hotaru version update.