Performing a text-based interactive installation

This text-based, command-line installation can be performed without a browser and Launchpad. You can install the software by using the IBM Installation Manager. If you have not yet downloaded IBM® Installation Manager, the installation will check for this and automatically offer to download Installation Manager for you.

1. Close all open programs and any command prompt windows.
2. Open a command prompt window. From the folder location in which you extracted your downloaded product files, enter the following command:
   • For installation in English language: InstallerImage_<OS>/userinstc.exe -c Example: InstallerImage_Windows/userinstc.exe -c. Here -c stands for command line.

     For installation in another, supported language: InstallerImage_<OS>/userinstc.exe -c -nl <locale_code>
     Example:InstallerImage_Windows/userinstc.exe -c -nl fr_CA

   • For installation in English language:InstallerImage_<OS>/userinstc -c
     Example:./InstallerImage_AIX/userinstc -c

     For installation in another, supported language: ./InstallerImage_<OS>/userinstc -c -nl <locale_code>
     Example:./InstallerImage_AIX/userinstc -c -nl fr_CA

3. Select the packages and versions for installation and press Enter.
4. Type A to accept the license agreement and press Enter. Press Enter again to continue to the next screen.
5. Choose a location for the Shared Resources directory. The default is IBM\SDPShared.
   • To accept the default, press Enter.
   • To choose a different directory, type M and press Enter. Type the path and directory name and press Enter. Press Enter again to continue to the next screen.
6. Choose an installation location. If you select a directory that already exists, an error message is displayed.
   • To accept the default, press Enter.
   • To choose a different directory, type M and press Enter. Type the path and directory name and press Enter. Press Enter again to continue to the next screen.
7. Type the number associated with the language for which you want to install the Sterling Order Management System Software language pack translations.
   Make a selection by typing the corresponding number, such as 3 for French, and then press Enter. After you select an option, the prompt is displayed again. You can choose another option (1 to 13) or press Enter to continue to the next step.
   Note: By default, the English language is selected.

   Important: To perform a traditional installation, continue with steps 8- 29.

   To set up a runtime for generating Docker images, follow steps 30 - 37. Setup Runtime for Docker Image Build is supported only on UNIX.

8. Select the features to install:
   • Product Files - selected by default.
   • 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. Upgrades can be done only in the same deployment model.
   • Install Reference Implementation - this option is supported only for non-sharded environments.
   Make a selection and press Enter. After you select one option, the prompt is displayed again. You can choose another option (2 or 3) or press Enter to continue to the next step.
9. Enter the path and name for the JDK home directory and press Enter. This pathname should have no spaces.
10. 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.
11. Choose either Db2 or Oracle based on your requirement and press Enter.
12. Enter the Database user name and press Enter.
13. Enter Database password and press Enter.
14. Confirm the Database password and press Enter.
15. Enter the Database catalog Name and press Enter.
16. Enter the Database Hostname (or IP address) and press Enter.
17. Enter the Database Port Number and press Enter.
18. 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.
19. 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.
20. Validate the connection by typing Y or N and press Enter.
21. If have chosen Db2, in Step 11, 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.
22. Enter the ADDITIONAL_ANT_JAVA_TASK_ARGS memory parameter settings for your operating system and press Enter.
23. Enter the ADDITIONAL_ANT_COMPILER_TASK_ARGS memory parameter settings for your operating system and press Enter. Press Enter again to confirm your choices.
24. Type G (Generate an Installation response file) to have an XML file that contains the install prompts and your responses created.
25. When prompted, type the location and name for the file and press Enter. Use "xml" as the file extension.
26. 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.
27. When the installation is complete, a status screen is displayed.
28. Exit Installation Manager.
29. Continue to post-installation tasks and configuration procedures that you must complete before running the Sterling Order Management System Software software. For more information, refer Post installation section.
30. Select Setup Runtime for Docker Build and then click Next.
31. By default, the option to copy JDK to your installation directory is selected. If you do not want to copy JDK to your installation directory, clear the check box and enter the location and name of the JDK home directory. Copy the following jars to the <JAVA_HOME>/jre/lib/endorsed directory.
    • serializer.jar
    • xalan.jar
    • xercesImpl.jar
    • xml-apis.jar

    These jars are included in the Sterling Order Management System Software software installer image. If the endorsed directory is not present in <JAVA_HOME>/jre/lib, create a new directory and name it endorsed. Copy the jars to the endorsed directory, and proceed with your installation.
32. 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. For more information, refer Memory parameter settings.
33. Select the Database Vendor. Click Add Jars, select the Database driver jars, and then click Next.
34. Review the summary and then click Install to start the installation.
    A progress bar is displayed at the bottom of the screen.
35. 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.
36. Exit Installation Manager.
37. Continue to post-installation tasks and configuration procedures that you must complete before running the Sterling Order Management System Software. For more information, refer Post installation section.