Configure and Install a Jumpoint for Linux Systems

Setup of a Jumpoint on a remote network is a multi-step process that includes configuring from the /login administrative interface, downloading the installer, and running the installation wizard.

Configuration

Manage Jumpoints

  1. From the administrative interface, go to Jump > Jumpoint.
  2. Click Add.

 

Adding and configuring a Jumpoint.

  1. Create a unique name to help identify this Jumpoint. This name should help users locate this Jumpoint when they need to start a session with a computer on its same network.
  2. Set a code name for integration purposes. If you do not set a code name, one is created automatically.
  3. Add comments to help identify this Jumpoint.
  4. Select the Jumpoint Platform. Options are Windows and Linux. Once the Jumpoint has been created, this setting cannot be changed.
  5. Leave the Disabled box unchecked.
  6. Check the Clustered box, if appropriate.

A Clustered Jumpoint allows you to install multiple, redundant nodes of the same Jumpoint on different host systems. If you select this option, the Jumpoint is available as long as at least one of the installed nodes is online. This provides redundancy, preventing the failure of all Jump Items associated with the failure of a single, standalone Jumpoint, and improves load balancing across the system. Once created, a clustered Jumpoint cannot be converted to standalone, nor a standalone Jumpoint converted to clustered.

Linux Jumpoints can only be used for RDP and SSH/Telnet sessions.

 

Jumpoint cluster nodes must be installed on hosts residing in the same local area network.

  1. If you want users to be able to connect to SSH-enabled and Telnet-enabled network devices through this Jumpoint, check Enable Shell Jump Method.
  1. From the Jumpoint edit page, you can authorize users to start sessions through this Jumpoint. After the Jumpoint has been created, you can also grant access to groups of users from Users & Security > Group Policies.
  2. Save the configuration. The new Jumpoint appears in the list of configured Jumpoints.

Once you have installed the Jumpoint, the table populates the hostname of the host system, as well as that system's public and private IP addresses. This information can help you locate the Jumpoint's host system in case you need to change the Jumpoint's configuration.

At the bottom of the Jumpoint page is the option to Enable network browsing. If checked, a permitted user can view and select systems from the network directory tree. If unchecked, a user can access a system through a Jumpoint only by entering the system's hostname or IP address. Either way, the user must provide valid credentials to the remote system before gaining access.

Download

Now that the Jumpoint is configured, you must install the Jumpoint on a single system in the remote network you wish to access. This system serves as the gateway for Jump sessions with other computers on the remote network. You can either install the Jumpoint directly to the host or email the installer to a user at the remote system. If this is to be a clustered Jumpoint, you add nodes after the Jumpoint is installed.

Download Linux 64 bit.

  1. From the table, find the appropriate Jumpoint and click the link to download the installer file.
  1. If you are logged into the system you want to use as the Jumpoint host, you can run the installation file immediately.
  2. Otherwise, save the file and then transfer it to and deploy it onto the system that will serve as the Jumpoint host.

If you need to change the Jumpoint's host system, click Redeploy. This uninstalls the Jumpoint from its current location and makes the download links available. You can then install the Jumpoint on a new host. The new Jumpoint replaces the old one for any existing Jump shortcuts that are associated with it.

Install

  1. Once the installer file is on the remote system, use a command interface to install the file and specify any desired parameters. The Jumpoint must be installed within 7 days of downloading it.
    • Install the Jumpoint using --install-dir <path>. You must have permission to write to this location, and the path must not already exist.
      sh ./bomgar-jpt-{uid}.bin --install-dir /home/username/jumpoint
    • If you wish to install under a specific user context, you can pass the --user <username> argument. The user must exist and have rights to the directory where the Jump Client is being installed. If you do not pass this argument, the Jumpoint installs under the user context that is currently running.

      sh ./bomgar-jpt-{uid}.bin --install-dir /home/username/jumpoint --user jsmith

 

We do not recommend installing the Jumpoint under the root context. If you attempt to install when the current user is root, you receive a warning message and are required to pass --user <username> to explicitly specify the user that the process

  1. After installing the Jumpoint, you must start its process.
    /home/username/jumpoint/init-script start

    This init script also accepts the stop, restart, and status arguments. You can use ./init-script status to make sure the Jumpoint is running.

 

You must also arrange for init-script start to run at boot, as the correct user, in order for the Jumpoint to remain available whenever the system restarts.

  1. To remove the files, use the uninstall.sh script included in the installation

Clustered Jumpoint Setup: Adding Nodes

The steps for creating a clustered Jumpoint in /login are the same as for a standalone, with one difference: once you have created the clustered Jumpoint, you add nodes to it. At least one node needs to be installed for the Jumpoint to be online.

  1. From the administrative interface, go to Jump > Jumpoint.
  2. From the table of existing Jumpoints, find the appropriate Jumpoint and click the Add Node link to download the installer file (bomgar-jpt-{uid}.bin).
  1. If you are logged into the system you want to use as the Jumpoint host, you can run the installation file immediately.
  2. Otherwise, save the file and then transfer it to and deploy it onto the system that will serve as the Jumpoint host.

Jumpoint Cluster Installed

  1. Install the node following the same steps for Install, as above.
  2. In the Jumpoint table, the clustered Jumpoint now shows information about each installed node, including public and private IP addresses and online or offline status.

Nodes can be deleted but cannot be individually edited. In the representative console, none of the nodes are visible; only the clustered Jumpoint under which they are installed is visible. Nodes function as redundant connection points. When a user needs to use the Jumpoint, one of the nodes is selected randomly. At least one node must be online for the Jumpoint to work.