storePasswords command

The storePasswords command prompts for passwords that are blank in a profile and stores the encrypted passwords in the file. Storing encrypted passwords might not be FIPS 140-2 compliant, and you can cancel the command after the prompt about compliance.

Syntax

You can run the command for a single task or for all tasks in the profile. If a password entry in a configuration XML file is not blank, the following message is displayed.
There are no missing passwords to store.
The following syntax includes line breaks to format the command for reading. Enter the command and options on a single line without any line breaks.
configmgr_cl storePasswords [-task task_type | -taskfile task_file_name]
 -profile myprofile [-help]

Parameters

-task task_type

The -task task_type parameter specifies a specific task to encrypt the passwords for. You can omit the -task task_type parameter if you want to store passwords for all the tasks or if you specify the -taskfile task_file_name parameter.

If you omit the -task task_type parameter and the -taskfile task_file_name parameter, you are prompted to enter the passwords for each configuration XML file in the profile. Each password is encrypted before it is added to the XML file.
Table 1. Passwords and files
Password description Property name and XML file name
Application server administrator password ApplicationServerAdminPassword property in the websphereapplicationserver.xml file.
IBM® Content Navigator administrator password NexusPassword property in the contentnavigatorserver.xml file
Content Platform Engine domain user password CEPassword property in the contentengineserver.xml file
Directory service bind user password LDAPBindPassword property in the configureldap.xml file
Case operations password CaseOperationsPassword property in the registerprojectarea.xml file (development environment) or registertargetenv.xml file (production environment)
LTPA key password LTPAKeyPassword property in the importltpakey.xml file

When you specify a specific task for the storePasswords command, encrypted passwords are added to the task file, the websphereapplicationserver.xml file, the contentnavigatorserver.xml file, and the contentengineserver.xml file. The following table describes the valid task_type and task_file_name values, the password property names, and the task configuration XML file names that are affected by the task options.

Table 2. Valid task_type and task_file_name values
task_type values task_file_name values Description

No value is specified.

No value is specified.

Encrypts the passwords for all the tasks in the profile, as listed in Table 1.

configbox configbox.xml

Encrypts the password configuring the Box host properties.

configibmbpm

configibmbpm.xml

Encrypts the password configuring the IBM Business Automation Workflow host properties.

configrules configrules.xml Lists the task that configures business rules in your solution.

registerprojectarea

registerprojectarea.xml

Encrypts the case operations user password that is stored in CaseOperationsPassword property in the registerprojectarea.xml file and the IBM Content Navigator administrator password that is stored in the NexusPassword property in the contentnavigatorserver.xml file.

registertargetenv

registertargetenv.xml

Encrypts the case operations user password that is stored in CaseOperationsPassword property in the registertargetenv.xml file and the IBM Content Navigator administrator password that is stored in the NexusPassword property in the contentnavigatorserver.xml file.

-taskfile task_file_name

Specifies the configuration XML file to encrypt the passwords for. You can omit the -taskfile task_file_name parameter if you want to store passwords for all the tasks or if you specify the -task task_type parameter.

If you omit the -task task_type parameter and the -taskfile task_file_name parameter, you are prompted to enter the passwords for each configuration XML file in the profile. Each password is encrypted before it is added to the XML file. The passwords that you enter depend on the type of profile, which is described in Table 1.

See Table 2 for the valid task_file_name values and passwords.

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

Sample commands

The following examples include line breaks to format the command for reading. Enter the command and options on a single line without any line breaks.
Encrypt and save all passwords for a profile.
The following command encrypts and saves passwords for any blank entries in the profile named develop1:
configmgr_cl storePasswords -profile develop1
Show the help for the storePasswords command.
The following command shows the help for the storePasswords command:
configmgr_cl storePasswords -help