Skip to content

Install Connect on Windows

Tip

Download links for CyberHive Connect client installers can be found on the Release notes page.

Installing the client

This short video shows the simple steps needed to install the software package and configure a new Endpoint to join a CyberHive Connect fast and resilient software-defined mesh network.

The steps shown may not reflect the current release of Connect.

To install the client, run the installer executable cyberhive-connect_ver_sha1.exe and select the directory where you would like to install the Connect client.

Select installation destination directory

Press Install to continue

Once installation is completed you are given the opportunity to open the online documentation.

Optionally open the online documentation

Note

Any existing installation will be replaced by the new version. See Upgrade Connect.

Installing the client silently

A silent install of the Connect client can be performed with the following command line parameters:

/SILENT: wizard and background windows are not displayed; installation progress is shown.

/VERYSILENT: wizard, background windows, and installation progress are not displayed.

Any errors during a silent or very silent install will be displayed.

A silent install will display a Reboot now? message when a reboot is required. A very silent install will reboot without asking.

/SUPPRESSMSGBOXES: message boxes are not displayed when used with /SILENT or /VERYSILENT.

/NORESTART: prevent a system reboot after a successful install.

Configuring the service

The Connect client runs on Windows as a Service and is configured using the Connect system tray application. After Connect is installed, or whenever the Connect system tray application is started without a valid configuration, a notification will be displayed.

Configure Connect notification

Clicking on this notification or right-clicking the Connect icon in the system tray and selecting Configure opens the Configuration dialog.

Connect configuration dialog

Add the configuration

Enter the three pieces of required configuration:

  • The URL of the Connect control service.
  • Your username.
  • Your authentication token.

Enter configuration

Clicking Apply will set the configuration and start the VPN.

Advanced configuration

Checking the Advanced box allows additional configuration to be set:

  • The hostname of this Connect Endpoint; by default this will be the computer hostname.
  • The VPN listen port.

Advanced configuration

Clicking Reset All will remove the current VPN configuration.

Activating and deactivating the VPN

The VPN may be activated and deactivated either by right-clicking the Connect system tray icon and selecting Activate or Deactivate, or from the Connect Configuration dialog.

Note

To test the functionality of Connect using ping, you will first need to enable ICMP within the Windows Firewall.

Tip

It is also possible to pre-generate keys for the Endpoint.

Alternative methods of controlling the Connect client

The Connect client can also be controlled using the built-in Windows tools, for example:

> sc.exe query cyberhiveconnect
> sc.exe stop cyberhiveconnect
> sc.exe start cyberhiveconnect

The Services UI can also be used by pressing Win+R to open the Run Command dialog and entering services.msc and pressing Return.

Alternative methods of configuring the Connect client

From a Command Prompt with Administrative privileges

Within an Admin Command Prompt, change to the directory where you installed the Connect client.

For example:

> cd "\program files\cyberhive connect"

The configuration can be entered into the Connect client as follows:

  • Connect control service
> cyberhive-connect set vpn_server https://connect.yourcompany.com
  • Username
> cyberhive-connect set username [email protected]
  • Authentication token
> cyberhive-connect set auth_token 19e6c772c1b7e69650a494bcc2c903598f2cbf9c

Configuring the Connect client

From the Registry

As the Connect client keeps its configuration in the Registry, you can use regedit.exe to edit it, export it, etc. The Connect client stores its configuration in the key HKEY_LOCAL_MACHINE\SOFTWARE\CyberHive\Connect.