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

Purpose

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 74  - /scratch/u01/app/jdk
• WebLogic Server 12.2.1 - /scratch/u01/app/fmw1221_infra

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

• Completed the prerequisite tutorials since this tutorial uses the WebLogic Installation from the prerequisites:
• WebLogic Server 12c (12.2.1): Installing WebLogic Server Using the Infrastructure Installer 
• WebLogic Server 12c (12.2.1): Creating a Restricted JRF 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 /scratch/u01/domains/jrf_domain

3. Execute the startWebLogic.sh script to start WebLogic Server:

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

4. Enter the username and password to boot WebLogic Server. The username in these tutorials is weblogic and the password is Welcome1.

   Enter username to boot WebLogic server:weblogic
   Enter password to boot WebLogic server:Welcome1

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

   ...
   <Jul 30, 2015 2:20:43 PM MDT> <Notice> <WebLogicServer> <BEA-000360> <The server started in RUNNING mode.> 
   <Jul 30, 2015 2:20:43 PM MDT> <Notice> <WebLogicServer> <BEA-000365> <Server state changed to RUNNING.> 
   

   The WebLogic Server is ready for use in this tutorial.

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 /scratch/u01/app/fmw1221_infra/wlserver/samples/server/medrec/database-migration

3. Edit the project.properties file:

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

4. Add a line to the project.properties files to set the property db to derby:
   

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

5. Save the changes and quit the vi editor:

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

6. Set your shell environment by sourcing the setExamplesEnv.sh file (the command below starts with a period and a space):
   

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

   The script outputs that the environment has been set:
   

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

7. Execute the Ant target data.import to import the medrec application into the Derby database:
   

   [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 <clinit>
        [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]$

1. Open a browser, and in the browser navigate to http://localhost:7001/console.

2. Enter the Username and Password for this domain - this tutorial uses weblogic for the Username and welcome1 for the Password. Click Login.

   

3. In the Change Center pane, click Lock and Edit.

4. In the Domain Structure pane, click Services and Data Sources.

   

   The Summary of JDBC Data Sources displays.

   

5. In the Summary of JDBC Data Sources, select Generic Data Source from the New drop down menu.

   

6. Enter MedRecGlobalDataSourceXA for Name, jdbc/MedRecGlobalDataSourceXA for JNDI Name, select Derby from the Database Type drop down menu and click Next.

   

7. From the Database Driver drop down menu, select Derby's Driver (Type 4 XA) Versions:Any and click Next.

   

8. Click Next.

   

9. 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.

   

10. Click the Test Configuration button.

    

11. The connection test succeeds. Click Next.

    

12. In Select Targets page, click AdminServer and click Finish.

    

13. In the Change Center pane, click Activate Changes.

14. The domain changes activate.

    

1. In the Domain Structure pane, click Deployments.

   

2. In the Change Center pane, click Lock & Edit.

3. In the Summary of Deployments pane, click Install.

   

4. Navigate to the path that contains the medrec.ear file; this tutorial uses /scratch/u01/app/fmw1221_infra/wlserver/samples/server/medrec/dist/standalone/medrec.ear. Select the medrec.ear file and click Next.

   

5. Select Install this deployment as an application and click Next.

   

6. For Available targets for medrec, select AdminServer and click Next.

   

7. Enter medrec for Name and click Next.

   

8. Click Finish.

   

   The deployment settings display.

   

9. In the Change Center panel, click Activate Changes.

   

   The changes are activated.

   

10. In the Summary of Deployments panel, click the Control tab and select the medrec application by clicking the checkbox.

    

11. Click the Start button and select Servicing all requests.

    

12. In the Start Application Assistant, click Yes.

    

    The start request is sent to the medrec deployment.

    

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 (if fred@golf.com is not entered by default), enter 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.

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

Version

• 02-34-005-DeploySampleApplication