Installation

PageSeeder installation and upgrade instructions

Upgrading

Below are the details to upgrade an existing PageSeeder installation.

Warning!

Before upgrading, backup the PageSeeder install folder and the PageSeeder database. To preserve the cache, stop the PageSeeder service before backing up.

Warning!

Before upgrading, read the NOTE sections in all relevant release notes to ensure all necessary upgrade steps have been followed.

To upgrade from an old version of PageSeeder, see Upgrading (from version 5.6 or earlier).

To upgrade from a recent beta version use the normal procedures below. If you have any questions about options for upgrades, please contact Allette Systems.

Windows

To upgrade from version 5.7 or later follow these steps:

If not installed already, install Java 8 or later (see which version of java) as follows:

  • Go to https://www.oracle.com/java  and choose Java for Developers / Java SE.
  • Download the JDK or JRE .exe for windows (x64 for 64 bit) and run it.

Stop the PageSeeder windows service (if there is one).

Download the latest pageseeder-x.exe file, available under the Install folder on the Download page and run it.

Once the install commences, follow the instructions provided by the on-screen prompts.

Note

It may take a few minutes to update the database after PageSeeder starts. To see the progress or if PageSeeder fails to start view the pageseeder/webapp/WEB-INF/logs/general/general.log file.

Linux

To upgrade from version 5.7 or later, follow these steps:

To upgrade to Open JDK 8 enter:

sudo yum install java-1.8.0-openjdk
sudo alternatives --config java

Stop the PageSeeder service as follows:

sudo service pageseeder stop

Install the latest PageSeeder production version as follows:

sudo yum update pageseeder

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

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

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

When first upgrading from 5.7, configure Tomcat 8 as follows (if upgraded to Open JDK 8 or later remove -XX:MaxPermSize=128m when prompted):

sudo service pageseeder config

Start the PageSeeder service as follows:

sudo service pageseeder start

After the update, it may take a few minutes for the database to start. To check the progress, or if PageSeeder fails to start, view the log file.

/opt/pageseeder/webapp/WEB-INF/logs/general/general.log

Note

During the update any warnings such as "... created ... .rpmnew" or under Cleanup "No such file or directory" can usually be ignored.

Created on , last edited on