close

Filter

loading table of contents...

Content Server Manual / Version 2010

Table Of Contents

3.13 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, 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.

Caution

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.

Search Results

Table Of Contents