Deleting Organizations through Command Line Interface
Pre-requisites:
To delete an organization through the CentraSite Command Line Interface, you must have the CentraSite Administrator role.
Before you run the tool, make sure that the target user for transferring the ownership of referenced objects is activated.
In some circumstances, you may not be able to delete an organization because internal objects that reference it cannot be deleted. This can happen when there are internal references to an organization object even though the organization is no longer the owner of any assets. There can also be references to the organization object in the audit log.
CentraSite provides a command tool named delete Organization for this purpose. The tool does the following:
Transfers ownership of objects to the target user.
Redirects internal references to the target user.
Creates an
OWNERSHIPTRANSFERRED event in the audit logs for every registry object that references the organization object.
Remove the GUI configuration and the organization object.
Important:
The operation to delete an organization requires several steps that cannot run within a single transaction. This means every parallel running transaction is able to see intermediate results. Make sure no other activity is in progress while you run the tool. Moreover if there is a failure of any of the steps during the execution, the registry have an intermediate state. The original state cannot be recovered by rolling back the complete operation.
To delete an organization
Run the command delete Organization. The syntax is of the format: C:\SoftwareAG\CentraSite\utilities>CentraSiteCommand.cmd delete Organization [-url <CENTRASITE-URL>] -user <USER-ID> -password <PASSWORD> -targetuser <TARGET-USER> -organizationName <ORGANIZATION-NAME>
The input parameters are:
Parameter | Description |
CENTRASITE-URL | (Optional). The URL of the CentraSite registry. For example, http://localhost:53307/CentraSite/CentraSite. |
USER-ID | The user ID of a registered CentraSite user who has the CentraSite Administrator role. For example, Administrator. |
PASSWORD | The password for the CentraSite user identified by the parameter USER-ID. |
ORGANIZATION-NAME | The name of the organization you want to remove from the registry. |
TARGET-USER | The name or UUID of a CentraSite user to whom you want to transfer ownership of the objects that are referenced by the organization identified by the parameter -organizationName. |
Example (all in one line):
C:\SoftwareAG\CentraSite\utilities>CentraSiteCommand.cmd delete Organization -url http://localhost:53307/CentraSite/CentraSite -user Administrator -password manage -targetuser LDAPDomain\Claire -organizationName MISOrganization
The response to this command could be:
Executing the command : delete Organization
Successfully executed the command : delete Organization