Recording a GUI-based installation

Complete the step-by-step instructions to record a silent GUI-based installation.

Before you begin

You must use IBM Installation Manager to perform a recorded installation. If you have not already done so, download the IBM Installation Manager now.

If you are upgrading from a previous release, stop any running instances of the previous installation.

Close all open programs and any command prompt windows.

Procedure

  1. To record a silent GUI-based installation, open a new command prompt window and issue the following command line.
    • WindowsNavigate to the \IBM\Installation Manager\eclipse folder.

      For installation in the English language, enter IBMIM.exe -record response.xml -skipInstall <IM_data_dir>...where response.xml is the silent installation file to be generated and <IM_data_dir> is a new directory generated for the Installation Manager to write and store data into.

      For example:

      IBMIM.exe -record response.xml -skipInstall C:\SterlingInstallData

      For installation in another, supported language, enter: IBMIM.exe -record response.xml -skipInstall <IM_data_dir> - nl <locale_code>

      For example:

      IBMIM.exe -record response.xml -skipInstall C:\SterlingInstallData -nl zh_TW

    • UNIXLINUXNavigate to the /IBM/Installation Manager/eclipse folder.

      Enter ./IBMIM -record response.xml -skipInstall <IM_data_dir>...where <silent_filename>.xml is the silent installation file to be generated and <IM_data_dir> is a new directory generated for the Installation Manager to write and store data into.

      For example:

      ./IBMIM -record response.xml -skipInstall $HOME/SterlingInstallData

      For installation in another, supported language, enter: ./IBMIM -record response.xml -skipInstall <IM_data_dir> - nl <locale_code>

      For example:

      ./IBMIM -record response.xml -skipInstall $HOME/SterlingInstallData -nl zh_TW

  2. Review the installation packages to be installed.
  3. Review and accept the license agreement.
  4. Accept the default location for the shared resources directory, or browse to a new location.
  5. Accept the default location for Installation Manager directory, or enter a different location.
  6. Review and accept the package group to be installed and the installation directory, or browse to a new location.
  7. Select the languages for which you want to install the Sterling Order Management System Software language pack translations.
    Note: By default, the English language is selected.
  8. Select the appropriate features to install. More information about each feature is provided under Details.
    Note: By default, the Product Files feature is selected.
  9. Enter the location and name of the JDK home directory. Copying the JDK to your installation directory is selected by default. If you do not want a copy of the JDK made under your installation directory, clear the checkbox.
  10. Select Enable Sharded Database Mode if you plan to use more than one database vendor. If you select Enable Sharded Database Mode, then the next screen shows Enable mixed database vendor support checkbox. Select this check box if you plan to use more than one database vendor. If you plan to use only one vendor, ignore this check box and select your database vendor Oracle or Db2 from the list. Click Add Jars to browse to the JDBC driver file for Oracle or Db2. Repeat to add the license file for Db2 (required). Then enter the information for the remaining database fields.
    1. If doing a non-sharded installation, enter information for the following fields:
      • Database user name
      • Database password/Confirm database password
      • Database catalog name
      • Database host name (or IP address)
      • Database port
      • Database schema name
        Note:
        • Sharded Database Mode is supported in Sterling Order Management System Software version 10.0 Fix Pack 7, or later.
        • The default schema names are always the same as the user name, except that the schema names are all uppercase. This applies to both nonsharded and sharded scenarios.
      To test the connection to the database, click Validate Connection. If a message saying the connection failed is displayed, verify the information you entered in all fields and try validating again.
      Note: The Validate Connection option does not work when the ojdbc8.jar is used as an Oracle driver.
    2. If doing a sharded database installation, click Add Jars to browse to the JDBC driver file. If you are using mixed database vendors, you may need to add more than two drivers.

      If you are using only one database vendor, browse to the Jars for Oracle or Db2. Repeat to add the license file for Db2 (required).

      For each shard type, you can select Reuse existing database shard configuration, which auto-fills the required fields with existing database information, or select Create new database shard configuration, which prompts you to enter the following database information for Statistics, Configuration, Master, and Transaction connections. If you are using mixed database vendors, you will also pick the database vendor type for each connection.

      • Database user name
      • Database password/Confirm database password
      • Database catalog name
      • Database host name (or IP address)
      • Database port number
      • Database schema name
        Note:
        • The Transaction and Master database shard configuration must have the same connection data.
        • The default schema names are always the same as the user name, except that the schema names are all uppercase. This applies to both nonsharded and sharded scenarios.
      For each shard, you can test the connection to the database by clicking Validate Connection. If a message saying the connection failed is displayed, verify the information you entered in all fields and try validating again.
      Note: The Validate Connection option does not work when the ojdbc8.jar is used as an Oracle driver.
  11. Select Enable Upgrade if you are upgrading from a previous release or if you are doing a new installation, but want to apply DDL manually after installation.
  12. You could select Install Reference Implementation option if you are planning to install reference implementation.
  13. Enter the following information in the Database Information screen:
    • Database Vendor
    • Database user name
    • Database password/Confirm database password
    • Database catalog name
    • Database host name (or IP address)
    • Database port number
    • Database schema name
    • Database driver jars
      Note: The default schema names are always the same as the user name, except that the schema names are all uppercase.
  14. Based on the selection that is made to the Database Vendor in the Database Information screen, perform the following steps in the Database Details screen:
    • If you have chosen Db2 as your database vendor, choose whether to use multibyte support.
    • If have chosen Oracle, there are no additional database properties to configure; click Next.
  15. In the Memory Arguments screen, enter the ADDITIONAL_ANT_JAVA_TASK_ARGS and ADDITIONAL_ANT_COMPILER_TASK_ARGS memory parameter settings for your operating system.
  16. Click Install to start the installation.
    A progress bar is displayed at the bottom of the screen.
  17. When the installation is complete, a status screen is displayed. Click Finish.
    You can also view the installation log from this screen.
    Note: If the installed_data directory is not removed by the post installation cleanup process, you can delete it. It is only used for installation.
  18. Exit Installation Manager.
  19. You now have a response.xml file from which you can run a silent installation.