Upgrade from 6.x to 7.0 - Revision history

T.lamprecht at 08:25, 29 June 2023

2023-06-29T08:25:35Z

← Older revision		Revision as of 08:25, 29 June 2023
Line 161:		Line 161:

	[https://www.debian.org/releases/bullseye/amd64/release-notes/ Release Notes for Debian 11.0 (bullseye), 64-bit PC]		[https://www.debian.org/releases/bullseye/amd64/release-notes/ Release Notes for Debian 11.0 (bullseye), 64-bit PC]

			[[Category: Upgrade]]

Stoiko Ivanov: /* Potential issues */

2022-05-24T09:15:15Z

Potential issues

← Older revision		Revision as of 09:15, 24 May 2022
Line 144:		Line 144:
	As a Debian based Distribution, Proxmox Mail Gateway is affected by most issues and changes affecting Debian.		As a Debian based Distribution, Proxmox Mail Gateway is affected by most issues and changes affecting Debian.
	Thus, ensure to read the [https://www.debian.org/releases/bullseye/amd64/release-notes/ch-information.en.html upgrade specific issues for Bullseye].		Thus, ensure to read the [https://www.debian.org/releases/bullseye/amd64/release-notes/ch-information.en.html upgrade specific issues for Bullseye].

			== Installations as Container on Proxmox VE ==

			The newer version of <code>systemd</code> inside the container requires that the <code>nesting</code> feature has to be enabled for the container.
			This is needed in order for many essential services to be able to run.
			Keep in mind that this makes running privileged containers an even greater risk, thus it is recommended to only use unprivileged containers.

	== non-usr-merged layouts ==		== non-usr-merged layouts ==

T.lamprecht: /* Upgrade the PostgreSQL database */

2021-07-17T17:37:00Z

Upgrade the PostgreSQL database

← Older revision		Revision as of 17:37, 17 July 2021
Line 104:		Line 104:
	** If possible, use the default setting of dumping the old databases and restoring them, to avoid problems.		** If possible, use the default setting of dumping the old databases and restoring them, to avoid problems.
	:<pre>pg_upgradecluster -v 13 11 main</pre>		:<pre>pg_upgradecluster -v 13 11 main</pre>


	* Unmask postfix and all '''non-cluster''' Proxmox Mail Gateway services to enable them again.		* Unmask postfix and all '''non-cluster''' Proxmox Mail Gateway services to enable them again.

T.lamprecht: /* Upgrade the PostgreSQL database */

2021-07-17T17:36:07Z

Upgrade the PostgreSQL database

T.lamprecht: /* Stop and mask services before upgrade */

2021-07-17T17:33:48Z

Stop and mask services before upgrade

← Older revision		Revision as of 17:33, 17 July 2021
Line 85:		Line 85:

	* Stop postfix and all Proxmox Mail Gateway services (emails will be queued by the servers trying to contact the Proxmox Mail Gateway)		* Stop postfix and all Proxmox Mail Gateway services (emails will be queued by the servers trying to contact the Proxmox Mail Gateway)
	systemctl stop postfix pmg-smtp-filter pmgpolicy pmgdaemon pmgproxy pmgmirror pmgtunnel		:<pre>systemctl stop postfix pmg-smtp-filter pmgpolicy pmgdaemon pmgproxy pmgmirror pmgtunnel</pre>
	* Mask postfix and all Proxmox Mailgateway services to prevent them from starting during the upgrade		* Mask postfix and all Proxmox Mailgateway services to prevent them from starting during the upgrade:
	systemctl mask postfix pmg-smtp-filter pmgpolicy pmgdaemon pmgproxy pmgmirror pmgtunnel		:<pre>systemctl mask postfix pmg-smtp-filter pmgpolicy pmgdaemon pmgproxy pmgmirror pmgtunnel</pre>

	=== Upgrade the system ===		=== Upgrade the system ===

T.lamprecht: /* Preconditions */

2021-07-17T17:32:30Z

Preconditions

← Older revision		Revision as of 17:32, 17 July 2021
Line 40:		Line 40:
	*::apt dist-upgrade		*::apt dist-upgrade
	*:</pre>		*:</pre>
	*: You can check the web-interface (~~relaod~~) at the top, or use <code>pmgversion</code>. Both must show a version with 6.4-4 (or newer), for example something like <code>pmg-api/6.4-4/...</code> for the CLI command.		*: You can check the web-interface (reload) at the top, or use <code>pmgversion</code>. Both must show a version with 6.4-4 (or newer), for example something like <code>pmg-api/6.4-4/...</code> for the CLI command.
			*: If you still see an older version, you should ensure that you have valid [https://pmg.proxmox.com/pmg-docs/pmg-admin-guide.html#pmg_package_repositories package repositories] configured.
	* Make a valid and tested backup of Proxmox Mail Gateway.		* Make a valid and tested backup of Proxmox Mail Gateway.
	*: You can either create and download one from the web-interface, store it on your Proxmox Backup Server or create it from the CLI with <code>pmgbackup backup</code>.		*: You can either create and download one from the web-interface, store it on your Proxmox Backup Server or create it from the CLI with <code>pmgbackup backup</code>.

T.lamprecht: /* Preconditions */

2021-07-17T17:30:14Z

Preconditions

← Older revision		Revision as of 17:30, 17 July 2021
Line 36:		Line 36:

	* Upgrade to the latest version of Proxmox Mail Gateway 6.4 first.		* Upgrade to the latest version of Proxmox Mail Gateway 6.4 first.
			*:<pre>
	apt update
	apt ~~dist-upgrade~~		*::apt update
			*::apt dist-upgrade

			*:</pre>
⚫	* ~~Make~~ ~~a valid and tested backup of Proxmox Mail Gateway.~~ ~~Either~~ create and download it from the web interface, store it on your Proxmox Backup Server or create it from the CLI with:
			*: You can check the web-interface (relaod) at the top, or use <code>pmgversion</code>. Both must show a version with 6.4-4 (or newer), for example something like <code>pmg-api/6.4-4/...</code> for the CLI command.
	pmgbackup backup
			* Make a valid and tested backup of Proxmox Mail Gateway.
		⚫	*: You can either create and download one from the web-interface, store it on your Proxmox Backup Server or create it from the CLI with <code>pmgbackup backup</code>.

	* At least 4 GiB free disk space on root mount point.		* At least 4 GiB free disk space on root mount point.

Martin: Proxmox Mail Gateway 7.0 release

2021-07-15T08:35:24Z

Proxmox Mail Gateway 7.0 release

Show changes

T.lamprecht: Created page with "reserved."

2021-07-13T10:09:57Z

Created page with "reserved."

New page

reserved.

← Older revision		Revision as of 17:36, 17 July 2021
Line 98:		Line 98:
	=== Upgrade the PostgreSQL database ===		=== Upgrade the PostgreSQL database ===

	* Before upgrading the ~~postgres~~ main cluster, you need to remove the automatically created cluster in the new version.		* Before upgrading the PostgreSQL main cluster, you need to remove the automatically created cluster in the new version.
	pg_dropcluster --stop 13 main		:<pre>pg_dropcluster --stop 13 main</pre>
	* Upgrade the ~~postgres~~ main cluster from 11 to 13, using <code>pg_upgradecluster</code>		* Upgrade the PostgreSQL main cluster from 11 to 13, using <code>pg_upgradecluster</code>
	** This step will need some '''time''' and enough '''free diskspace''' as it will create another database containing your rules, statistics, and quarantine information.		** This step will need some '''time''' and enough '''free diskspace''' as it will create another database containing your rules, statistics, and quarantine information.
	** If possible, use the default setting of dumping the old databases and restoring them, to avoid problems.		** If possible, use the default setting of dumping the old databases and restoring them, to avoid problems.
	pg_upgradecluster -v 13 11 main		:<pre>pg_upgradecluster -v 13 11 main</pre>


	* Unmask postfix and all '''non-cluster''' Proxmox Mail Gateway services to enable them again.		* Unmask postfix and all '''non-cluster''' Proxmox Mail Gateway services to enable them again.
	systemctl unmask postfix pmg-smtp-filter pmgpolicy pmgdaemon pmgproxy		:<pre>systemctl unmask postfix pmg-smtp-filter pmgpolicy pmgdaemon pmgproxy</pre>
	* Reboot and then check the journal to ensure that everything is running correctly again.		* Reboot and then check the journal to ensure that everything is running correctly again.
			:<pre>reboot</pre>

			* Reconnect to the node after it successfully rebooted
	reboot

	* ~~Remove~~ the old ~~postgres~~ version and its data:		* You can remove the old PostgreSQL version and its data now, if all is working as expected:
	apt purge postgresql-11 postgresql-client-11		:<pre>apt purge postgresql-11 postgresql-client-11</pre>

	== After the Proxmox Mail Gateway upgrade ==		== After the Proxmox Mail Gateway upgrade ==