Dashboard
Activity Stream
Audio Library
Blog
Bookmark Directory
Discussions Board
Event Calendar
File Repository
Image Gallery
Status Log
Video Library
Home
cyn.in Help
Cyn.in license
Enterprise Support
Supported Browsers
Web Links
cyn.in Homepage
Cynapse Homepage
Cynapse Community
Wiki Page
Upgrade Cyn.in 3.x Community Appliance
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". :)
Please feel free to edit when you see places where you can contribute, just put a changelog note, there's no need to even add a regular comment. We can always find out what the changes were, using the version diffing.
If you ever have specific proof-reading needs, let me know.
How did you upgrade? Like above, or you did it via apt-get update && apt-get upgrade?
Also did you click the ugprade webmin button by mistake?
Are you sure you're typing https and not http ?
Correct URL: https://<sitedomain or IP address>:10000
There could be several reasons / problems why this could/would happen and a screenshot will tell us exactly what you're seeing.
Are you logged out and halfway-partially through the Anonymous setup guide, by any chance? Just a thought. :)
http://www.cynapse.com/[…]/
http://www.cynapse.com/[…]/
http://www.cynapse.com/[…]/
Test this: Go to one of the Spaces that's not appearing in the navigation UI and edit and save it, no need to change anything there if you don't want to. Navigate one more time (to anywhere) and see if the Space shows up. If the edited Space now shows up, you've found the problem.
Login with the admin user (no, not siteadmin) and go to this URL:
http://<yoursitedomain or IP Address>:8080/cynin/portal_catalog/manage_catalogAdvanced and press the Clear and Rebuild button.
This re-indexes all items in your Cyn.in site, and will take a *long* time if you've got a lot of items. Wait.
When it get's done, hit Ctrl + F5 on your site home and it should show all the missing stuff.
Is anybody else having this problem?
Site Error
An error was encountered while publishing this resource.
Resource not found
Sorry, the requested resource does not exist.
Check the URL and try again.
Resource: csi:10000 GET
Troubleshooting Suggestions
* The URL may be incorrect.
* The parameters passed to this resource may be incorrect.
* A resource that this resource relies on may be encountering an error.
For more detailed information about the error, please refer to the error log.
If the error persists please contact the site maintainer. Thank you for your patience.
Anyways, go to the command line console for your Cyn.in appliance and login with the root user, and try this:
apt-get update
apt-get purge webmin
apt-get purge cyninwebmin
apt-get install cyninwebmin
Try this on command line console with root logged in:
cd /etc/apt
nano sources.list
This opens up the command-line editor for the apt sources. Check if updates.cynapse.com has a # prepended before it. Sometimes, especially during the system installation from the CD, if the apt repository cannot be contacted, it gets automatically disabled by the system.
If you find the # on the updates.cynapse.com line, remove it (del key), press Ctrl + X, press y and press enter to save and exit.
Next you do the apt-get update again and try to apt-get install cyninwebmin again.
Are you using the Cyn.in ISO CD to install or are you doing buildout?
Please paste the contents of the file into a comment here, or add it as a file in sandbox area and put a link to it, here.
You cannot *not* have that entry at all in your sources.list if you installed from the CD.
# deb cdrom:[Ubuntu-Server 9.04 _Jaunty Jackalope_ - Release i386 (20090421.1)]/ jaunty main restricted
# deb cdrom:[Ubuntu-Server 9.04 _Jaunty Jackalope_ - Release i386 (20090421.1)]/ jaunty main restricted
# See http://help.ubuntu.com/community/UpgradeNotes for how to upgrade to
# newer versions of the distribution.
deb http://sg.archive.ubuntu.com/ubuntu/ jaunty main restricted
deb-src http://sg.archive.ubuntu.com/ubuntu/ jaunty main restricted
## Major bug fix updates produced after the final release of the
## distribution.
deb http://sg.archive.ubuntu.com/ubuntu/ jaunty-updates main restricted
deb-src http://sg.archive.ubuntu.com/ubuntu/ jaunty-updates main restricted
## N.B. software from this repository is ENTIRELY UNSUPPORTED by the Ubuntu
## team. Also, please note that software in universe WILL NOT receive any
## review or updates from the Ubuntu security team.
deb http://sg.archive.ubuntu.com/ubuntu/ jaunty universe
deb-src http://sg.archive.ubuntu.com/ubuntu/ jaunty universe
deb http://sg.archive.ubuntu.com/ubuntu/ jaunty-updates universe
deb-src http://sg.archive.ubuntu.com/ubuntu/ jaunty-updates universe
## N.B. software from this repository is ENTIRELY UNSUPPORTED by the Ubuntu
## team, and may not be under a free licence. Please satisfy yourself as to
## your rights to use the software. Also, please note that software in
## multiverse WILL NOT receive any review or updates from the Ubuntu
## security team.
deb http://sg.archive.ubuntu.com/ubuntu/ jaunty multiverse
deb-src http://sg.archive.ubuntu.com/ubuntu/ jaunty multiverse
deb http://sg.archive.ubuntu.com/ubuntu/ jaunty-updates multiverse
deb-src http://sg.archive.ubuntu.com/ubuntu/ jaunty-updates multiverse
## Uncomment the following two lines to add software from the 'backports'
## repository.
## N.B. software from this repository may not have been tested as
## extensively as that contained in the main release, although it includes
## newer versions of some applications which may provide useful features.
# deb cdrom:[Ubuntu-Server 9.04 _Jaunty Jackalope_ - Release i386 (20090$
# See http://help.ubuntu.com/community/UpgradeNotes for how to upgrade to
# newer versions of the distribution.
deb http://sg.archive.ubuntu.com/ubuntu/ jaunty main restricted
deb-src http://sg.archive.ubuntu.com/ubuntu/ jaunty main restricted
## Major bug fix updates produced after the final release of the
## distribution.
deb http://sg.archive.ubuntu.com/ubuntu/ jaunty-updates main restricted
deb-src http://sg.archive.ubuntu.com/ubuntu/ jaunty-updates main restric$
## N.B. software from this repository is ENTIRELY UNSUPPORTED by the Ubu$
## team. Also, please note that software in universe WILL NOT receive any
## review or updates from the Ubuntu security team.
deb http://sg.archive.ubuntu.com/ubuntu/ jaunty universe
## Also, please note that software in backports WILL NOT receive any review
## or updates from the Ubuntu security team.
# deb http://sg.archive.ubuntu.com/ubuntu/ jaunty-backports main restricted universe multiverse
# deb-src http://sg.archive.ubuntu.com/ubuntu/ jaunty-backports main restricted universe multiverse
## Uncomment the following two lines to add software from Canonical's
## 'partner' repository.
## This software is not part of Ubuntu, but is offered by Canonical and the
## respective vendors as a service to Ubuntu users.
deb http://archive.canonical.com/ubuntu jaunty partner
deb-src http://archive.canonical.com/ubuntu jaunty partner
deb http://security.ubuntu.com/ubuntu jaunty-security main restricted
deb-src http://security.ubuntu.com/ubuntu jaunty-security main restricted
deb http://security.ubuntu.com/ubuntu jaunty-security universe
deb-src http://security.ubuntu.com/ubuntu jaunty-security universe
deb http://security.ubuntu.com/ubuntu jaunty-security multiverse
deb-src http://security.ubuntu.com/ubuntu jaunty-security multiverse
Download the new source snapshot, extract it in a new folder, and copy the Data.fs from your existing current buildout into the same location (var/filestorage) in your new buildout - make the folder chain if it doesn't exist already. Take care to stop your existing buildout so that users cannot add data to it to while you're upgrading.
Do your buildout again in the location, and then re-install ubify.policy product from portal_quickinstaller screen, this will automatically migrate all your existing data and you can use this new location from then on.
So when you try to put the Data.fs I thought you might get confused as to where to put it. Looks like I went the other way and confused you more, instead of helping you out. :)
Short Answer: If you're a developer or need to have buildout for adding/testing other products -> do a buildout from source snapshot, like you're doing. No Webmin. No auto-upgrades.
If you're not interested in any of the above, then you're better off installing from the CD as you get peace-of-mind, automatic upgrades and much less headaches. ============================
Long Answer:
Webmin is for administering the appliance CD that we package. What you're using is the snapshot source which only has the buildout. This is intended for the developer audience who are already comfortable with the command line way.
The apt-get repository based upgrading of Cyn.in is currently only available for installations that have been installed from the Cyn.in ISO CD (through Webmin or command line, the operation is the same). If you try it on any other OS, the results are completely unpredictable as we ourselves have not attempted this yet.
If you're interested in just Webmin itself, it is available for all linux distros, just google it. Note that getting Webmin on your OS does not mean that you'll be able to upgrade Cyn.in that way, you need to have the updates repository installed, and that is definitely not recommended for any other OS than the one we're packaging on the CD. Note that even if you're running Debian 5, adding the apt-get repo URL directly on an existing Debian 5 box and apt-get installing it *may* have unpredictable results, we're making assumptions because we're adding all the required packages in the CD installation. In short, we've not tested with this scenario either.
Even in buildout source scenario, your data migration forward path will be retained, you'll just manually have to backup your Data.fs file, manually copy it over to the new buildout that you'll make for the new source tree, do the buildout and then use the new one if everything's working fine.
Tips:
On the source server:
1. Make sure to shutdown the Cyn.in instance (./bin/instance stop) before you start copying the Data.fs file.
On the target server:
0. Shut down the Cyn.in daemon first (/etc/init.d/cynin stop) and then delete or move all files out from the /home/cynin/buildout/var/filestorage directory.
1. After you copy the Data.fs file to /home/cynin/buildout/var/filestorage remember to check the ownership on the file. It *must* belong to userid cynin, groupid anything you want, usually root. chown command is your friend. :)
2. Start the cyn.in daemon (/etc/init.d/cynin start) after you copy the file, look in /home/cynin/buildout/var/log/instance.log for problems with startup - there will usually be a lot of Translation catalog errors reported when you move a Data.fs file, this is *normal*. Just make sure the Cyn.in instance started up fine from the log.
3. At this point your Cynin instance should already be up and running fine. If you encounter problems with out-of-sync stuff like Spaces not appearing, try clearing and rebuilding portal_catalog in the Advanced tab in ZMI. Another problem solver is reinstalling the ubify.policy product.
4. Another point to note is that complete state is maintained in the Data.fs file, all users, passwords, content, configuration, *everything* is in it.
5. Backup before. Backup after. Backup often.
Do let us know how it went. :)
When you say "couldn't replace the file" -> What happens, exactly? If there's an error, what's the error?
Anyway, I managed to transfer the file using the command prompt. Now my Spaces doesn't show up even after I tried doing the clearing and rebuilding the portal_catalog. Is there any other way to do it? We managed to login using the old ID's so I guess the Data.fs file is ok.
As I was saying earlier, *all* state is maintained within the Data.fs file, if you replace it, you will no longer be able to login with "old" logins (unless they're existing in the new Data.fs file as well).
If you're comfortable with the command line, then you should probably use the command line methods to move the Data.fs around. I need to see the situation or you to give us more details for me to be able to add more ideas on what could be wrong.
From what you're saying, it's looking like the new Data.fs file has simply not gotten loaded at all!
How could I change it back to just the IP address without the ports and the folder name behind?
You have to delete or move out *all* the files in /home/cynin/buildout/var/filestorage first on target, and *then* copy over the Data.fs file from source.
Copy the cynin file from .... /etc/apache2/conf.d/cynin on the source server to the the same place on the target and restart your apache2 server (/etc/init.d/apache2 restart). If you don't have apache2 on the target, install it using apt-get or whatever you prefer.
Actually, I have a server (source) build from the snapshot which is 3.0.4 and right now I have another server which I installed using the ISO CD (target) which is 3.0.5.
On my source server, I used to key in URL http://<IP Address of source>/csi in order for me to access the cynin webpage.
On the target server, before I copy the Data.fs, I could use my Firefox to browse to the cynin page by just keying in http://<IP Address of target> to make sure everything is all right.
Right now, I want to transfer the Data.fs from source to target. I stop the instance. I did delete all the files in /home/cynin/buildout/var/filestorage and I copy in the Data.fs from source server to target server. Changed the owner of the Data.fs to cynin. Start back the instance.
Now when I use my Firefox again, when I key in the URL http://<IP Address or target> I will get a Site Error Message like below.
------------------------------------------------
Site Error
An error was encountered while publishing this resource.
Resource not found
Sorry, the requested resource does not exist.
Check the URL and try again.
Resource: cynin GET
Troubleshooting Suggestions
* The URL may be incorrect.
* The parameters passed to this resource may be incorrect.
* A resource that this resource relies on may be encountering an error.
For more detailed information about the error, please refer to the error log.
If the error persists please contact the site maintainer. Thank you for your patience.
-----------------------------------------------
But on the other hand, when I key in the URL of http://<IP Address of target>:8080/csi I could see the page already. What I need right now is that I don't want to key in the port number and also the /csi thingy just like when I newly installed from ISO CD.
It looks like you setup the 3.0.4 target with a different sitename than cynin, as per your description it looks like target had a site named "csi".
For the site name change, you will have to change your existing rewrite URLs in your apache or whatever you were using as reverse proxy. You can easily determine this by CDing to /etc/apache2/sites-available and seeing what files are there using the ls and the cat commands.
You should make a new buildout at any path, using svn tag for 3.0.5 and use that as target instead of the current 3.0.4 buildout that you have. If you made your current target using svn checkout, then you can use the "svn sw" command to update the source, try svn help sw if you don't know how to do this.
"svn info" at your target's buildout root will tell you if you have made it using checkout or give you a message like "not a working copy" or something similar.
The new checkout url for 3.0.5 is http://odn.cynapse.com/svn/cynin/tags/cynin_3_0_5 so use this to svn switch to the new source code base - this is *very* important for the migration to complete properly.
---------------------------------------------------
RewriteCond %{HTTP_HOST} ^(.+)
RewriteRule ^(.*)/(.+)\.ics(.*)$ http://<Server IP Address>:8080/csi/VirtualHostBase/http/%1:80/cynin/VirtualHostRoot/$1/@@icalendar.ics [L,P]
RewriteCond %{HTTP_HOST} ^(.+)
RewriteRule ^(.*) http://<Server IP Address>:8080/csi/VirtualHostBase/http/%1:80/cynin/VirtualHostRoot/$1 [L,P]
--------------------------------------------------
And it works! I can just key in the URL http://<Server IP Address> and it will direct me to the page but the URL will change automatically to http://<Server IP Address>:8080/csi.
That is ok with me as long as my users don't have to key in the port and also that /csi thingy.
Anyway, right now when we go to main page, it says that I do not have priviledges to see the page unless I login. Is that public access page? How do I share it to user without login?