Exporting a security configuration by using the command line

Edit online

Draft comment:
This topic only applies to BAW, and is located in the BAW repository. Last updated on 2025-01-20 10:38

You must export the case management security configuration from one domain (such as the testing or development environment) before you can move the security configuration to another domain (such as the production environment). You can use the command line to export one or more security configurations.

About this task

The exportSolutionSecurityManifest command exports a list of security configurations that are associated with a solution to prepare for importing the security configurations to another IBM® Business Automation Workflow environment. Security configuration settings are stored in a security manifest file. You must specify a development environment or production environment profile with this command to provide information about the Content Platform Engine server that contains the security configuration. You can specify the path for the security configuration package or omit the value to use the default name and path.

Procedure

To export the security configuration:

Change the current directory to the install_root/CaseManagement/configure directory, where install_root is the location where Business Automation Workflow is installed.
Run the following command. Do not enter any line breaks when you enter the command.
```
configmgr_cl exportSolutionSecurityManifest -profile myprofile 
 -manifestNames manifest_names -manifestPackage manifest_package_file 
 -solutionName solution_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.
-manifestNames manifest_names

Specifies the name of the security manifest. To specify more than one manifest at a time, enter multiple -manifestNames options with the command.

-manifestPackage manifest_package_file

Specifies the exported security package ZIP file. You can specify the full path and file name for the exported security package ZIP file. If the path includes spaces, put the entire path in double quotation marks. For example, enter "C:\Security Packages\Security1.zip".

If you specify only the file name, the security package is exported to the ICM_Home/CaseManagement/configure directory. If you do not specify an option for -manifestPackage, the security package is exported to ICM_Home/CaseManagement/solution_packages/SolutionName_securityManifest.zip.

-solutionName solution_name

Specifies the name of the solution that is associated with the security configuration.

-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.

Results

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

What to do next

Import the security configuration package into the new environment.