Skip to content

Plugin installation and updating

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

Installing/Uninstalling

The JovianDSS Proxmox plugin can be deployed using the automated installation script (recommended), installing the Debian package manually, or by running the Makefile-based installation from source.

Important
The JovianDSS plugin must be installed on every Proxmox VE node in your cluster.

Automated Installation (Recommended)

The easiest way to install the JovianDSS Proxmox plugin is using our automated installation script. This script handles downloading, verification, and installation across all cluster nodes.

Fresh Installation

It is recommended to run the installation command via ssh, not through the Proxmox Web UI shell. The plugin installation requires a restart of Proxmox services, which the Web UI shell shell depends on. Therefore, using the --restart flag in the Web UI shell will abruptly terminate the terminal session and prematurely stop the installation script.

Install on all cluster nodes over ssh

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

Install on all cluster nodes with Proxmox Web UI shell

If installing from the Proxmox Web UI shell, do not use the --restart flag:

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

Once installation is complete, restart the Proxmox VE services on all cluster nodes:

systemctl restart pvedaemon
systemctl restart pve-ha-lrm.service
systemctl restart pve-ha-crm.service

Additional Options

# Install latest stable version on local node only
curl -fsSL https://raw.githubusercontent.com/open-e/JovianDSS-Proxmox/main/install.pl | perl -

# Install pre-release version on all nodes
curl -fsSL https://raw.githubusercontent.com/open-e/JovianDSS-Proxmox/main/install.pl | perl - --pre --all-nodes

# Install specific version on all nodes
curl -fsSL https://raw.githubusercontent.com/open-e/JovianDSS-Proxmox/main/install.pl | perl - --version v0.10.12 --all-nodes

# Test installation without making changes
curl -fsSL https://raw.githubusercontent.com/open-e/JovianDSS-Proxmox/main/install.pl | perl - --dry-run --all-nodes

More about installation script can be found at here.

Download and Run Locally

If you prefer to download and inspect the script first:

# Download the script
curl -fsSL https://raw.githubusercontent.com/open-e/JovianDSS-Proxmox/main/install.pl -o install.pl

# Make it executable and run
chmod +x install.pl
./install.pl --all-nodes

# View available options
./install.pl --help

Security Features

The installation script includes several security features:

  • Package verification: Downloads and verifies SHA256 checksums when available
  • HTTPS-only downloads: All downloads use secure HTTPS connections
  • Source verification: Downloads packages directly from GitHub releases
  • Cluster discovery: Automatically discovers all cluster nodes
  • Confirmation prompts: Shows all affected nodes before proceeding

Troubleshooting

If you encounter issues:

  1. Permission errors: Try adding --sudo flag if not running as root
  2. Network issues: Ensure nodes can access GitHub and have internet connectivity
  3. SSH issues: For cluster operations, ensure SSH key authentication is set up between nodes

After installation, proceed to the Configuration section to set up storage configurations.

Automated Removal

Automated removal from all nodes in the cluster can be accomplished by invoking the installation script with the --remove flag:"

Remove from all cluster nodes

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

In the same manner, removal from a single node can be done using:

Remove from a single node

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

Manual Installation for deb package

apt install ./open-e-joviandss-proxmox-plugin_0.10.0.deb

After installation restart the Proxmox VE services to make them aware of plugin.

systemctl restart pvedaemon
systemctl restart pve-ha-lrm.service
systemctl restart pve-ha-crm.service

To remove the plugin call:

apt remove -y open-e-joviandss-proxmox-plugin

Install from source

Installation can be done by make inside source code folder:

apt install python3-oslo.utils git
git clone https://github.com/open-e/JovianDSS-Proxmox.git
cd ./JovianDSS-Proxmox
make install

Removing JovianDSS Proxmox plugin:

make uninstall

Configuration

For a concise walk-through, see the Quick Start guide.

For a full listing of all configuration options and their meanings, refer to the Plugin Configuration guide.

Clone this wiki locally