Managing Ensemble
Using the Archive Manager
[Back] [Next]
   
Server:docs1
Instance:LATEST
User:UnknownUser
 
-
Go to:
Search:    

The [Ensemble] > [Archive Manager] page allows you to periodically save older messages to a separate archive for long-term storage. The Archive Manager is deprecated. Instead of using the Archive Manager, you should use the Enterprise Message Bank, which enables you to archive messages from multiple productions. For an overview, see Defining the Enterprise Message Bank in Developing Ensemble Productions. Also see Using the Enterprise Message Bank in Monitoring Ensemble

To navigate to the Archive Manager page, click Ensemble, click Manage, and then click Local Archive Manager.
This chapter describes how to use this page. It contains the following topics:
Archive Basics
The page displays the following archive settings for the active namespace:
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:
Click Edit to the right of the namespace to update these settings. 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  2012-01-05 12:06:10
Archive stop time  2012-01-05 12:06:10
Total messages processed  70 - 100% finished
Total messages archived  0
Total message headers deleted  0
Total message bodies deleted  0
Archive status  idle
Archiving Data
Note:
During this process, Ensemble scans the entire message header table. Accordingly, you should use this option when the performance impact is acceptable.
At the bottom of the page is the Run Archive command. This command is operable only if there is data in all three fields in the form and there is no previous archive operation still in progress. After clicking Run Archive, click OK to verify and begin the archive.
Caution:
You cannot stop the archive operation.
The archive operation runs in the background and displays progress statistics while it is running. The numbers in the display update continuously, with count and percentage continuing to change until the result reaches 100%, status becomes idle, and a final stop time appears:
Archive start time: 2008-05-14 18:19:02
Archive stop time:
Total messages processed 100 - 10% finished
Total messages archived 3
Total message headers deleted 1
Total message bodies deleted 1
Archive status running
If errors occur during the archive operation, you see the following display.
Total number of errors XX [show error log] 
[show error log] is a link that toggles with [hide error log]. You can click this link to show or hide the error log. The maximum number of errors displayed in the table is 1000. Each time you run an archive operation, it deletes the previous archive error log.
Default Behavior
If you use the default class (Ens.Archive.Manager), Ensemble does the following for each message to be archived:
Note:
Messages cannot be restored once archived to another namespace.