Secure Node agent installation on OS X

Introduction

The Secure Node agent is available for Windows, Linux, and Mac operating systems. This article will show you how to install the OS X version of the client.

Secure Nodes can be used to access resources that are based in external networks that you are not able to route to by other means. The Secure Node agent maintains a tunnel between networks so that you can publish resources on your Hypersocket server as if they were local LAN services.

 

Prerequisites

The Secure Node feature should be installed on the server (in the top navbar from Updates, Features & Licensing->Features->Secure Node).

 

Click on the download link for the feature and accept the license agreement that appears. Restart the Hypersocket server when prompted.

Before the agent can be installed and configured, you must have a Secure Node resource created and configured on the server (see Getting Started Guide or Administrator's Manual) 

 

Step 1 – Download the agent

The Secure Node agent is required to be able to route to resources in other networks. Installing the agent requires administrator rights.

To get the agent installer the user should first log on to the Hypersocket web interface, then click on the Downloads button in the top navbar. In the Downloads page that appears, click on the link for the correct client operating system. We will demonstrate the OS X client here.

 

 

Step 2 – Installing the client

Before you install the client, you need to download the private key from the key pair that was generated during the configuration of the Secure Node resource that should already have been created.

Log on to the web UI as admin and navigate to Service Keys. For the key you want, click the green Gears icon next to the key and click Download Public Key.

 

Save the resulting .pub flie that will be downloaded.

With the agent install that was downloaded in Step 1, open the .dmg package and launch the Secure Node Installer by double clicking it.

Click Open to launch the install wizard, then enter your OS X username and password to give the installer permission to continue.

 

On the welcome page, click Next to continue.

 

Either accept the default destination directory or click Browse to choose your own directory, then click Next.

 

Type in the name of the Secure Node. NOTE: this must be the same as the Secure Node resource that has been created on the server. Also enter the Hypersocket server's host or IP and the SSH port number that is configured (default 4022).

Click Next to continue.

 

Edit the Public Key that was downloaded earlier and paste the contents of that file into the Public Key text field. Click Next.

 

The install then proceeds and the files are copied to the system.

When completed, click Finish.

 

 

You may now continue to configure the Server Agent Routes on the server and then publish your resources.

Have more questions? Submit a request

Comments