Group maintenance page

Key point: General maintenance tasks and archival.

Use this page if you need to perform maintenance tasks following large imports of data or system upgrades.

Index

PageSeeder maintains your index up-to-date automatically. However, there might be situations where you need to index the content manually.

For example, if you have recently upgraded PageSeeder and you prefer to index groups separately, or if you change the indexing configuration.

Click Index to open the index dialog box.

You can then select which objects to index:

  • Documents and folders.
  • URLs.
  • Comments and tasks.
  • Document versions (see following).

Indexing is a background system task, as it might take some time for the job to complete. You view the progress of the indexing on this page, or on the dashboard if you are an administrator.

Document versions

By default, PageSeeder doesn’t index document versions, as they significantly increase the size of the index and might affect the search user experience.

To enable the indexing of document versions, you need to select the Index document versions option on the group configuration page.

For developers: Document versions are indexed when the boolean group property indexVersions is set to true.

Clearing the index

Clearing the index is generally unnecessary. However, because the indexing process determines whether to re-index an object based on its last modified date, you need to clear the index if you change any of the indexing options in your group properties form.

If you suspect that the index contains results that were deleted, you might also need to clear the index before re-indexing.

Selecting the option Clear the index, to force PageSeeder to clear the index before starting the index process, ensures that all indexable objects in your group are indexing using the same configuration.

When you clear the index, the search results are incomplete until the indexing finishes.

Resolve references

Click the Resolve button, to open the resolve references dialog, if you have documents that contain unresolved xrefs, links or images. This might happen if you imported a large collection of documents without resolving references.

PageSeeder looks through all the PSML documents in the group and attempts to resolve any unresolved references.

When you resolve references, a background system task is started. You can monitor the progress on this page. When the task is finished you can see results on the process logs (group) page.

For developers

The resolution process tries to use the href attribute first on <xref> and <link> (src attribute on <image>).

On <xref> if there are no documents or URLs matching the path specified in the href, PageSeeder tries to resolve using the docid attribute.

uriid attributes on <xref>, <link> and <image> are ignored as they could have come from a different PageSeeder server.

Repair publications

This action fixes searches and document activity which are out of sync with the actual publications.
After repair, the publication group(s) are automatically re-indexed.

If the server crashes, or there is a database problem while publication information is being saved, information can become out of sync with the actual publications. In this case, searches or document activity results might return documents that are not in the publication or be missing some that are. Performing repair publications fixes this.

Archive a group

When a group is archived:

  • The group is moved to the archive project.
  • Members of the group no longer have access to the group.
  • New comments or edits are not allowed in the group.
  • The group’s index is removed.
  • Documents and folders in the group are considered archived.

Click Archive if you want to archive the group and all its contents. You must confirm you want to archive by typing “ARCHIVE” in the dialog, then click Yes.

Immediately after archiving, you see the group dashboard page. At the top right, you see an archived flag to the right of the group name. 

Managers of the group can unarchive a group. See How to unarchive a group.

Delete a group

Click Delete if you want to permanently delete the group and all its content.

By default, this option is disabled on PageSeeder. Administrators can enable group deletion – see delete.

This operation is irreversible. When you delete the group, all its content is permanently removed from PageSeeder – both in the database and file system – with no option to recover.

How to find this page

Administration menu > [Group] > Administration > Group maintenance