Skip to content

Connection Assignments

For meaningful actions to be performed with the server, connections must be assigned. The following connections are supported:

  • PXE
  • DHCP
  • IPMI
  • PiKVM IPMI and VNC console
  • Web resetter (TELEJET)
  • PDU (list of supported devices)
  • KVM over IP switches (list of supported devices)
  • Switch port
  • Proxmox
  • VMware
  • Hetzner Cloud
  • Hetzner Dedicated
  • OVH / Kimsufi / SYS
  • myLoc / Webtropia / Servdiscount
  • NovoServe (only power management supported)
  • Tailor Made Servers
  • GTHost

Remote Agents

For most connections you can choose which remote agent is responsible for handling the connection. You can choose this for each connection assignment separately.

Features

You can enable different features on each connection. The features are usually presented in the form of a checkbox.

Features would be, for example, a permanent DHCP lease or power control.

How to add a connection assigment

  1. Open the server detail page.
  2. Click on "Configuration" in the navigation menu.
  3. Click on the "Add Connection" button and select the type you want to add.
  4. Fill out the form and click on the "Add" button.

Switch Ports / PDU / KVM over IP Switches

To assign switch / PDU / KVM ports, you must first add the device to Tenantos.

Once the device has been added, you can add a connection to the servers as described above.

KVM over IP Switches

With KVM over IP switches, depending on the model, additional fields for overwriting the used username and password become available when adding connection assignments.

If these fields are offered, it means that the viewer is started without an isolated account. This can pose a security risk if the user somehow extracts the login credentials from the Docker container. However, if the KVM switch is within a private network or behind a firewall, the security risk is minimized. This is because the Docker container contains only a bare minimum of programs and user access to the switch from outside is restricted. Nevertheless, in this scenario, it is advised to create a dedicated user for each KVM port to limit the user to the intended KVM port.

If these fields are left blank, Tenantos defaults to the login credentials specified on the "Network Devices" page.

PDU Handling

Multiple PDU port assignments can be added for each server, allowing the servers to be redundantly connected to PDUs while still executing power actions through Tenantos.

It is also possible to add an IPMI connection in addition to the PDU port assignments. In this case, the IPMI connection serves as the primary power management source if the power management feature in the IPMI connection has been activated. An automatic fallback to the PDU ports occurs if IPMI is unreachable.

PiKVM Devices

The IPMI and console implementation of PiKVM is supported by Tenantos. To add a PiKVM, just enable the IPMI BMC at PiKVM and add an IPMI connection assignment as usual. Afterward, the power state of the server can be managed.

To make the NoVNC console work, the VNC server of PiKVM must be activated. Please refer to the PiKVM documentation for instructions on how to enable the VNC server.

Proxmox / VMware

You must first add access to the virtualization platform so that you can assign such a connection. For more information, please read below.

External Providers (OVH, etc.)

To assign an external provider, you need to add the API credentials. Follow these steps:

  1. Navigate to the "External Providers" page.
  2. Add the API credentials for the external provider.

For more information, please read the "Manage External Providers" page.

Once the external provider has been added, you can add a connection to the servers:

  1. Open the server detail page.
  2. Click on "Configuration" in the navigation menu.
  3. Click on the "Add Connection" button and select the provider you want to add.
  4. In the dialog that appears, select the account you added, fill out the form, and enable any desired features such as power control.

For most external providers, you only need to enter the server ID of the other side. The following explains how to find out the server ID.

Proxmox

The "KVM Server ID" is the VM ID which you can find after you have logged in at the Proxmox panel.

2000 (the-hostname.com) - the VM ID is 2000.

VMware

ESXi

To find the "VM ID" value in VMware ESXi, log in to the ESXi panel and open the detail page of the virtual server you want to add to Tenantos. The VM ID can be found in the URL, as shown in the following example:

https://vmware/ui/#/host/vms/85 - the VM ID is 85.

vSphere

To find the "VM ID" value in VMware vSphere, log in to the vSphere panel and open the detail page of the virtual server you want to add to Tenantos. The VM ID can be found in the URL, as shown in the following example:

https://vmware/ui/app/vm;nav=h/urn:vmomi:VirtualMachine:vm-3038:f3342ccb-2609-4118-8e98-986caa15e3dc/summary - the VM ID is "vm-3038"

OVH

To locate the server ID at OVH, refer to the service name on this page. The service name will typically be in a format like ns1111111.ip-37-180-0.eu.

Hetzner Dedicated

To locate the server ID at Hetzner, refer to the ID on this page. When inserting the ID, do not include the "#" symbol. For example:

EX42-NVMe #1234567 - the server ID is 1234567.

Hetzner Cloud

To locate the Server ID for a cloud server at Hetzner, refer to the URL when you open the server in the Hetzner console. For example:

https://console.hetzner.cloud/projects/111111/servers/1234567/overview - the server ID is 1234567.

MyLoc

To locate the Server ID at MyLoc, log in to customer-interface.com. The Server ID is a numeric value that will be visible once you are logged in.

NovoServe

The Server ID is in the format "123-123".

Tailor Made Servers

The Server ID is contained in the URL of the server information page.

Tenantos

The Server ID is contained in the URL of the server detail page.

https://tenantos-domain/servers/1234567 - the server ID is 1234567.

Screenshots

Server Connections #1 Server Connections #2