9/11

5 Deploying the HPD Application

This chapter provides procedures on how to deploy the HPD Application to the WebLogic application server and how to run HPD sample data through the HPD Application.

This chapter includes the following section:

• Deploying and Running Individual Provider MPI Application

Deploying and Running Individual Provider MPI Application

This procedure leads you through the steps to deploy and run an Individual MPI Application on Oracle WebLogic Server.

Deploying and Running Individual Provider MPI Application on an Oracle WebLogic Server

1. On the left panel of the WebLogic Server Administration Console, under Domain Structure, select Environment and then choose Deployments.

   The Summary of Deployments panel appears.

2. On the right side of the panel under Deployments, click Install.

   A Summary of Deployments panel with a Deployments table containing a list of EAR files appears.

3. Locate your Individual Provider MPI Application EAR file and click Next. For more information, see Chapter 2, "Creating HPD Application Related Projects".

   The Install Application Assistant page appears in the right panel.

4. Locate the deployment you want to install and prepare for deployment.

   Tip:

   Select the file path that represent the application root directory, archive file, exploded archive directory, or application module descriptor that you want to install. You can also enter the path of the application directory or file in the Path field.

   Note:

   Only valid file paths are displayed. If you cannot find your deployment files, upload your file(s) and/or confirm that your application contains the required deployment descriptors.

5. Click Next.

   Note:

   When deploying an MPI EAR file through the WebLogic Admin Console under Security, ensure that you choose DD Only. If you choose one of the other options, you will not be able to log into the MIDM.

6. Click Finish.

7. Launch Master Index Data Manager (MIDM) from a web browser, enter the following:

   • For Individual Provider MPI Application: http://localhost:7001/HPDIndProviderMIDM

     Note:

     The HPDIndProvider portion of HPDIndProviderMIDM is from the Individual Provider MPI application name.

8. Log in using your configured user name and password.

Deploying and Running Organizational Provider MPI Application

The procedure to deploy and running Organization Provider MPI Application is same as procedure in Deploying and Running Individual Provider MPI Application on an Oracle WebLogic Server. Replace Individual Provider by Organizational Provider and HPDIndProvider by HPDOrgProvider.

Deploying HPD Application

The procedure to deploy and running Organization Provider MPI Application is same as procedure in Deploying and Running Individual Provider MPI Application on an Oracle WebLogic Server. Replace Individual Provider by HPD. There is no MIDM access though.

Running Data through the HPD Application

OHMPI provides HPD sample data to help you get started with the application. The sample data illustrates basic HPD Feed and HPD Query usage. It is provided in the form of soapUI test cases.

To Run HPD Sample Data

Under the samples\hpd directory of your OHMPI installation, there is a soapUI sample project that you can use to test your HPD Feed and HPD Query web services.

Before you begin, ensure the application server is running, your HPD Application has been deployed, and soapUI has been installed properly.

Note:

To install soapUI:

1. Go to http://soapui.org.

2. Download the latest version for your platform (for example, soapui-x64-5.0.0.exe for Windows).

3. Run the executable file.

For best results, run the tests in the order they are displayed in the project. If the tests are run out of order additional errors will occur because the response from the Master Person Index will be different.

1. Adjust web service URLs in the sample soapUI project if necessary.

   The soapUI sample project provided is based on an HPD Application deployed on WebLogic with default configuration, that is, the HPD web services are assumed to be running at http://localhost:7001/ProviderInformationDirectory/ProviderInformationDirectory_Service. If your HPD Application is running on a different host or a different port on WebLogic, then you need to adjust the above URL in the soapUI sample project accordingly. To adjust the URLs, open samples\hpd\hpd-samples-soapui-project.xml in your favorite editor, and replace all instances of the above two URLs based on the following instructions:

   For WebLogic, the web service URLs should be in the following format: (the default port number on WebLogic is 7001):

   http://<host_name>:<port_number>/ProviderInformationDirectory/ProviderInformationDirectory_Service

2. To start soapUI, go to the ${SOAPUI_HOME}\bin directory and invoke soapui.bat.

3. To import the HPD samples soapUI project, click File, select Import Project, and then select hpd-samples-soapui-project.xml from the samples\hpd directory.

4. Select the HPD Samples node in the project tree. In the Custom Properties tab, update the following properties accordingly: (This is only needed by the "TC0 - Re-initialize Database Tables" Test Case.)

   • HPD_IND_PROVIDER_DB_USER: This is the database user name for Individual Providers. The default value is hpd_ip.

   • HPD_IND_PROVIDER_DB_PASSWORD: This is the database user's password for Individual Providers. The default value is hpd_ip.

   • HPD_ORG_PROVIDER_DB_USER: This is the database user name for Organizational Providers. The default value is hpd_op.

   • HPD_ORG_PROVIDER_DB_PASSWORD: This is the database user's password for Organizational Providers. The default value is hpd_op.

   • HPD_RELATIONSHIP_DB_USER: This is the database user name for HPD Relationship. The default value is hpd.

   • HPD_RELATIONSHIP_DB_PASSWORD: This is the database user's password for HPD Relationship. The default value is hpd.

   • IND_PROVIDER_MPI_PROJECT: This is the location of the MPI Project for the Individual Providers.

   • ORG_PROVIDER_MPI_PROJECT: This is the location of the MPI Project for the Organizational Providers.

   • HPD_EAR_PROJECT: This is the location of the HPD Project.

5. Expand the HPD Samples node in the project tree.

6. Double click the HPD Samples Test Suite node to show the Test Suite Editor.

7. Click Run to run all the test cases in the test suite.

8. After running a test suite, you can:

   • Check whether the tests passed or failed within soapUI.

   • Review records using the Master Index Data Manager (MIDM).

HPD Feed is an asynchronous transaction per IHE's HPD specification. The client (Provider Information Source) always gets an immediate acknowledgement of the feed transaction. However, the actual persistence of the provider information happens asynchronously in the background. This is the reason for the (30 seconds) delay at the end of HPD Feed Test Case. If the MPI and HPD Applications are accessed the first time, it might take a longer time for the actual persistence of the provider information to finish. If the HPD Query tests fail, wait a couple of minutes and try again.

You can rerun the complete HPD Sample Test Suite (including Database Initialization, HPD Feed, and HPD Query).