Skip to main content

History Retention Schedule

While configuring history tracking for an identity store, you can choose to keep history records forever in the GroupID database or retain history for a specific period (see the Configure History Tracking topic). In case you select the latter option, the History Retention schedule is auto created for the identity store. This schedule runs on a specified frequency to check if the retention period is over for any history records, and if so, move them from the GroupID database to the following .csv files:

  • History - contains history data of the GroupID portal, Synchronize, GroupID Management Shell, scheduled jobs, and the GroupID mobile app. It also contains history data for the identity store, security roles, and workflow configurations.
  • AuditingHistory - contains history data of all authentication actions performed in GroupID, as logged in Helpdesk history. See the History in Helpdesk topic.
  • PasswordCenterHistory - contains history data of all actions tracked in Helpdesk, except the authentication action. See the History in Helpdesk topic.
  • AdminCenterHistory - contains Admin Center history data. See the Admin Center History topic.

These files are available at the following location on the GroupID server:
X:\Program Files\Imanami\GroupID 11.0\GroupIDDataService\Inetpub\GroupIDDataService\Web\HistoryBin\
(X is the GroupID installation drive)

History data moved to these files is not longer displayed in GroupID.

NOTE: Admin Center history does not fall in a specific identity store, so its retention mechanism is different. GroupID checks the identity store of the user who performed an action logged in Admin Center history, and archives that record according to the history retention setting of the identity store that user belongs to.

After the History Retention schedule runs, the following information is displayed on the History page in identity store configurations:

historyretention

You cannot create or delete a History Retention schedule; only update the existing one.

What do you want to do?

Update the History Retention Schedule​

  1. In Admin Center, click Identity Stores in the left pane.

  2. On the Identity Stores page, click the ellipsis button for an identity store and select Edit.

  3. Click Schedules under Settings in the left pane.

  4. On the Schedules page, click the plus sign next to History Retention. Then click the ellipsis button for the schedule and select Edit.

  5. On the Edit Schedule page, the schedule name is displayed in the Schedule Name box as read-only.
    The default name format is: HistoryRetention<identity store ID><identity store name>.

  6. The Name Preview box displays the schedule name as HistoryRetention; the schedule is displayed with this name in email notifications.

  7. In the Scheduler Service Name drop-down list, select a Scheduler service that would be responsible for triggering this schedule. The number of services displayed in the list depend on the number of Elasticsearch clusters in the environment, as each cluster has its own Scheduler service. See the Scheduler Service topic.

  8. The Triggers area displays the default triggering frequency for the schedule.

    • To change a trigger, click Edit for it.
    • To add a new trigger, click Add Trigger.

    Follow step 11 in the Create a Group Usage Service Schedule topic to manage triggers.

  9. Click Update Schedule.

  10. On the Schedules page, click Save.
    For general schedule info, see the View the Schedules in an Identity Store  topic.

See Also