Oracle WebLogic Server 12c (12.2.1): Configuring a Single Domain Partition

Purpose

Configuring a Single Domain Partition uses WebLogic 12c (12.2.1) Multitenancy for several benefits:

• Separation between the Administrative Domain and Application Domain Partition - for Security Realms, JDBC Data Sources, JMS services, and other application services
• Management and Monitoring for Application Domain Partition components
• Use Virtual Targets to service the Application Domain Partition using another host and port

Time to Complete

Approximately 30 minutes.

Introduction

The sample Avitek Medical Records application (MedRec) is used in this tutorial - the MedRec application is a web front-end on a Derby database back-end, and it is configured to be deployed using a Resource Group Template.

The high-level process in this tutorial for configuring an application for WebLogic 12c (12.2.1) Multitenancy includes:

• Creating the Resource Group Template
• A Resource Group Template is a collection of deployable resources to be used as a template; for the MedRec application in this tutorial, the Resource Group Template includes the medrec.ear and the JDBC Data Source
  
• Creating the Security Realm
• A Domain Partition can use the Domain Security Realm, or a different Security Realm; in this tutorial, the Domain Partition uses a different Security Realm to enable a different set of users to administrate the Domain Partition
• Creating the Virtual Target
• In this tutorial, the MedRec application uses the localhost address and port 9999.
• Creating the Domain Partition
• The Domain Parition in this tutorial is the realization of the Resource Group Template, custom Security Realm, and Virtual Target - creating a specific instance of the MedRec sample application.

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, Database and Application Deployment 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
    
  • WebLogic Server 12c (12.2.1): Deploying a Sample Application

1. Open a secure shell terminal session to the Linux development machine and login as the oracle user.

2. Change to the jrf_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 the server enters the RUNNING state, it is ready for this tutorial.

   ...
   The server started in RUNNING mode.
   ...
   

If the MedRec sample application and JDBC Data Source still deployed as a result of the prerequisite tutorial, delete them from the domain; later steps in this tutorial will deploy MedRec and its JDBC Data Source in a Domain Partition.

1. Open a web browser on the Linux development machine - this tutorial uses Firefox.

2. In the browser navigate to http://localhost:7001/em.

3. Enter the administrator Username and Password (in the prerequisite tutorial the Username weblogic and Password Welcome1 were used) and click Login.

   

   The Fusion Middleware Control 12c domain home page displays.

   

4. This domain is running in production mode, so configuration changes are managed by the Change Center. In the Change Center menu, select Lock & Edit.

   

   The confirmation of the edit session lock displays.

   

5. To delete the current medrec application deployment, select Deployments from the WebLogic Domain menu.

   

   The Deployments page displays.

   

6. In the Deployments page, select the current medrec deployment, click the Control menu, click Stop and click Force stop now.

   

7. In the Confirmation dialog box, click Stop.

   

   The confirmation message to stop the deployment displays.

   

8. In the Deployments page, click the medrec deployment, click the Deployment menu and select Undeploy.

    

9. In the Confirmation page, click Undeploy.

   

10. In the Undeployment Succeeded dialog box, click Close.

    

    The updated Deployments page displays.

     

11. To delete the current medrec JDBC Data Sources, select JDBC Data Sources from the WebLogic Domain menu.

    

    The JDBC Data Sources page displays.

    

12. In the JDBC Data Sources page, click the MedRecGlobalDataSourceXA table entry and click Delete.

    

13. In the Confirm Data Source Deletion dialog box, click OK.

    

    The confirmation message displays.

    

14. From the Change Center menu, select Activate Changes.

    

    The confirmation message displays that the changes have been activated.

    

Working with multitenancy and domain partitions requires that the Lifecycle Manager is enabled in a WebLogic Server 12.2.1 domain. If the Lifecycle Manager is not enabled, enable the Lifecycle Manager and restart the WebLogic Administration Server.

1. From the WebLogic Domain menu select Environment and then select Domain Partitions.

   

2. If the Domain Partitions page displays a message that the Lifecycle Manager services are not available, click Enable Lifecycle Manager.

   

   The confirmation displays.

   

3. To stop the WebLogic Administration Server, click the WebLogic Domain menu, select Environment and select Servers.

   

4. Click the AdminServer table entry.

   

5. Click the Control menu, then click Shutdown, and click Force Shutdown Now.

   

6. In the Forcibly Shutdown Servers dialog box, click Forcibly Shutdown Servers.

   

   The Forcibly Shutdown Servers dialog box displays a message to relogin after the AdminServer has been restarted.

   

7. Open a secure shell terminal session to the Linux development machine and login as the oracle user.

8. Change to the jrf_domain directory:

   [oracle@ol71 ~]$ cd /scratch/u01/domains/jrf_domain

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

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

10. 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 the server enters the RUNNING state, it is ready to continue this tutorial.

    ...
    The server started in RUNNING mode.
    ...
    

11. Back in the web browser, in the Forcibly Shutdown Servers dialog box, click Relogin.

    

12. The Fusion Middleware Control 12c login page displays. top the adminserver. Enter the administrator Username and Password (in the prerequisite tutorial the Username weblogic and Password Welcome1 were used) and click Login.

    

1. From the WebLogic Domain menu, click Environment, and then click Resource Group Templates.

   

   The Resource Group Templates page displays.

   

2. From the Change Control menu, select Lock & Edit.

   

   The edit session lock confirmation message displays.

   

3. In the Resource Group Templates page, click Create.

   

4. In the Create a Resource Group Template dialog box, enter MedRecRGT for Name and click Create.

   

5. The confirmation of the resource group template creation displays. Click the MedRecRGT table entry.

   

6. In the Resource Group Template : MedRecRGT page, click the Deployments tab.

   

7. The Deployments tab displays.

   

8. In the Resource Group Template : MedRecRGT page, click the Deployment menu, and select Deploy.

   

9. In the Deploy Java EE Application: Select Archivereate a Resource Group Template page, click Archive or exploded directory is on the server where Enterprise Manager is running. Click Browse... and select the file at /scratch/u01/app/fmw1221_infra/wlserver/samples/server/medrec/dist/standalone/medrec.ear and click Next.

   

10. Review the application attributes and click Next.

    

11. Review the deployment settings and click Deploy.

    

12. In the Deployment Succeeded dialog box,click Close.

    

13. The updated Deployments tab displays. Click Services.

    

14. In the Resource Group Template : MedRecGT page, in the Services tab, click Create and select Generic Data Source.

    

15. In the Data Source Name field, enter MedRecGlobalDataSourceXA. In the JNDI Name field, enter jdbc/MedRecGlobalDataSourceXA. Next to the Driver Class Name field, click Select...

    

16. From the Database Type drop down menu, select Derby and click OK.

    

17. Click Next.

    

18. Click the Generate URL and Properties... button.

    

19. In the Generate URL reate dialog, enter the following values and click OK:

    • Database Host Name: localhost

    • Database Listener Port: 1527
    • Database Name: medrec
    • Database User Name: medrec
    • Password: medrec
    • Confirm Password: medrec

    

20. Review the connection properties and click Test Database Connection.

    

21. In the Confirmation dialog box, click OK.

    

22. In the Create a JDBC Data Source: Connection Properties page, click Next.

23. In the Create a JDBC Data Source: Transaction Properties page, click Next.

    

24. Review the settings for the JDBC Data Source and click Create.

    

    The confirmation for the new JDBC Data Source displays.

    

1. From the WebLogic Domain drop down menu, select Security and then Security Realms.

   

2. The security realms display. Click Create.

   

3. Enter MedRecRealm for Name and click Create.

   

   The confirmation for the new security realm displays.

   

4. From the Change Center drop down menu, select Activate Changes.

   

5. The confirmation for the activation changes displays.

   

6. From the WebLogic Domain menu, select Security and then select Users and Groups.

   

7. In the Users and Groups page, select MedRecRealm from the Select a Realm drop down menu.

   

8. In the Users and Groups page, click Create.

   

9. In the Create a New User dialog box, enter administrator for Name, enter a Password, Confirm Password and click Create. 

   

   The medrec administrator user is created.