close

Filter

loading table of contents...

Content Server Manual / Version 2010

Table Of Contents

3.13.1.1 Dump

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 -u <user> [other options] [<id1> <id2> ... |
 -U <uuid1> <uuid2> ... |
 -t <path1> <path2> ... |
 -pn <name1> <name2> ... |
 -cn <name1> <name2> ... |
 -un <name1> <name2> ... |
 -gn <name1> <name2> ...]
 If not properly prefixed, IDs are interpreted as numeric
 content IDs or UUIDs, content repository paths, user
 names, group names or content type names as appropriate.


 Available options:

 -f,--file-name <file name>    dump the output to the
                               given file (using UTF-8)
 -d,--domain                   domain for login
                               (default=<builtin>)
 -e,--encoding                 output encoding for dump
                               (default=platform encoding)
 -cn,--contenttype-name        names of contenttypes to dump
 -gn,--group <group>           names of groups to dump
 -p,--password                 password for login
 -pn,--processdefinition-name  names of processdefinitions
                               to dump
 -U,--uuids                    UUIDs of contents to dump
 -t,--paths                    path of contents to dump
 -u,--user                     user for login (required)
 -un,--user-name <user>        names of users to dump
 -url <ior url>                url to connect to
 -v,--verbose                  enables verbose output

The options have the following meaning:

Parameter Description
-f <file name> Name of the file where to dump the output using UTF-8 encoding. By default, the output is written to stdout.
-e <encoding> Choose the encoding of the dump output. "ISO-8859-1" creates a dump in ISO-Latin-1. "UTF-8" creates a Unicode dump. The default value is the platform encoding. Consult the API documentation of java.nio.charset.Charset of your particular JRE to find out other supported values.
-un <names> The named users to dump.
-gn <names> The named groups to dump
-pn <names> The named process definitions ("workflows") to dump
-cn <names> The named content types to dump
-U <UUIDs> UUIDs of contents to dump.
-t <paths> The paths of resources to dump.

Table 3.12. Options of dump


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 tool cm processdefinitions gives you IDs of workflow process definitions.

  • The tool cm processes gives you IDs of running processes.

  • Section 3.13.1.8, “Sessions” shows how to get IDs of open sessions.

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.

Search Results

Table Of Contents