To Download and Install Ignition on Linux

1. Go to the Inductive Automation website at
   www.inductiveautomation.com

2. Select Download > Current Release.
   

3. On the Ignition Downloads page, scroll down to System Installers and select the
   ignition-X.X.X-linux-x64-installer.run installer.
   If your computer runs on a 32- bit Linux, select the ignition-X.X.Xlinux-32-installer.run.

   

   Note: If you choose the wrong installer, an Error window is displayed letting you know the correct installer to use for your machine.
   The installers can run in both graphical or command-line mode, allowing Ignition to install on a headless Linux server. The installer will install files in the following locations:
   
   /usr/local/bin/ignition
   (unless a different installation directory was used) – contains binaries, startup scripts and the uninstall executable
   
   /var/lib/ignition/data
   contains application-generated files, temporary files and the internal database
   
   /var/lib/ignition/user-lib
   contains modules and JDBC jars
   
   /var/log/ignition
   contains the wrapper.log and other log files
   
   /etc/ignition
   contains configuration files. Symbolic links to these files are created in
   
   /var/lib/ignition/data

4. You must run all the commands as root. Prefix everything with sudo or first run

   sudo su

5. If Java 8 is not already installed, run the following commands to install it:

   sudo add-apt-repository ppa:webupd8team/java

   sudo apt-get update

   sudo apt-get install oracle-java8-installer

6. Open a command shell and navigate to the installer executable, by running the following command from the command line:

   sudo chmod +x ignition-x.x.x-linux-xxxinstaller.run

7. Start the installer executable.
   The installer can run in a graphical mode or command line mode.
   If you are running the installer in a shell in a graphical environment, the graphical installer opens automatically.
   If you are running the installer in a headless Linux installation or through an SSH shell, the text installer opens automatically.
   To start the text installer in a graphical environment, run the following command:

   sudo ./ignition-X.X.X-linux-xxx-installer.run --mode text

8. Agree to the licensing terms.

9. Ensure the installation directory is the default directory at:
   /user/local/bin/ignition

   
   

10. Specify the user name under which Ignition is to be installed. For Ubuntu installations, the user that invoked sudo is used by default. For other Linux installations, this field is initially blank.
    
    The Linux installer requires a user name to set the permissions on the folders created by the installer. This user is then able to start and stop Ignition, run the Gateway Control Utility, and the command line interfaces.
    
    The binaries in the installation folder are still owned by root and cannot be modified without root access. The selected user must already exist on the system before starting the installer.

    
    

    Normally, the installer is capable of auto-detecting a Java 8 installation that has been installed through APT or some other Linux package management tool. In these cases, the installer uses that Java installation and skips this step.
    
    However, if you have installed Java by extracting the Java binaries to a folder and adding them to the system PATH, the installer is unable to find the Java binaries. You must provide the installer with a full path to the Java executable.

11. If the Java Installation window is displayed, type the full path to the Java executable.

    
    

12. Select either the Typical or the Custom installation mode.
    
    The Typical mode installs everything that you need to get started.
    
    The Custom mode lets you add optional modules, such as the OEE Downtime module. It also lets you control and select which modules get installed.

    
    

    If you select Custom Mode, the Select Components window is displayed.
    
    • In Graphical mode to view a brief description of the module, click on the module name. Selecting the check box next to a module installs the module as part of the Ignition installation. Clearing the check box next to a module prevents the module from being installed.
    
    • In Text mode a list of all the modules are displayed one at a time. Type y to install the module, and type n to prevent the module from being installed.

    
    

    Ignition is now ready to be installed. At this point, you can click the Back button (graphical mode) to change your selections. For the text mode, you can only abort the installation at this point by typing n.

13. Click Forward (graphical mode) or type y (text mode) to finish the installation.

    
    

14. When the installation is complete, click Finish (graphical mode) or type y to start Ignition (text mode).
    Ignition is started as a background process.

    
    

Once the Ignition Gateway starts up, your web browser opens and brings you to the Gateway home page at http://localhost:8088.

Ignition Service

Automated Installation on Linux

You can automate Ignition installation across different machines using scripts. Ignition is then installed silently from a command shell without showing any user prompts.

Keep in mind that the installer cannot automatically start the Gateway after a silent installation. Use the /etc/init.d/ignition start command as shown in example below.

Command line example

Flags

-- mode unattended (ensures that no prompts appear during installation)
-- prefix /somefolder/bin/ignition (optional flag; if a value is set, then Ignition is installed in the specified folder, otherwise Ignition is installed in /usr/local/bin/ignition by default)
-- serviceuser username (allows a Linux system user to be installed (that is, a user that cannot log in to the OS))
-- 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)

Uninstalling Ignition on Linux

During a new Ignition installation, an uninstaller executable is created.

When Ignition is uninstalled, the settings database and folder in /data is backed up to /data_<current date>, and modules and user-supplied JDBC jars in /user-lib are backed up to /user-lib_<current date>. Also, the Ignition service is removed from Ubuntu Linux installations automatically.