Sepasoft - MES Modules
Cirrus Link - MQTT Modules
Knowledge Base Articles
All User Manual Versions
When GCU is launched, the following window is displayed:
On the upper-left of the window, Status shows the state of the Tomcat web server and the Ignition Gateway web application. It is possible for the web server to be running while Gateway has failed. For example, this can occur when the Gateway has faulted on startup. You can also see the Ignition software version that is running.
On the upper-right of the window, Go to web page launches a web browser to the Gateway home page.
On the upper-right of the window, Restart restarts the Tomcat web server.
On the upper-right of the window, Reset Password lets you reset the root password of the system. Normally, this is not considered a security risk, because the GCU can only be used from the machine the software is installed on, which should be secure. However, it is important to know about this feature here so that the GCU can be removed if the machine can't be properly secured, for example when the server is also used as a client.
On the upper-right of the window, Thread Dump downloads a file with the current states of all threads in the server. Inductive Automation uses this file for troubleshooting problems.
On the upper-right of the window, Gateway Backup downloads a Gateway backup
.gwbk file to the local file system. A Save dialog opens to let you specify where you want to save the
On the lower-left of the window, Port lets the primary, non-encrypted port, used by clients to communicate with the server. You can see the ports that you are using and you can change the ports and click the Save button to save the ports to the Gateway. Note that Gateway must be restarted for the changes to take effect.
All the functions in the GCU are also available as a command-line utility for both Windows and Linux.
To run the utility, open a command shell and type:
Options are as follows:
|Creates an |
Downloads a Gateway backup
You will be prompted whether it is OK to overwrite the file if another
|Shows the usage for this command.|
|Retrieves server status and port information from the Gateway if it is running.|
|Changes the Gateway http port.|
|Changes the Gateway https port.|
|Resets the Gateway login password.|
|Restarts the Gateway.|
Restores a gateway backup (.gwbk) file.
|Performs a thread dump in the Gateway and prints the dump to the command-line.|
|Creates an |
|-w,--||Applies a |
|Automatically answers |
In Ubuntu Linux, I had to change the file /usr/local/bin/ignition/ignition.sh on line 112 from RUN_AS_USER=ubuntu to RUN_AS_USER=root to use ports 80 and 443, as you must be root to bind to a port below 1024.
how do you find gcu on a mac?
You have to open a terminal and run gcu.sh within the Ignition installation directory. The default installation location is /usr/local/ignition for OSX.