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 Proxmox

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 Proxmox 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 OVA file.

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

---

2. Deploying the VM

Using an SFTP client, upload the ova file to your Proxmox server.

Determine your next available VM id number and the name of the storage you want to store the VM on and run these commands (replacing items in <> with appropriate values).

tar xvf nodal-agent-ova-<version>.ova

qm importovf <vmid> nodal-agent-<version>.ovf <storage>

In the Proxmox web UI, navigate to the new VM and look at the Hardware tab, you may need to add a new Network Device if this is missing.

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:

Setting a static IP on the Nodal Agent

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.