CONNECT: Install Webinar for Code-A-Thon September 7 th, 2010.

CONNECT:Install Webinar for Code-A-ThonSeptember 7th, 2010

CONNECT Windows Source Install

Kathy Pham

2

Documentation

To install the latest Windows version of CONNECT you will need reference the installation wiki on the Connect Open Source website:

http://developer.connectopensource.org/display/currentrelease/Source+Code+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.

3

Overview and Assumptions

Overview

The following webinar describes the single server installation of

the latest CONNECT Source on a Windows platform. This

installation will prepare developers for coding at the Code-A-

Thon on September 21st and 22nd

Assumption

You have acquired a machine that meets the Hardware

Requirements defined on the Installation Page.

4

Things to Remember

• This installation is designed for Windows 32-bit machine.

• In this particular install, the machine used is named ELS3045.

5

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

• Validation Tests6

Object IDentifer (OID)

• 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:

7

If Then

System in dev/test mode with a few endpoints

OID is not required

System in limited production, not in the National Health Information Network

OID is not required

System has many endpoints OID is recommended

Planning to use system in the NationalHealth Information Network

OID is required

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

• Validation Tests8

Source Code Location

https://svn.connectopensource.org:8443/svn/Nhin_Public/Current

9

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

• Validation Tests10

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

• Validation Tests11

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

12

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

• Validation Tests13

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

• Validation Tests14

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

• Validation Tests15

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

• Validation Tests16

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

• Validation Tests17

Certificates

18

If Then

System in dev/test mode on a single box No “trust” required.  Recommend to use Sun

supplied “copyv3” certificates

System in dev/test mode on a few machines

“Trust” required among thesemachines.  Recommend to

exchange self-signed certificates

System in dev/test mode on a many machines

“Trust” required among these machines.  Recommend to install Entrust certificates

System in limited production in a non-National Health Information Network

Trust” required among these machines.  ecommend to install Entrust certificates

System planned for National Health Information Network production

“Trust” required.  Required toinstall 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

• Validation Tests19

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

• Validation Tests20

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

• Validation Tests21

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

• Validation Tests22

Validation Tests

Run Validate Services and Internal Self Test

http://developer.connectopensource.org/display/currentrelease/CONNECT+Validation+Tests

23

Important Links

Webinar Recording, Q & A, Slides:http://www.connectopensource.org/about/events/installation-webinars-september-2010-code-a-thon

CONNECT Forums:http://www.connectopensource.org/developer-resources/forums

24

Thank you for participating.

See you at the Code-A-Thon!