Install a Jump Client on a Windows System

Installation parameters can be specified for both the MSI and the EXE installers using a systems administration tool or the command line interface. When you mark specific installation options for override during installation, you can use the following optional parameters to modify the Jump Client installer for individual installations. Note that if a parameter is passed on the command line but not marked for override in the /login administrative interface, the installation fails. If the installation fails, view the operating system event log for installation errors.

It is common to receive an error message during the install, regarding a layout or appearance issue. This can be disregarded.

Command Line Parameter Value Description
--install-dir <directory_path>

Specifies a new writable directory under which to install the Jump Client. When defining a custom install directory, ensure that the directory you are creating does not already exist and is in a location that can be written to.

--jc-name <name...> If override is allowed, this command line parameter sets the Jump Client's name.
--jc-jump-group

user:<username>
jumpgroup:<jumpgroup-code-name>

If override is allowed, this command line parameter overrides the Jump Group specified in the Mass Deployment Wizard.

--jc-public-site-address <public-site-address-hostname>

If override is allowed, this command line parameter associates the Jump Client with the public portal which has the given host name as a site address. If no public portal has the given host name as a site address, then the Jump Client reverts to using the default public site.

--jc-session-policy-present <session-policy-code-name>

If override is allowed, this command line parameter sets the Jump Client's session policy that controls the permission policy during a support session if the customer is present at the console.

--jc-session-policy-not-present <session-policy-code-name>

If override is allowed, this command line parameter sets the Jump Client's session policy that controls the permission policy during a support session if the customer is not present at the console.

--jc-jump-policy <jump-policy-code-name>

If override is allowed, this command line parameter sets the Jump Policy that controls how users are allowed to Jump to the Jump Client.

--jc-tag <tag-name>

If override is allowed, this command line parameter sets the Jump Client's tag.

--jc-comments <comments ... >

If override is allowed, this command line parameter sets the Jump Client's comments.

--silent  

If included, the installer shows no windows, spinners, errors, or other visible alerts.

If --silent is selected, run as Administrator must be used, otherwise the installation will fail as a prompt during installation does not display.

When deploying an MSI installer on Windows using an msiexec command, the above parameters can be specified by:
  1. Removing leading dashes (--)
  2. Converting remaining dashes to underscores (_)
  3. Assigning a value using an equal sign (=)

MSI Example:

msiexec /i bomgar-scc-win32.msi KEY_INFO=w0dc3056g7ff8d1j68ee6wi6dhwzfefggyezh7c40jc90 jc_jump_group=jumpgroup:server_support jc_tag=servers

When deploying an EXE installer, the above parameters can be specified by:

  • Adding dashes
  • Add a space between the parameter and the value instead of an equal sign

EXE Example:

bomgar-scc-[unique id].exe --jc-jump-group jumpgroup:servers --jc-tag servers

Other rules to consider:

  • installdir has a dash in the EXE version (--install-dir) but no dashes in the MSI version (installdir).
  • /quiet is used for the MSI version in place of --silent in the EXE version.

A Jump Client can also be installed in service mode.

Uninstall a Jump Client

To uninstall a Jump Client, remove it from the Representative Console.

If the client is not connected when it is removed from the console, the files are removed next time the client authorizes with the server.

Jump Clients can be removed from a device using a script. This will leave an entry in the Representative Console interface. The entry is automatically marked uninstalled or deleted, depending on your Jump Client Settings.

For information about Jump Client settings, please see Configure Jump Client Settings.