Search

User Manual

GETTING STARTED


MODULES AND PLATFORM


APPENDIX


TUTORIALS & HELPFUL TRICKS


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

Employees

Sign In

Skip to end of metadata
Go to start of metadata


Command Line/Terminal

Clients can be launched from the Client Launcher via command/terminal. When called in this way, many of the application properties may be overridden for the one call. The overrides use the same property names as noted in the Application Property Reference Table, under the "JSON name" column.

Windows: 
"C:\ClientLauncher\visionclientlauncher.exe" application=myproject window.mode=window
 
Linux: 
./visionclientlauncher.sh application=myterminal window.mode=fullscreen screen=0 

There are a few important notes when using the Command Line/Terminal to launch a project from the Vision Client Launcher. 

  • The Vision Client Launcher must be installed and have an application added for the Command Line/Terminal commands to work.
  • The application argument requires the application name in the Launcher, not the project name. You can open the launcher to determine what the application name is. Adding new applications in the launcher uses the Project title by default.
  • Applications may contain spaces in their name. However, when launching from command/terminal, spaces should be escaped with %20. For example, if our application was named my project, then we could all it with the following:

    "C:\ClientLauncher\visionclientlauncher.exe" application=my%20project

On this page ...


Command Line Arguments

ArgumentDescription
application
The name of the application to launch.
window.mode

Controls the client mode. Available options are:

  • window : Launches the client in Windowed Mode
  • fullscreen : Launches the client in Fullscreen Mode
screen

The screen index indicates which monitor to use.

fallback.application
The name of the application to use if the number of retries has been exceeded. The fallback is only utilized if the Retries setting is greater than 0.
timeout

The maximum number of seconds to allow for any gateway communication. Any communication that exceeds this amount will cause the Vision client launcher to abort the communication and try again if configured.

retries

How many times to attempt to contact a gateway again if an error occurred during communication. Available values are:

  • -1 : Retry indefinitely, or until the launcher is manually closed.
  • 0 : Zero retries, or abort after the first failure.
  • 1 (or more): Determines the number of retries: i.e., a value of "5" means five retries. If the number of retries is exceeded, then the launcher will attempt to launch the Fallback Application.

If the number of retries is exceeded, then the Launcher will attempt to launch the Fallback Application

init.heap
The initial heap size (memory) for the client.
max.heap
The maximum heap size (memory) for the client
-Djavaws.launchparams

Defines client tags that can be overwritten upon launch. The use of this argument alone only defines the client tags that will be overwritten. Setting a value on the tags can be done by an additional argument that utilizes the tag names delimited by a semicolon:

// Establishes the tag names
 -Djavaws.launchparams="Tag1;Tag2"

// Sets values on the tags
-Djavaws.launchparams.Tag1=10
-Djavaws.launchparams.Tag2=20

//An actual call would look like:
"C:\ClientLauncher\visionclientlauncher.exe" application=myproject -Djavaws.launchparams="Tag1;Tag2" -Djavaws.launchparam.Tag1=10 -Djavaws.launchparam.Tag2=20
config.json

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

Allows you to point the launcher to a launcher configuration file command line. Doing so will start running an instance of the launcher using the configurations in the file as temporary overrides. The argument expects a path to a JSON export file, specifically the same file that created by the that's created by the Export Launcher Config button under the launcher's  Settings menu. 

"C:\ClientLauncher\visionclientlauncher.exe" config.json="C:\Users\MyUser\Desktop\vision-client-launcher.json"




  • No labels