Managing Ensemble Productions - InterSystems Documentation

Maintenance
• Delete deletes the entry in that row.
CAUTION:
You cannot undo the Delete operation.
12.4 Local Archive Manager
The [Ensemble] > [Maintenance] > [Archive Manager] page allows you to periodically save older messages to a separate
archive for long term storage.
The Archive Manager requires you to identify a namespace in which to keep the archive. InterSystems strongly recommends
that you keep this archive in a namespace that meets both of the following criteria:
• A separate namespace from those in which you run Ensemble productions. If you are running productions in more
than one namespace, be aware that multiple namespaces can archive their messages into one shared target namespace.
• An Ensemble-enabled namespace, so that you can use Ensemble Management Portal features such as the Message
Browser and Visual Trace whenever you have a reason to examine the archived messages. For details about Ensembleenabled
namespaces, see “Working with Namespaces” in the chapter “What to Manage.”
You can display the Archive Manager page as follows:
1. From the [Ensemble] home page menu, choose Maintenance.
2. From the Maintenance menu choose Archive Manager.
3. The Archive Manager page displays.
There is no menu on the Archive Manager page.
At the top of the page is an Run Archive command. This command is enabled only if there is data in all three fields in the
form and there is no previous archive operation still in progress.
Next, the page displays text — Current archive manager settings for namespace — and the name of the currently selected
namespace. The following fields display information about the Archive Manager:
• Archive to namespace — The namespace to which Ensemble saves archived messages.
• Archive manager class name — The class that acts as the Archive Manager. Generally you will keep the default of
Ens.Archive.Manager, but if you wish to customize the archive operation you can subclass Ens.Archive.Manager and
write your own code. If so, choose your subclass for this field.
• Number of days before archiving — Messages older than this number of days are automatically archived when you run
the archive operation.
To edit any of these settings in this part of the page, click Edit at right. A form displays. Change the information in the
fields and then click Save. If the save is successful, the page is refreshed with the new settings displayed. If the save failed,
the form displays the error message from the server.
The Archive history display provides information about the last or current archive. For example:
Archive start time 2008-06-04 16:52:55
Archive stop time 2008-06-04 16:52:55
Total messages processed 3002 - 100% finished
Total messages archived 0
Total message headers deleted 0
Total message bodies deleted 0
Archive status idle
108 Managing Ensemble Productions