Skip to content

Upgrading from legacy versions

Tom Taylor edited this page Oct 19, 2017 · 4 revisions

These instructions are intended for users of authoring tool versions v0.1.1 and below. If you're using a newer version, please see this page for more information.

Upgrading from releases between v0.1.2 and v0.3.0

Upgrading installs between v0.1.2 and v0.3.0 is usually a fairly painless process, and will just require running through the upgrade script using node upgrade and answering the prompts as necessary.

An important thing to note with these releases is that the upgrade process has no safeguard against upgrading to breaking 'major' releases of the framework or authoring tool. For this reason, we advise that you backup first, and upgrade to v0.4.0+ asap.

Upgrading from version v0.1.1 and Framework v1.x.x

When you run node upgrade.js, node reports that there're updates available for both the authoring tool and the framework, but nothing happens when you pressed the enter key to continue.

Make sure you're using node version at least v4.2.2, run the following commands:

  • git pull to pull the latest code to your local machine;
  • Then remove the node_modules directory;
  • Run npm install --production to install dependencies;
  • Run node upgrade.js to install the latest adapt framework; A prompt will ask you if you'd like to continue. If you would, simply press the enter/return key to accept the default of "(Y)".
  • Run grunt build:prod to build the web application;
  • Run node server launch the server; or if it is already running, refresh the page in the browser.

Upgrading from pre-v0.1.1 versions

If node server does not report the versions of your authoring tool and framework, it is unlikely that you are running version 0.1.1. In this case, we encourage you to upgrade asap. Upgrading does not affect the database.

To enable automatic checks for newer versions, open a console/terminal and navigate to the authoring tool root folder—the same directory where you run node server. Run the following command:
git pull
Then run:
npm install

From now on, running node server will check for a newer version. Since you have not yet upgraded, you should expect that the next time you run node server you will be informed that an upgrade is available. If you'd like to upgrade follow the instruction at the top of this page.

Clone this wiki locally