Go to primary content
Oracle® Retail Integration Bus Cloud Service Hospital Administration Guide
Release 19.1.000
F31994-01
  Go To Table Of Contents
Contents

Previous
Previous
 
Next
Next
 

2 Installation and Setup

The RIHA installation chapter widely focuses on ADF 12c runtime installation and deploying the tool's EAR file. For more information about domain creation and other server related information, see the WebLogic application server documents.

Installation and Setup Instructions

This section describes the installation and setup instructions including the installation prerequisite, preparing the WebLogic server, creating a WebLogic domain, verifying installation of ADF runtime libraries, extending an existing domain to add ADF run-time libraries, and deploying the EAR file. It also describes the security setup guidelines.


Note:

The screen captures included in the following procedures are for example only. Because these procedures must be followed for each application, valid values will vary. Therefore, consider the illustrations as guides only; the values shown may not always apply.

Installation Prerequisite

The RIB Hospital Administration(RIHA) requires Oracle WebLogic Server 12c (12.2.1.4.0) and built with Java 8 (JDK 1.8.0+ 64 bit or later, with the latest security updates.


Important:

If there is an existing WebLogic 12.x.x or 10.3.xc installation on the server, you must upgrade to WebLogic 12.2.1.4.0. All middleware components associated with WebLogic server 10.3.6 should be upgraded to 12.2.1.4.0

Back up the weblogic.policy file ($WLS_HOME/wlserver/server/lib) before upgrading your WebLogic server, because this file could be overwritten. Copy over the weblogic.policy backup file after the WebLogic upgrade is finished and the post patching installation steps are completed.

For upgrading your WebLogic server to 12.2.1.4.0 use the appropriate Upgrade Installer.


Prepare the WebLogic Server

Take the following steps to prepare the WebLogic server:

  1. Find fmw_12.2.1.4.0_infrastructure_Disk1_1of1.zip and download this file to your system.

  2. Extract the contents of this zip file to your system. Use the fmw_12.2.1.4.0_infrastructure.jar file to run the installer.

  3. Run the installer by executing the java -jar fmw_12.2.1.4.0_infrastructure.jar file. The Welcome window displays.

    WebLogic Installer
    Description of the illustration ''installer_homepage.gif''

  4. Click Next. The Auto Updates window displays.

    Auto Updates Step
    Description of the illustration ''installer_autoupdates.gif''

  5. Select appropriate radio button and click Next. The Installation Location window displays.

    Installation Location Step
    Description of the illustration ''prereq_checks.gif''

  6. Click Browse to select the Oracle Home location where the Weblogic server is to be installed. Click Next. The Installation Type window displays.

    Installation Type Step
    Description of the illustration ''specify_inst_loc.gif''

  7. Select Fusion Middleware Infrastructure and click Next. The installer performs the pre-requisite checks and ensures all required conditions are satisfied.

    Pre-requisite Checks Step
    Description of the illustration ''prereq_checks2.gif''

  8. When the pre-requisite check completes successfully, click Next. The Installation Summary window displays.

    Installation Summary
    Description of the illustration ''installer_summary.gif''

  9. Click Install. The Installation Progress window displays.

    Installation Progress
    Description of the illustration ''installer_progress.gif''

  10. Click Next when the installation completes. The Installation Complete window displays.

    Installation Complete
    Description of the illustration ''installer_complete.gif''

Creating Required RCU Schema Using the Repository Creation Utility

To create a schema user for the domain, take the following steps:

  1. Run the RCU from the <MW_HOME>/oracle_common/bin folder. The Welcome window displays.

    Repository Creation
    Description of the illustration ''rcu_welcome.gif''

  2. Click Next and select the Create Repository option.

    Create Repository Step
    Description of the illustration ''Create_repository.gif''

  3. Click Next. Enter the database credentials where the schema user has to be created.

    Database Credentials Step
    Description of the illustration ''rcu_databaseconnection.gif''

  4. Click Next. Specify the prefix to be used for the schema user creation. For example, INT. Select Metadata Services, Weblogic Services, and Oracle Platform Security Services.

    Schema User Creation Step
    Description of the illustration ''rcu_selectcomponents.gif''

  5. Click Next. Specify the password.

    Password Step
    Description of the illustration ''schema_pass.gif''

  6. Click Next. The window provides the details of tablespaces created as part of schema creation.

    Map Tablespaces Step
    Description of the illustration ''map_tablespaces.gif''

  7. Click Next. The Confirmation window displays.

    Confirmation Window
    Description of the illustration ''confirmation_window.gif''

  8. Click OK. The Summary window displays.

    Summary
    Description of the illustration ''rcu_summary.gif''

  9. Click Create and proceed to create the schema. This could take a while to complete. The Completion Summary window displays.

    Completion Summary
    Description of the illustration ''rcu_completionsummary.gif''

Creating a WebLogic Domain with JRF

To create a new WebLogic domain with JRF, take the following steps:

  1. Run the config.sh from <ORACLE_HOME>/oracle_common/common/bin folder. The Configuration Type window displays.

    Configuration Type Step
    Description of the illustration ''jrf_configtype.gif''

  2. Select Create a new domain, provide domain location, and click Next. The Templates window displays. By default, the Basic WebLogic Server Domain [wlserver] checkbox is selected. Select the Oracle JRF [oracle_common], Oracle Enterprise Manager [em], Oracle WSM Policy Manager [oracle_common], and Weblogic Advanced WebServices for JAX-WS Extension [oracle_common] check boxes.

    Create Domain Step
    Description of the illustration ''jrf_templates.gif''

  3. Click Next. The Application location window displays, provide the application location.

  4. Click Next. The Administrator Account window displays. Enter the user credentials you want to use to log in to the WebLogic Administration Console.

    Administrator Account Step
    Description of the illustration ''jrf_adminaccount.gif''

  5. Click Next. The Domain Mode and JDK window displays. Set the Domain Mode as Production and select the JDK version (JDK 1.8 with the latest security updates) you want to use.

    Domain Mode and JDK Step
    Description of the illustration ''jrf_domainmode.gif''

  6. Click Next. The Database Configuration Type window displays.

    1. Select RCU Data radio button.

    2. Select Oracle as the Vendor.

    3. Select Oracle's Driver (Thin) for Service connections; Version 9.0.1 and later as the Driver.

    4. Enter the Service, Host Name, Port, Schema Owner, and Schema Password for *_STB schema created using RCU.

    5. Click Get RCU Configuration.

    The Connection Result Log displays the connection status.

    Connection Result Log Step
    Description of the illustration ''jrf_log.gif''

  7. Click Next. The JDBC Component Schema window displays.

    JDBC Component Schema Step
  8. Click Next. The JDBC Component Schema Test window displays status on whether the JDBC tests on the schemas were successful.

    JDBC Component Schema Test Step
    Description of the illustration ''jrf_jdbctest.gif''

  9. Click Next. The Advanced Configuration window displays. Select all the checkboxes, except Domain Frontend Host Capture and JMS File Store options, in this window.

    Advanced Configuration Step
  10. Click Next. The Administration Server window displays. Enter the Listen Address and the Listen Port details.

    Administration Server Step
    Description of the illustration ''jrf_adminserver.gif''

  11. Click Next. The Node Manager window displays. Select the Node Manager Type and enter the Node Manager credentials.

    Node Manager Step
    Description of the illustration ''jrf_nodemgr.gif''

  12. Click Next. The Managed Servers window displays.

    1. Click Add to add a managed server on which you will deploy the application.

    2. Enter the Server Name, Listen Address, and Listen Port for the managed server.

    3. Set the Server Groups to JRF-MAN-SVR.

    Managed Servers Step
    Description of the illustration ''jrf_managedsev.gif''

  13. Click Next. The Clusters window displays.

    1. Click Add to add a cluster. This is an optional step in the procedure.

      Clusters Step
      Description of the illustration ''jrf_clusters.gif''

  14. Click Next. The Server Templates window displays.

    1. Click Add to add a server template. This is an optional step in the procedure.

      Server Templates Step
      Description of the illustration ''jrf_config_wiz.gif''

  15. Click Next. The Coherence Clusters window displays.

    1. Add a coherence cluster. This is an optional step in the procedure.

      Coherence Clusters Step
      Description of the illustration ''jrf_cohcluster.gif''

  16. Click Next. The Machines window displays.

    1. Click Add.

    2. Enter the Name and the Node Manager Listen Address for the managed server.

      Machines Step
      Description of the illustration ''jrf_machines.gif''

  17. Click Next. The Assign Servers to Machines window displays. Add the Admin Server and the managed server to the computer.

    Assign Servers to Machines
    Description of the illustration ''jrf_assignserv.gif''

  18. Click Next. The Virtual targets window displays.

    1. Click Add to add a Virtual target. This is an optional step in the procedure.

      Virtual Targets Step
      Description of the illustration ''jrf_virtual.gif''

  19. Click Next. The Partitions window displays.

    1. Click Add to add a Partition. This is an optional step in the procedure.

    Partitions Step
    Description of the illustration ''jrf_partitions.gif''

  20. Click Next. The Deployments Targeting window displays. Select wsm-pm from Deployments and add it to Admin Server in Targets.

    Deployments Targeting Step
    Description of the illustration ''jrf_deploytarget.gif''

  21. Click Next. The Services Targeting window displays.

    Services Targeting Step
    Description of the illustration ''jrf_servicetarget.gif''

  22. Click Next. The Configuration Summary window displays. Verify that all information described in this window is accurate.

    Configuration Summary
    Description of the illustration ''jrf_configsummary.gif''

  23. Click Create. The Configuration Progress window displays a message when the domain is created successfully.

    Configuration Progress
    Description of the illustration ''jrf_configprogress.gif''

  24. Click Next. The Configuration Success window displays that describes the Domain Location and Admin Server URL once the configuration is complete. Configuration Success
    Description of the illustration ''jrf_endofconfiggif.gif''

  25. Click Finish to complete creating the WebLogic domain and managed servers.

Verify Installation of ADF Runtime Libraries

This section describes the steps to verify the installation of ADF runtime libraries.

  1. Start the Admin Server in the WebLogic domain and log on to the WebLogic Server Administration console with the admin credentials.

    Administration Console
    Description of the illustration ''summary_of_deploymts.gif''

  2. In the Domain Structure section, click Deployments. The deployed libraries are listed.

  3. Click on an ADF library and go to the Targets tab. Verify that the library is targeted to both the Admin Server and the managed server. Verify these details for all the ADF libraries.

    Targets Tab
    Description of the illustration ''settings_for_adf.gif''

  4. Click the Targets tab and verify that the created server is selected for that library.

Extending an Existing Domain to Add ADF Run-time Libraries

This section describes the steps to extend an existing domain to add ADF runtime libraries.

  1. Run config.sh from the Oracle_home/oracle_common/common/bin folder. The Configuration Type window displays.

    Configuration Type Screen
    Description of the illustration ''config_type_window.gif''

  2. Select the Upgrade an existing domain option. Click Browse and choose the location of the domain to be updated with the ADF libraries.

    Upgrade Existing Domain
    Description of the illustration ''upgrade_domain.gif''

  3. Click Next. The Templates window displays. Select the Oracle JRF [oracle_common], WebLogic Coherence Cluster Extension [wlserver], and Weblogic Advanced WebServices for JAX-WS Extension [oracle_common] checkboxes.

  4. Click Next. The Application location window displays provide the application location.

    Application Location Step
    Description of the illustration ''database_config_type.gif''

  5. Click Next. The JDBC Component Schema Test window displays which indicates the status of the schema tests.

    1. Select the RCU Data radio button.

    2. Select Oracle as the Vendor.

    3. Select Oracle's Driver (Thin) for Service connections; Version 9.0.1 and later as the Driver.

    4. Enter the Service, Host Name, Port, Schema Owner, and Schema Password for the *_STB schema created using the RCU.

    5. Click Get RCU Configuration. The Connection Result Log displays the connection status.

      Connection Result Log Stepo
      Description of the illustration ''jdbc_comp_schema.gif''

  6. Click Next. The JDBC Component Schema window displays.

    JDBC Component Schema Step
    Description of the illustration ''jdbc_comp_schema_test.gif''

  7. Click Next. The JDBC Component Schema Test window displays which indicates the status of the schema tests.

    JDBC Component Schema Test Step
    Description of the illustration ''advanced_config.gif''

  8. Click Next. The Advanced Configuration window displays. Select the Managed Servers, Clusters and Coherence, and the Deployments and Services check boxes.

    Advanced Configuration Step
    Description of the illustration ''managed_services.gif''

  9. Click Next. The Managed Servers window displays.

    1. Click Add to add a managed server.

    2. Enter the Server Name, Listen Address, and the Listen Port for the managed server.

    3. Set the Server Groups to JRF-MAN-SVR.

    Managed Servers Step
    Description of the illustration ''clusters.gif''

  10. Click Next. The Server templates window displays. Click Add to add a server template. This is an optional step in the procedure.

    Server Templates Step
    Description of the illustration ''server_templates.gif''

  11. Click Next. The Clusters window displays. Click Add to add a cluster. This is an optional step in the procedure.

    Clusters Step
    Description of the illustration ''clusters_window.gif''

  12. Click Next. The Coherence Clusters window displays. Add a coherence cluster. This is an optional step in the procedure.

    Coherence Clusters Step
    Description of the illustration ''coherence_clusters.gif''

  13. Click Next. The Machines window displays.

    1. Click Add to add a computer.

    2. Enter the Name and the Node Manager Listen Address.

    Machines Step
    Description of the illustration ''config_clusters.gif''

  14. Click Next. The Virtual targets window displays. Click Add to add a virtual target. This is an optional step in the procedure.

    Virtual Targets Step
    Description of the illustration ''virtual_targets.gif''

  15. Click Next. The Partitions window displays. Click Add to add a Partition. This is an optional step in the procedure.

    Partitions Step
    Description of the illustration ''partitions.gif''

  16. Click Next. The Assign Servers to Machines window displays. Add both the Admin Server and the managed server to the computer.

    Assign Servers to Machines Step
    Description of the illustration ''assign_serv_mac.gif''

  17. Click Next. The Deployments Targeting window displays.

    Select wsm-pm from Deployments and add it to Admin Server in Targets.

    Deployments Targeting Step
    Description of the illustration ''deploy_targeting.gif''

  18. Click Next. The Services Targeting window displays.

    Services Targeting Step
    Description of the illustration ''services_target.gif''

    1. By default, all services are only targeted to the Admin Server.

    2. Target all the services to the managed server.

  19. Click Next. The Configuration Summary window displays. Verify that all information described in this window is accurate.

    Configuration Summary Step
    Description of the illustration ''config_summ.gif''

  20. Click Update. The Configuration Progress window displays. The window displays a status message when the domain is updated successfully.

    Configuration Progress
    Description of the illustration ''config_progress1.gif''

  21. Click Next. The Configuration Success window displays that describes the Domain Location and Admin Server URL once the configuration is complete.

    Configuration Success
    Description of the illustration ''eoc.gif''

  22. Click Finish to complete updating the existing domain with the ADF runtime.

    Complete
    Description of the illustration ''finish_adf.gif''

Deploying RIHA ear File from RIB-HOME

This section describes the steps to deploy RIHA ear from rib-home. Single RIHA ear file is used for all the rib-apps and deployment is supported only from rib-home.

To deploy RIHA app from rib-home:

  1. Download RibHospitalAdministration-Web-19.1.000 for all 19.x.xApps_eng_ga.tar and extract it to RIB_INSTALL/rib-home/tools-home.

  2. Go to the location rib-home/tools-home/riha/conf

  3. Edit the riha-deployment-env-info.properties with riha-admin-server-connection-url value

    Ex: riha-admin-server-connection-url=t3://host:port to the location rib-home/tools-home/riha/conf

    1. Edit target server name where RIHA app should be deployed.

      Ex: riha-wls-target-name=AdminServer

      This means riha app will deploys to AdminServer.

      Ex: riha-wls-target-name=m1

      This means riha app will deploys to Managed Server 'm1'.

    2. Edit cluster name where RIHA app should be deployed.

      If no cluster is configured then enter cluster name as ”no_cluster”

      Ex:riha-wls-cluster-name=no_cluster

      If any cluster is configured then enter the name of the cluster.

      Ex:riha-wls-cluster-name=New_Cluster_1

  4. Compile the riha-app. Security credentials get configured while compiling with the following command:

    tools-home/riha/bin: ./riha-app-compiler.sh -setup-security-credential

    Complation Output
    Description of the illustration ''compile_riha_app.gif''

  5. Prepare Weblogic for RIHA deployment: by executing this step all the datasource required by RIHA application will be created based on the number of applications in scope of rib-deployment-info.xml and user information required for riha app to login will be created (RihaAdminGroup and user entered in riha compilation phase) tools-home/riha/bin: ./riha-app-deployer.sh -prepare-wls.

  6. Deploy RIHA app by executing tools-home/riha/bin: ./riha-app-deployer.sh -deploy-riha-app.

  7. Restart the WebLogic managed server.

  8. If needed you can undeploy RIHA by executing tools-home/riha/bin: ./riha-app-deployer.sh -undeploy-riha-app.

  9. Restrict access to the riha folder with a command like:

    cd rib-home/tools-home/riha

    chmod -R 700.

Testing the Deployment

This section describes the steps to test the deployment.

Navigate to the post deployment screen.

  1. Click the Control tab.

    Control Tab
    Description of the illustration ''settings_for_riha_rfm-5.gif''

  2. Select the application. Click Start

  3. Click Yes.

    • The deployed tool is started successfully.

    Deployed Tool Started
    Description of the illustration ''settings_for_riha-rms.gif''

  4. Click on the Testing tab and expand the deployed tool to access the URL of the tool.

Accessibility

Accessibility involves making your application usable for differently-abled persons, such as low vision or blindness, deafness, or other physical limitations. This means creating applications that can be used without a mouse (keyboard only), used with a screen reader for blind or low-vision users, and used without reliance on sound, color, or animation and timing.

RIHA provides the ability to support the above accessibility in the applications.

Users should be able to navigate to all parts and functions of the application using the Tab and arrow keys, without using any keyboard shortcuts. In addition to that, keyboard shortcuts provide additional ways to access a function quickly.

Keyboard shortcuts provide an alternative to pointing devices for navigating the page. There are five types of keyboard shortcuts that can be used in ADF Faces applications:

  • Tab traversal, using Tab and Shift+Tab keys: Moves the focus through UI elements on a screen.

  • Accelerator keys (hot keys): Bypasses menu and page navigation, and performs an action directly. For example, Ctrl+C for Copy.

  • Access keys: Moves the focus to a specific UI element. For example, Alt+F for the File menu.

  • Default cursor/focus placement: Puts the initial focus on a component so that keyboard users can start interacting with the page without excessive navigation.

  • Enter key: Triggers an action when the cursor is in certain fields, or when the focus is on a link or button.