2

Documentation
3
To install the latest Linux version of CONNECT you will need reference the installation wiki on the Connect
Open Source website: http://developer.connectopensource.org/display/currentrelease/Source+C ode+Install+(Windows)
This webinar is a supplement to the installation documentation. The documentation above is still evolving, since it is for the Current build. In addition, the code in the
Current build repository is constantly evolving.

4
Overview and Assumptions
Overview
•
The following webinar describes the single server installation of the latest CONNECT Source on a Linux platform.
Assumptions
• You have acquired a machine that meets the Hardware Requirements defined on the Installation Page.
• You have root privileges or can sudo on this machine
• You have an understanding of UNIX commands

Things to Remember
5
• This installation is designed for Red Hat Enterprise Linux 5 (32-bit)
• The installation will create a glassfish user to run glassfish application server and CONNECT applications
• Some commands require root user. Use “su” command to open shell as root or use “sudo” to run the commands
• Depending on your disk size and partitioning, you may wish to create a separate partition for the source code
• In this particular install, the machine used is named ELS4047.
• This install will utilize a GUI interface.

Checklist
6
• OID – not needed for this install
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1 with GlassFish v 2.1
• Set Environment Variables
• Creation of GlassFish domain for CONNECT deployment
• Install Metro v 1.5
• Copy Common GlassFish Libraries, CONNECT Configuration Files
• Certificates: Install copyv3 certificates
• Configure GlassFish and Certificates - edit domain.xml
• Install & Configure mySQL v 5.1
• Build & Deploy CONNECT
• Validation Tests

Object IDentifer (OID)
7
• Each gateway has a unique identifier known as the OID (Object Identifier) or Home
Community ID. The instructions located in the link below can be used to request an OID
– http://developer.connectopensource.org/display/currentrelease/Request+Object+Identifier
•
Use the table below to determine if your system requires an object Identifier:
If
System in dev/test mode with a few endpoints
System in limited production, not in the
National Health Information Network
System has many endpoints
Planning to use system in the National
Health Information Network
Then
OID is not required
OID is not required
OID is recommended
OID is required

Checklist
8
• OID – not needed for this install
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1 with GlassFish v 2.1
• Set Environment Variables
• Creation of GlassFish domain for CONNECT deployment
• Install Metro v 1.5
• Copy Common GlassFish Libraries, CONNECT Configuration Files
• Certificates: Install copyv3 certificates
• Configure GlassFish and Certificates - edit domain.xml
• Install & Configure mySQL v 5.1
• Build & Deploy CONNECT
• Validation Tests

9
Source Code Location https://svn.connectopensource.org:8443/svn/Nhin_Public/Current

Checklist
• OID – not needed for this install
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1 with GlassFish v 2.1
• Set Environment Variables
• Creation of GlassFish domain for CONNECT deployment
• Install Metro v 1.5
• Copy Common GlassFish Libraries, CONNECT Configuration Files
• Certificates: Install copyv3 certificates
• Configure GlassFish and Certificates - edit domain.xml
• Install & Configure mySQL v 5.1
• Build & Deploy CONNECT
10
• Validation Tests

Checklist
• OID – not needed for this install
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1 with GlassFish v 2.1
• Set Environment Variables
• Creation of GlassFish domain for CONNECT deployment
• Install Metro v 1.5
• Copy Common GlassFish Libraries, CONNECT Configuration Files
• Certificates: Install copyv3 certificates
• Configure GlassFish and Certificates - edit domain.xml
• Install & Configure mySQL v 5.1
• Build & Deploy CONNECT
11
• Validation Tests

12
Netbeans Installation
The bundle includes two versions of GlassFish: a 2.1.1 version and a preview of the 3.0 version.
CONNECT uses the 2.1.1 version only

Checklist
• OID – not needed for this install
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1 with GlassFish v 2.1
• Set Environment Variables
• Creation of GlassFish domain for CONNECT deployment
• Install Metro v 1.5
• Copy Common GlassFish Libraries, CONNECT Configuration Files
• Certificates: Install copyv3 certificates
• Configure GlassFish and Certificates - edit domain.xml
• Install & Configure mySQL v 5.1
• Build & Deploy CONNECT
13
• Validation Tests

Checklist
• OID – not needed for this install
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1 with GlassFish v 2.1
• Set Environment Variables
• Creation of GlassFish domain for CONNECT deployment
• Install Metro v 1.5
• Copy Common GlassFish Libraries, CONNECT Configuration Files
• Certificates: Install copyv3 certificates
• Configure GlassFish and Certificates - edit domain.xml
• Install & Configure mySQL v 5.1
• Build & Deploy CONNECT
14
• Validation Tests

Checklist
• OID – not needed for this install
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1 with GlassFish v 2.1
• Set Environment Variables
• Creation of GlassFish domain for CONNECT deployment
• Install Metro v 1.5
• Copy Common GlassFish Libraries, CONNECT Configuration Files
• Certificates: Install copyv3 certificates
• Configure GlassFish and Certificates - edit domain.xml
• Install & Configure mySQL v 5.1
• Build & Deploy CONNECT
15
• Validation Tests

Checklist
• OID – not needed for this install
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1 with GlassFish v 2.1
• Set Environment Variables
• Creation of GlassFish domain for CONNECT deployment
• Install Metro v 1.5
• Copy Common GlassFish Libraries, CONNECT Configuration Files
• Certificates: Install copyv3 certificates
• Configure GlassFish and Certificates - edit domain.xml
• Install & Configure mySQL v 5.1
• Build & Deploy CONNECT
16
• Validation Tests

Checklist
• OID – not needed for this install
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1 with GlassFish v 2.1
• Set Environment Variables
• Creation of GlassFish domain for CONNECT deployment
• Install Metro v 1.5
• Copy Common GlassFish Libraries, CONNECT Configuration Files
• Certificates: Install copyv3 certificates
• Configure GlassFish and Certificates - edit domain.xml
• Install & Configure mySQL v 5.1
• Build & Deploy CONNECT
17
• Validation Tests

18
Certificates
If
System in dev/test mode on a single box
System in dev/test mode on a few machines
System in dev/test mode on a many machines
System in limited production in a non-National Health Information Network
System planned for National Health
Information Network production
Then
No “trust” required. Recommend to use Sun supplied “copyv3” certificates
“Trust” required among these machines. Recommend to exchange self-signed certificates
“Trust” required among these machines. Recommend to install Entrust certificates
“Trust” required among these machines.
Recommend to install Entrust certificates
“Trust” required. Required to install Entrust certificates

Checklist
• OID – not needed for this install
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1 with GlassFish v 2.1
• Set Environment Variables
• Creation of GlassFish domain for CONNECT deployment
• Install Metro v 1.5
• Copy Common GlassFish Libraries, CONNECT Configuration Files
• Certificates: Install copyv3 certificates
• Configure GlassFish and Certificates - edit domain.xml
• Install & Configure mySQL v 5.1
• Build & Deploy CONNECT
19
• Validation Tests

Checklist
• OID – not needed for this install
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1 with GlassFish v 2.1
• Set Environment Variables
• Creation of GlassFish domain for CONNECT deployment
• Install Metro v 1.5
• Copy Common GlassFish Libraries, CONNECT Configuration Files
• Certificates: Install copyv3 certificates
• Configure GlassFish and Certificates - edit domain.xml
• Install & Configure mySQL v 5.1
• Build & Deploy CONNECT
20
• Validation Tests

Checklist
• OID – not needed for this install
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1 with GlassFish v 2.1
• Set Environment Variables
• Creation of GlassFish domain for CONNECT deployment
• Install Metro v 1.5
• Copy Common GlassFish Libraries, CONNECT Configuration Files
• Certificates: Install copyv3 certificates
• Configure GlassFish and Certificates - edit domain.xml
• Install & Configure mySQL v 5.1
• Build & Deploy CONNECT
21
• Validation Tests

Checklist
• OID – not needed for this install
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1 with GlassFish v 2.1
• Set Environment Variables
• Creation of GlassFish domain for CONNECT deployment
• Install Metro v 1.5
• Copy Common GlassFish Libraries, CONNECT Configuration Files
• Certificates: Install copyv3 certificates
• Configure GlassFish and Certificates - edit domain.xml
• Install & Configure mySQL v 5.1
• Build & Deploy CONNECT
22
• Validation Tests

23
Validation Tests
Install SoapUI
Run Validate Services and Internal Self Test http://developer.connectopensource.org/display/currentrele ase/CONNECT+Validation+Tests

24
Important Links
Webinar Recording, Q & A, Slides: http://www.connectopensource.org/about/events/inst allation-webinars-september-2010-code-a-thon
CONNECT Forums: http://www.connectopensource.org/developerresources/forums