Simphony Installation for an All-in-One Server

The Oracle Food & Beverage Compatibility Matrix provides more information on compatibility between R&A and Simphony.

  1. Log in and download the Simphony release 19.1 installation application from the Oracle Technology Network (OTN) website at https://edelivery.oracle.com/.
  2. Run the Setup file, and then click Next to continue the installation.
  3. Select Application and Database Components, and then click Next. List of Simphony Components and Services contains more information.

    Figure 3-1 Simphony Installation Application


    This figure shows the Simphony Install wizard page where you select the installation type.
  4. Select all of the components, and then click Next. The Simphony Data Request Processing Service is installed by default, and is used for Import/Export tasks.

    Figure 3-2 Simphony Install Component Selections


    This figure shows the Simphony Install wizard page where you select the components that you want to install.
  5. Select all of the components that are to be enabled by default, and then click Next.

    Figure 3-3 Simphony Install Components to Enable by Default


    This figure shows the Simphony Install wizard page where you select the components that you want to be enabled by default.
  6. If you are not using a Load Balancing server and are using the Import/Export feature or plan to use the Simphony Engagement Cloud Service:
    1. Select IIS for the Certificate Location field.
    2. To add a new certificate, select New, click Select, enter or select the certificate location, and then enter the Password for the certificate.
    3. To add an existing certificate, select Existing, and then select the certificate from the drop-down list.
    4. Enter the port number in the Service Host Secure Port field.

      See Requesting and Installing Secure Certificates for more information about requesting and installing secure certificates.

      If you define a Service Host Secure Port number other than the default of 443, you need to configure the IIS Bindings of each Application Pool to the new port. To add IIS Bindings, refer to Binding Secure Server Certificates to IIS and the Microsoft TechNet Library at https://technet.microsoft.com/en-us/ for more information.

  7. Enter the IP address of the server for the Service Host Name (computer name) in the Https IP Address field. If the server is using a Domain Name System (DNS) or Host file mapping, you can enter the name of the server instead of the IP address.

    Figure 3-4 Simphony Install Certificate Information


    This figure shows the Simphony Install wizard page where you verify the installation of a secure certificate, IP address, and your secure port number.
  8. Click Next.

    For the All-in-One Server installation scenario, skip Steps 9, 10, and 11.

  9. If you are using the Import/Export Service or plan to use the Simphony Engagement Cloud Service, on Oracle RAC or a Load Balancing server, select LoadBalancer for the Certificate Location field.
  10. Enter the port number in the Service Host Secure Port field.
    • If you define a Service Host Secure Port number other than the default of 443, you need to enable that port on the Load Balancer server.

    • If you define a Service Host Secure Port number other than the default of 443, you need to configure the IIS Bindings of each Application Pool to the new port. To add IIS Bindings, refer to Binding Secure Server Certificates to IIS and the Microsoft TechNet Library at https://technet.microsoft.com/en-us/ for more information.

    • You can define any free port number for the Service Host Port. If you define a port number other than the default 443, you must manually change the port number when you install subsequent services.

    • If you plan to install Reporting and Analytics on the same server as Simphony, do not assign port number 8081 for the Service Host Port. This is the default port number assigned to the Red Hat JBoss server for Back Office Reports.

    1. Select IIS in the Certificate Location field.
    2. To add a new certificate, select New, click Select, enter or select the certificate location, and then enter the Password for the certificate.
    3. To add an existing certificate, select Existing, and then select the certificate from the drop-down list.
  11. Click Next.

    Figure 3-5 Service Host and Default Gateway Addresses


    This figure shows the Simphony Install wizard page where you specify the Service Host Name and Port number as well as the Default Gateway IP addresses.
  12. Enter the Service Host Name and Service Host Port number, as well as the Default Gateway IP and Default Net Mask IP addresses, and then click Next.
  13. Select the database platform type of Oracle Database, and then click Next:
    1. For an Oracle Database, select Oracle.

      For All-in-One installation scenarios, the installation application installs an Oracle 18c client (even if you are using Oracle Database 12c as a platform). If you are using Oracle Database 18c, the installer does not install an Oracle 18c client.

    2. Click OK to install the 18c client if prompted to do so.
  14. Enter or select the location to install Simphony, and then click Next twice.

    Oracle Food and Beverage recommends that you install the Simphony application on a separate partition from where the Microsoft Windows or Oracle Linux for MICROS operating system resides (usually the C:\ drive).

  15. To install Simphony with a blank database:
    1. Select Blank Database.
    2. Enter a strong Username and Password to comply with Payment Card Industry (PCI) security guidelines. The credentials that you enter here are used to create the Simphony super user to access the EMC.
    3. Confirm the password, and then click Next.
  16. For Oracle as the database platform type:
    1. Enter the information to create the transaction database, and then click Next. List of Simphony Database Configuration Fields contains more information on the database setup options.
    2. Enter the login credentials for the default sys user, and then click OK.
    3. Enter the information to create the security database, and then click Next.

      Oracle Food and Beverage recommends separating the Transaction and Security databases onto different servers for additional security.

  17. Enter the following information that is used to connect to the existing security database, and then click Next.
    1. Server Name: Enter the name of the database server.
    2. Service Name: (Oracle Database users) Enter the name of the service (TNS alias).
    3. Username: Enter your security database access user name.
    4. Password: Enter your security database access password.
    5. Database Port: Enter the port number used to access the security database server, and then click Next.

    Figure 3-6 Security Database Connection Information


    This figure shows the Simphony Install wizard page where you enter the information to connect to the security database.
  18. Enter the following information to connect to the reporting database.
    1. Server Name: Enter the name of the reporting database server.
    2. Service Name: (Oracle Database users) Enter the name of the service (TNS alias).
    3. Username: Enter (or verify) your reporting database access user name.
    4. Password: Enter your reporting database access password.
    5. Database Port: Enter the port number used to access the reporting database.
    6. Username: Enter (or verify) your reporting database access user name.
    7. Password: Enter your reporting database access password, and then click Next.

    Figure 3-7 Simphony Install Reporting Database Connection


    This figure shows the Simphony Install wizard screen where the connection to the reporting database is made.
  19. You have the option to configure Multi-Factor Authentication (MFA) if you already have your SMTP email servers set up and validated. MFA Configuration During the Installation of Simphony contains instructions about configuring MFA during the installation process.
  20. Click Confirm.
  21. After the installation completes, click Finish to exit the Simphony setup.
  22. Click Yes to restart the computer.
  23. Proceed to Post-Installation Tasks to continue.