Installing Portal WebLogic AdminServer

  1. Extract the following from the installation file archive. Do not extract the files to a folder structure that contains spaces.

    /Weblogic/

    Install_version.exe

  2. Double-click Install_version.exe to launch the installation wizard.
  3. On the Choose Install Folder page, enter the installation path or click Choose to select the installation path.
  4. On the Before We Begin page, select Yes or No for the questions shown to help the installation wizard understand your installation environment. The selections do not affect whether or not the wizard installs the selected modules, but the selections allow you to enter database connection information for the selected modules.
    1. For Would you like to install or upgrade a database with this installation for either myMicros or iCare?, select No.
    2. For Will different features connect to the myMicros Database using different database IP Addresses, select Yes if you expect to use more than one IP or database service name to connect to the Enterprise Back Office database. For example, select Yes in an Oracle Real Application Cluster (RAC) environment that does not use a virtual IP and when features such as Remote Transfer Agent connect to a different node. If you select No, you can still modify the connection strings, but you cannot view individual database information screens by feature.
  5. On the Use existing Portal configuration page:
    1. If you want to install with a clean set of configurations, select No to install and configure a new installation set.
    2. If you are performing an upgrade and want to keep old settings, select Yes to use existing configurations. You can then select whether to configure the feature set on the Additional Features page.
  6. On the Choose Install Set page, select Portal WebLogic AdminServer.
  7. On the WebLogic Info - Single Box page, configure the application server settings:

    Table 4-1 Oracle WebLogic Application Server Information

    Field Description

    WebLogic User Name and WebLogic Password

    Create the login credentials for an administrator account on the WebLogic application server. The password must be eight to 20 characters, must not contain special characters, and must include at least one number.

    Local JVM Path

    Verify the folder path to the local Java Development Kit installation.

    WebLogic Admin Server Host Name and WebLogic Admin Server Port

    Enter the hostname and port of the server that hosts Portal WebLogic AdminServer.

    Node Manager port

    Enter the port used by the Node Manager, typically 9556.

  8. If you are completing a 9.1 release installation, on the SSL page select Yes to enable SSL/Transport Layer Security.
  9. If you are completing a 9.1 New Tech Stack release installation or completed Step 8, on the Certificate Configuration - Portal page fill out the form to install the signed certificate. It is not possible to continue installation without providing a CA signed certificate:
    1. Enter the Keystore Password, the Private Key Password, and the Alias that was used when generating the Certificate Signing Request for the Reporting and Analytics application.

      Note:

      Both passwords can only contain alphanumeric characters. Special characters, symbols, or spaces are not allowed.
    2. Click Choose, select the keystore file, and then click Next. See the Oracle MICROS Enterprise Back Office Security Guide for instructions on how to select the keystore file.

      Make sure the filepath includes the following components: folder_path/file_name.extension

    3. Verify the certificate information, and then click Next.
  10. On the Database Information page, configure the connection to the Reporting and Analytics database:
    Oracle Database Microsoft SQL Server
    1. In the Database Type section, select Oracle, and then enter the database network port and SID.

    2. Enter the database login credentials.

    3. Enter the hostname of the database server.

    4. In the Preferred Cache Type drop-down list, select Oracle.

    1. In the Database Type section, select SQL Server, and then enter the database network port.

    2. In the Additional Connection Parameters field, enter any required connection strings.

    3. Enter the database login credentials.

    4. Enter the hostname of the database server.

    5. In the Preferred Cache Type drop-down list, select Generic.

  11. If you are completing a 9.1, 9.1 with OBIEE, or 9.1 New Tech Stack with Pentaho installation, on the Repository Database Information page, configure the connection to the Business Intelligence Repository database (BiRepos):
    Oracle Database Microsoft SQL Server
    1. In the Database Type section, select Oracle, and then enter the database network port and database service name.

    2. Enter the login credentials to the Business Intelligence Repository database.

    3. Enter the login credentials to the Quartz Job Scheduler database.

    4. Enter the hostname of the Business Intelligence Repository database server.

    5. Enter the externally-facing address for access to Enterprise Back Office. This is typically the customer-facing, Internet URL for Reporting and Analytics.

    1. In the Database Type section, select SQL Server, and then enter the database network port and SID.

    2. Enter the login credentials to the Business Intelligence Repository database.

    3. Enter the login credentials to the Quartz Job Scheduler database.

    4. Enter the hostname of the Business Intelligence Repository database server.

    5. Enter the externally-facing address for access to Enterprise Back Office. This is typically the customer-facing, Internet URL for Reporting and Analytics.

  12. If you are completing a 9.1, 9.1 with OBIEE, or 9.1 New Tech Stack with Pentaho installation, on the Is this an OLAP Portal Instance page, select DUAL.
  13. If you are completing a 9.1, 9.1 with OBIEE, or 9.1 New Tech Stack with Pentaho installation, on the OLAP Database Type Database Information page, configure the OLAP database connection as described in the following table:

    Table 4-2 Online Analytical Processing Database Connection

    Field Description

    OLAP Login and OLAP Password

    Enter the login credentials for the OLAP database.

    OLAP Server name or IP

    Enter the hostname of the OLAP database.

    OLAP DatabasePort

    Enter the OLAP database server port.

    OLAP DB SID

    Enter the SID for the OLAP database.

  14. Set up the following connections:
    Connection Page Information

    IceWarp Mail Server

    Portal Mail Server

    Enter the Simple Mail Transfer Protocol (SMTP) hostname and port of the server that will host the IceWarp Mail Server, and then enter the mail domain, such as example.com.

    InfoDelivery Service

    InfoDelivery Mail Server

    Enter the hostname of the IceWarp Mail Server, or enter the hostname for the separate InfoDelivery server. Enter the SMTP port.

    RTA Master Server

    Location of Master Server

    Enter the hostname of the RTA Master Server.

  15. On the Mail Users page, configure the accounts used by Enterprise Back Office:
    1. In the Mail account jobs will be sent to by the client stores field, enter the email account that the Master Server uses to receive resultSets data and deploy jobs.
    2. In the Email account that will receive errors field, enter the email account to which the Point-of-Sales stores forward error messages.
  16. Configure Reporting and Analytics:
    1. On the Portal Specific Settings page, configure Reporting and Analytics as described in the following table:

      Table 4-3 Reporting and Analytics Configurations

      Field Description

      Names of all Portal Application Servers

      Enter the hostnames of all Reporting and Analytics web application servers in a comma-separated list.

      Administrator e-mail address

      Enter the email address, without the domain, of the administrator account.

      What email user will the Portal use to send mail?

      Enter the email address, without the domain, that the Portal uses to send mail.

      What is the password for the email user?

      Enter the password for the portal email user.

      Use HTTPS protocol for portal?

      Select whether the web application uses the HTTPS protocol. This option requires a Secure Socket Layer (SSL) connection and should typically only be selected when the installation environment has an SSL accelerator.

      Password for Messaging Queue

      Enter the login credentials for the messaging queue. This field does not show when performing an upgrade.

      Username and Password for utility user

      Enter the login credentials for the UTIL account created during database installation.

      Username and Password for CE user

      Enter the login credentials for accessing the Microsoft Windows Compact Edition database (CEDB).

      New Line Style for Portal CSV display

      Select whether to use Windows, Unicode, or HTML line styling when using the CSV export while viewing a report.

    2. On the Portal Specific Settings - Purge page, select whether Reporting and Analytics uses thread pooling to purge threads, and then configure the purge parameters.
    3. On the Portal Specific Settings - Aggregation and Adjustment Service page, enter the hostname of the server that will host the Adjustment and Aggregation Service in the Adjustment Server Name field.
  17. Configure Info Delivery:
    1. On the InfoDelivery Configuration page, enter the infoDelivery email login credentials for sending and receiving emails.
    2. On the Portal/InfoDelivery Settings - Font page, configure the Report Mail font settings as described in the following table:

      Table 4-4 Report Mail Font Configurations

      Field Description

      Enable User Font

      Select whether to allow using custom fonts when rendering PDFs.

      Path to user font

      Enter the path to a font, or click Choose and navigate to a font, to set the font used when rendering PDFs.

      Limit detail query days

      Enter a date limit for executing audit/analysis detail queries. The Organization configuration can override this setting.

      Limit summary query days

      Enter a date limit for executing audit/analysis summary queries. The Organization configuration can override this setting.

      New Line Style for InfoDelivery CSV format

      Select whether to use Windows, Unicode, or HTML line styling when formatting Report Mail items in CSV.

      Load reports by market segment

      Select whether to load reports dynamically by appending the organization or role market segment to the template name.

  18. On the Confirm Datasource Name page, enter the OLAP database name in the OLAPDS database name field. By default, this field uses AGGREGATE_DB.
  19. On the InfoDelivery Configuration page, enter the Info Delivery email username for sending and receiving emails, and the Info Delivery administrator email account.
  20. On the Review page, select your preferred review type:
    • Normal: Review the install folder, features, and disk space requirements.

    • Advanced: Review and edit individual variables in the installation files, then review the install folder, features, and disk space requirements.

  21. Review the Pre-Installation Summary, and then click Install.

Verifying the Portal WebLogic AdminServer Installation

  1. Check the installation wizard logs for error, exception, and fail:
    • root\temp\MM_Log.log

    • root\temp\MMInstaller.log

    • root\myMicros\Uninstall_myMicros\myMicros_Install_datetime.log

  2. Perform the following checks in the Oracle WebLogic console:
    1. In a web browser on the Portal WebLogic AdminServer computer, log in using the WebLogic administrator account credentials created during the installation.
    2. Click Environment from the menu, and then click Servers. Verify that you see AdminServer (admin) as Running.
    3. Click Deployments from the menu, click Customize this table, and then select Exclude libraries when displaying deployments. Verify that all components are set as Active except for the portal.
  3. Verify the following Microsoft Windows services are running:
    For the 9.1 or 9.1 with OBIEE release:
    • beasvc_bifoundation_domain_AdminServer

    • Oracle WebLogic NodeManager (<Path to Oracle Middleware wlserver installation>)

    For the 9.1 New Tech Stack or 9.1 New Tech Stack with Pentaho release:
    • wlsvc bifoundation_domain_AdminServer

    • Oracle Weblogic bifoundation_domain NodeManager