Uploaded workflow definitions are stored in the database as serialized objects. You can customize workflows by programming own extensions, for example actions, expressions, handlers. So every time, you have made incompatible changes in classes, which are used in already uploaded workflows, you need to convert these workflows. In case of an update of the CoreMedia Workflow Server, the workflows have to be converted, too. Otherwise, object deserialization errors can occur (see Oracle JDK documentation for details).
The workflowconverter utility has the following syntax:
cm workflowconverter [ -v | -c [processID]* | -X [processID]* |-r processID
jar]
The parameters have the following meaning:
| Parameter | Description |
|---|---|
-v
| Checks which workflows can not be deserialized and have to be converted. |
-c [processID]*
| If you use -c without a process ID parameter, all uploaded
workflows will be converted if necessary. If you enter process IDs, only the
workflows with the given process IDs will be converted. |
-X [processID]*
| Similar to -c the workflow converter converts the uploaded
workflows if necessary. If the conversion fails, the workflow process and all
corresponding workflow instances are removed from the workflow server. |
-r processID jar | Replace a custom made JAR file for a workflow with a new version (see Section 3.6.4, “Upload” for the upload of a JAR file). |
Table 3.5. Parameters of the workflowconverter utility
To convert the workflows, use the cm workflowconverter utility as follows:
Make sure that the CoreMedia Workflow Server is stopped.
Make sure that the Content Server to which the Workflow Server is attached is running. If necessary, start the Content Server.
Copy the changed classes (if any) into the appropriate directories.
Start the
workflowconverterutility. Note that the conversion only takes place, if the-cor-Xflag is given.Finally, start the workflow server again.
The Content Server must run so that user names and groups names can be resolved while reparsing the workflow definitions.
 |  |  |
 |