loading table of contents...

3.14.3.6. Republish

You can use the republish tool to publish all content and versions below a given folder which have been published in a given period. A major use case is the update of a Master Live Server which has been recovered with a backup (see Section 3.9.3, “Recovery of a Master Live Server Database”).

There are certain limitations when using this tool:

  • Because the tool spawns only a single publication, it should not be used when there are many thousands of resources to be published. In particular, for the recreation of a fresh Master Live Server from a Content Management Server the tool cm publishall described in Section 3.14.3.5, “Publishall is more appropriate.

  • The tool cannot repeat the publication of withdrawals and deletions.

  • The tool cannot repeat the publication of resources that have been marked for withdrawal or deletion after being published.

  • The tool cannot repeat the publication of moves and renames of resources that have been moved or renamed again after being published.

  • If the publication of a new folder fails for any reason, no resources contained in the folder can be published.

  • If the publication of a new content item fails or any reason, no content items linking to that content item can be published.

usage: cm republish -u <user> [other options] [-f <path>]

available options:

 -a,--after                  Minimum date for documents to be 
                             republished <default=2 days before now>. 
                             Format is yyyyMMddHHmmss
 -b,--before                 Maximum date for documents to be 
                             republished <default=now>. 
                             Format is yyyyMMddHHmmss
 -d,--domain <domain name>   domain for login (default=<builtin>)
 -f,--folder <folder>        base folder for republication (mandatory 
                             only for multisite systems)
 -p,--password <password>    password for login
 -u,--user <user name>       user for login (required)
 -url <ior url>              url to connect to
 -v,--verbose                enables verbose output

Example 3.27. 


The options have the following meaning:

Parameter Description
-a Start date for content items to be republished. The format is yyyyMMddHHmmss. By default, the start date is two days before now.
-b The end date for content items to be republished. The format is yyyyMMddHHmmss. By default, the end date is the current date.
-f The base folder for republication. It's only mandatory for multi-site systems. By default, the root folder will be taken as the base folder.

Table 3.39. Parameters of the republish utility