Migrating from v2 to v3¶

Migrating to v3 is simple. To migrate to v3, please follow these steps on all places where PufferPanel is installed. This includes any nodes.

Remove old repository¶

Removing the repository is as simple as removing it from your apt/yum source list.

On APT systems, delete /etc/apt/sources.list.d/pufferpanel_pufferpanel.list

On YUM systems, delete /etc/yum.repos.d/pufferpanel_pufferpanel.repo

Install new repository¶

DEB-based

curl -s https://packagecloud.io/install/repositories/pufferpanel/pufferpanel/script.deb.sh?any=true | sudo bash
sudo apt update

RPM-based

curl -s https://packagecloud.io/install/repositories/pufferpanel/pufferpanel/script.rpm.sh?any=true | sudo bash

Ubuntu/Debian - Manual Repo

echo "deb https://packagecloud.io/pufferpanel/pufferpanel/any/ any main" > sudo tee /etc/apt/sources.list.d/pufferpanel.list
sudo apt update

Red-Hat - Manual Repo

  echo "   [pufferpanel]
name=pufferpanel
baseurl=https://packagecloud.io/pufferpanel/pufferpanel/rpm_any/rpm_any/$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/pufferpanel/pufferpanel/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300" > sudo tee /etc/yum.repos.d/pufferpanel.repo

Update Panel¶

Run the following to update the panel:

DEB-based

sudo apt-get install pufferpanel
systemctl restart pufferpanel

RPM-based

sudo yum install pufferpanel
systemctl restart pufferpanel

Stop Nodes¶

On each node, run systemctl stop pufferpanel

Deploy New Configs¶

Log into the panel. For each node, get the new config that is available through the panel and deploy it on that node.

Update Nodes¶

Run the following on each node:

DEB-based

sudo apt-get install pufferpanel
systemctl restart pufferpanel

RPM-based

sudo yum install pufferpanel
systemctl restart pufferpanel

Validate¶

Validate that all nodes now show up and all servers appear functional.