loading table of contents...

3.14. Server Utility Programs

The 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 Manual], 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.

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. This is optional. If you don't specify the password on the command line (because you don't want it to be stored in the shell history, for example) the tool will prompt for it at runtime.
-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.

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 Manual].