Performing a GUI-based installation

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. From the folder location of your downloaded product files, enter the following command:
   • For installation in English language: InstallerImage_<OS>/userinst.exe

     Example: InstallerImage_AIX/userinst.exe

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

   • For installation in English language: InstallerImage_<OS>/userinst
     Example: ./InstallerImage_AIX/userinst

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

3. Click the link to install the software.
   Note: You can also click IBM Documentation link, which contains all the information.
4. Review the installation packages to be installed.
5. Review and accept the license agreement.
6. Accept the default location for the shared resources directory, or browse to a new location.
7. Accept the default location for Installation Manager directory, or enter a different location.
8. Review and accept the package group to be installed and the installation directory, or browse to a new location.
9. 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.

   Important: To perform a traditional installation, continue with steps 10-19.

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

10. Select the appropriate features to install and then click Next. More information about each feature is provided under Details.
    • 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.
    • Select Install Reference Implementation if you are planning to install reference implementation.
      Note: If you choose to Install Reference Implementation, then you must perform the steps mentioned in Install all the Reference Implementation components on Windows

    Note:

    • By default, the Product Files feature is selected.
    • You cannot install the Reference Implementation data in a sharded environment.
11. 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.
12. 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
      Note: The default schema names are always the same as the user name, except that the schema names are all uppercase.
    • Database driver jars. For example, click Add Jars, select the appropriate database driver jars based on the database vendor selected, and then click Next.

    You can test the connection to the database by clicking Validate Connection. If a message saying the connection failed is displayed, verify the information that you entered in all fields and validate again.

    Note: The Validate Connection option does not work when the ojdbc8.jar is used as an Oracle driver.
13. Based on the Database Vendor that you selected in the Database Information screen, perform one of the following steps in the Database Details screen and then click Next.
    • If you have chosen Db2® as your database vendor, select Enable database multibyte support if required.
    • If have chosen Oracle, there are no additional database properties to configure.
14. If you want to manage the properties in the database, select Enable database property management in the Additional configuration screen, and then 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. Review the summary and then 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. 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.
20. Select Setup Runtime for Docker Build and then click Next.
21. 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.
22. 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.
23. Select the Database Vendor. Click Add Jars, select the Database driver jars, and then click Next.
24. Review the summary and then click Install to start the installation.
    A progress bar is displayed at the bottom of the screen.
25. 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.
26. Exit Installation Manager.
27. 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.