PageSeeder installation and upgrade instructions

Release Notes – Version 5.9701 (8 March 2019)


Fixed: edit sheet not using editor-config.xml to validate entered data.

6745678 Mar 20195.9701

Fixed: edit sheet not filtering by location when exporting to CSV.

6744736 Mar 20195.9701

Fixed: project files import and upload (using post) not creating backup files for history.

6741551 Mar 20195.9701

Fixed: words breaking in Chrome tables.

6741541 Mar 20195.9701

Added: beta version of Admin User Interface (UI) for PageSeeder v6 – accessible under the existing Admin menu as “Admin UI v6 (beta)”. To return to the v5 interface, click the button at the bottom of the lefthand side bar.

66701326 Feb 20195.9700

Added: support for OAuth refresh tokens when using password grant type.

67095715 Feb 20195.9700

Fixed: problem editing XRefs when there is an apostrophe in the target document title or manual title. Also fixed the unavailable “Browse” tab when inserting an XRef with the default configuration.

67016015 Feb 20195.9700

Fixed: the list of groups for a logged-in user not being updated when they are a subgroup member being added, removed or modified.

66957213 Feb 20195.9700

Fixed: transcluded ASCIImath and MathML occasionally not formatting on document view page.

67059812 Feb 20195.9700

Added: support for MySQL 8.


  Use the v5 JDBC driver. Do NOT use Connector/J v8.

6620206 Feb 20195.9700

Fixed: ANT script errors when file extension contains upper case characters.

66909925 Jan 20195.9700-beta-8

Modified: default group/project creation to use “Normal” (immediate) notification when joining existing member accounts to a group.

Added: check box option “Join this group/project automatically after creation” on group and project creation pages.


Projects or external applications that require notification of “Announcements only” (send only exceptional messages) will need to modify this setting.

66884125 Jan 20195.9700-beta-8

Modified: sharing functionality as follows:

  • Fixed: problems searching shared folders when the folder name contains upper case letters (to fix existing folders, rename them and then renamed them back).
  • Allowed: project managers to share folders instead of administrators only.
  • Deprecated: sharing sub-folders of shared folders with different groups. Or editing their ancestors.
65964925 Jan 20195.9700-beta-8

Added: the following new services:

DELETE /members/{member}
GET /groups/{group}/supergroups
GET /groups/{group}/uris/{uri}
GET /publish/schedule
GET /groups/{group}/publish/checkall
GET /threads/{threadid}/logs

Deprecated: the following service:

POST /members/{member}

Removed: the following service:

GET /publish/about

Modified: the following services:

  • POST /members/{member}/creategroup: Added createdocuments parameter.
  • GET /members/{member}/publish/cancel: Changed response XML root from <peek> to <cancel>.
  • GET /members/{member}/groups/{group}/publish/start: Changed response XML contents of <parameters> element.
  • GET /members/{member}/groups/{group}/uris/{uri}/publish/start: Changed response XML contents <parameters> element.


Any apps or projects using these services may need to be updated.

66805015 Jan 20195.9700-beta-8

Removed: the following obsolete servlets:

66804915 Jan 20195.9700-beta-8

Fixed: possible memory and performance problems with PDF thumbnail generation.

66562815 Jan 20195.9700-beta-8

Modified: reverting deleted fragments back to the document location where they previously existed (when possible).

66801414 Jan 20195.9700-beta-8

Modified: fragment history and document activity pages so that adjacent edits from the same author, on the same fragment, appears as a single event.

66462614 Jan 20195.9700-beta-8

Reorganized: the folder / file structure, state, publish scripts and custom config files.

These are automatically moved to the following locations when PageSeeder starts:

  • All top level folders under template/[project] will be renamed to lowercase (i.e. config, index, label, layout, member, notification, publish).
  • Publish script files will be merged into the corresponding template/[project] folder using their existing folder structure.
  • The woconfig files will be moved to the template folder as follows:
woconfig/[project]/psml/[type]/* -->
woconfig/[project]/organization/* -->

All these files will remain accessible via /ps/woconfig using the path under template but removing the style folder. For example: 



  • Manually move any other woconfig files, such as shared CSS or images, to the following folder and adjust any URLs that reference them:
  • After upgrading, check the Recent logs on the Admin Console page for warnings about renamed files. Naming clashes are possible when merging publish scripts with config files.
  • Custom index XSLT files must be updated to correctly reference the default XSLT.
  • Any apps or deploy scripts that upload config files will need to be updated to use the new locations.
  • Rename to lower case all top level template folders in code repositories. On Windows, this can be done by adding a suffix and committing, then renaming to lowercase and committing (e.g. Publish -> Publish2 -> publish).
6420777 Jan 20195.9700-beta-8

Added: <publication> to PSML under <documentinfo> on the root document of a publication. Also on root documents, added support for uploading publication id/type using:

<publication id="mypub" type="mytype" />

On upload, existing publication id/type will only be overwritten if the “overwrite metadata and document properties” option is selected under the Developer options menu when using the Upload page from the Developer perspective.

6652894 Jan 20195.9700-beta-6

Added: support for  a convertasciimath attribute (default value = true) to the ps:process ANT task. This setting converts to MathML the content of either of the following elements:

<inline label="asciimath">
 <media-fragment mediatype="text/asciimath">
6646192 Jan 20195.9700-beta-6

Added: to PSML support for a comma-separated list of fragment types in section/@fragmenttype with default as an allowed value.

6669622 Jan 20195.9700-beta-6

Added: to document-template.xml support for <t:description> under <t:fragment>. For usability and maintenance, it is recommended that every fragment type have a description.

66720521 Dec 20185.9700-beta-6

Added: to XRef and document configs, support for @folder, @filters and @group on <target>. These replace the @folder, @filters and @group on <autosuggest>

66526819 Dec 20185.9700-beta-6

Added: index fields psfragmenttype, psinlinelabelname, pspublicationroot, psrootpublicationid and updated index version to 5402.

Also added the following fields to the change columns dialog on the search page: pslastediteddate, psfragmenttype, psinlinelabelname.

66558414 Dec 20185.9700-beta-5

Added: to indexing, parsing of inline label dates using written format e.g. 2nd March 2010

66695310 Dec 20185.9700-beta-5

Modified: new document page to always display “Default” and “References” at the top of the list.

66505110 Dec 20185.9700-beta-5

Modified: the Publish engine to run under the /ps webapp and removed the /ps-publisher webapp.

6463795 Dec 20185.9700-beta-5

Fixed: problem selecting an XRef config with * in the target folder when under a sub-project.

6651634 Dec 20185.9700-beta-5

Added: “open in new tab” right-click option on XRefs and links in the CK editor.

6597924 Dec 20185.9700-beta-5

Added: to xref-config.xml and editor-config.xml support for a comma-separated list of target document-types in the XRef config.

6601764 Dec 20185.9700-beta-5

Added: support for fieldsize parameter on the services below (default 1000, maximum 10000) which is the maximum number of characters allowed in a result field:

/groups/{group}/search [GET]
/groups/{group}/search/predicate [GET]
/members/{member}/projects/{group}/search [GET]
   search/predicate [GET]
6601463 Dec 20185.9700-beta-5

Added: to document-config.xml, support for @description  attribute on <document> so that on creation, dynamic tokens can set the document description automatically.

6601583 Dec 20185.9700-beta-5

Added: the extendedmember=true parameter to the following services (administrators only):

members GET
find-members GET
find-project-members GET
**list-member-memberships GET

**administrators or self

6664243 Dec 20185.9700-beta-5

Fixed: errors when exporting files and viewing folders with filenames that include square brackets "[" or "]" characters.

66560716 Nov 20185.9700-beta-5

Added: featured image thumbnails for PSML and PDF documents to list and grid views of search results and to the edit sheet.

66492217 Oct 20185.9700-beta-5

Fixed: error in fragment history when an XML namespace occurs in PSML.

6646788 Oct 20185.9700-beta-5

Deprecated: "ps-" prefix on Default servlet parameters. Also added support for comparing different documents.


Although old parameters still work in this release, except for "ps-reload", any apps using the Default servlet must remove "ps-" from the start of all parameters.

6642103 Oct 20185.9700-beta-5

Fixed: non-admin unable to change Projects under insert XRef browse.

6638832 Oct 20185.9700-beta-5

Created on , last edited on