Understanding the Task Archival Utility

Using the Archival Utilities 23-9 11. On Microsoft Windows platforms, reset the short date format to the date format for your region or locale after the Task Archival utility finishes running. Use the Regional and Language Options command in the Control Panel to reset the date format.

23.2.4 Reviewing the Output Files Generated by the Task Archival Utility

Table 23–2 describes the output files that are generated by the Task Archival utility.

23.3 Using the Requests Archival Utility

This section describes how to use the Requests Archival utility. It contains the following topics: ■ Understanding the Requests Archival Utility ■ Prerequisites for Running the Requests Archival Utility ■ Input Parameters ■ Running the Requests Archival Utility ■ Log Files Generated by the Utility

23.3.1 Understanding the Requests Archival Utility

By default, Oracle Identity Manager does not remove closed or withdrawn requests from the active request tables. To archive these requests and free up the disk space and thereby enhance database performance, the Requests Archival utility is used. You can archive request data based on request creation date and request status. Archiving Note: You must enter the value of Y or N when prompted. If you press Enter without selecting a value, then the utility again counts the number of tasks to be archived and prompts you without beginning the archive. Note: You must analyze the active task tables and their indexes for updated statistics, because the data from active task tables is removed. Perform this step only if you are using Oracle Database as the database for Oracle Identity Manager. Table 23–2 Output Files Generated by the Task Archival Utility File Description Err_DB_Conn_timestamp.log Generated when the utility is unable to connect to the database with the specified credentials Err_Arch_Tasks_timestamp.log Generated when the archival or deletion processes fail Arch_TaskData_timestamp.log Generated when the archival or deletion processes succeed Note: These error log files are deleted when you run the utility again. 23-10 Oracle Fusion Middleware Administrators Guide for Oracle Identity Manager requests based on the request status is optional. By using request status, you can archive: ■ Completed requests such as requests with status Withdrawn, Closed, and Completed. This is specified by selecting the 1 for Completed option. ■ Completed and failed requests such as requests with status Withdrawn, Closed, Completed, Failed, and Partially Failed. This is specified by selecting option 2 for Completed and Failed . ■ All requests based on request creation date. This is specified by selecting option 3 for All . Table 23–3 lists the names of the tables which are to be archived and the corresponding archival table names. The files that constitute the Oracle Database version of the Requests Archival utility are located in the following directory: OIM_HOME dboimoracleUtilitiesRequestArchival You can run the Requests Archival utility in offline mode with Oracle Identity Manager stopped, or in online mode with Oracle Identity Manager running. Before running the utility in offline mode, you must stop Oracle Identity Manager.

23.3.2 Prerequisites for Running the Requests Archival Utility

Before running the Requests Archival utility: ■ Create the OIM_REQUEST_ARCH tablespace. When the Requests Archival utility is run for the first time, a corresponding archival table is created for all the tables that are to be archived. The archival tables are created in a separate tablespace Table 23–3 Archival Tables Main Table Archival Table REQUEST ARCH_REQUEST REQUEST_HISTORY ARCH_REQUEST_HISTORY REQUEST_APPROVALS ARCH_REQUEST_APPROVALS REQUEST_ENTITIES ARCH_REQUEST_ENTITIES REQUEST_ENTITY_DATA ARCH_REQUEST_ENTITY_DATA REQUEST_BENEFICIARY ARCH_REQUEST_BENEFICIARY REQUEST_BENEFICIARY_ENTITIES ARCH_REQUEST_BE REQUEST_BENEFICIARY_ENTITYDATA ARCH_REQUEST_BED REQUEST_TEMPLATE_ATTRIBUTES ARCH_REQUEST_TA WF_INSTANCE ARCH_WF_INSTANCE REQUEST_COMMENTS ARCH_REQUEST_COMMENTS Note: You must set LD_LIBRARY_PATH to start Oracle utilities such as SQLPlus in the environment where you want to run Oracle Identity Manager utilities.