Deploy Human Task and Annotation Services

Content for the Human Task and Annotation services are stored separately from the main content store. This content may be stored in the same database as the content store as different tables or in a separate database. To deploy this content, scripts are used, rather than the deployment tool.

The procedure in this topic describes using scripts to deploying human task and annotation service content. For information about using scripts to deploy IBM® Cognos® Workspace comments, see Deploying IBM Cognos Workspace comments.

You deploy them by running a batch file, which retrieves your human tasks or annotations from a source database. Then you run another batch file to install them on a destination server.

Procedure

  1. Create task data in your database by creating a selection of tasks pointing to valid reports.

    For instructions on creating user tasks, see the IBM Cognos Event Studio User Guide. For more information about annotations (comments), see the IBM Cognos Workspace User Guide.

  2. On the source server, open a command prompt in c10_location/bin.
  3. Run the file htsDeployTool with the following arguments:

    htsDeployTool -camUsername camUsername -camPassword camPassword -camNamespace camNamespace -exportFile exportFileName -password exportFilePassword

    where:

    • camUsername is the username for the namespace.
    • camPassword is the user password for the namespace.
    • camNamespace is the name of the namespace.
    • exportFileName is the name of the export file that will be created, for example, HumanTaskExportFile1.
    • exportFilePassword is the password for the export file.

    Enclose arguments that contain spaces in quotes. Precede special characters with a backslash. For example:

    htsDeployTool -exportFile "jan\'s file" -password test2Password -camNamespace default -camUsername myId -camPassword myPassword

    To allow anonymous access, omit the -cam arguments.

    To export annotations, add the argument -persistenceUnit annotations. For example:

    -camPassword <camPassword> -camNameSpace <camNamespace> -exportfile AnnotationExportFile1 -password <exportFilePassword> -persistenceUnit annotations.

  4. Check to make sure that the file <exportFileName>.xml.gz was created in c10_location/deployment. For example, HumanTaskExportFile1.xml.gz. Copy it.
  5. On the destination server, paste the file <exportFileName>.xml.gz in c10_location/deployment.
  6. On the destination server, open a command prompt in c10_location/bin and run the file htsDeployTool with the following arguments:

    htsDeployTool -camUsername camUsername camPassword -camNamespace camNamespace -importFile importFileName -password importFilePassword

    where:

    • camUsername is the username for the namespace.
    • camPassword is the user password for the namespace.
    • camNamespace is the name of the namespace.
    • importFileName is the name of the file that you created in step 3.
    • importFilePassword is the password for the file that you created in step 3.

    See additional syntax tips in step 3.

Parent topic: Deployment