Deleting Organizations from the Command Line

CentraSite Documentation : CentraSite Administrator’s Guide : Basic Operations : Usage of the CentraSite Command Tools : Deleting Organizations from the Command Line

In some circumstances, an organization object cannot be deleted 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.

Note:

Deleting organizations using CentraSite command line tool is explained in this section.

For procedures on deleting organizations using CentraSite Business UI, see the section "Working with Organizations" in Working with the CentraSite Business UI.

For procedures on deleting organizations using CentraSite Control, see the section "Managing Organizations" in Working with the CentraSite Business UI.

CentraSite provides a command line 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.

Removed the GUI configuration and the organization object.

Prerequisite: Before you run the tool, make sure that the target user for transferring the ownership of referenced objects is activated.

Important:

The operation to delete an organization requires several steps that cannot run within a single transaction. This means every parallel running transaction will be 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 will have an intermediate state. The original state cannot be recovered by rolling back the complete operation.

The syntax for the command is:

C:\SoftwareAG\CentraSite\utilities>CentraSiteCommand.cmd|sh delete Organization [-url <CENTRASITE-URL>] -user <USER-ID> -password <PASSWORD> -targetUser <TARGET-USER> -organizationName <ORGANIZATION-NAME>

The input parameters are:

Parameter	Description
-url	(Optional). The fully qualiﬁed URL of the CentraSite registry/repository. Default value is http://localhost:53307.
-user	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.
-organizationName	The name of the organization you want to remove from the registry.
-targetUser	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:

C:\SoftwareAG\CentraSite\utilities>CentraSiteCommand.cmd|sh 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

Contact Support | Community | Feedback