Installing silently 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-03-13 12:15
You can install IBM® Business Automation Workflow silently using the command line. With this method, you need to run only one command to perform the installation.

Before you begin

If you do not have the prerequisite base products that are necessary for IBM Business Automation Workflow installation, you must install the base products as part of the silent installation. The required base products are:
  • IBM Installation Manager
  • WebSphere® Application Server Network Deployment, including the ejbdeploy and thinclient features.
When you install the product, also install any available cumulative fixes or fix packs by adding the repository where you downloaded the fix. Additionally, install security fixes as they become available.
If you are installing from downloaded images from Passport Advantage®, ensure that you downloaded all three required images for Windows. If you are installing from the DVD images, obtain the compressed files from the DVDs. In both cases, extract all of the files from the compressed files to the same location on your hard disk. Make sure to extract all files to one single folder on your hard disk.
Restriction: Use 7zip External link opens a new window or tab to extract the files. Disk 2 is too big for the built-in Windows extraction tool.

About this task

During the silent installation, the following tasks are performed:
  • Installation Manager is installed or updated to the appropriate level.
  • The required base products and IBM Business Automation Workflow are installed.

Only one IBM Installation Manager is required to install multiple instances of IBM Business Automation Workflow.

Procedure

  1. Run the following command to generate encrypted passwords using Installation Manager to securely connect to Db2® and the administrative console.
    Important: On Windows, start your command prompt by right-clicking and selecting Run as administrator.
    extract_directory\IM64\tools\imutilsc -silent -nosplash encryptString password_to_encrypt
    Note: If you already have Installation Manager installed, run the command from the IM_installation_directory\eclipse\tools directory.
  2. Read and accept the license terms before installing. Adding -acceptLicense to the command line means that you accept all licenses.
  3. Use the table in this step to compose the command line to install the product.
    Important: On Windows, start your command prompt by right-clicking and selecting Run as administrator.
    extract_directory\IM64\tools\imcl install list_of_package_IDs -acceptLicense -installationDirectory location -repositories repository -properties key=value,key=value -showVerboseProgress -log logName.log
    where:
    • list_of_package_IDs is a list of the IDs for the products and features that you want to install. You must include the required features. The syntax is packageID,feature,feature, with multiple products separated by spaces.
      Tip: Names of the installable features provided by a package might differ, depending on your platform. To determine the features that you can install for your platform, run the imcl listAvailablePackages command, for example: extract_directory\IM64\tools\imcl listAvailablePackages -features -long -repositories ./repository
      Table 1. Package IDs
      Product Package ID Feature and Description
      IBM Business Automation Workflow Enterprise com.ibm.bpm.ADV.v85
      • WorkflowEnterprise.NonProduction - Test, staging, or development use
      • WorkflowEnterprise.Production - Production use
      Important: Do not mix production and non-production servers in the same cell.
      IBM Business Automation Workflow Express com.ibm.bpm.EXP.v85
      • WorkflowExpress.NonProduction - Test, staging, or development use
      • WorkflowExpress.Production - Production use
      Important: Do not mix production and non-production servers in the same cell.
      IBM Business Automation Workflow Enterprise Service Bus com.ibm.bpm.ESB.v85
      • EnterpriseServiceBus.NonProduction - Test, staging, or development use
      • EnterpriseServiceBus.Production - Production use
      Important: Do not mix production and non-production servers in the same cell.
      WebSphere Application Server Network Deployment com.ibm.websphere.ND.v85
      • core.feature: Required. WebSphere Application Server core content.
      • ejbdeploy: Required. Pre-Enterprise JavaBeans (EJB) 3.0 modules.
      • thinclient: Required. Stand-alone thin clients and resource adapters.
      • embeddablecontainer: Embeddable EJB container.
      • samples: Sample applications feature.
      • com.ibm.sdk.6_64bit: 64-bit SDK.
      Installation Manager com.ibm.cic.agent
      • agent_core: Installation Manager core content.
      • agent_jre: Installation Manager Java™ Runtime Environment (JRE).
      Db2 for Windows 64-bit com.ibm.ws.DB2EXP.winia64 Db2 must match the operating system
    • location is the path to the directory where you want to install the products. To install into an existing supported instance of WebSphere Application Server Network Deployment, specify its directory.
      Tip: Keep the installation path as short as possible. Otherwise, you might run into problems later when the paths of other components, when added to this path, exceed the 255-character path limit.
    • repository is the path to the repository where you have extracted the files: 
      extract_directory\repository\repos_64bit

      For more than one repository, separate the repository locations with commas.

    • key=value is a list of the keys and values you want to pass to the installation, separated by commas. Do not put spaces between the commas. Create encrypted passwords using the IBM Installation Manager.
      Important: You must include the user.wasjava=java8 property.
      If you are installing Db2, you can include the following properties:
      Table 2. Keys
      Key Description
      user.db2.admin.username User name with authority to access the Db2 database
      user.db2.admin.password Encrypted password for the user name with authority to access the Db2 database. Choose a password that complies with the password policy of your system.
      user.db2.port Port for the Db2 database. The default value is 50000.
    • logName is the name of the log file to record messages and results.
    Running this command installs the product with the default features. To install any specific features or make other changes, see the reference link for the command-line arguments for imcl.

Results

Installation Manager installs the list of products and writes a log file to the directory that you specified. The log file is empty if there are no errors or warnings.

Example

The following example installs IBM Business Automation Workflow, WebSphere Application Server Network Deployment, and Db2 on Windows.
Tip: If you copy the example, make sure there are no line breaks.
imcl install com.ibm.bpm.ADV.v85,WorkflowEnterprise.NonProduction com.ibm.websphere.ND.v85,core.feature,ejbdeploy,thinclient,embeddablecontainer,samples,com.ibm.sdk.6_64bit com.ibm.ws.DB2EXP.winia64 -acceptLicense -installationDirectory C:\IBM\BPM -repositories D:\temp\BPM\repository\repos_64bit -properties user.wasjava=java8,user.db2.admin.username=bpmadmin,user.db2.admin.password="Vvrs88V/a9BUdxwodz0nUg==" -showVerboseProgress -log silentinstall.log
The following example installs IBM Business Automation Workflow Enterprise Service Bus and WebSphere Application Server Network Deployment on Windows.
Tip: If you copy the example, make sure there are no line breaks.
 imcl install com.ibm.bpm.ESB.v85,EnterpriseServiceBus.NonProduction com.ibm.websphere.ND.v85,core.feature,ejbdeploy,thinclient,embeddablecontainer,samples,com.ibm.sdk.6_64bit -acceptLicense -installationDirectory C:\IBM\BPM -repositories D:\temp\BPM\repository\repos_64bit -showVerboseProgress -log silentinstall.log
The following example installs IBM Business Automation Workflow from C:\tmp\BPM\repository\repos_64bit, a cumulative fix from C:\tmp\BPMCF, WebSphere Application Server Network Deployment, and Db2 on Windows.
Tip: If you copy the example, make sure there are no line breaks.
imcl install com.ibm.bpm.ADV.v85,WorkflowEnterprise.NonProduction com.ibm.websphere.ND.v85,core.feature,ejbdeploy,thinclient,embeddablecontainer,samples,com.ibm.sdk.6_64bit com.ibm.ws.DB2EXP.winia64 -acceptLicense -installationDirectory C:\IBM\BPM -repositories C:\tmp\BPM\repository\repos_64bit,C:\tmp\BPMCF -properties user.wasjava=java8,user.db2.admin.username=bpmadmin,user.db2.admin.password="Vvrs88V/a9BUdxwodz0nUg==" -showVerboseProgress -log silentinstall.log
The following example installs IBM Business Automation Workflow Enterprise Service Bus from C:\tmp\BPM\repository\repos_64bit, a cumulative fix from C:\tmp\BPMCF, and WebSphere Application Server Network Deployment on Windows.
Tip: If you copy the example, make sure there are no line breaks.
 imcl install com.ibm.bpm.ESB.v85,EnterpriseServiceBus.NonProduction com.ibm.websphere.ND.v85,core.feature,ejbdeploy,thinclient,embeddablecontainer,samples,com.ibm.sdk.6_64bit -acceptLicense -installationDirectory C:\IBM\BPM -repositories C:\tmp\BPM\repository\repos_64bit,C:\tmp\BPMCF-showVerboseProgress -log silentinstall.log
The following example installs IBM Business Automation Workflow on an existing WebSphere Application Server installation under C:\IBM\BPM on Windows. Ensure that the WebSphere Application Server installation meets the prerequisites.
Tip: If you copy the example, make sure there are no line breaks.
imcl install com.ibm.bpm.ADV.v85,WorkflowEnterprise.NonProduction -acceptLicense -installationDirectory C:\IBM\BPM -repositories D:\temp\BPM\repository\repos_64bit -showVerboseProgress -log silentinstall.log
The following example installs IBM Business Automation Workflow Enterprise Service Bus on an existing WebSphere Application Server installation under C:\IBM\BPM on Windows. Ensure that the WebSphere Application Server installation meets the prerequisites.
Tip: If you copy the example, make sure there are no line breaks.
 imcl install com.ibm.bpm.ESB.v85,EnterpriseServiceBus.NonProduction -acceptLicense -installationDirectory C:\IBM\BPM -repositories D:\temp\BPM\repository\repos_64bit -showVerboseProgress -log silentinstall.log

What to do next

After you install Business Automation Workflow, you must configure the product by creating profiles, setting up database tables, and configuring the network deployment environment. To do these configuration tasks in one step, use the BPMConfig command. Alternatively, you can do each configuration step separately using the Profile Management Tool, if it is supported on your operating system, and the Deployment Environment wizard.
Important: If you are migrating business data and applications from a previous version, use the configuration instructions in the Migrating to IBM Business Automation Workflow section.