20.3 Purging Data from the Operations Database

To run the Data Purge utility, you must have an account with the Global Administrator or Data Administrator authorization in Identity Governance. To avoid entering the settings for the Identity Governance server each time you run the Data Purge utility, you can use a parameters file. For more information, see Creating a Parameters File to Run the Data Purge Utility.

NOTE:The utility always refreshes the list of purgeable items after you perform a purge.

By default, Identity Governance installs the Data Purge utility in the /opt/netiq/idm/apps/idgov/bin (Linux) c:\netiq\idm\apps\idgov\bin (Windows) directory.

  1. Back up the operations database (by default, igops) to preserve historical information before purging the database.

  2. (Conditional) If you do not have a parameters file, complete the following steps:

    1. Enter the following command:

      • Linux: ./data-purge-utlility.sh

      • Windows: data-purge-utility.bat

    2. At the prompts, specify the settings for the Identity Governance and OSP servers.

      For more information about the required settings, see Creating a Parameters File to Run the Data Purge Utility.

  3. (Conditional) To run the utility from a parameters file, complete the following steps

    1. Enter the following command:

      • Linux: ./data-purge-utility.sh datapurge.paramter.file=file_name

      • Windows: data-purge-utility.bat datapurge.parameter.file=file_name

    2. At the prompts, specify the passwords for the Identity Governance user and Client ID for the authentication server.

  4. (Optional) To review a list of commands and the online help, enter ?.

  5. (Optional) To change the timeframe in which the utility searches for purgeable data, complete one of the following sets of steps:

    1. date

    2. mm dd yyyy h:mm:ss AM/PM

      For example, to search for purgeable data since a specific date, enter date and then enter Sep 30 2017 11:20:00 AM.

    or

    1. days

    2. n

      For example, to search for purgeable data older than a day, enter days and then enter 1.

    NOTE:If you are using a parameters file, the utility applies the retention timeframe specified in the file. You can override that setting by entering a new value.

  6. Specify the type of data that you want to purge.

    For example, to purge one or more data sources, enter 7.

  7. Review the list of purgeable items, then specify those that you want to purge.

    For example, you chose to purge data sources and the utility responded with the following information:

    Data Source Name

    Collection ID

    Type

    Status

    Collection Time

    1. Full-time Employees

    1

    Identity

    Completed

    Sep 29, 2016 9:24:21 AM

    2. Miami, Inc. Consultants

    3

    Identity

    Completed

    Sep 29, 2016 9:36:36 AM

    3. Money Stats

    4

    Application

    Completed

    Sep 30, 2016 9:07:01 AM

    4. Trending Actions

    7

    Application

    Completed

    Sep 30, 2016 11:15:44 AM

    To purge the data source called Full-Time Employees, enter 1. To purge all the sources except Money Stats, enter 1-2,4.

  8. To quit the utility, enter q.