Setting Up the Uninstall Connector Utility

6-68 Oracle Fusion Middleware Administrators Guide for Oracle Identity Manager ■ Files that constitute the Uninstall Connector utility are viable in OIM_HOMEserverbin directory. These files are as follows: – ConnectorUninstall.properties – uninstallConnector.bat – uninstallConnector.sh

6.9.4 Uninstalling Connectors and Removing Connector Objects

Depending on your requirements, you can use the Uninstall Connectors utility to perform any of the following tasks: ■ Uninstalling a Connector ■ Removing Adapters, Lookup Definitions, Resource Objects, and Scheduled Tasks The following section provides detailed instructions on using the ConnectorUninstall script to delete connector objects from the Oracle Identity Manager database. Each of the earlier sections provides a link to this section. ■ Running the Script to Uninstall Connectors and Connector Objects

6.9.4.1 Uninstalling a Connector

You can use the ConnectorUninstall script to uninstall a connector. When you run the script, all objects that form part of the connector and all the resource data that was collected through the connector are deleted from the database. As mentioned earlier in this guide, when a connector is defined, an entry is created for the connector in the Oracle Identity Manager database. This entry also includes the contents of the connector XML. When you choose to uninstall a connector, the utility identifies the connectors objects to be dropped by parsing the connector XML contents. Caution: It is strongly recommended that Oracle Identity Manager is idle and it is not available for any operations. You must ensure that: ■ There are no operations on Oracle Identity Manager while using uninstalling connector or connector objects ■ All scheduled tasks are disabled and there are no asynchronous messages pending for processing such as audit messages, offline provisioning messages, offline task messages, requests scheduled for future and so on. Note: Before running the uninstall utility: ■ You cannot use uninstall utility on production database. ■ You cannot delete data that are already archived. ■ You must ensure that you have the latest Oracle Identity Manager schema and MDS backup , which will help to restore if uninstall utility does not complete successfully. ■ You must ensure that your UNDO tablespace is sized properly. This is required if your developmenttest environment has significant amount of data to be deleted. Managing Connector Lifecycle 6-69 See Running the Script to Uninstall Connectors and Connector Objects on page 6-69 for the procedure.

6.9.4.2 Removing Adapters, Lookup Definitions, Resource Objects, and Scheduled Tasks

You can use the ConnectorUninstall script to remove an adapter, lookup definition, resource object, or scheduled task. Only the object that you specify is removed from Oracle Identity Manager.

6.9.4.3 Running the Script to Uninstall Connectors and Connector Objects

Running the script to uninstall connectors and connector objects includes the following procedures: ■ Preuninstall ■ Uninstall ■ Postuninstall

6.9.4.3.1 Preuninstall

Before Uninstalling the connector, you must: 1. Take Oracle Identity Manager Database backup so that if something goes wrong during uninstalling, then the data can be restored. See Oracle Identity Manager Database documentation for details about taking backup. Warning: ■ Connector uninstall collects all the objects information from the connector XML, which is created while installing or defining a connector. If an additional object, which is not related to this connector is added while defining the connector, uninstall would delete that too. For example, while defining AD connector, if user adds a system lookup or lookup related to other connector, uninstall would delete that lookup. ■ Ensure that only the connector specific objects are added while defining a connector. Caution: It is strongly recommended that Oracle Identity Manager is idle and it is not available for any operations. You must ensure that: ■ there are no operations on Oracle Identity Manager while using uninstalling connector or connector objects ■ all scheduled tasks are disabled and there are no asynchronous messages pending for processing such as audit messages, offline provisioning messages, offline task messages, requests scheduled for future and so on. Note: Before executing the uninstall, you must ensure that all scheduled tasks are disabled.