Migrating to the new version of Rotonde

As of October 17th, 2017, the first iteration of Rotonde for Beaker Browser was deprecated in favour of a new version, which aims to simplify installation & on-going maintenance of the application.

If you are currently using the old version, it's recommended that you migrate to the latest version.

This page provides details as why this deprecation has occured, and simple instructions on how you can migrate.

Note

• Migrating is not compulsory, but still recommended. Rotonde is a platform agnostic protocol, which means that it should work with any clients that can read the Rotonde specification.

• Migration is only relevant to users who are using the first iteration of Rotonde for Beaker, and wish to keep their current dat:// URL. If you are a completely new user, head straight to the setup guide.

Why?

When the first iteration of Rotonde for Beaker Browser was made public, there was no streamlined installation process. Tutorials from the community were created in order to guide new users through a developer focused installation process involving git. This also meant that in order to keep the application up-to-date, users were forced to step through another complex git driven upgrade process.

The latest revision of Rotonde for Beaker Browser fixes these two problems. Installation is now as simple as forking an existing feed, and upgrades are automatically delivered to users.

How?

• In your Terminal, navigate using cd to a parent directory you'd like to store the new version of Rotonde for Beaker Browser inside of (eg. cd ~/Sites).

• Run the following command inside that folder:

git clone https://github.com/Rotonde/rotonde-portal

• Open Beaker Browser, and navigate to your Library.

• Select your Rotonde feed in your library's left sidebar, open the dropdown menu in the top right hand corner of the page, and select Change Folder. Select the rotonde-portal folder you cloned earlier.

• Copy the portal.json and dat.json files from the old folder you just re-located your feed from, and paste/overwrite them into the new rotonde-portal folder.

• Your Library in Beaker should be asking you to review several unpublished changes. Make sure to click the blue Review Changes button, then press the green Publish button.

• Important! Any images that you have posted to your feed should be copied from your old folder's media/content/ directory, into your new rotonde-portal folder's media/content/ directory.

• Important! Any modifications you have made to your .css stylesheets in your old folder's links/ directory, should be transferred into your new rotonde-portal folder's links/custom.css file.