Go to primary content
Oracle® Retail Integration Bus Hospital Administration Guide
Release 16.0.21
E86947-02
  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.2.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.2.0. All middleware components associated with WebLogic server 10.3.6 should be upgraded to 12.2.1.2.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.2.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.2.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.2.0_infrastructure.jar file to run the installer.

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

    Description of installer_homepage.gif follows
    Description of the illustration ''installer_homepage.gif''

  4. Click Next. The Auto Updates window displays.

    Description of installer_autoupdates.gif follows
    Description of the illustration ''installer_autoupdates.gif''

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

    Description of prereq_checks.gif follows
    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.

    Description of specify_inst_loc.gif follows
    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.

    Description of prereq_checks2.gif follows
    Description of the illustration ''prereq_checks2.gif''

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

    Description of installer_securityupdates.gif follows
    Description of the illustration ''installer_securityupdates.gif''

  9. Prove the information and click Next. The Installation Summary window displays.

    Description of installer_summary.gif follows
    Description of the illustration ''installer_summary.gif''

  10. Click Install. The Installation Progress window displays.

    Description of installer_progress.gif follows
    Description of the illustration ''installer_progress.gif''

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

    Description of installer_complete.gif follows
    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.

    Description of rcu_welcome.gif follows
    Description of the illustration ''rcu_welcome.gif''

  2. Click Next and select the Create Repository option.

    Description of Create_repository.gif follows
    Description of the illustration ''Create_repository.gif''

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

    Description of rcu_databaseconnection.gif follows
    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.

    Description of rcu_selectcomponents.gif follows
    Description of the illustration ''rcu_selectcomponents.gif''

  5. Click Next. Specify the password.

    Description of schema_pass.gif follows
    Description of the illustration ''schema_pass.gif''

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

    Description of map_tablespaces.gif follows
    Description of the illustration ''map_tablespaces.gif''

  7. Click Next. The Confirmation window displays.

    Description of confirmation_window.gif follows
    Description of the illustration ''confirmation_window.gif''

  8. Click OK. The Summary window displays.

    Description of rcu_summary.gif follows
    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.

    Description of rcu_completionsummary.gif follows
    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.

    Description of jrf_configtype.gif follows
    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 - 12.2.1.2 [wlserver] checkbox is selected. Select the Oracle JRF - 12.2.1.2 [oracle_common], Oracle Enterprise Manager [em], Oracle WSM Policy Manager - 12.2.1.2 [oracle_common], and Weblogic Advanced WebServices for JAX-WS Extension [oracle_common] check boxes.

    Description of jrf_templates.gif follows
    Description of the illustration ''jrf_templates.gif''

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

    Description of riha_fus_config.jpg follows
    Description of the illustration ''riha_fus_config.jpg''

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

    Description of jrf_adminaccount.gif follows
    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.

    Description of jrf_domainmode.gif follows
    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.

    Description of jrf_log.gif follows
    Description of the illustration ''jrf_log.gif''

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

    Description of jrf_jdbcdatasources.gif follows
    Description of the illustration ''jrf_jdbcdatasources.gif''

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

    Description of jrf_jdbctest.gif follows
    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.

    Description of jrf_advconfig.gif follows
    Description of the illustration ''jrf_advconfig.gif''

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

    Description of jrf_adminserver.gif follows
    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.

    Description of jrf_nodemgr.gif follows
    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.

    Description of jrf_managedsev.gif follows
    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.

      Description of jrf_clusters.gif follows
      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.

      Description of jrf_config_wiz.gif follows
      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.

      Description of jrf_cohcluster.gif follows
      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.

      Description of jrf_machines.gif follows
      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.

    Description of jrf_assignserv.gif follows
    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.

      Description of jrf_virtual.gif follows
      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.

    Description of jrf_partitions.gif follows
    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.

    Description of jrf_deploytarget.gif follows
    Description of the illustration ''jrf_deploytarget.gif''

  21. Click Next. The Services Targeting window displays.

    Description of jrf_servicetarget.gif follows
    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.

    Description of jrf_configsummary.gif follows
    Description of the illustration ''jrf_configsummary.gif''

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

    Description of jrf_configprogress.gif follows
    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. Description of jrf_endofconfiggif.gif follows
    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.

    Description of summary_of_deploymts.gif follows
    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.

    Description of settings_for_adf.gif follows
    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.

    Description of config_type_window.gif follows
    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.

    Description of upgrade_domain.gif follows
    Description of the illustration ''upgrade_domain.gif''

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

    Description of application_loc.gif follows
    Description of the illustration ''application_loc.gif''

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

    Description of database_config_type.gif follows
    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.

      Description of jdbc_comp_schema.gif follows
      Description of the illustration ''jdbc_comp_schema.gif''

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

    Description of jdbc_comp_schema_test.gif follows
    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.

    Description of advanced_config.gif follows
    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.

    Description of managed_services.gif follows
    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.

    Description of clusters.gif follows
    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.

    Description of server_templates.gif follows
    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.

    Description of clusters_window.gif follows
    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.

    Description of coherence_clusters.gif follows
    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.

    Description of config_clusters.gif follows
    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.

    Description of virtual_targets.gif follows
    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.

    Description of partitions.gif follows
    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.

    Description of assign_serv_mac.gif follows
    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.

    Description of deploy_targeting.gif follows
    Description of the illustration ''deploy_targeting.gif''

  18. Click Next. The Services Targeting window displays.

    Description of services_target.gif follows
    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.

    Description of config_summ.gif follows
    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.

    Description of config_progress1.gif follows
    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.

    Description of eoc.gif follows
    Description of the illustration ''eoc.gif''

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

    Description of finish_adf.gif follows
    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-16.0.21 for all 16.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

    Description of compile_riha_app.gif follows
    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.

    Description of settings_for_riha_rfm-5.gif follows
    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.

    Description of settings_for_riha-rms.gif follows
    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.