Migration to Node 4

After two months of work, Cozy now works with Node 4!

Why should you care? This technical modification will not change the way you use it, but developers now benefits from new features. They can use the ES6, latest JavaScript version, enabling them to build better applications.

If your Cozy instance is hosted by Cozy Cloud (e.g. your instance name looks like MyNickName.cozycloud.cc), then you’re fine: our Devops team has migrated your instance and you can stop reading now.

On the other hand, if you’re running your own self-hosted version, then you now have some homework to do, which is to upgrade it to Node 4.

In order to ease the installation process, we developed a tool called cozy-management. This tool allows you to upgrade in one command line.

Before anything, you have to install this new module:

sudo sed -i 's/main/cozy/' /etc/apt/sources.list.d/cozy.list
sudo apt-get update
sudo apt-get install python-cozy-management

Classical migration (anything but Raspberry Pi 2)

cozy_management backup
cozy_management migrate_2_node4

Wait for your Cozy to be updated!

If you have any trouble, or if you host Cozy on a Raspberry Pi 2, we advise you to reinstall your Cozy following this process.

Migration of a Raspberry Pi 2 (or if you encounter an error)

The process is a bit longer, but you will have a fresh install without losing your data. The steps are the following:

  • complete backup of your Cozy data
  • creation of a new instance
  • restore the backup in the new instance

Once again cozy_management comes to the rescue.

cozy_management backup

Get the backup file which is located in /var/lib/cozy/backups/.

Keep an old image of your Cozy in case of problem. Better safe than sorry!

Install a new Cozy by following the documentation on https://docs.cozy.io/en/host/install/install-on-debian.html, https://docs.cozy.io/en/host/instal… or https://docs.cozy.io/en/host/instal….

Then restore your backup with the following command:

cozy_management restore <path-of-the-backup-file>

Again, if you have any trouble, feel free to ask for help on #cozycloud on IRC (irc.freenode.net) or email us at contact at cozycloud.cc or on our forum.