Skip to main content

 Installation

PageSeeder installation and upgrade instructions

Release Notes – Version 6.2001 (11 August 2025)

DescriptionIDDateVersion

Added: “date created” and “last sign-in” to Admin account page, also added “status filter” and bulk “disable / enable / activate / unlock” account options when status is selected.

96985921 Jul 20256.2001

Modified: multi-factor authentication to automatically select code entry field.

97317121 Jul 20256.2001

Fixed: copy and pasting numbered lists reverting to default numbering.

94191321_Jul_20256.2001

Fixed: non-breaking spaces splitting when editing in inline labels.

96550321 Jul 20256.2001

Fixed: possible error "Signature not supported. Hash algorithm SHA1 not available" when installing PageSeeder on el9 (enterprise linux).

97302318 Jul 20256.2001

Fixed: rendering in document display mode italic, bold, underline, code or inline PSML elements that only contain whitespace.

96549618 Jul 20256.2001

Added: the following API services:

DELETE /authenticators/{authenticator}
GET    /authenticators/{authenticator}
PATCH  /authenticators/{authenticator}
POST   /authenticators/{authenticator}/challenge
POST   /authenticators/{authenticator}/verify
POST   /groups/{group}/members/{member}/email
DELETE /groups/{group}/publications/{publicationid}
GET    /members/{member}/authenticators
POST   /members/{member}/authenticators
GET    /members/{member}/groups/{group}/uris/{uri}/workflow
GET    /self/authenticators
POST   /self/authenticators

Modified: the following API services:

  • POST /authenticate – added support for action=challenge and parameters authenticator, challenge, code and credential.
  • POST /members/{member}/groups/{group}/uris/{uri}/workflow – added support for parameter draft.
  • PATCH /members/{member} – added support for parameter disabled.
  • GET /members/find – added support for parameter status.
9435976 Aug 20256.2001

Fixed: out of memory error when comparing large tables in side-by-side mode.

97309014 Jul 20256.2000

Added: options to import / export markdown files.

9699091 July 20256.2-beta-5

Fixed: marking unedited fragments as changed, when switching between documents in edit mode.

97294527 Jun 20256.2-beta-4

Added: support for underscores in numerical global properties ending with K, M or G, to multiply the number by a thousand, million or giga (e.g. 1_000_000, 100K, 2M, 3G). Also fixed error when maxUploadSize property is set to more than 2G.

97212227 Jun 20256.2-beta-4

Fixed: label display in document versions panel.

9719153 Jun 20256.2-beta-4

Added: Reprocess button to the Template configuration page for adding new document metadata properties to document types. The new properties may be specified in the document template, or they may overwrite property values on existing documents in a group.

97139027 May 20256.2-beta-4

Added: a copy publication script to sample document type bundles.

97164827_May_20256.2_beta-4

Fixed: error saving multiple edits when the document history panel is open.

9711247 May 20256.2-beta-3

Added: to the combined view, a new Gasherbrum III diff algorithm to improve change tracking in XML structures such as list items and table rows.

9321837 May 20256.2-beta-3

Added: option to download a CSV file of “Document Activity”.

9709735 May 20256.2-beta-3

Added: Member details tab to Template configuration page so that project managers can edit custom member fields.

9337262 May 20256.2-beta-3

Added: to the <ps:process> ANT task, an options to stop logging  warnings:

<warning imagenotfound="false" xrefambiguous="false" 
         xrefnotfound="false"/> 

Logging missing image warnings is now default behavior, so scripts using <ps:export binarymetadataonly="true">, for example, should add:

<ps:process><warning imagenotfound="false"/>
97096716 Apr 20256.2-beta-3

Fixed: custom help images not accessible to some users.

9702974 Apr 20256.2-beta-2

Fixed: links in help, also added a history tab to the help panel.

9694232 Apr 20256.2-beta-2

Modified: the image upload when editing a publication, so the images folder defaults to the same level as the publication root document.

There is no longer the creation of a top level images folder as part of a new group.

7048471 Apr 20256.2-beta-2

Fixed: systemctl timeout on PageSeeder el8/9 upgrades. Also add display of upgrade progress to the UI.

The DBMonitor service can now return status, and upgrade progress, as XML or JSON.

9699121 Apr 20256.2-beta-2

Modified: the “duplicate” dialog to uncheck by default, the "Track the duplicate as a variation of the original document" option.

To maintain a connection between the source document and the duplicate, users now need to check this option.

9699851 Apr 20256.2-beta-2

Added: a “delete publication ID” service to help manage a corrupt publication.

96995431 Mar 20256.2-beta-2

Modified: General / Recent logs, to collapse exceptions by default.

96953426 Mar 20256.2-beta-2

Added: MFA (multi-factor authentication) support using:

  • a code sent to an email address,
  • TOTP authenticator apps,
  • backup codes, and
  • webauthn (devices, Yubikeys, Passkeys).

There is also beta support for SMS code. To access this, set global property smsProvider to console-test or twilio-verify, and then set smsProviderApiKey, smsProviderApiSecret, smsProviderServiceId and adding sms-otp to mfaSupport global property.

Where a user can't sign-in, an administrator can create an email authenticator for them on the Account profile page.

94359721 Mar 20256.2-beta-1

Added: a security log listing the following events:

  • account change,
  • authentication,
  • CSRF, deletion,
  • email change,
  • username change,
  • password change,
  • configuration change,
  • other.
96605724 Mar 20256.2-beta-1

Fixed: cursor in a markdown property jumping to the start of the field after autosave.

96881924 Mar 20256.2-beta-1

Added: check box to any document in a publication so the publish can run source="publication". This saves the user from having to return to the publication root to publish.

Also added personal preference "Prioritise publications in navigation (beta)" to display the current publication in the navigation bar, with a drop-down menu for documents that are in multiple publications.

93062121 Mar 20256.2-beta-1

Added: reminder messages for tasks / workflows that are due, or overdue. Sent every Monday, to enable this, set global property reminderNotification=true and select the "Send reminder emails" group property in the desired project / group configuration pages. Use the following global properties and default values to customize behavior:

  • reminderMaxEmails=2000
  • reminderStatuses=Open,Initiated,In Progress,Complete
  • reminderTime=04:00
62438421 Mar 20256.2-beta-1

Added: select option on server indexing page for projects to index, and a find field when there are too many projects / groups to list.

96336121 Mar 20256.2-beta-1

Fixed: display of line-breaks (shift-enter or <br/>) in document view mode, when the "Display white spaces and special characters" option is selected.

96917317 Mar 20256.2-beta-1

Added: “Quick edit” option to the fragment menu for faster editing of a single fragment, and with less scrolling.

Double-clicking a fragment now starts quick edit by default but a user prompt allows for switching to the legacy editing experience.

96858917 Mar 20256.2-beta-1

Added: support for malware scanning to file upload, or comment attachements. This requires ClamAV integration through the global property:

malwareScanner=[host]:[port]

To enable scanning of email attachments, set  malwareMaxEmailThreads to a non-zero value that is not more than ClamAV MaxThreads.

96879517 Mar 20256.2-beta-1

Added: option to Account profile page to disables sign-in, email notifications and all permissions, while preserving all member data. For disabled accounts, there is an “enable account” option.

95428114 Mar 20256.2-beta-1

Added: new <ps:progress> ANT task to send progress info, log messages and result instructions to PageSeeder. Instead of the <echo> and <echoxml> ANT tasks, use this to simplify the code and open result in a panel, link to a PSML document or reload the current document.

96621911 Mar 20256.2-beta-1

Fixed: display of deleted sections and xref-fragments in combined compare, and allowed deleted="true" on <section> for processed-level PSML when using compare-diffx=combined parameter.

9552175 Mar 20256.2-beta-1

Fixed: indexing and display of workflow steps as discussions in some panels.

9632685 Mar 20256.2-beta-1

Fixed: creation of non-breaking spaces when adding bold or other formatting at the end of a line and when pasting into preformat elements.

9587935 Mar 20256.2-beta-1

Added: option on publish dialogs for administrators to display a icon to "Allow download of the working files" next to "Show console" to create and download a ZIP of the script working folder.

96488226 Feb 20256.2-beta-1

Fixed: disabling of URL indexing using disableIndexing=true in config/group.properties.

96888518 Feb 20256.2-beta-1

Added: support for MySQL v8.4.

PageSeeder version 5x still requires MySQL v5.7.

9254127 Feb 20256.2-beta-1

Added: field psrootpublicationtype to index, and updated current index version to 91100.

After upgrading, use the Server indexing page to RE-INDEX EVERYTHING.

95422215 Jan 20256.2-beta-1

Added: the Argon algorithm as the new default for password hashing.

9414795 Feb 20256.2-beta-1

Fixed: comments / tasks disappearing from a document when comparing it with a different version.

9684853 Feb 20256.2-beta-1

Fixed: possible corruption of PSML structure if old structure XLinks have status 'Documentation-New'.

96825321 Jan 20256.2-beta-1

Removed: redirect port functionality and made the redirectPorts global property obsolete.

95404714 Jan 20256.2-beta-1

Fixed: missing XML declaration from PSML export. This allows better XML tools support (e.g. the XPath collection function).

ANT scripts using the <concat> task, or similar, on exported PSML, must first remove the XML declaration.

95831413 Jan 20256.2-beta-1

Fixed: OAuth scope permissions for comments and URLs.

96797613 Jan 20256.2-beta-1
Added: to the default word-export-template.docx:
  • Table Bulleted List, Table Numbered List and associated paragraph styles,
  • Subtitle 2, TOC Heading, Front Matter 1, Front Matter 2 for headings.
  • Also added to the default template, Word sections for cover page, front matter and landscape pages.

The version of the template used is now shown in the Status property under File > Info in Word. To use the correct Word section, a custom word-export-config.xml may need to add

<document wordsection="3" />

to the config just under <elements>.

96783810 Jan 20256.2-beta-1

Modified: the database as follows:

  • Add the AUTHENTICATOR table for multi-factor authentication.
  • Add a unique constraint on the Name field in the HOSTALIAS table to improve integrity.
  • Remove from the CONTENT table, the unused Role, Title and Label fields.
  • Remove from the URI table, the unused Status field.
  • Remove from the XLINK table, the unused ShowDefault and ActuateDefault fields.
  • Ensure new PageSeeder servers use the utf8mb4 charset after the deprecation of utf8 in MySQL 8.

BEFORE upgrading, backup the database and CHECK that the free disk space is at least equal to the database size using a command similar to:

du -sh /opt/mysql

PageSeeder may be down for 30 minutes while upgrading, depending on the size of the database.

9446598 Jan 20256.2-beta-1

Added: to Schematron support for ps:resource?location=x URL to get template resources.

Also added a sample, general bundle Schematron quickfix to check the word-export-config.xml against a publication and remove unused block labels.

96621117 Dec 20246.2-beta-1

Added: sending of email notification to new, and previous, email addresses after changing.

6034692 Dec 20246.2-beta-1

Fixed: quickfix fragment labels not defaulting to transformed *fragment/@labels attribute.

Also, automatically reload XSLT templates when they change.

96523627 Nov 20246.2-beta-1

Fixed: Tomcat error when URL contains invalid characters. After upgrading PageSeeder on an enterprise linux(el) 7 distribution (e.g. CentOS 7) run service pageseeder config. Running this service is not necessary with el 8 or 9 distributions.

96520227 Nov 20246.2-beta-1

Fixed: ignoring white space changes inside <heading>, <para> and <preformat> on upload.

91799026 Nov 20246.2-beta-1

Added: support for the following:

  • <source type="publication"> in publish-config.xml and document-config.xml to flag target scripts that are only for publications.
  • independent=true parameter / attribute on export services/ANT task which removes the _ from _local and _external folders to make them more portable.
  • Better error / warning messages for publish scripts and uploads.

Running custom scripts on the publication root requires setting the <source type="publication">. Until this is done, users need to untick "Export/Publish/Process the whole publication" to access them.

93059025 Nov 20246.2-beta-1

Added: support for csrfMode global property which determines if non-GET requests require an Anti-CSRF-Token header/parameter as follows:

  • enforce – means required,
  • partial – means required except for legacy API requests,
  • disabled – means not required.
  • Adding a -log suffix means that all requests without the correct token are logged as warnings (default is partial-log).

All scheduled publish scripts accessing the local PageSeeder must specify target/@username instead of specifying username/password in a properties file.

All remote scripts accessing PageSeeder must use OAuth client config properties.

All apps should also use OAuth to access PageSeeder.

92281915 Nov 20246.2-beta-1

Fixed: cookies not setting SameSite=lax. After upgrading PageSeeder on an enterprise linux(el) 7 distribution (e.g. CentOS 7) run service pageseeder config. On el 8 or 9, run:

/opt/pageseeder/bin/setup
92281915 Nov 20246.2-beta-1

Fixed: upload option not displayed for word-export-template.docx if it already exists.

9603106 Nov 20246.2-beta-1

Fixed: template admin pages not indicating that the project is using a different template.

9629736 Nov 20246.2-beta-1

Fixed: group documents sorting folders in left panel differently to folders in main content.

96248329 Oct 20246.2-beta-1

Added: markup from headings and resolvable placeholders inside <xref> elements which use template {heading}.

Character-style elements (except for <image> and <xref>) can now appear inside <xref> elements in PSML with level="processed".

95698016 Oct 20246.2-beta-1

Fixed: non-publication Word/PDF export having multiple heading 1 by not adjusting heading levels in non-publication content.

This is a change to the default Word/PDF export. To enable adjusting heading levels create a custom export build.xml and set:

ps:process/publication/headingleveladjust="content"
96027011 Oct 20246.2-beta-1

Added: automatic saving of draft workflows, so users don't lose their text.

94169018 Oct 20246.2-beta-1

Added: options to filter access logs by permission (Administrator, Project manager, Group manager, Member, Public), and method (Read, Write).

This filtering will not work with logs written prior to upgrading.

94171618 Oct 20246.2-beta-1

Added: option to organize access logs by group.

93662918 Oct 20246.2-beta-1
Created on , last edited on