The following tables describe all the properties on the Gateway Setttings.
Gateway Settings |
|---|
System Name | Is a unique name for this Ignition installation. It is used to distinguish this server from others on the network when working with multiple Ignition installations.
Caution: It is not recommended to change the Gateway's System Name after initial Gateway setup. Renaming your Gateway may break critical dependencies, affect data collection, and halt production. To see a list of features dependent on the Gateway name, click here.
|
Persist Alarms | Whether or not alarm properties such as acknowledgment should persist across Gateway restarts. |
| Homepage Redirect URL | The URL this gateway will redirect to when http://ip:port/ is visited. Can either be a relative path (e.g., /web/home), or fully qualified (e.g., https://inductiveautomation.com). |
Gateway Scripting Project | The Gateway Scripting Project is a Project in which Gateway-scoped scripts with no project affiliation can access user script libraries. |
Launch Settings |
|---|
Designer Memory | The maximum amount of memory that the Designer has access to. |
Disable Direct3D | Disables the Direct3D rendering pipeline launched clients. Direct3D can cause performance problems with XOR painting. (affects clients on Windows only) |
Disable DirectDraw | Disables the DirectDraw system for launched clients. Can be useful for some video cards that don't support DirectDraw well. (affects clients on Windows only) |
| Use Condensed Font |
The following feature is new in Ignition version 8.1.4
Click here to check out the other new features
Designers and Vision Clients will use a condensed version of the "Dialog" font for better compatibility with pre-8.0 Vision project design. (affects clients on Windows and Linux only). Defaults to false. |
Local Client Fallback Settings
Ignition provides a Local Vision Client Fallback mechanism that lets you use a Gateway running on the local machine. If the Gateway is lost, the Client can automatically retarget to a project that you specify in the local in the local Gateway.
Local Vision Client Fallback |
|---|
Enable Local Fallback | Enables a client to fall back to a project in a local Gateway if communication is lost to the central Gateway. Note that port 6501 must be open on the local machine. |
Seconds Before Failover | The number of seconds to wait before switching to the local Gateway project after communication loss. |
Fallback Project | The local project to use during fallback. |
Scheduled Backups
The Scheduled Backup Settings control the Gateway's scheduled backup system. This system is capable of automatically making a Gateway backup and storing it to the specified location, which can be a network path. When you enable this system, you must specify a destination folder. This can be a local folder, for example C:\backups or /var/backups , or a network path such as \\fileserver\backups .
The scheduled backup system works on a schedule that is specified using UNIX Crontab syntax. See the Crontab Formatting Reference page for more details.
Scheduled Backup Settings |
|---|
| Enable Scheduled Backups | Enables the scheduled backup system which automatically makes backups at a scheduled time. |
| Backup Folder | A path to a folder in which to put the scheduled backups. |
| Backup Schedule | A UNIX 'crontab' format scheduling string representing when to make the backups. |
| Retention Count | The number of backups to keep in the backup folder. |
| Filename Pattern |
The following feature is new in Ignition version 8.1.18
Click here to check out the other new features
The filename pattern used for creating scheduled and manually downloaded Gateway backups. Default pattern is ${gatewayName}_Ignition-backup-${edition}${timestamp}.gwbk. There are a few possible placeholder pattern values: | Filename Pattern | Description |
|---|
| ${os} | The operating system the Gateway is installed on. | | ${version} | The Ignition Gateway version. | | ${gatewayName} | The System Name of your Gateway. | | ${edition} | The Ignition version you are using. Standard Ignition versions will be blank. | | ${timestamp} | The current date and time at which the backup initializes. |
|
Automatic Thread Dump Settings
The following feature is new in Ignition version
8.1.13
Click here to check out the other new features
When enabled, Ignition will conduct automatic thread dumps at the specified interval when above the target CPU Usage Threshold. If the threshold is met or exceeded, a timestamped thread dump will be saved to the logs folder. When the number of thread dumps in the logs folder exceeds the Retention Count, old files will be automatically removed. The default sample rate (60 seconds) can be overridden by adding an
additional parameter to the Ignition configuration file.
Automatic Thread Dump Settings |
|---|
| Enable Automatic Thread Dumps | Enables automated thread dump generation when CPU utilization exceeds the threshold below. |
| Thread Dump Capture Interval | Number of seconds between thread dumps when utilization threshold+duration is met. |
| CPU Usage Threshold | CPU Usage Threshold (%) that when exceeded for a given duration (below) will trigger a thread dump capture. |
| CPU Usage Exceedance Duration | Duration (seconds) during CPU Usage Threshold exceedance to delay a thread dump capture. |
| Retention Count | The number of thread dumps to keep in the logs folder. |
Error Reporting
When an error occurs in the Client or Designer, the users can click a link on the Details tab to report the error via email.
These settings define how the errors are reported.
Error Reporting |
|---|
| SMTP Server | When not blank, user-reported errors are emailed using this SMTP server. |
| To Address | The email address(es) that will receive the error notification. Separate multiple email addresses with a semicolon (;) |
| From Address | The email address that the error notification is from. |
| SMTP Username | A username for the SMTP server, if required. |
| Change Password? | Check this box to change the existing password. |
| Password | A password for the SMTP server, if required. |
| Password | Re-type password for verification. |
Multicast Settings
These properties allow the Gateway to broadcast information about itself via multicast UDP packets. This allows the Gateway to be discoverable by any components that are also listening to the same multicast address. For example, native client launchers listen on a multicast address to provide a list of available Gateways on the network. Verify that the send ports and receive ports are open on the Gateway machine in order to be able to broadcast multicast message.
Multicast Settings |
|---|
| Enable Multicast | Allows this Gateway to be discoverable on your local network. |
| Multicast IP Address | Gateway messages are broadcast on this address. |
| Send Port | This port must be open on this machine to send multicast messages. |
| Receive Port | This port must be open on any machine that will receive multicast messages. |
| Message Interval | The interval in milliseconds at which multicast messages will be sent. |
