Content Server Manual / Version 2406.1
Table Of ContentsThe CoreMedia CMS provides a series of server utility programs for information, adjustment and optimization of the server processes. Basically there are four categories of such tools:
Information
The informational tools allow you to inspect the current state of the CoreMedia CMS. You can dump all kinds of server objects, such as resources, running processes or used licenses. Furthermore, you can query system information about the CoreMedia CMS itself (esp. the version), which becomes important whenever you submit a support request.
Operation
With the operational tools you control the CoreMedia CMS. This includes cleaning up the repository, uploading new workflow definitions and maintaining the database.
Repository
The repository tools allow you to execute actions normally performed by the editors, like approving and publishing resources or starting workflows. They are emergency tools, needed only in exceptional cases to fix the repository immediately when something went wrong.
General usage
All server utilities are implemented as cm
programs as described in the Operations Basics,
that is you run them from the command line with cm
, cmw
or cm64
. Most of the tools open a session
and therefore need a user who is specified by three command line options -u
, -d
and
-p
.
Furthermore, you can explicitly specify the IOR URL of the content server to connect to. If you don't specify the
URL, it is taken from capclient.properties
. That implies, that most of the tools work only on one server
simultaneously.
Parameter | Description |
---|---|
-u <name>
| The name of the user |
-d <domain>
| The domain of the user (optional, only for LDAP users) |
-p <password>
| The password of the user (optional) |
-url <ior url>
| The IOR URL of the content server (optional) |
Table 3.11. Common options of server utilities
These options are common for most of the server utilities, and will therefore not be mentioned in detail for each tool. Note that most server utilities require administrative permissions and thus can only be run with users of administrative groups.
The password parameter -p
is always optional.
You can provide the password as the environment variable REPOSITORY_PASSWORD
instead.
If you don't specify the password at all, the tool will prompt for it at runtime.
Protecting Passwords
A password that is provided via the command line might be visible in the shell history or in the list of running processes. A password provided via an environment variable might accidentally be passed to other commands, if the environment variable is set in a long-running shell or even during shell initialization.
If you must not or cannot enter the password manually, consider setting the environment variable in a wrapper script. Preferably the password is retrieved automatically from a secure password vault. If the password is stored in the shell script, the shell script must not be readable by other users.
If you are not sure how to use a utility, just start it without any options to print out a summary of its usage.
General usage in a Windows 64-bit environment
The server utilities can be started using the cm64.exe
command in a Windows 64-bit environment with a
JVM 64-bit, as described in the Operations Basics.