Upgrading the Adapt Authoring Tool

samumist edited this page Dec 23, 2015 · 5 revisions
Clone this wiki locally

Upgrading to a Newer Version

When you launch the authoring tool by running node server, the authoring tool automatically checks if a new version is available. If it is, a message will be displayed in the server console log informing you so. If a newer version is not available, the versions of the authoring tool and the framework that you are running will be reported in the server console.

To upgrade, open a console/terminal and navigate to the authoring tool root folder— the same directory where you run node server.

run node upgrade.js, then 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)".

This will upgrade the app to the latest version. When the upgrade is completed, run node server to launch the server; or if it is already running, refresh the page in the browser.

Upgrade from version 0.1.1 and Framework 1.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.

Authoring Tool Versions 0.0.1 and Earlier

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. We encourage you to upgrade. 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.