CONNECT:Install Webinar for Code-A-Thon
April 20th, 2010
CONNECT Linux Source Install
Kathy Pham
2
Documentation
• 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/NHINR30/Source+Code+Install+(Linux)
• This webinar is a supplement to the installation documentation. The documentation above is still a work in process, since it is for the current build.
Copyright 2009. All Rights Reserved.3
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
4Copyright 2009. All Rights Reserved.
Things to Remember
• 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 ELS4020.
Checklist
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1
• Set Environment Variables
• Install Metro v 1.5
• Copy Ant Libraries, GlassFish Libraries, Configuration Files
• Install copyv3 certificates
• Edit domain.xml
• Install mySQL v 5.1
• Build CONNECT
• Deploy CONNECT
• Others: OID, Validation Tests
6
Source Code Location
https://svn.connectopensource.org:8443/svn/Nhin_Public/Current
Checklist
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1
• Set Environment Variables
• Install Metro v 1.5
• Copy Ant Libraries, GlassFish Libraries, Configuration Files
• Install copyv3 certificates
• Edit domain.xml
• Install mySQL v 5.1
• Build CONNECT
• Deploy CONNECT
• Others: OID, Validation Tests
8
Checklist
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1
• Set Environment Variables
• Install Metro v 1.5
• Copy Ant Libraries, GlassFish Libraries, Configuration Files
• Install copyv3 certificates
• Edit domain.xml
• Install mySQL v 5.1
• Build CONNECT
• Deploy CONNECT
• Others: OID, Validation Tests
9
Checklist
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1
• Set Environment Variables
• Install Metro v 1.5
• Copy Ant Libraries, GlassFish Libraries, Configuration Files
• Install copyv3 certificates
• Edit domain.xml
• Install mySQL v 5.1
• Build CONNECT
• Deploy CONNECT
• Others: OID, Validation Tests
10
Set Environment Variables
• The list of environment variables are available on the wiki
• In some test cases, an extra ‘/’ is required
• Replace <home> with download location of Netbeans
Checklist
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1
• Set Environment Variables
• Install Metro v 1.5
• Copy Ant Libraries, GlassFish Libraries, Configuration Files
• Install copyv3 certificates
• Edit domain.xml
• Install mySQL v 5.1
• Build CONNECT
• Deploy CONNECT
• Others: OID, Validation Tests
12
Checklist
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1
• Set Environment Variables
• Install Metro v 1.5
• Copy Ant Libraries, GlassFish Libraries, Configuration Files
• Install copyv3 certificates
• Edit domain.xml
• Install mySQL v 5.1
• Build CONNECT
• Deploy CONNECT
• Others: OID, Validation Tests
13
Checklist
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1
• Set Environment Variables
• Install Metro v 1.5
• Copy Ant Libraries, GlassFish Libraries, Configuration Files
• Install copyv3 certificates
• Edit domain.xml
• Install mySQL v 5.1
• Build CONNECT
• Deploy CONNECT
• Others: OID, Validation Tests
14
Checklist
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1
• Set Environment Variables
• Install Metro v 1.5
• Copy Ant Libraries, GlassFish Libraries, Configuration Files
• Install copyv3 certificates
• Edit domain.xml
• Install mySQL v 5.1
• Build CONNECT
• Deploy CONNECT
• Others: OID, Validation Tests
15
Checklist
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1
• Set Environment Variables
• Install Metro v 1.5
• Copy Ant Libraries, GlassFish Libraries, Configuration Files
• Install copyv3 certificates
• Edit domain.xml
• Install mySQL v 5.1
• Build CONNECT
• Deploy CONNECT
• Others: OID, Validation Tests
16
Checklist
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1
• Set Environment Variables
• Install Metro v 1.5
• Copy Ant Libraries, GlassFish Libraries, Configuration Files
• Install copyv3 certificates
• Edit domain.xml
• Install mySQL v 5.1
• Build CONNECT
• Deploy CONNECT
• Others: OID, Validation Tests
17
Checklist
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1
• Set Environment Variables
• Install Metro v 1.5
• Copy Ant Libraries, GlassFish Libraries, Configuration Files
• Install copyv3 certificates
• Edit domain.xml
• Install mySQL v 5.1
• Build CONNECT
• Deploy CONNECT
• Others: OID, Validation Tests
18
Checklist
• Check out source code from SVN
• Install Java 6 Update 16
• Install Netbeans v 6.7.1
• Set Environment Variables
• Install Metro v 1.5
• Copy Ant Libraries, GlassFish Libraries, Configuration Files
• Install copyv3 certificates
• Edit domain.xml
• Install mySQL v 5.1
• Build CONNECT
• Deploy CONNECT
• Others: OID, Validation Tests
19
Others: OID and Validation Tests
• 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/NHINR24/Request+Object+Identifier
• Use the table below to determine if your system requires an object Identifier:
If Then
System in dev/test mode with a few endpoints
OID is not required
System in limited production in a non-NHIN network
OID is not required
System has many endpoints OID is recommended
Planning to use system in the NHIN OID is required
Other: Validation Tests
Run Validate Services and Internal Self Test
http://developer.connectopensource.org/display/NHINR30/CONNECT+Validation+Tests
21
Important Links
• Webinar Recording, Q & A, Slides: http://www.connectopensource.org/about/events
• CONNECT Forums:http://www.connectopensource.org/developer-resources/forums
22
Thank you for participating.
See you at the Code-A-Thon!