/
Proxmox Virtual Environment configuration

Proxmox Virtual Environment configuration

Proxmox OVA Deployment Guide

Use this guide to import the Apporto OVA on Proxmox and create your cluster. Follow the steps in order; optional settings are called out.

Prerequisites

Security & Time Sync

    • SSH access to OVA cluster nodes is not permitted for security purposes. Nodes are built on Ubuntu LTS.

    • Configure NTP time servers to UTC on all nodes.

Install Steps

  1. Download the Apporto VM file from Step 1 of the installer. Different file formats are available to meet the needs of various hypervisors. Proxmox supports uploading several image types, including .raw, .qcow2, and .vmdk for virtual disk images, as well as .iso files for CD/DVD images, and OpenVZ templates.

    image-20250624-185915.png

    For the rest of this document, we will focus on setup from an .ova image.

  2. From the Proxmox console, import the file.

    image-20250714-162354.png

    1. Select a server.

    2. Click on the datastore called “local.”

    3. Click Import in the detail panel.

    4. Choose the appropriate OVA file.

    5. Click on the Import button above the file list.

  3. Change the following values, then click on the “Advanced” tab to proceed.

    1. Default bridge - the desired network

    2. CPU type - host for max performance

    3. Name

    4. Starts a VM and imports the disks in the background - checked

  4. From the “Advanced” tab, update the following values and then click Import to start the deployment.

    1. SCSI Controller - VirtIO SCSI single

    2. Network Interfaces net0 - VirtIO (paravirtualized)

  5. You may wish to configure additional settings, as shown below. These settings are not required.

    image-20250714-162434.png
    image-20250714-162444.png

Apporto recommends setting the NTP timeservers to UTC.

Post-Deployment

  1. Once the VM has been created, start it and view its details from your resource list.

    image-20250618-172230.png

  2. Power on the first VM for your manager node to access the Network Config screen through the VM console. Update the network config values to accommodate the Apporto VM, including the control plane FQDN (your Apporto instance domain). The image below shows sample values.

    1. Repeat the process for the additional nodes in your cluster. Most customers will have three nodes, where the first node is designated as the manager, and the remaining nodes will serve as workers.

    2. Click Save at the bottom of the screen.

  3. Open https://[your_manager_node] in a browser window. This will launch the On-Premises Cluster Management tool that was included with the Apporto VM file.

    Any nodes that are detected in your container will appear in the Node Discovery list.

The nodes in this image show greater resources than the minimum requirements. See the Components section for information on those requirements.

Create Cluster

Review the following:

Prerequisites for Cluster Install

  1. Select all nodes that you want to be connected to Apporto, then click Create Cluster to be transferred back to the Apporto NextGen control plane to continue cluster installation.

If any nodes from your container do not appear in the list within a few minutes of loading the tool, you may want to click Refresh.