Installation

PageSeeder installation and upgrade instructions

Upgrading

Warning!

Before installing any upgrade, make a backup of the PageSeeder install folder and the PageSeeder database. To preserve the PageSeeder cache, the PageSeeder service needs to be stopped before doing the backup.

Warning!

Before upgrading, read the NOTE sections in any release notes after the current version to ensure any project customizations are compatible with the new version.

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:

  1. 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.
  2. Stop the PageSeeder windows service (if there is one).
  3. Download the latest pageseeder-x.exe file, available under the Install folder on the Download page and run it.
  4. 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:

  1. To upgrade to Open JDK 8 enter:

    sudo yum install java-1.8.0-openjdk
    sudo alternatives --config java
    
  2. Stop the PageSeeder service as follows:

    sudo service pageseeder stop
    
  3. Install the latest PageSeeder production version as follows:

    sudo yum update pageseeder
    

    Or to install a beta version use the following (replace x.y-z for example by 5.9300~beta8-1):

    sudo rpm -Uvh http://download.pageseeder.com/pub/rpm/beta/pageseeder-x.y-z.noarch.rpm
    
  4. When upgrading from 5.7 the first time, configure for Tomcat 8 as follows (if upgraded to Open JDK 8 remove -XX:MaxPermSize=128m when prompted):
    sudo service pageseeder config
    
  5. Start the PageSeeder service as follows:
    sudo service pageseeder start
    
  6. It may take a few minutes to update the database after starting. To see the progress or if PageSeeder fails to start view the /opt/pageseeder/webapp/WEB-INF/logs/general/general.log file.

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