Secure Node agent installation on Linux/Unix (.sh script)

Introduction

The Secure Node agent is available for Windows, Linux, and Mac operating systems. This article will show you how to install the generic Linux/Unix 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 sudo or root access.

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 generic Linux/Unix 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.

The client should be executedvia the command line. To install via the command line first ensure the sh file is set to executable, then run it with the below to start the GUI installer:

sudo ./secure-node-linux-VERSION.sh

If you do not have a GUI, the install can be run silently with:

sudo ./secure-node-unix-VERSION.sh -q

 

On the welcome page for the GUI install, click Next to continue.

 

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

 

Accept the default destination for symlinks 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.

 

 

Step 3 - Configuring the agent

If you installed using the GUI, the agent is now already configured and you may move on to Step 4.

If you installed silently using the -q argument, you will now need to configure the agent.

Move the public key file that was downloaded into /opt/secure-node/conf/default/ and rename it to server.pub.

sudo mv /pathtofile/securenodename.pub /opt/secure-node/conf/default/server.pub

 

Create a new file (with sudo or root) in /opt/secure-node/conf/default called agent.properties containing the following:

agent.name=Secure Node 1
server.host=10.0.2.24
server.port=4022

Replace the name, host and port as required for your configuration and save the file.

 

 

Step 4 - The Secure Node service

The agent install creates a service called secure-node which should automatically start on reboot.

Now there is a valid configuration, we can start the service manually with:

sudo service secure-node start

 

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