Skip to content

Installation script

Jump to bottom
andrei perepiolkin edited this page Mar 26, 2026 · 5 revisions

JovianDSS Proxmox plugin can be installed with install.pl script.

install.pl simplifies installation and removal of the plugin across Proxmox VE clusters.

Installation

By default install.pl will check and install the latest JovianDSS Proxmox plugin release on the node that is running it:

curl -fsSL https://raw.githubusercontent.com/open-e/JovianDSS-Proxmox/main/install.pl | perl -

Cluster-wide installation can be done by:

curl -fsSL https://raw.githubusercontent.com/open-e/JovianDSS-Proxmox/main/install.pl | perl - --all-nodes

It is recommended to restart the pvedaemon, pve-ha-lrm and pve-ha-crm service on every Proxmox server where the plugin was installed. Automatic restart can be done by adding the --restart argument.

But it is IMPORTANT to remember that the install.pl script with --restart should NOT be called from the Proxmox Web UI as --restart will restart the shell interfaces provided by the Proxmox Web UI.

curl -fsSL https://raw.githubusercontent.com/open-e/JovianDSS-Proxmox/main/install.pl | perl - --all-nodes --restart

The recommended multipath configuration file open-e-joviandss.conf is automatically installed to /etc/multipath/conf.d/ as part of the plugin package.

Removal

Removal of the JovianDSS Proxmox plugin can be done in the same manner as installation: manually using apt or using the install.pl script.

Single node removal can be done by running the script with the --remove flag added.

curl -fsSL https://raw.githubusercontent.com/open-e/JovianDSS-Proxmox/main/install.pl | perl - --remove

To remove the plugin from all nodes in the cluster, add the --all-nodes flag.

curl -fsSL https://raw.githubusercontent.com/open-e/JovianDSS-Proxmox/main/install.pl | perl - --remove --all-nodes

Options

pre

Default: stable

Install the latest pre-release instead of the latest stable release. Use this flag to test new features before they are officially released.

version

Default: None

Install a specific release tag instead of the latest version. Specify the exact GitHub release tag (e.g., v0.10.8-2).

Example:

./install.pl --version v0.10.8-2 --all-nodes

sudo

Default: False

Use sudo for commands when not running as root. This flag is useful when the script is executed by a non-root user who has sudo privileges.

restart

Default: False

Automatically restart the pvedaemon, pve-ha-lrm and pve-ha-crm service after installation or removal.

Important: Do not use this flag when running the script from the Proxmox Web UI, as it will restart the shell interfaces provided by the Web UI.

dry-run

Default: False

Show what would be done without actually executing the commands. Useful for testing the installation process and verifying which nodes would be affected.

reinstall

Default: False

Use the --reinstall apt flag during package installation. This forces reinstallation even if the package is already installed.

allow-downgrades

Default: False

Allow installing older package versions. By default, apt prevents downgrading packages as it can cause compatibility issues. Use this flag when you need to roll back to a previous version.

Example:

./install.pl --version v0.9.9 --allow-downgrades --all-nodes

Warning: Downgrading packages can cause configuration incompatibilities or data issues. Ensure you have backups before downgrading.

assume-yes

Default: False

Automatically answer "yes" to all prompts. This enables non-interactive mode, useful for automation scripts and CI/CD pipelines.

Without this flag, the installer prompts for confirmation before installing or removing packages on cluster nodes. With --assume-yes, the installer proceeds automatically without user interaction.

Example:

./install.pl --all-nodes --assume-yes

Use cases:

  • Automated deployments
  • CI/CD integration
  • Scripted cluster management
  • Remote execution where interactive prompts are not possible

verbose

Default: False

Show detailed output during installation and removal operations. Use -v or --verbose to enable verbose mode.

help

Default: None

Display the help message with usage information and available options. Use -h or --help to show help.

all-nodes

Default: False

Install or remove the plugin on all cluster nodes instead of just the local node. The script automatically discovers cluster node IPs from cluster membership information.

Node discovery methods (in order of preference):

  1. /etc/pve/.members file
  2. PVE::Cluster::get_members() API
  3. pvecm nodes command output

remove

Default: False

Remove the plugin instead of installing it. Can be combined with --all-nodes to remove from all cluster nodes.

Notes

Verification

Check installed version:

dpkg-query -W -f='${Version}\n' open-e-joviandss-proxmox-plugin

Verify cluster installation:

# Run on each node
pvesm status

Next Steps

After successful installation:

  1. Configure Storage: Follow the Quick Start guide to configure storage pools
  2. Network Setup: Review Networking for optimal network configuration
  3. Multipath Setup: See Multipathing for advanced multipath configuration

Clone this wiki locally