Enabler Upgrades

Where Do I Get The Upgrade Files From?

Note: When a new version is released, clients will be notified via email. We recommend internal testing of the new version in a test environment prior to upgrading stores in the live environment.

Note The Head Office branch MUST be upgraded prior to upgrading stores

Downloading upgrade packs from the web site

Browse to our website: www.magentaretail.com.au and select Support then Downloads.

The Downloads page will contain the latest upgrade and install packs and relevant documentation.

Clicking on the title of the upgrade pack will enable the file to be opened or downloaded.

Click on save to download upgrade packs to a local directory.

The upgrade version and type of upgrade can be identified by the file name.

The auto upgrade pack is a zip file and identified by the file name starting with _u ie: _u406602.zip. Do NOT extract this file. The upgrade file is copied to branches and Enabler executes the upgrade process as a scheduled task. Nibbler must be running on all tills in the branch during upgrade process. Refer to the Auto upgrade checklist section for further details

A manual Upgrade file should be extracted and the upgrade is executed via a command prompt manually. All Enabler applications including nibbler must be shut down prior to running the upgrade command. The upgrade process only upgrades the till it’s being run on. Refer to the manual upgrade section for further details

Note: If you are looking for a specific version of Enabler other than the latest release, please contact Magenta Support and we will provide details for downloading required version.

Manual Upgrade

It is preferred that the manual upgrade process is applied on Head Office Server and tills (nodes). It can also be used for upgrading store servers/tills that cannot be upgraded automatically due to network issues etc or new tills that are being added/ rebuilt.

Note: If the Head Office branch is upgraded using the auto upgrades pack nibbler must be running on the Head Office server and on ALL Head Office nodes at the scheduled time of the upgrade. A backup of the enabler folder is suggested prior to running an upgrade.

How do I install the Manual Upgrade?

1. Download the manual upgrade package and unzip into an empty folder

   Note: In the examples provided, the manual upgrade pack has been unzipped into a folder called MAGENTA on the C: drive. This folder has also been shared as 'Magenta'.

2. Close ALL Enabler applications including Nibbler
3. Open a command prompt and go to the Enabler folder. EG: C:\Users\POS> cd\enabler
4. Enter the following command and press Enter to run the upgrade

   c:\magenta\upgrade c:\magenta\ 

   Note: Ensure you include the '\' on the end

5. The following screen will be displayed:

   

6. Press <enter> to start the upgrade
7. The upgrade should complete with no errors. If you have any errors, refer to the section investigating upgrade issues within this document

Note: The Head Office server and tills must always on be the same or a greater version to that of the stores. All machines in a branch environment must run the same version of enabler.

How do l manually upgrade the tills (nodes) across the network?

1. As per the previous details, unzip the upgrade package to a folder on the Head Office or Store Server
2. On the tills (nodes) close ALL Enabler applications including Nibbler
3. Open a command prompt and go to the enabler folder. EG: C:\Users\POS> cd\enabler
4. Enter the following command to run the upgrade

   \\ServerName\magenta\upgrade \\ServerName\magenta\ 

   Note: Ensure you include the '\' on the end

   Note: Replace 'ServerName' with the name or IP Address of your Head Office or Store Server

5. Press <enter> to start the upgrade
6. The upgrade should complete with no errors. If you have any errors, refer to the section investigating upgrade issues within this document