Jericho Installation Instructions - CONNECT

entomologistsamoanSoftware and s/w Development

Aug 15, 2012 (5 years and 1 day ago)

303 views







CONNECT
Jericho Installation and
Configuration Manual


Version 4.0

CONNECT Release 2.4

18 March 2010





CONNECT_
Jericho
_
Manual

i

Release 2.4

3/18/10


REVISION
HISTORY


REVISIO
N

DATE

DESCRIPTION

1.0

7 July

2009

Initial Release

2.0

29 September 2009

Updated to reflect

CONNECT

Release 2.2

3.0

05 January 2010

Updated to reflect CONNECT Release 2.
3

4.0

18 March 2010

Updated to reflect CONNECT Release 2.
4



































CONNECT_
Jericho
_
Manual

ii

Release 2.4

3/18/10


TABLE OF CONTENTS


1.0

INTRODUCTION

................................
................................
................................
...

1

1.1

P
URPOSE

................................
................................
................................
.............

1

1.2

S
COPE

................................
................................
................................
.................

1

1.3

D
OCUMENT
D
ESCRIPTION

................................
................................
.....................

1

2.0

REFERENCED DOCUMENTS

................................
................................
..............

1

3.0

INSTALLATION PRE
-
REQUISITES

................................
................................
.....

1

4.0

INSTALLING JERICHO A
S THE PDP
................................
................................
..

1

5.0

TESTING JERICHO AS T
HE PDP

................................
................................
.....

10

6.0

ACRONYMS

................................
................................
................................
.......

15

APPENDIX A

................................
................................
................................
..............

A
-
1

A.1

CREATE A CONSUMER PR
EFERENCES DOCUMENT

................................
.

A
-
2

LIST OF FIGURES


Figure 4.0
-
1: Launch NetBeans

................................
................................
....................

2

Figure 4.0
-
2: Command Prompt

................................
................................
...................

3

Figure 4.0
-
3: Create OpenSSO Circle of Trust Command

................................
.........

4

Figure 4.0
-
4: Add Jericho PDP to Circle of Trust Command

................................
.....

4

Figure 4.
0
-
5: ConnectOpenSSOPEP to the Circle of Trust Command

.....................

5

Figure 4.0
-
6: Launch the OpenSSO Console

................................
..............................

6

Figure 4.0
-
7: Select the “jericho
-
pdp
-
cot”

................................
................................
..

7

Figure 4.0
-
8: Add ConnectOpenSSOPEP Entity to Jericho PDP Circle of Trust

.....

8

Figure 4.0
-
9: Verify
ConnectOpenSSOPEP was added to Jericho PDP Circle of
Trust

................................
................................
................................
.........................

9

Figure 4.0
-
10: Configure the AdapterPEP to use the Jericho PDP

.........................

10

Figure A.1
-
1: Log into the CPP GUI

................................
................................
.........

A
-
3

Figure A.1
-
2: Select Define Patient Authorization Activity

................................
....

A
-
4

Figure A.1
-
3: Enter Search Criteria

................................
................................
..........

A
-
5

Figure A.1
-
4: Update
Patient Authorization

................................
............................

A
-
6

Figure A.1
-
5: Define Patient Authorization

................................
.............................

A
-
7

Figure A.1
-
6: Verify Changes

................................
................................
...................

A
-
8

CONNECT_
Jericho
_
Manual

1

Release 2.4

3/18/10


1.0

INTRODUCTION

1.1

Purpose

This document is the installation and configuration manual for installing the Jericho
software.

1.2

Scope

The procedures in this document are applicable to all CONNECT users who wish to use
the OpenSSO polic
y engine with the Jericho policy decision point application.

1.3

Document Description

This
document

includes the following sections:



Section 1.0 Introduction



Section 2.0 Referenced Documents



Section 3.0 Installation Pre
-
requisites



Section 4.0 Installing
Jericho as the PDP



Section 5.0 Testing Jericho as the PDP



Section 6.0 Acronyms


2.0

REFERENCED DOCUMENTS

The following documents are referenced in this document:



CONNECT System Installation and Configuration PreConfig Manual



CONNECT System Installation and Co
nfiguration Full Binary Manual



CONNECT System Installation and Configuration Source Code Manual



System Installation and Configuration
OpenSSO

Manual

3.0

INSTALLATION PRE
-
REQUISITES

Install the following software prior to the Jericho installation.

1.

Install th
e NHIN CONNECT Gateway and Adapter Installations by following one
of the provided installation manuals (pre
-
configured, full binary, or source code).

2.

Install and deploy OpenSSO on the server

according to the OpenSSO installation
instructions found on th
e CONNECT web site
.

4.0

INSTALLING JERICHO A
S THE PDP

Perform the following procedure to install the Jericho software.

1.

Launch NetBeans and start Glassfish

as described below.

CONNECT_
Jericho
_
Manual

2

Release 2.4

3/18/10



Figure 4.
0
-
1:
Launch NetBeans


2.

Verify OpenSSO is deployed
.

3.

Open a command prompt and navigate to
C:
\
NHINC
\
ThirdPartyTools
\
OpenSSO
\
AdapterPDPOpenSSO
\
conf.






CONNECT_
Jericho
_
Manual

3

Release 2.4

3/18/10



Figure 4.
0
-
2
:
Command Prompt


4.

From the command prompt enter the following command to create the OpenSSO
Circle of Trust that includes the Jericho PDP:

s
soadm create
-
cot
-
t jericho
-
pdp
-
cot
-
u amadmin
-
f password.txt
.



CONNECT_
Jericho
_
Manual

4

Release 2.4

3/18/10


Figure 4.
0
-
3
:
Create
OpenSSO Circle of Trust Command


5.

From the command prompt enter the following command to add the Jericho PDP
to the Circle of Trust:

ssoadm import
-
entity
-
t
jericho
-
pdp
-
cot
-
m jerichoPdp.xml
-
u amadmin
-
f
password.txt
:



Figure 4.
0
-
4
:
Add Jericho PDP to Circle of Trust Command


6.

At the command prompt enter the following command to create the OpenSSO
Circle of Trust that includes the ConnectOpenSSOPEP:

ssoadm
create
-
cot
-
t opensso
-
pep
-
cot
-
u amadmin
-
f password.txt
:

7.

At the command prompt enter the following command to create the PEP
metadata template:

ssoadm create
-
metadata
-
templ
-
y ConnectOpenSSOPepEntity
-
e
/openssoPep
-
m openssoPep.xml
-
x openssoPep
-
x.xml
-
u amadmin
-
f
password.txt
:

CONNECT_
Jericho
_
Manual

5

Release 2.4

3/18/10


8.

From the command prompt enter the following command to add the
ConnectOpenSSOPEP to the Circle of Trust:

ssoadm import
-
entity
-
t opensso
-
pep
-
cot
-
m openssoPep.xml
-
x
openssoPep
-
x.xml
-
u amadmin
-
f password.txt



Note: This ste
p is not necessary if previously done for the OpenSSO installation.


Figure 4.
0
-
5
:
ConnectOpenSSOPEP to the Circle of Trust

Command


9.

Launch the OpenSSO console in a web browser (http://localhost:8080/open
sso)
and select the Federation t
ab to set up the
Federation
.


CONNECT_
Jericho
_
Manual

6

Release 2.4

3/18/10



Figure 4.
0
-
6
:
Launch the OpenSSO C
onsole


10.

Select the “jericho
-
pdp
-
cot” item under the “Circle of Trust” section.


CONNECT_
Jericho
_
Manual

7

Release 2.4

3/18/10



Figure 4.
0
-
7
:
Select the “jericho
-
pdp
-
cot”


11.

Add the ConnectOpenSSOPEP Entity to the Jericho PDP Circle of Trust by
selectin
g ConnectOpenSSOPepEntity SAMLv2 under the Available box and
clicking the Add button
.




CONNECT_
Jericho
_
Manual

8

Release 2.4

3/18/10




Figure 4.
0
-
8
:
Add ConnectOpenSSOPEP Entity to Jericho PDP Circle of Trust

CONNECT_
Jericho
_
Manual

9

Release 2.4

3/18/10



12.

Click the Save
button

and then the Back
button
.


13.

Verify the ConnectOpenSSOPEP has been added to the Jericho PDP Circle of
Trust by making sure both entities now appear in the Jericho Circle of Trust
section.


Figure 4.
0
-
9
:
Verify ConnectOpenSSOPEP
was

added to Jericho PDP Circle of Trust






CONNECT_
Jericho
_
Manual

10

Release 2.4

3/18/10




14.

Modify

the $NHINC_PROPERTIES_DIR/gateway.properties file to configure the
AdapterPEP to use the Jericho PDP

by changing the
PdpEntityName property to
“jericho”.


Figure 4.
0
-
10
:
C
onfigure the AdapterPEP to use the Jericho PDP

15.


Restart Glassfish.

5.0

TESTING JERICH
O AS THE PDP

There are several SoapUI tests provided to test the functionality of the PEP to PDP
communication. These tests are provided in the
CONNECT_
Jericho
_
Manual

11

Release 2.4

3/18/10


NHIN_CONNECT_OPENSSO_AdapterPEPWS.zip file found on the Jericho web page
on the CONNECT web site. You will need
to download this zip file and unpackage it to
the following directory:

C:
\
NHINC
\
ThirdPartyTools
\
OpenSSO

In order to run the tests contained in this soapUI project, all of the CONNECT
components
described

in the CONNECT installation
manual

must have already

been

deployed into the Glassfish web application server.

In addition, you will need a consent
document for a test patient stored in the document repository (see appendix section A.1
for instructions).

As the soapUI project mentioned above contains many te
sts, the following steps are
provided as an example to assist you with your testing should you choose to execute
more than the one listed below.

Step

Action Input

Expected Result

1

Open the soapUI application
.

The soapUI
application will
start.

2

From
the File menu item, click on the “Import
Project” sub
-
menu⁩ em.



The “Select
獯ap啉rm牯橥捴c䙩汥l
d楡汯g⁷楮iow wi汬
be⁤楳p污led.

P

Enter “C:
y
么䥎f
y
Th楲dma牴rToo汳
y
lpenppl
y

Adap瑥牐rmtp
-
soapui
-
project.xml” as the
f楬ename
.



Tex琠en瑥牥d.

CONNECT_
Jericho
_
Manual

12

Release 2.4

3/18/10


Step

Action Input

Expected Result



4

Click
on the “Open” button.

The
AdapterPEPWS
-
soapui
-
project.xml
file will be
imported into your
soapUI
application.

5

From the AdapterPEPWS project node, expand
the “AdapterPEPBindingSoap11” and
“CheckPolicy” nodes.



The soapUI
application will
expand the nod
es
similar to the
screen shot shown
to the left.

CONNECT_
Jericho
_
Manual

13

Release 2.4

3/18/10


Step

Action Input

Expected Result

6

Double click on the “DocumentQueryIn” node.



The
DocumentQueryIn
request and
response window
will open inside
soapUI.

7

Click on the green arrow near the top, left corner
of the DocumentQueryIn window
as shown below
(the green arrow has a red circle around it).



SoapUI will
execute the
request and return
a response.

8

Verify that the response contained the text,
“Permit” similar to the screen shot below.


A successful
response as
indicated to the

left.

CONNECT_
Jericho
_
Manual

14

Release 2.4

3/18/10


Step

Action Input

Expected Result



CONNECT_
Jericho
_
Manual

15

Release 2.4

3/18/10


6.0

ACRONYM
S



CA

Certificate Authority

CAC

Common Access Card

CD

Compact Disk

CDC

Centers for Disease Control & Prevention

CMS

Centers for Medicare & Medicaid Services

DAT

Digital Audio Tape

DOD

Department of Defense

DURSA

Data Use and
Reciprocal Support Agreement

DVD

Digital Video Disc

EHR

Electronic Health Record

EMR

Electronic Medical Record

ESB

Enterprise Service Bus

FHA

Federal Health Architecture

GB

Gigabyte

HDD

Hard Disk Drive

HITSP

Healthcare Information Technology
Standards Panel

IDE

Integrated Drive Electronics

IHS

Indian Health Services

IPv6

Internet Protocol Version 6

MB

Megabyte

MPI

Master Patient Index

NCI

National Cancer Institute

NDMS

National Disaster Medical System

NHIE

NHIN Health Information
Exchange

NHIN

Nationwide Health Information Network

NIST

National Institute of Standards and Technology

OID

Object Identifier or Home Community ID

ONC

Office of the National Coordinator

OS

Operating System

CONNECT_
Jericho
_
Manual

16

Release 2.4

3/18/10


QA

Quality Assurance

RAID

Redundant Array of Inexpensive Disks

RAM

Random Access Memory

SCSI

Small Computer System Interface

SDK

Software Development Kit

SSA

Social Security Administration

SSL

Secure Sockets Layer

TBD

To Be Determined

USB

Universal
Serial Bus

VA

Department of Veterans Affairs

CONNECT_
Jericho
_
Manual

A
-
1

Release 2.4

3/18/10





APPENDIX A

CONNECT_
Jericho
_
Manual

A
-
2

Release 2.4

3/18/10


A.1

CREAT
E

A CONSUMER PREFER
E
NCES DOCUMENT


Perform the following steps
to create a CPP document using the

provided CPP GUI:


Note: The assigningAuthorityId property in adapter.properties must be set to the
appropriate Assigning Authority OID (in most cases this will be the same value as the
home community id OID).

1.

On the server running the Adapter components
,

deploy the Consumer
Preferences Profile GUI (if not deployed).


2.

Bring up a web browser and navigate the following url:

http://localhost:8080/ConsumerPreferencesProfileGUI/

CONNECT_
Jericho
_
Manual

A
-
3

Release 2.4

3/18/10



Figure
A
.
1
-
1
:
Log into the CPP GUI


3.

Log into the CPP GUI using the account setup during the OpenSSO installation
(default user1/password).

CONNECT_
Jericho
_
Manual

A
-
4

Release 2.4

3/18/10



Figure
A
.
1
-
2
:
Select
Define Patient Authorization A
ctivity


4.

Select the Define Patient Authorization activity from the list of

activities presented
after a successful login.

CONNECT_
Jericho
_
Manual

A
-
5

Release 2.4

3/18/10



Figure
A
.
1
-
3
:
Enter Search Criteria


5.

Enter in your search criteria for the patient. These criteria will be used to search
for
a
patient currently in the MPI. For example: Younger for the last name will
r
eturn all of the entries in the MPI that have a last name of Younger.

CONNECT_
Jericho
_
Manual

A
-
6

Release 2.4

3/18/10



Figure
A
.
1
-
4
:
Update Patient Authorization


6.

Check (or uncheck) the checkbox next to the patient you want to update and
press the "Update Patient Authorization” button.

CONNECT_
Jericho
_
Manual

A
-
7

Release 2.4

3/18/10



Figure
A
.
1
-
5
:
Define

Patient Authorization


7.

Click the Define Patient Authorization button to take you back to the search page
and repeat the steps to execute
the
same search.

CONNECT_
Jericho
_
Manual

A
-
8

Release 2.4

3/18/10



Figure
A
.
1
-
6
:
Verify Changes


8.

Verify that the changes were made
.