Upgrading Ignition

tip

Upgrading from 7.6 or earlier?

Please read this upgrade guide: Ignition 7.7 Upgrade Guide

Choose your operating system for detailed instructions on upgrading Ignition.

Windows

Before you upgrade Ignition...

You should backup your Gateway, see Gateway Backups.

​

Upgrading Ignition on Windows

Watch the video

The Ignition installer also doubles as an upgrader, thus upgrading Ignition is very similar to downloading a new version and installing from scratch. You can see your current Ignition version by looking in the Status page of the Gateway.

To Upgrade Ignition on Windows

1. Simply download the Windows executable installer from our website, and double-click on the executable installer.

   A window is displayed asking you Continue with upgrade?

   note

   Make sure you download the 32-bit installer for a 32-bit Windows installation, and the 64-bit installer for a 64-bit Windows installation. If you attempt to upgrade a 32-bit installation with a 64-bit installer, or vice versa, you will get an error message.

2. Click Yes to start the upgrade process.

3. Accept the license agreement. The Upgrade Mode window is displayed.

4. You choose either:
   No, just upgrade currently installed modules
   The Ignition base installation and the existing modules are upgraded.
   
   Or you can choose:
   Yes, let me choose which modules to add or remove
   The Select Components window is displayed and you can then add a module that was not part of the original installation or uninstall/remove a currently installed module. You can view a brief description of each module by clicking on the module name. Selecting the check box next to a module installs the module as part of the upgrade.Clearing the check box next to a module uninstalls the module during the upgrade.

5. Click Next. The Ready to Install window is displayed.
   Ignition is ready to be upgraded. At this point, you may click Back to change your selections.

6. Click Next to finish the upgrade. Once the upgrade process starts, it may take a few minutes to finish. At the end of the upgrade process, the Setup window is displayed letting you know that Setup has finished installing Ignition on your computer.

7. Select the check box for Start Ignition now and click Finish.

A splash screen displays informing you that the Ignition service is starting. Once the Ignition Gateway starts up, your web browser opens and brings you to the Gateway Homepage.

You can go back and check the Status page of the Gateway to see that a new version of Ignition is now installed.

Automated Upgrading

You can silently upgrade Ignition from a command shell without showing any user prompts. Remember to make a Gateway backup before performing any type of upgrade. Also, the installer cannot automatically start the Gateway after a silent upgrade.

Use the net start ignition command as shown below.

Command line example

gwcmd -b C:\backups\mybackup.gwbk

Ignition-7.x.x-windows-x64-installer.exe --mode unattended --unattendedmodeui none --autoupgrade true

net start ignition

Flags

• -- mode unattended (ensures that no prompts appear during installation)
• -- unattendedmodeui none | minimal (the none flag does not display any sort of graphic during installation; the minimal flag displays a small progress bar and nothing else)
• -- autoupgrade true (disables any Are you sure? prompts when running the upgrader so that a user can run an automated upgrade without any user interaction)

Mac OS X

Before you upgrade Ignition...

You should backup your Gateway, see Gateway Backups.

​

Upgrading Ignition on Mac OS X

Watch the video

1. From Gateway, go to Configure > Backup / Restore.

2. Click on Download Backup to back up the entire project from the existing installation. The .gwbk backup file is created in the Downloads folder.

3. Shut down Ignition by typing the following from the command-line: /usr/local/bin/ignition stop

4. Move the existing installation folder somewhere else.

5. Unzip the new installation and place it in the location of the old installation.

6. Start the new installation.

   /usr/local/bin/ignition start

7. Go to Configure > Backup / Restore and click Restore to perform the restoration.

Linux

Before you upgrade Ignition...

You should backup your Gateway, see Gateway Backups.

Also, you need to be able to run as ROOT (prefix everything with sudo, run sudo su, or login as root user) to perform the upgrade.

​

Upgrading Ignition on Linux

Watch the video

Unlike some Linux operations, the Ignition Linux upgrade process is designed to be as simple as possible. Note that while Ignition is currently optimized for Ubuntu Linux, the upgrade process will work for any Linux distribution.

The Ignition installer also doubles as an upgrader, thus upgrading Ignition is very similar to downloading a new version and installing from scratch. You can see your current Ignition version by looking in the Status page of the Gateway.

To Upgrade Ignition on Linux

1. Simply download the Linux executable installer from our website, and double-click on the executable installer.

   note

   Make sure you download the 32-bit installer for a 32-bit Linux installation, and the 64-bit installer for a 64-bit Linux installation. A 32-bit installer does not launch in a 64-bit system and vice versa.

2. After downloading the installer, open a command shell and navigate to the installer executable.

3. Run chmod 744 *

4. Then run ./ignition_X.X.X-installer.run

   1. If you are running the installer in a shell in a graphical environment, the graphical installer opens automatically.
   2. If you are running the installer in a headless Linux installation, or through a SSH shell, the text installer opens automatically.
   3. If you want to run the text installer in a graphical environment, add --mode text to the end of the above command.

   The installer starts running.

5. Agree to the licensing terms and click Forward. The Installation Directory window is displayed.

6. Click Forward to accept the default installation directory.
   Linux does not have the concept of a central registry like Windows systems do. Therefore, you must provide the location of the existing Ignition installation. By default, this value is /usr/local/bin/ignition, unless you have installed Ignition in another location.

7. In the Question window, click Yes to continue. This Question window is displayed when the upgrader was able to locate Ignition in the specified folder. After you click Yes, the Upgrade Mode window is displayed.

8. You choose either:
   No, just upgrade currently installed modules
   The Ignition base installation and the existing modules are upgraded. This is the choice for most scenarios.
   

   Or you can choose:
   Yes, let me choose which modules to add or remove
   The Select Components window is displayed and you can then add a module that was not part of the original installation or uninstall/remove a currently installed module.

   In graphical mode, you can view a brief description of each module by clicking on the module name. Selecting the check box next to a module installs the module as part of the upgrade. Clearing the check box next to a module uninstalls the module during the upgrade.

   In text mode, a list of all the modules is displayed, one at a time. Type y to install or upgrade the module, and type n to uninstall the module.

9. Ignition is ready to be upgraded. At this point, you can click Back (graphical mode) to change your selections, or you can only abort the upgrade at this point (text mode) by typing n.

10. To finish the upgrade, click Next (graphical mode) or type y (text mode).

11. When the upgrade is complete, click Finish (graphical mode) or type y to start Ignition or n to exit (text mode).

    If the box for Start Ignition now was selected, Ignition starts as a background process.

12. Use a web browser and go to http://localhost:8088 to confirm that your Gateway is running. For instructions on how to stop or start Ignition, see Installing Ignition.

Automated Upgrading

You can silently upgrade Ignition from a command shell without showing any user prompts. Remember to make a Gateway backup before performing any type of upgrade. Also, the installer cannot automatically start the Gateway after a silent upgrade.

Use the /etc/init.d/ignition start command as shown below.

Command line example

gwcmd -b /var/backups/mybackup.gwbk

sudo ./ignition-7.x.x-linux-x64-installer.run --mode unattended --unattendedmodeui none --autoupgrade true


/etc/init.d/ignition start

Flags

• -- mode unattended (ensures that no prompts appear during installation)
• -- unattendedmodeui none | minimal (the none flag does not display any sort of graphic during installation; the minimal flag displays a small progress bar and nothing else, but only if you are working in a graphical system)
• -- autoupgrade true (runs the installer in upgrade mode)