This how-to describes how to upgrade your appliance from an old Cyn.in 3.x version to a new one. Cyn.in has an automatic forward migration of content that will take your content and upgrade it so that everything in the new version works properly with it.
All of this guide will focus on working with the Cyn.in webmin appliance management interface. This is a web based management interface to be used for managing the Computer where Cyn.in server is installed.
Go to Cyn.in Webmin interface
Navigate to https://<your sitehost OR IP address>:10000
You will have to accept the https warning that your browser will show because the administration interface is protected with HTTPS but the certificate is self-signed. This is normal. Once the login screen appears, login with the root user whose password you set up during the CD install.
Once you login, you will see the appliance status dashboard screen.
Navigate to System -> Software Packages
This is the web based software package manager that is provided with the Cyn.in Web based appliance management interface. This is where you will find and install new upgrades on to the system.
Check if an upgrade is available
Change Upgrade Mode to Normal and choose Yes for Only show which packages would be updated.
This will show you a simulation of what would happen if you actually performed the upgrade, you'll get to see what all packages will be installed. If "cynin" is one of them, there's a Cyn.in version update available for you! If you look closer you will see what version and interation of the package will be installed.
Wait! Let's take a manual backup of the data file first
Navigate to Others -> File Manager. This is a Java applet which will let you see and manage the full directory structure and files on your server.
Navigate to /home/cynin/buildout/var/filestorage as shown, and select the Data.fs file and press the Save button. This will let you download the Data.fs file from your server. This is the main Data file for your Cyn.in installation. It's the most important file on the system and if you need to manually restore your Cyn.in site on a new computer this is the only file you will need.
Back to the Software Packages screen. Let's install for real, this time
Go back to System -> Software Packages and choose Normal upgrade mode and this time, choose No for "Only show" radio button and press the Upgrade now button.
The update will start to download and you can sit back and watch the progress.
This is normal. Yes, I know, this is weird. :)
But really it's not that bad. Plus the extra verbose log lets us help you if / when there's a problem.
In case you're worrying, or you need to troubleshoot problems by comparing with what the "normal" case is, consult this output dump for reference installation.
If you're more comfortable with the linux command line console you can do this upgrade by typing out the usual at the # prompt:
apt-get update && apt-get upgrade
After an agonizingly long wait, you should see the above screen telling you the package was installed successfully. This is good. Now you get to test if your upgrade was received and all is fine. Do this by navigating to your normal site URL, which will remain the same http://<your sitehost or IP address/ and verifying that the upgrade did indeed "take". :)