Exporting a solution package by using the command line

You must export the case management solution package from the development environment domain before you can move the solution to the production environment domain. You can use the command line to export the solution package.

Before you begin

Ensure that the solution does not contain locked items. You cannot export a solution that contains locked items.

Be sure to have your completed configuration checklist available.

About this task

A solution package consists of the assets in the solution folder in a case management design object store. The package includes these items:
  • The solution definition file.
  • The connection definition.
  • The task steps (stored as one XPDL file per case type).
  • The Pages subfolder.
  • The default page objects and any custom page objects that you created in the development environment.
  • Any documents, objects, or folders that were in the solution folder at the time of export, including those added by the user.

Procedure

To export the solution package:

  1. Change the current directory to the install_root/CaseManagement/configure directory. Where install_root is the location where IBM® Business Automation Workflow is installed.
  2. Run the following command. Do not enter any line breaks when you enter the command. 
    configmgr_cl exportSolution -profile myprofile 
 -solutionName solution_name | -solutionTemplateName template_name 
 -solutionPackage package_file
 [-help] [-silent] [-force]
    -profile myprofile
    Specifies the profile to use. The myprofile value can be one of the following items:
    • The name of the profile, such as develop1. The profile is located in the install_root/CaseManagement/configure/profiles directory. install_root is the location where IBM Business Automation Workflow is installed.
    • The full path to the profile directory, such as "install_root\CaseManagement\configure\profiles\develop1" or /install_root/CaseManagement/configure/profiles/develop1.
    • The full path to the profile input file, such as "install_root\CaseManagement\configure\profiles\develop1\develop1.cfgp" or /install_root/CaseManagement/configure/profiles/develop1/develop1.cfgp.
    -solutionName solution_name
    Specifies the solution to export. You can omit this option if you are exporting a solution template.
    -solutionTemplateName template_name
    Specifies the solution template to export. You can omit this option if you are exporting a solution.
    -solutionPackage package_file
    Specifies the full path and file name for the exported solution package ZIP file. If the path includes spaces, put the entire path in double quotation marks. For example, enter "C:\Solution Packages\Credit Dispute Solution.zip".
    -help
    Optional and displays a brief message on the command syntax instead of running the command.
    -silent
    Optional: When you specify the -silent parameter, no prompts or informational messages are shown in the console, but the errors are written to the log. Failure messages and validation error messages are shown as needed, such as messages about missing passwords or invalid port numbers. If you run the execute command to run all the tasks in a profile and you specify the -silent parameter, you must also specify the -force parameter.
    -force
    Optional and applies only when the -silent parameter is used. When you specify the -force parameter, the task is run without pausing for required responses to validation error messages, such as messages about missing passwords or invalid port numbers.

Results

The solution package ZIP file is created in the folder that you specified.

What to do next

Import the solution package into the new environment.