Documentation

Server Management
Installing the Windows Credentials Provider
User Accounts
Roles
Authorized Keys
Event Logs
Email Messages
HTML templates
Session Management
Authentication Modules
Authentication Policies
SMTP Configuration
User Interface
Branding
User Interface Themes

Deploying Nodal Agent on Hyper-V

The Jadaptive Nodal VPN service requires an agent to be installed in your network. Your end-user’s VPN clients will connect through this endpoint for their VPN sessions.

This article covers deploying the OVA VM image in a Hyper-V environment.

1. Downloading the Agent VM

Whilst logged into your cloud tenant, click the Download button at top right then select Download under Nodal Agent.

On the next screen, choose to download the HyperV file.

The downloaded file will be named something like: nodal-agent-hyperv-<version>.zip.

Unzip the file to get a nodal-agent-<version>.vhd file.


2. Deploying the VM

In Hyper-V Manager, start the New Virtual Machine wizard, give the new VM a name and select its location, click Next.

Select Generation 1 and click Next.

Change the memory to 2048Mb and click Next.

Select the Networking for this VM, click Next again.

Select Use an existing virtual hard disk, browse to the location of the extracted Hyper-V image and select it. Click Next.

Click Finish to complete the creation, then start the new VM.


3. Authorizing the Nodal Agent

On first boot, you are prompted to log in with the username: nodal-agent.

Log in as this user now and change the password when prompted.

You are now logged in and are presented with the Nodal Agent summary.

If you want to change the IP Address, please refer to this article:

As this is the first time you are logging into your Nodal Agent, the tenant registration process should start automatically. If for any reason this does not start, you can manually start the process with the command:

nodal-do auth <tenanthostname> <agentname>

The <tenanthostname> can be just the subdomain that you chose when creating your tenant if you opted for the default top level nodal.network domain. If you chose to use another domain, this needs to be the fully qualified hostname

<agentname> is optional, if you leave this blank a random name will be chosen.

Enter your <tenanthostname> when prompted and press enter.

Either type in your <agentname> and press enter or press enter to accept a random name.

You will now be prompted to visit your tenant on a URL to pair your agent.

In a browser, visit the pair URL and log in with your admin credentials.

Now enter the User Code as displayed on your Agent.

Finally, click Approve.

Your agent is now authorized. You can check this status on the agent at any time by typing: nodal-do status

or by logging onto your tenant’s web UI and navigating to Resources->Node Agents.

You can now continue your configuration by creating a network.

To top