The dump utility prints out arbitrary objects of the CoreMedia CMS repository. You will probably use it mainly to dump resources, but you can also dump users, processes etc.

usage: cm dump [<id1> <id2> ...] [-b <[plain|text]>] [-cn <name>] [-d
       <domain name>] [-e <encoding>] [-f <path>] [-gn <name>] [-p
       <password>] [-pn <name>] [-t <paths>] [-U <uuids>] -u <user name>
       [-un <name>] [-url <ior url>] [-v]

available options:

 -b,--blob <[plain|text]>              select blob output behavior; plain
                                       (default): represent as descriptive
                                       string;text: additionally dump text
                                       (and alike) blob contents
 -cn,--contenttype-name <name>         names of content types to dump
 -d,--domain <domain name>             domain for login
                                       (default=<builtin>)
 -e,--encoding <encoding>              encoding of the dump output
                                       (default=Cp1252)
 -f,--file-name <path>                 dump the output to the given file
                                       (using UTF-8)
 -gn,--group-name <name>               names of groups to dump
 -p,--password <password>              password for login; you will be
                                       prompted for password if not given
 -pn,--processdefinition-name <name>   names of process definitions to
                                       dump
 -t,--paths <paths>                    path of contents to dump
 -U,--uuids <uuids>                    UUIDs of contents, groups, or users
                                       to dump
 -u,--user <user name>                 user for login (required)
 -un,--user-name <name>                names of users to dump
 -url,--url <ior url>                  url to connect to
 -v,--verbose                          enables verbose output

If not properly prefixed, IDs are interpreted as numeric content IDs or
UUIDs, content repository paths, user names, group names, user/group UUIDs
or content type names as appropriate.

The options have the following meaning:

The standard way to specify a resource to be dumped is its ID. To dump the root folder, for example, you call

> cm dump -u admin -p admin 1

and get a result like

content: coremedia:///cap/content/1
  uuid: c4ca4238-a0b9-3382-8dcc-509a6f75849b
  type: Folder (coremedia:///cap/contenttype/Folder_)
  path: /
  created by: admin (coremedia:///cap/user/0), creation date:
    2004-12-20T07:57:19+00:00
  modified by: admin (coremedia:///cap/user/0),
    modification date: 2004-12-20T07:59:48+00:00
  is place approved: true, place approved by: -,
    place approval date: 2004-12-20T07:57:19+00:00
  is published: true, published by: -, publication date:
    2004-12-20T07:57:19+00:00
  to be deleted: false, to be withdrawn: false
  is checked out: false, current editor: -
  children:
    /Home (coremedia:///cap/content/5)
    /Inbox (coremedia:///cap/content/3)
    /System (coremedia:///cap/content/9)
    /work (coremedia:///cap/content/13)
    /work2 (coremedia:///cap/content/15)

The result for a content item looks similar; instead of the children you get detailed information about all versions of the content item. If you don't know the IDs of the resources you want to dump, you can alternatively specify their paths with the -t option, or their UUIDs with -U option, for example,

> cm dump -u admin -p admin -t /work/article1 -t /work/image1
> cm dump -u admin -p admin -U a935da47-271b-4712-9612-acf8aa1b965e

You can dump users and groups by specifying their names with the -n option, for example,

> cm dump -u admin -p admin -un publisher -gn system

dumps the user publisher and the group system.

As alternative to this, you may use the option -U to dump a user or group by its UUID, just as you can do it for content UUIDs.

> cm dump -u admin -p admin -U c4b75f33-b75f-3b23-9e13-bbff072f1c4d

However, all these examples are only special convenient variants of invoking the dump tool. As you can see in the very first line of the result of dumping the root folder, the actual ID of the root folder is not 1, but coremedia:///cap/content/1, and this format is the general way to use dump:

> cm dump -u admin -p admin coremedia:///cap/content/1

Each CoreMedia CMS object has such an ID and can be dumped. Try the above example for dumping users and groups, and you will get IDs like coremedia:///cap/user/5 and coremedia:///cap/group/1. You will obtain IDs of other objects by the other server tools:

The dump tool tries some additional heuristics to interpret strings given on the command line that do not match an ID pattern. IDs containing a slash are treated as a content repository path. String may also be interpreted as user names, group names or content type names if possible.