Search

User Manual

GETTING STARTED


MODULES AND PLATFORM


APPENDIX


TUTORIALS & HELPFUL TRICKS


GLOSSARY


STRATEGIC PARTNER LINKS

Sepasoft - MES Modules
Cirrus Link - MQTT Modules

RESOURCES

Inductive University
Ignition Demo Project
Knowledge Base Articles
Forum
IA Support
SDK Documentation
SDK Examples

ALL USER MANUAL VERSIONS

Ignition 8.1
Ignition 7.9
Ignition 7.8

Deprecated Pages

Skip to end of metadata
Go to start of metadata



Windows

For a new installation from a ZIP file, do the following:

  1. Unzip the contents of the ZIP file. Wherever this file in unzipped is where Ignition will be installed so be sure to unzip this file in a suitable location. For this example, I placed my zip file contents in "C:\Program Files\Inductive Automation\Ignition\" which is the default Windows installation directory for Ignition.
  2. Once your file contents are unzipped in a suitable location, run the executable file named install-ignition.bat to install the Windows service like below:



  3. Similarly, run the executable file named start-ignition.bat to start the Ignition service. 
  4. Navigate to the Gateway's web interface ( http://localhost:8088) to start the commissioning process. If any errors occur during startup, they will be logged to logs/wrapper.log 


On this page ...

Upgrading an Existing Installation

If you are upgrading from a preexisting installation, follow these steps:

  1. Take a Gateway backup from the running system and store in a safe location.
  2. Stop Ignition by runing the stop-ignition.bat file located in the Ignition installation directory. 



  3. Delete both the lib and webserver\webapps folders.
  4. Unzip the ZIP installer for the version you're upgrade to into the current folder and allow files to be overwritten.
  5. Unzip the new jre-win runtime in lib\runtime folder. 
  6. If this is a major version upgrade (such as 8.0 to 8.1) then the data/ignition.conf file may have changed. If this is a minor version upgrade (8.0.1 to 8.0.2) then skip to step 8.

  7. To upgrade the ignition.conf file for a major version upgrade, run the following from command line in the ignition folder:

    lib\runtime\jre-win\bin\java.exe -classpath "lib/core/common/common.jar" com.inductiveautomation.ignition.common.upgrader.Upgrader . data logs file=ignition.conf
  8. Start Ignition. Run start-ignition.bat

At this point, the Gateway will start, completing the upgrade. 


Linux (Including ARM)

The following feature is new in Ignition version 8.0.15
Click here to check out the other new features

As of 8.0.15, 64-bit zip installers are available for ARM machines.


For a new installation from a ZIP file, do the following:

  1. Unzip the contents of the ZIP file. Wherever this file in unzipped is where Ignition will be installed, so be sure to unzip this file in a suitable location. Below, you can see the contents of the zip file in /user/local/bin/ignition which is the default Linux installation directory for Ignition.



  2. Open up a terminal command, navigate to the directory where you unzipped the installer and make the ignition-gateway file and all .sh files executable. You can run the following commands: 

    chmod +x ignition-gateway
    chmod +x *.sh
  3. Execute  ignition.sh

    ./ignition.sh start

That's it. You can navigate to the Gateway's web interface ( http://localhost:8088 ) to start the commissioning process. If any errors occurred during startup, they'll be recorded in logs/wrapper.log file. 

You can also add the unzipped folder to your system PATH by adding the folder path to a file such as .profile or .bashrc. This allows you to start programs like the Gateway Command-line Utility from the command line without specifying a complete path to the unzipped folder.

Upgrading and Existing Installation

If you are upgrading from a preexisting installation, follow these steps:


  1. Take a Gateway backup from the running system and store it in a safe location. 
  2. Stop your Ignition service. Open a terminal window and navigate to your Ignition installation directory (/user/local/bin/ignition is the default install directory location and it is also the location we use in the installation steps above) and run the command below: 

    ./ignition.sh stop



  3. Delete both the "lib" and "webserver/webapps" folders. 
  4. Unzip the contents of the new zip installer into the current directory and allow files to be overwritten 
  5. Set the executable permission on all .sh files in the unzipped folder by running this command: 

    chmod +x *.sh
  6. Unzip the new runtime: 

    tar -C lib/runtime -xf lib/runtime/jre-nix.tar.gz
  7. If this is a major version upgrade (8.0 to 8.1) then the data/ignition.conf file may have changed. If this is a minor version upgrade (8.0.1 to 8.0.2) then skip to step 8.
    To upgrade the ignition.conf file for a major version upgrade, run the following from command line in the ignition folder, run the following: 

    lib/runtime/jre-nix/bin/java -classpath "lib/core/common/common.jar" com.inductiveautomation.ignition.common.upgrader.Upgrader . data logs file=ignition.conf
  8. Start Ignition. Run: 

    ./ignition.sh start


Mac

For a new installation from a ZIP file, do the following:

  1. Open up Terminal.app and change directories to the same directory the ZIP install is located. If you downloaded to your desktop then it would be:

    cd ~/Desktop
  2. Become root:

    sudo su
  3. Unzip Ignition (Replace X.X.X with the actual build number). This unzips the contents of Ignition-osx-X.X.X.zip in /usr/local/ignition which is the default MAC OS installation directory for Ignition.

    unzip -d /usr/local/ignition Ignition-osx-X.X.X.zip
  4. Change directory to the directory where you unzipped the contents of the zip installer or /usr/local/ignition in this example. 

    cd /usr/local/ignition


  5. Make the make the following files executable:

    chmod +x *.sh
    chmod +x ignition-gateway
  6. Create a symlink in /usr/local/bin

    cd /usr/local/bin
    
    ln -s /usr/local/ignition/ignition.sh ignition
  7. You can now start Ignition from Terminal.app using the starting and stopping commands listed above. Start Ignition with:

    ignition start

    That's it. You can navigate to the Gateway's web interface ( http://localhost:8088 ) to start the commissioning process. If any errors occurred during startup, they'll be recorded in logs/wrapper.log file. 

    You can also add the unzipped folder to your system PATH by adding the folder path to a file such as .profile or .bashrc. This allows you to start programs like the Gateway Command-line Utility from the command line without specifying a complete path to the unzipped folder.

Upgrading Existing Installation

If you are upgrading from a preexisting installation, follow these steps:

  1. Take a Gateway backup from the running system and store in a safe location.
  2. Stop Ignition. Run:

    ignition stop



  3. Delete both the lib and webserver/webapps folders.

  4. Unzip the new ZIP into the old Ignition directory, allowing files to be overwritten.
  5. Set the executable permission on all .sh files and the ignition-gateway file: 

    chmod +x *.sh
    chmod +x ignition-gateway
  6. Unzip the new runtime:

    tar -C lib/runtime -xf lib/runtime/jre-mac.tar.gz
  7. If this is a major version upgrade (8.0 to 8.1) then the data/ignition.conf file may have changed. If this is a minor version upgrade (8.0.1 to 8.0.2) then skip to step 8.
    To upgrade the ignition.conf file for a major version upgrade, run the following from command line in the ignition folder, run the following:

    lib/runtime/jre-mac/bin/java -classpath "lib/core/common/common.jar" com.inductiveautomation.ignition.common.upgrader.Upgrader . data logs file=ignition.conf
  8. Start Ignition. Run:

    ignition start
  • No labels