Content Server Manual / Version 2512.0
Table Of Contents
With the destroy tool you can delete resources from the repository.
Warning
By means of the destroy tool, you remove the indicated objects permanently and irrevocably. Use with great care. This tool is typically needed to recover from error conditions only.
usage: cm destroy -u <user> <other options> [ -f ] [ -R ] [ -l <limit> ]
[ <id1>... | -I <id1>... | -U <uuid1>... | -t <path1>... | -cq
<query1>... | -vq <query1>... ]
available options:
Options Description
-cq, --contentquery <query> query/queries to select
contents
-d, --domain <domain name> domain for login
(default=<builtin>)
-f, --force force destruction of folders
with children
-g, --grpc-endpoint <gRPC endpoint> gRPC endpoint to connect to
--grpc-wfs-endpoint <WFS gRPC endpoint> gRPC endpoint of Workflow
Server to connect to
--http-base-uri <HTTP base URI> HTTP base URI of Content
Server where HTTP servlets
are provided (e.g. blob
servlet)
-I, --id <id> id(s) to select content
objects
-l, --limit <limit> limits the number of content
objects to select, negative
for unlimited which is also
the default
-p, --password <password> password for login; you will
be prompted for password if
not given
-R, --recyclebin include contents from recycle
bin
-t, --path <path> path(s) to select content
objects
-U, --uuid <uuid> UUID(s) to select contents
-u, --user <user name> user for login (required)
--url <ior url> url to connect to
-v, --verbose enables verbose output
-vq, --versionquery <query> query/queries to select
versions
Numeric ids will be interpreted as content ids. Otherwise use explicit ids
like for contents (coremedia:///cap/content/1234) or versions
(coremedia:///cap/version/1234/56). For more formats have a look into
the UAPI developer manual.
The options have the following meaning:
| Parameter | Description |
|---|---|
-f | Force the destruction of non-empty folders, which is normally forbidden due to safety considerations |
-cq <query> |
Object Selection
Content Query to locate contents. For versions see -vq.
Parameter can be used multiple times. Results will be linked by OR.
|
-vq <query> |
Object Selection
Version Query to locate versions. For contents see -cq.
Parameter can be used multiple times. Results will be linked by OR.
|
-R |
Object Selection
Add contents from recycle bin. Could also be done via -cq.
|
-I <id> | Object Selection Select objects via explicit id. This is an alternative if you want to mix explicit ids with for example content queries. Parameter can be used multiple times. Results will be linked by OR. |
-U <uuid> | Object Selection Select contents via UUID. This is an alternative if you want to mix UUIDs with for example content queries. Parameter can be used multiple times. Results will be linked by OR. |
-t <path> | Object Selection Path of a resource to be destroyed. Parameter can be used multiple times. Results will be linked by OR. |
<ids> |
Object Selection
IDs of objects to be destroyed. If mixing with other content selection parameters, it is recommended
to explicitly use the parameter -I
Parameter can be used multiple times. Results will be linked by OR.
|
-l <limit> | Object Selection Limit the number of selected objects to the given value. Default is unlimited. |
Table 3.44. Options of destroy
Note
For information about the UAPI query syntax see Section 5.8, “Query Service” in Unified API Developer Manual.
In order to keep Content Management Server and
Master Live Server in sync, destroy tries to withdraw the
resources from the Master Live Server before it destroys them on a
Content Management Server. To avoid dead links on the
Master Live Server, all referencing content items are also
withdrawn. On the Content Management Server however, the
referencing content items are not destroyed, and thus dead links may arise.
Warning
This tool might affect your live site.
As stated above, the destroy tool tries to withdraw the content that should be deleted and all content that recursively links to this content! That is, if the content to be deleted is linked by other content, more content might be withdrawn from your live site than you expected.
So when you use the tool, be sure that only content you want to remove from the live site links to the content you want to destroy and keep in mind that destroy is an emergency tool.
destroy is an emergency tool. The normal way to get rid of resources without causing dead links
is to move them to trash and have them deleted by the cleaners (see
Section 3.13.2.3, “Cleaners”).
Concerning users and groups, destroy is not an LDAP tool. If you apply destroy to
LDAP users, the users will only be logged out and synchronized with the LDAP
repository on the next access. If you apply destroy to
LDAP groups, the groups will lose their roles and be synchronized with the LDAP
repository on the next access.
Unless the users have been deleted from the LDAP server, they will not disappear
from the CoreMedia CMS. If you delete users
and groups on the LDAP server, the CoreMedia CMS notices this
automatically. So you don't need destroy in the regular case but only to expedite the
synchronization process and remove special privileges immediately.
