Skip to main content

 Installation

PageSeeder installation and upgrade instructions

Moving installations

Moving PageSeeder from one server to another, or cloning a virtual machine and changing the server name is a straightforward task, however, like many administration tasks, it is not risk-free.

To minimize the chance of problems, always have a complete backup of the running system prior to any changes Also, do not upgrade PageSeeder as part of the migration. Upgrade and check the server as a separate task, either before or after the migration.

Before you start

  • Before upgrading review the Release Notes for any NOTE sections in earlier versions. These sections call out specific database checks or required updates to properties, configurations or customizations.
  • If updating from 5.6 or earlier, use the same values as webSiteScheme and webSitePort in the documentScheme and documentPort properties in:

WEB-INF/config/template.properties
  • If the database password has not changed, use the existing EncryptedPassword in:
 WEB-INF/config/database.properties 
  • If the database password has changed, edit the database.properties file and add a LoginPassword property that has the new, unencrypted password. PageSeeder will encrypt it upon startup. 

Moving PageSeeder

To move a PageSeeder server, do the following:

If the server has been cloned, skip to step 8 but if the implementation includes a proxy server like NGINX remember to update the name of the PageSeeder server in the proxy configuration.

Install PageSeeder on the new server but don’t start it. Ideally use the same ports as the existing server and configure a proxy if required.

Stop the existing PageSeeder and perform file system and database backups.

Restore the PageSeeder database with create, on the new server ensuring you create the same pageseeder database account password as on the existing server.

Copy the following folders from the existing PageSeeder to the new PageSeeder. If using Linux scp, add the -p option to preserve file modification dates.

[pageseeder]/documents
[pageseeder]/webapp/WEB-INF/config
[pageseeder]/webapp/WEB-INF/state

If migrating PageSeeder v5.96 or earlier, instead of WEB-INF/state copy the following:

[pageseeder]/ps-publisher/WEB-INF/config
[pageseeder]/ps-publisher/WEB-INF/template (but not template/default)
[pageseeder]/webapp/WEB-INF/cache
[pageseeder]/webapp/WEB-INF/index
[pageseeder]/webapp/WEB-INF/template (but not template/default*)
[pageseeder]/webapp/woconfig

If the JDBC driver has not been downloaded to the new server, copy the database driver .jar files (e.g. mysql*.jar) located in:

[pageseeder]/webapp/WEB-INF/drivers
[pageseeder]/webapp/WEB-INF/lib

For Linux, ensure xinetd and tomcat are properly configured by running the following command and accepting default options. Ideally use the same Java -Xmx memory options. These at the top of the /opt/pageseeder/tomcat/bin/startup.sh file on the existing server.

$ service pageseeder config

If Linux file permissions could have changed when copying files, run the following command to ensure the new PageSeeder has access to all files:

$ chown -R pageseeder:pageseeder /opt/pageseeder

If the server domain name has changed:

Obtain a product key for the new domain and update it in

[pageseeder]/webapp/WEB-INF/config/global.properties

Update the webSiteAddress and emailDomain in

[pageseeder]/webapp/WEB-INF/config/global.properties

If migrating v5.97 or earlier, these values are in template.properties.

Start PageSeeder, then update the old domain name in Administration > System configuration > Internal hosts.

In the v5.97 interface, update the domain name in Admin > Hosts page.

When moving a production server and changing the server domain name, do the following:

Clear the xml-documents cache in the Admin > System info page (in the ver 6 User Interface, go to Administration > Server status > Caching).

Re-index all groups in the Dev > Server indexing page (in the ver 6 User Interface, go to Administration > Server status > Indexing).

This process is optional for dedicated test servers where indexing large document collections may be time-consuming and not affect testing.

Start PageSeeder, if not already started.

Created on , last edited on