Oracle WebLogic Server 12c (12.2.1): Deploying the MedRec Sample Application

In this tutorial you learn to configure and deploy the Avitek Medical Records (MedRec) Sample Application to WebLogic Server 12c (12.2.1).

Time to Complete

Approximately 15 minutes.

Introduction

The MedRec sample application demonstrates aspects of the Java Platform, Enterprise Edition (Java EE) and MedRec is designed as an educational tool for all levels of Java EE developers. Configuring and deploying MedRec to WebLogic Server 12c (12.2.1) is a prerequisite for several other tutorials and this tutorial uses a single-server domain.

What Do You Need?

The following is a list of hardware and software requirements:

• A Linux development machine with sufficient CPU, memory, and hard disk space
• Sufficient hardware to run WebLogic Server (For details, see the list of certified platforms.)
• Java Development Kit (JDK 1.8) on the development machine.
• Installing the following products in these locations has been tested with this tutorial:
  • JDK 1.8 version 60 - /u01/jdk1.8.0_60
  • WebLogic Server 12.2.1 - /u01/wls1221

  While other versions of these products may function for this tutorial, they have not been tested.

  Starting the WebLogic Domain

  1. Open a secure shell terminal session to the Linux development machine and login as the oracle user.
  2. Change to the jrf_restricted_domain directory:

  [oracle@ol71 ~]$ cd /u01/wls1221/user_projects/domains/jrf_restricted_domain

  [oracle@ol71 ~]$ ./startWebLogich.sh

  After starting the WebLogic Server, it enters the RUNNING state: .
  

  Creating the Derby Database

  1. Open a secure shell terminal session to the Linux development machine and login as the oracle user.
  2. Change to the medrec database migration directory:

  [oracle@ol71 ~]$ cd /u01/wls1221/wlserver/samples/server/medrec/database-migration

  [oracle@ol71 ~]$ vi ../project.properties

  # --------------- infrastructure info ----------------- database = derby db = derby 

  # --------------- infrastructure info ----------------- database = derby db = derby :wq 

  [oracle@ol71 database-migration]$ . ../../setExamplesEnv.sh 

  The script outputs that the environment has been set:
  

  Your environment has been set.
  [oracle@ol71 database-migration]$ 

  [oracle@ol71 database-migration]$ ant data.import 

  The script outputs that the build is successful:
  

  data.importer.run: [java] [EL Info]: server: 2015-07-30 14:43:23.222--Detected server platform: org.eclipse.persistence.platform.server.NoServerPlatform. [java] [EL Info]: server: 2015-07-30 14:43:23.299--ServerSession(1007880005)--Detected server platform: org.eclipse.persistence.platform.server.NoServerPlatform. [java] Jul 30, 2015 2:43:23 PM org.hibernate.validator.internal.util.Version [java] INFO: HV000001: Hibernate Validator 5.1.3.Final [java] All the data has been imported successfully! BUILD SUCCESSFUL Total time: 5 seconds
  [oracle@ol71 database-migration]$ 

  Creating the Derby Data Source

  1. Open a browser.
  2. In the browser navigate to http://localhost:7001/console.
  3. Open a terminal shell where the files are downloaded and where you want to install; in this exercise, /u01 is the location.
  4. Enter the Username and Password for this domain - this tutorial uses weblogic for the Username and welcome1 for the Password. Click Login.
  5. In the Domain Structure pane, click Services and Data Sources. The Summary of JDBC Data Sources displays.
  6. In the Summary of JDBC Data Sources, select Generic Data Source from the New drop down menu.
  7. Enter MedRecGlobalDataSourceXA for Name, jdbc/MedRecGlobalDataSourceXA for JNDI Name, select Derby from the Database Type drop down menu and click Next.
  8. From the Database Driver drop down menu, select Derby's Driver (Type 4 XA) Versions:Any and click Next.
  9. Click Next.
  10. Enter medrec for Database Name, localhost for Host Name, 1527 for Port, medrec for Database User Name, medrec for Password, medrec for Confirm Password, and click Next.
  11. Click the Test Configuration button.
  12. The connection test succeeds. Click Next.
  13. In Select Targets page, click AdminServer and click Finish.The domain changes activate.

  Deploying the MedRec Sample Application

  1. In the Domain Structure pane, click Deployments.
  2. In the Summary of Deployments pane, click Install.
  3. Navigate to the path that contains the medrec.ear file; this tutorial uses /u01/wls1221/wlserver/samples/server/medrec/dist/standalone/medrec.ear. Select the medrec.ear file and click Next.
  4. Select Install this deployment as an application and click Next.
  5. Enter medrec for Name and click Next.
  6. Click Finish.The deployment completes.

  Testing the MedRec Sample Application

  1. In the browser, navigate to the MedRec application URL, http://localhost:7001/medrec and click Getting Started!
  2. In the Patient section of the page, click Login.
  3. Enter fred@golf.com for Email, weblogic for Password, and click Sign In.
  4. In the View Record Summary section of the page, click Go.
  5. The records for the current patient displays. Click Logout.
  6. Click Logout. The deployed MedRec sample application test is successful.

  Summary

  In this tutorial, you learned to:

  • Create a Derby database for the MedRec Sample Application
  • Create and Configure a JDBC Data Source for the MedRec Sample Application
  • Deploy and Test the MedRec Sample Application

  Resources

  • WebLogic Server 12.2.1 Documentation
  • To learn more about WebLogic Server refer to additional OBEs in the Oracle Learning Library

  Credits

  • Lead Curriculum Developer: Tom Eliason
  • Other Contributors: TJ Palazzolo