Recording a text-based interactive installation

Complete the instructions provided to record a text-based interactive 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, text-based installation, open a command prompt window and issue the following command line.
    • WindowsNavigate to the \IBM\Installation Manager\eclipse\tools folder.

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

      For example:

      imcl.exe -c -record response.xml -skipInstall C:\SterlingInstallData

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

      For example:

      imcl.exe -c -record response.xml -skipInstall C:\SterlingInstallData -nl zh_CN

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

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

      For example:

      ./imcl -c -record response.xml -skipInstall $HOME/SterlingInstallData

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

      For example:

      ./imcl -c -record response.xml -skipInstall $HOME/SterlingInstallData -nl zh_CN

  2. Follow the prompt to select Installation and press Enter.
  3. Select the packages to install and press Enter.
  4. Select the current version for installation and press Enter.
  5. Press Enter on the confirmation screen to move to the next screen.
  6. Accept the license agreements and press Enter.
  7. Choose a location for the Shared Resources directory. The default is IBM\SDPShared. To choose a different directory, type M and press Enter. Type the path and directory name and press Enter.
  8. Press Enter on the confirmation screen to move to the next screen.
  9. Choose an installation location. The default is the IBM® directory. If you select a directory that already exists, an error message is displayed. To choose a different directory, type M and press Enter. Type the path and name of the new directory and press Enter.
  10. Press Enter on the confirmation screen to move to the next screen.
  11. Select the languages for which you want to install the Sterling Order Management System Software language pack translations.
    Make a selection and press Enter. For example, you can choose 2 for Brazilian Portuguese, or select 3 for French and so on. Also, you can Enter S to select all the translations or Enter U to clear all the translations.
    Note:
    • By default, the English language is selected.
    • You cannot enter multiple language selections in a single line in-order to select multiple languages. For example, you cannot enter (2,3) to select both Brazilian Portuguese and French.
  12. Select the features to install:
    • 1. Product Files - selected by default.
    • 2. Enable Sharded Database- Select this option if you plan to use more than one database vendor
      Note: Sharded Database Mode is supported in Sterling Order Management System Software version 10.0 Fix Pack 7, or later.
    • 3. Enable Upgrade - select if you are upgrading from a previous release or if you are doing a new installation, but want to apply DDL manually after installation. Do not select this option if you are doing a new sharded database installation.
    • 4. Install Reference Implementation - this option is supported only for nonsharded environments.
    Make a selection and press Enter. For example, you can choose 2 to enable sharded database upgrade or select 3 for enabling upgrade and so on. Press the default (N) and continue to the next step. Similarly you can enter the same option again to clear the selection. For example, you can type 2 to select Enable Upgrade, and press Enter, and type the default (N) and continue to the next step. However, if you type 2 again, and press Enter, the Enable Upgrade option is cleared.
  13. Enter the path and name for the JDK home directory and press Enter. This pathname should have no spaces.
  14. Choose whether to have the installer create a copy of the JDK folders under your installation directory. The default is Yes (create the copy). Press Enter to accept the default and continue. If you do not want a copy of the JDK made, type N and press Enter.
  15. If you have selected Enable Sharded Database in step 12, then you could perform a sharded installation. Choose whether to "Enable mixed database vendor support". The default is No. Type Yes if you want to select this option. Select this option if you plan to use more than one database vendor. If you plan to use only one database vendor, type the option number for the database, Db2 or Oracle, and press Enter. For example, Type 1 for Db2 or Type 2 for Oracle. Enter the location and name of the JDBC driver file for Oracle or Db2. Enter Database driver jars. Once you enter the jar name, you can type A to add a jar, type N to remove the jar or type D if you are done with the entry.
  16. Enter the information for Creating a new database shard configuration
    1. Enter the Database user name and press Enter.
    2. Enter Database password and press Enter.
    3. Enter Database password and press Enter.
    4. Enter the Database catalog Name and press Enter.
    5. Enter the Database Hostname (or IP address) and press Enter.
    6. Enter the Database Port Number and press Enter.
    7. Enter the Database schema name and press Enter.
    Note: 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 validate the database connection, type Y (validate the connection), or N (do not attempt to connect). If a message saying the connection failed is displayed, verify the information you entered in all fields and try validating again.

    Enter the location and name of 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 Type A to add the license file for Db2 (required). After adding the license file and the prompt is displayed again, type D (done) to continue to the next step.

    For each shard type, you can select the option to Reuse existing database shard configuration, which populates with the existing database information, or 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.

    Note: The Transaction and Master database shard configuration must have the same connection data.
  17. If you have not selected Enable Sharded Database in step 12, then you could perform a nonsharded installation. Enter information for the following fields:
    1. Enter the Database user name and press Enter.
    2. Enter Database password and press Enter.
    3. Enter Database password and press Enter.
    4. Enter the Database catalog Name and press Enter.
    5. Enter the Database Hostname (or IP address) and press Enter.
    6. Enter the Database Port Number and press Enter.
    7. Enter the Database schema name and press Enter.
    Note: 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 validate the database connection, type Y (validate the connection), or N (do not attempt to connect). If a message saying the connection failed is displayed, verify the information you entered in all fields and try validating again. Once all information is entered, you can choose B (back) if you want to change information, or choose N (next) to continue to the next step.

  18. If have chosen Db2, in Step 15, then, choose whether to enable database multibyte support. Type Y or N and press Enter. If you have chosen Oracle, then, there are no additional database properties to configure.
  19. Enter the ADDITIONAL_ANT_JAVA_TASK_ARGS memory parameter settings for your operating system and press Enter.
  20. Enter the ADDITIONAL_ANT_COMPILER_TASK_ARGS memory parameter settings for your operating system and press Enter. Press Enter again to confirm your choices.
  21. Type G (Generate an Installation response file) to have an XML file that contains the install prompts and your responses created.
  22. When prompted, type the location and name for the file and press Enter. Use "xml" as the file extension.
  23. Once a message saying that the file was successfully created is displayed, press Enter. The previous screen is displayed again, with the same options. This time, type I (Install) to start the installation.
    A progress bar is displayed at the bottom of the screen.
  24. When the installation is complete, a status screen is displayed.
  25. You now have a response.xml file from which you can run a silent installation.