This section demonstrates the common download and installation steps for all the launcher applications. Each launcher application has an install wizard that will guide you through the installation process. The installation steps are common for all the launchers with a few exceptions depending on the operating system you're using.
For the sake of brevity, this section will focus on installing the Designer Launcher, but the steps for installing the Vision Client Launcher and Perspective Workstation are all very similar.
Work through the install wizard. There are only a handful of options in the installer:
Whether or not to create a desktop icon
The installation directory for the launcher.
If this is a first time install, the Designer Launcher wizard has an additional step. It will prompt you to select the install mode. Installing locally installs the launcher in the user's AppData\Roaming folder whereas 'all users' installs it in Program Files.
To install the Designer Launcher application, drag the Designer Launcher icon to the Applications folder.
Extract the contents of the 'tar.gz' file to your desired install location.
Navigate to your install folder, and click the 'designerlauncher.desktop' file. A message box may popup about the launcher application being an untrusted application. Click Trust and Launch.
Once the installation process reaches its end, click Finish.
Whenever an Application is launched from a Launcher, the Launcher will check to see if it needs an update. If the Gateway containing launched application is several revisions ahead of the Launcher, the Launcher will provide a popup notifying you that an update is available.
However manual upgrades can be performed. Simply download and run a new launcher installer from a more recent Ignition Gateway. During installation, simply set the installation directory to the same directory as the old launcher.
The process for adding Applications/Designers to the Designer Launcher is very similar to adding Applications to the Vision Client Launcher and Perspective Workstation. This section demonstrates how to add new Applications.
The following Designer Launcher example is used to show how to add applications for the Designer and Vision Client Launchers and the Perspective Workstation.
Once added, the new Applications will appear on the starting screen of the Launcher.
Each Launcher has its own settings. To access the settings on a Launcher, click Settings on the top right of any launcher window.
The Settings popup window will appear, listing settings for the Launcher to use. There are some shared settings, such as those under the General tab.
The following tables represent common property settings in the Designer Launcher, Vision Client Launcher and Perspective Workstation. There are a few settings that are unique to each launcher application and are addressed on the specific application launcher page.
|General Settings - for the Design Launcher, Vision Client Launcher and Perspective Workstation|
|Property Setting||Description||JSON Name|
When set, the Launcher will attempt to automatically launch the specified Application on Launcher startup. If left blank/null, an Application will not automatically start
|Logging Level||Level of logging that will be used for the launcher. Useful for our support team, but can be used to help troubleshoot problems with the launcher.|
|Multicast Address||The address that will be used to listen for multicast broadcasts from Gateways.|
|Multicast Port||The port that will be used to listen for multicast broadcasts from Gateways.|
|Auto Exit on Launch||Automatically close the launcher window when an Application is started.|
|Default Settings - for the Designer Launcher and Vision Client Launcher|
|Property Setting||Description||JSON Name|
|Timeout||Maximum number of seconds allowed for any Gateway communication. Any communication that exceeds this amount will cause the Launcher to abort and try again (if multiple retries are configured).|
The number of times the Launcher will to attempt to contact a gateway when launching an application. Available values are:
|Initial Heap||Amount of heap memory to be allocated to the application on startup.|
|Max Heap||Maximum amount of heap memory allocated to the application.|
|JVM Arguments||Arguments to append to client startup. These should start with a '-D' and be separated by semi-colons. Mostly used by our support teams to aid with troubleshooting.|
The launchers are able to trust certificates from each Gateway. Normally this is an automated process: if you launch an application from a host Gateway that requires the use of Security Certificates, the launcher will attempt to retrieve the certificate details, and ask you to trust the certificates. If you have certificates from the gateway, you can manually add them to to the launcher from the Trusted Certificates tab of the Launcher's settings by clicking the Add icon.
When the launcher is aware of security certificates, you can use the Trusted Certificates screen to delete or export the certificates with the Delete icon and click the Export icon, respectively.
The directory where the Trusted Certificates are stored is under:
When the Gateway's SSL certificates are signed by a recognized Certificate Authority, no additional configuration is required on the launcher.
There is a "three dot menu" on the applications in each of the launchers and Perspective Workstation. When you click on the three dots, a dropdown list appears. There are five options available.
Launcher Options Table
|Manage||Allows you to configure/update property settings for your application. These properties are unique to each launcher application.|
|Create Shortcut||Creates a shortcut of the application and shows up as an icon on your desktop.|
|Add to Favorites||Creates a Favorite in your application and puts it under the Favorites tab located in the upper right corner. Your application is marked with a star icon denoting a Favorite.|
|Export||Exports the application launcher and configuration settings to a JSON file. It defaults to the application name and you provide the folder path.|
|Delete||Deletes/removes the application name from the launcher application.|
# Shows a simplified user interface C:\Users\user\Downloads\VisionClientLauncherSetup.exe /CURRENTUSER /SILENT # Shows no user interface at all. C:\Users\user\Downloads\VisionClientLauncherSetup.exe /CURRENTUSER /VERYSILENT # The following option installs silently without installing a desktop shortcut C:\Users\user\Downloads\VisionClientLauncherSetup.exe /CURRENTUSER /VERYSILENT /MERGETASKS="!desktopicon"
Commands above are taken from: https://jrsoftware.org/ishelp/index.php?topic=setupcmdline
Using ALLUSERS may trigger a check from User Account Controls, so you may need administrator access for the following command to offer a truly silent installation:
Normally, each Ignition Gateway includes files for the various launchers. When you download a launcher from a Gateway, it simply streams its local launcher files. However, you can override this behavior, causing the Gateway to ignore it's local launcher files and instead download launchers from the internet. For more information, see the Gateway Configuration File Reference page.
If you simply wanted to download one of our hosted launchers, without modifying your Gateway's configuration file, you can download them directly from your web browser:
Where VERSION is the Ignition version (i.e., 8.1.0), and LAUNCHER is the name of the launcher. Launcher names are listed below.
|Launcher||Operating System||Launcher Name|
For example, the following would download an 8.1.0 version of Perspective Workstation for Windows: