Creating custom profiles using the manageprofiles command-line utility

Instead of using the Profile Management Tool, you can use the manageprofiles command-line utility to create custom profiles.

Before you begin

Make sure that you are not already running the manageprofiles command-line utility on the same profile. If an error message is displayed when you run the command, determine if there is another profile creation or augmentation action in progress. If so, wait until it completes.

Restriction: To run the manageprofiles command on Windows 7, Windows Vista, or Windows Server 2008, you must elevate your Microsoft Windows user account privileges using the runas command. Remember to put double quotation marks around the manageprofiles command and all parameters. For example, the following command can be run from the install_root\bin directory:
runas /env /user:MyAdminName "manageprofiles.bat -response myResponseFile" 
Non-administrative users are prompted for the administrator password.

Procedure

  1. Determine the kind of profile you want to create, which in turn determines the template to use for your profile (using the -templatePath option).

    Templates for each profile are located in the install_root\profileTemplates\BPM directory for BPM templates and under install_root\profileTemplates for other products.

    The following templates are available for custom profiles:
    • managed.procctr: for a Process Center custom profile for IBM BPM Standard.
    • managed.procctr.adv: for a Process Center custom profile for IBM BPM Advanced.
    • managed.procsvr: for a Process Server custom profile for IBM BPM Standard.
    • managed.procsvr.adv: for a Process Server custom profile for IBM BPM Advanced.
    • managed.esbserver: for a WebSphere® Enterprise Service Bus custom profile.
  2. Determine which parameters are required for your profile by reviewing the example profile creation commands. Determine the values that you want to supply for the profile by reviewing the default values in the manageprofiles parameters topic.
  3. To use the -responseFile parameter, look at the provided sample response files and create a response file that is specific to your environment.
    Important: Ensure that you do not leave blank spaces after the values; for example 'personalCertValidityPeriod=1 ' or 'winserviceCheck=false '. Spaces will cause profile creation to fail.

    The samples are located in the install_root\BPM\samples\manageprofiles directory.

    Choose an appropriate response file based on the database and type of profile (stand-alone or network, Process Center or Process Server). The following sample files are available:
    • PC_Std_DMgr_DB2.response
    • PC_Std_DMgr_DB2zOS.response
    • PC_Std_DMgr_Oracle.response
    • PC_Std_DMgr_SQLServer.response
    • PC_Adv_DMgr_DB2.response
    • PC_Adv_DMgr_DB2zOS.response
    • PC_Adv_DMgr_Oracle.response
    • PC_Adv_DMgr_SQLServer.response
    • PC_Std_Managed_DB2.response
    • PC_Std_Managed_DB2zOS.response
    • PC_Std_Managed_Oracle.response
    • PC_Std_Managed_SQLServer.response
    • PC_Adv_Managed_DB2.response
    • PC_Adv_Managed_DB2zOS.response
    • PC_Adv_Managed_Oracle.response
    • PC_Adv_Managed_SQLServer.response
    • PC_Std_Standalone_DB2.response
    • PC_Std_Standalone_DB2zOS.response
    • PC_Std_Standalone_Oracle.response
    • PC_Std_Standalone_SQLServer.response
    • PC_Adv_Standalone_DB2.response
    • PC_Adv_Standalone_DB2zOS.response
    • PC_Adv_Standalone_Oracle.response
    • PC_Adv_Standalone_SQLServer.response
    • PS_Std_DMgr_DB2.response
    • PS_Std_DMgr_DB2zOS.response
    • PS_Std_DMgr_Oracle.response
    • PS_Std_DMgr_SQLServer.response
    • PS_Adv_DMgr_DB2.response
    • PS_Adv_DMgr_DB2zOS.response
    • PS_Adv_DMgr_Oracle.response
    • PS_Adv_DMgr_SQLServer.response
    • PS_Std_Managed_DB2.response
    • PS_Std_Managed_DB2zOS.response
    • PS_Std_Managed_Oracle.response
    • PS_Std_Managed_SQLServer.response
    • PS_Adv_Managed_DB2.response
    • PS_Adv_Managed_DB2zOS.response
    • PS_Adv_Managed_Oracle.response
    • PS_Adv_Managed_SQLServer.response
    • PS_Std_Standalone_DB2.response
    • PS_Std_Standalone_DB2zOS.response
    • PS_Std_Standalone_Oracle.response
    • PS_Std_Standalone_SQLServer.response
    • PS_Adv_Standalone_DB2.response
    • PS_Adv_Standalone_DB2zOS.response
    • PS_Adv_Standalone_Oracle.response
    • PS_Adv_Standalone_SQLServer.response
    Copy one of the sample response files to your working directory. Edit the parameters in the response file as appropriate to your configuration and save the edited response file. Make sure that the templatePath property path matches your specific installation directory.
  4. Run the file from the command line. For example:
    Note: The following example is an example only and shows optional parameters as well as required parameters. For a more complete set of parameters that can be changed, see the response file for creating custom profiles.
    manageprofiles.bat -create -templatePath install_root/profileTemplates/BPM/managed.procctr.adv -adminUserName bpmadmin -adminPassword bpmsecret -dbUserId dbuser -dbPassword dbsecret 
    If you have created a response file, specify the -response parameter without any other parameters. For example:
    manageprofiles.sh -response myResponseFile
    The status is written to the console window when the command is finished running. Normal syntax checking on the response file applies as the file is parsed like any other response file. Individual values in the response file are treated as command-line parameters.

What to do next

After you have finished adding custom profiles, configure the deployment environment.