Upgrading from version 6.x

Use the following instructions to upgrade PageSeeder from version 6.0 or higher on Linux.

Prerequisites

You must have root permissions on the server.

PageSeeder is installed correctly and running.

Find the current distribution

The upgrade procedure depends on the current distribution of PageSeeder installed.

To find out whether the current distribution is el7, el8 or el9 look at the baseurl displayed from:

$ cat /etc/yum.repos.d/pageseeder.repo

In the following example response, the distribution is el8.

[pageseeder]
name=pageseeder
baseurl=https://download.pageseeder.com/pub/rpm/el8/noarch
enabled=1
gpgcheck=1
gpgkey=https://download.pageseeder.com/pub/rpm/RPM-GPG-KEY-pageseeder-2048.public

If there is no el7, el8 or el9 in the baseurl then the distribution is el7.

Upgrading el8 or el9

Use these instructions if the current distribution is el8 or el9.

Stop the PageSeeder service as follows:

$ sudo systemctl stop pageseeder

Install the latest PageSeeder production version as follows:

$ sudo dnf upgrade pageseeder

OR to upgrade to a beta version use rpm and remove hyphens from the version identifier. So, if the source version is called:
6.2000-beta-4
change it to this:
6.2000~beta4
fully expanded, the version name should follow this pattern:
pageseeder-6.2000~beta4-1.el8.noarch.rpm

So, to upgrade to a beta PageSeeder, use the following URL but replace [ver.num~ber] with a valid beta identifier and the correct el[8|9]:

$ sudo rpm -Uvh https://download.pageseeder.com/pub/rpm/el[8|9]/beta/pageseeder-[ver.num~ber]-1.el[8|9].noarch.rpm

$ sudo update-crypto-policies --set LEGACY
$ sudo dnf upgrade pageseeder --nogpgcheck
$ sudo update-crypto-policies --set DEFAULT

Start the service

Start the PageSeeder service as follows:

$ sudo systemctl start pageseeder

Upgrading el7 on CentOS v7

Use these instructions if the current distribution is el7 and the operating system is RHEL version 7 or CentOS version 7. Check the operating system using:

$ cat /etc/os-release

Stop the PageSeeder service as follows:

$ sudo service pageseeder stop

Install the latest PageSeeder production version as follows:

$ sudo yum update pageseeder

OR to upgrade to a beta version use the following, where [ver.num~ber] is for example 6.2000~beta4:

$ sudo rpm -Uvh https://download.pageseeder.com/pub/rpm/el7/beta/pageseeder-[ver.num~ber]-1.el7.noarch.rpm

Start the PageSeeder service as follows:

$ sudo service pageseeder start

Upgrading from el7 to el8

Use these instructions if the current distribution is el7 and the operating system is NOT RHEL version 7 or CentOS version 7. Check the operating system using:

$ cat /etc/os-release

Set up firewalld

In this step, we ensure that the firewalld service is running and enabled before we install PageSeeder.

$ sudo systemctl status firewalld
● firewalld.service - firewalld - dynamic firewall daemon
   Loaded: loaded (/usr/lib/systemd/system/firewalld.service; disabled; vendor preset: enabled)
   Active: inactive (dead) since Tue 2024-10-08 06:12:46 UTC; 20h ago

If firewalld is not installed, install it with:

$ sudo dnf install firewalld

If the service status is inactive, start the service with:

# sudo systemctl start firewalld

If the service status is disabled, enable the service with:

$ sudo systemctl enable firewalld

Update Yum repo

To update the PageSeeder yum repository use:

# rpm -Uvh https://download.pageseeder.com/pub/rpm/pageseeder-repository-1.3-1.el8.noarch.rpm

Update PageSeeder

Stop the PageSeeder service:

# service pageseeder stop

Update PageSeeder:

# dnf update pageseeder

Start the PageSeeder service:

# systemctl start pageseeder

Check (optional)

To check that the PageSeeder service is running and enabled:

$ sudo systemctl status pageseeder
● pageseeder.service - PageSeeder Server
   Loaded: loaded (/etc/systemd/system/pageseeder.service; enabled; vendor preset: disabled)
  Drop-In: /etc/systemd/system/pageseeder.service.d
           └─override.conf
   Active: active (running) since Wed 2024-10-09 02:53:03 UTC; 7s ago

To check that the service override contains your original java options:

$ cat /etc/systemd/system/pageseeder.service.d/override.conf
[service]
Environment="CATALINA_OPTS=-Xmx1024m -Djava.awt.headless=true -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/opt/pageseeder"

To check that the old PageSeeder service has been removed, the following should not include ‘pageseeder’ in the listed files:

$ ls /etc/init.d/

To check that the xinetd service is inactive and disabled:

$ sudo systemctl status xinetd
● xinetd.service - Xinetd A Powerful Replacement For Inetd
   Loaded: loaded (/usr/lib/systemd/system/xinetd.service; disabled; vendor preset: enabled)
   Active: inactive (dead)

To check the firewall configuration:

$ sudo firewall-cmd --list-all
public (active)
  target: default
  icmp-block-inversion: no
  interfaces: eth0
  sources:
  services: cockpit dhcpv6-client http https ssh
  ports: 25/tcp
  protocols:
  forward: no
  masquerade: no
  forward-ports:
      port=25:proto=tcp:toport=2525:toaddr=
  source-ports:
  icmp-blocks:
  rich rules:

Script

If this guide is scriptable, provide shell script below.

#!/bin/bash

# 1. Start and enable firewalld
systemctl start firewalld
systemctl enable firewalld

# 2. Update repo
rpm -Uvh https://download.pageseeder.com/pub/rpm/pageseeder-repository-1.2-1.el8.noarch.rpm

# 3. Upgrade pageseeder
service pageseeder stop
dnf update -y pageseeder
systemctl start pageseeder