Importing a solution from a manifest by using the command line

You can deploy an IBM® Business Automation Workflow Case solution from a version control system (VCS) into a production environment or a different development environment. You must first extract the solution manifest from the VCS. You then use this manifest to import the solution into the design object store in the new environment before you can deploy the solution to the environment domain.

Before you begin

Run the extract script that you created for the VCS to extract the manifest and related solution files.

Procedure

  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. Import the solution manifest by running the following command. Do not enter any line breaks when you enter the command.
    configmgr_cl importSolutionManifest -profile myprofile 
     -solutionManifest mymanifest
     -projectAreaName project_area_name 
     [-silent] [-force] [-help]
    -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.
    -solutionManifest mymanifest
    The full path to the solution manifest that you want to import.

    If the path includes a directory name with spaces, enclose the path in double quotation marks. For example, enter "C:\Solution Manifests\PREFIX_Manifest.json".

    Any files that are related to the solution manifest must be in the same folder as the solution manifest.

    Important: Do not rename any of the extracted files including the solution manifest file. Do not modify the content of any of the extracted files.
    -projectAreaName project_area_name
    Specifies the name of the project area for the solution. This option is valid only for importing a solution package to into another development environment.
    -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 activities 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 activity is run without pausing for required responses to validation error messages, such as messages about missing passwords or invalid port numbers.
    -help
    Optional: Shows a brief message on the command syntax instead of running the command.