MacSeie - UOIT.CA

echinoidqueenΔιακομιστές

4 Δεκ 2013 (πριν από 3 χρόνια και 10 μήνες)

122 εμφανίσεις



McMaster  Service
-­‐
based  eHealth  
Integration  Environment  (MacSeie)
 
Installation  Guide
 


August  10,  2009
 









Amir  Tavasoli
 

tavasoa@mcmaster.ca


MacSeie


Installation  Manual

1


Document Revision History


Rev. Level

Date

Description

I
mport
ant

2009/9/10

Initial Version

Low

2009/12/10

Review and Edit




Reference Documents


Document #

Description






MacSeie


Installation  Manual

2

 
 
1.
 
Overview
................................
................................
................................
...............
3
 
1.1
 
Purpose
................................
................................
................................
...........
3
 
1.2
 
How to Use This Document
................................
................................
.............
3
 
1.3
 
Assumptions
................................
................................
................................
....
3
 
2.
 
System Requirements
................................
................................
...........................
4
 
2.1
 
Hardware Requirements
................................
................................
..................
4
 
2.2
 
Operating System Requirements
................................
................................
....
4
 
2.3
 
Software Requirements
................................
................................
...................
4
 
2.4
 
Web Browser Requirements
................................
................................
............
5
 
3.
 
Installation
................................
................................
................................
.............
6
 
3.1
 
Installing MySQL Community Server (Server Side)
................................
........
6
 
3.2
 
Installing MySQL GUI Tools (Server Side)
................................
....................
12
 
3.3
 
Installing MySQL ODBC Connection (Server Side)
................................
......
13
 
3.4
 
Installing Microsoft IIS (Server and Client Side)
................................
............
16
 
3.5
 
Install
ing Microsoft .NET framework (Server and Client Side)
......................
18
 
3.6
 
Install MacSeie .NET Side
................................
................................
.............
20
 
3.6.1
 
Server Section
................................
................................
............................
21
 
3.6.1.1
 
Installing Database
................................
................................
..................
21
 
3.6.1.2
 
Preparing the ODBC Connection
................................
............................
25
 
3.6.1.3
 
Installing the Service Server
................................
................................
....
28
 
3.6.2
 
Client Section
................................
................................
.............................
34
 
3.6.2.1
 
Installing Client on IIS
................................
................................
..............
35
 
3.6.2.2
 
Configuring and Testing the client
................................
...........................
39
 
MacSeie


Installation  Manual

3

1.

Overview
 
1.1

 Purpose
 
MacSeie is a Service
-
based eHealth Integration Environment which integrates
Electronic Health Record (EHR) systems and Decision Support Systems (D
SS) using
Service Oriented Architecture (SOA) and HL7 v3. The system is made of two parts
first is a Microsoft .NET based side and the other is Java based. The reason for using
these two different parts is showing that using different technologies and oper
ating
systems we can still have an integrated eHealth environment.

This manual provides the requirements and installation instructions for Microsoft .NET
part of MacSeie

on all supported operating systems. The Installation manual has two
sections: A server
side and a client side section

1.2

 How  to  Use  This  Document
 
In this document, the first part gives the system requirement for running
MacSeie
,
includ
ing
software
and hardware aspects. The second part described steps to install
MacSeie
.

To install
MacSeie
, us
er needs to install
MySQL 5.0 or later and

Microsoft .NET Framework

3.5 or later
and
ISS 5.0 or later
first.

In the last part,

configuring MacSeie
is described.

1.3

 Assumptions
 
In addition to the instructions outlined in this manual, it is assumed that anyone

installing MacSeie should have working knowledge of and/or experience with:



General installation of software on the target platform



Starting and stopping processes on the target platform



Working with MySQL Database platform



General networking (IP Address,
…)

MacSeie


Installation  Manual

4

2.

System  Requirements  
 
System requirements for MacSeie are separated into several groups:



Hardware Requirements



Operating System Requirements



Software
Requirements



Web Browser Requirements

2.1

 Hardware  Requirements
 
The
hardware used for MacSeie should meet
the following minimum requirements:



256 MB of RAM (512 MB is recommended)



Pentium III 800 MHz or AMD 800 MHz or greater



512 MB hard disk space

plus space for MacSeie

2.2

 Operating  System  Requirements
 
MacSeie .NET Side

has been tested and is supported on only
Windows operating
system platform. It has been proven to support Windows XP Professional or Windows
Vista. Even thou it has not been tested, it may be possible using technologies like
Mono.NET to run the MacSeie .NET side on various operating systems like:



All Win32 Platforms.



Linux (OpenSuse and Novell SUSE)



Mac OS X

Mono.NET can be downloaded from:
http://www.mono
-
project.com/Main_Page

2.3

 
Software  
Requirements
 
To install
MacSeie
,
the following
products
are necessary
:



Microsoft .NET Framework

3.5 or later



Internet Information Services (IIS) 5.0 or later

MacSeie


Installation  Manual

5



MySQL 5.0 or later

2.4

 Web  Browser  Requirements
 
Some functions and views of
MacSeie

use a standard Web
browser
. Any browser
used
in
MacSeie must support Ja
vaScript 1.2 and scripting must not be disabled.


Presently there are four tested and supported web browsers:



Microsoft Internet Explorer 5.5 or later



Safari 3.0 or later



Firefox 2.
0
or
later



Opera 9.0 or later

MacSeie


Installation  Manual

6

3.

I
nstallation
 
As mentioned MacSeie .NET side h
as two individual sections. The first section is the
server side which plays the Service Server on Service Oriented Architecture and the
second section is the client side which plays Service Client role and uses the server to
accomplish its tasks. Server a
nd client need not to be installed on the same machine
but they need to have network access to each other. At this part we will first go
through general installation of softwares that are needed to install both server and
client side and then we will descr
ibe the installation of server and client side. For
server side Microsoft IIS and .NET Framework and MySQL need to be installed but for
client side Microsoft IIS and .NET Framework is enough.

3.1

 Installing  MySQL  Community  Server  (Server  Side)
 
MySQL is needed
for the server side. If MySQL is already installed in the network you
do not need to go through this process and all that needs to be done is to install the
database on it, which described in “
Installing MacSeie
” section. You can also install
MySQL on a d
ifferent computer than the MacSeie server side. They only need to have
network access to each other. This is another point that proves the flexibility of the
system.


Installing MySQL Community Server:


1
-
Download “MySQL 5.1 Community Server” from:

http://dev.mysql.com/downloads/mysql/5.1.html


MacSeie


Installation  Manual

7


2

Run the setup and click on next.


3

Select complete and click on next.


4

Click on install to start the installation.


5

Click on next to
start configuring your MySQL Community Server

MacSeie


Installation  Manual

8


6

Now click on finish to start configuring the server.


7

Select the detailed configuration


8

Select the machine that mostly describes your machine.


9

Select Multifunctional Database

MacSeie


Installation  Manual

9


10

Selec
t the drive that you want to install Database into


11

Select DSS/OLAP


12

Enable TCP/IP Networking and click next with default port number 3306

MacSeie


Installation  Manual

10


13

Select Standard Character Set


14

Click on Install Windows Service and Install Bin Directory on
Windows Path


15

Type in the root password you want to

MacSeie


Installation  Manual

11


16

Click on execute to start the configuration


NOTE: If there is problem in execution the configuration just restart the system and
run the Configuration Wizard from the start menu in MySQL f
older.



MacSeie


Installation  Manual

12

3.2

 
Installing  MySQL  GUI  Tools
 (Server  Side)
 
We will need these tools for installing MacSeie so even if MySQL is installed on a
different machine on the network. It is highly recommended to install these tools on
the machine that intended to be the
server machine for MacSeie .NET side or you
need to know how to install the MacSeie database using MySQL command line tools.


Installing MySQL GUI Tools:


1

Download the MySQL GUI Tools from:

http://dev.mysql.com/downloads/gui
-
tools/5.0.html


2

Click on next to start the setup.


MacSeie


Installation  Manual

13

3

Select a drive to install the tools


4

Select Complete to completely install all the files


5

Now you can run the MySQL Administrator and MySQL Quer
y Browser and
MySQL System Tray Monitor from start menu.



3.3

 Installing  MySQL  ODBC  Connection  (Server  Side)
 
This is the process that is needed to install the MySQL ODBC Connectors. You need
two applications that will make Microsoft .NET be able to connect t
o a MySQL Server.
For sure you will only need this on MacSeie .NET Server section and the Client
section does not need this tool.


The first tool is the
MySQL Connector/ODBC
:

1

you can download MySQL Connector/ODBC from:

http://dev.mysql.com/downloads/connector/odbc/5.1.html

MacSeie


Installation  Manual

14


2

Now just press next and select complete installation and everything will be ready



Now you need to install
Microsoft ODBC .NET Data Provider
.

1

You can
download the ODBC .NET Data Provider from:

http://www.microsoft.com/downloads/details.aspx?FamilyID=6ccd8427
-
1017
-
4f33
-
a0
62
-
d165078
e32b1&displaylang=en

MacSeie


Installation  Manual

15


2

Click Next to start the installation


3

Select the drive that you want to install the binaries into

MacSeie


Installation  Manual

16



NOTE: It is recommended to install this tool after you installed the .NET framework.
However if you ran to any errors rela
ted to ODBC connection of .NET just install the
binary DLL to your project BIN directory and everything will be fine.


3.4

 Installing  Microsoft  IIS  (Server  and  Client  Side)
 

Microsoft IIS is installed on Windows Visa by default but for Windows XP Professional

you need to have the Windows XP Professional installation CD. Unfortunately
Windows XP Home Edition does not support Microsoft IIS. After putting the CD in
drive just follow the following instructions:


1

From control panel select “Add or Remove Program
s”


2

From there select “Add/Remove Windows Components”

MacSeie


Installation  Manual

17



3

In here select “Internet Information Services (IIS)” and click on next



4

Now wait till the setup finishes.

MacSeie


Installation  Manual

18


3.5

 
Install
ing
 
Microsoft  .NET  framework  (Server  and  Client  Side)
 
Download Mi
crosoft .NET framework 3.5 from
http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=333325
fd
-
ae52
-
4e35
-
b531
-
508d9
77d32a6
.

After downloading .NET framework the process is quiet straight forward. Just follow
the instructions that appear on the screen.

1

Click on download to start downloading the setup.

MacSeie


Installation  Manual

19


2

Now run the setup that you have downloaded.


3

Just cl
ick on install and it .NET framework will be installed.

MacSeie


Installation  Manual

20


4
-
Click exit and everything is ready.


NOTE: IIS should be installed before .NET framework or you need to configure the IIS
using .NET framework “
regiis

tool which can be found in .NET installed
folder. You
will need to run “
regiis

i
” to install .NET on IIS.

3.6

 
Install  
MacSeie
 .NET  Side
 
MacSeie
can be downloaded from: //////

After downloading MacSeie just unzip the
MacSeie
-
NET.zip
file and for server
binaries you can look through the “
server

fold
er and you can find client binaries in
MacSeie


Installation  Manual

21


client
” folder.

3.6.1

Server  Section
 
3.6.1.1

Installing  Database
 
In Server folder you can find the
emrdb.sql
file. Here is the process of installing the
database on the server:


1

run MySQL Administrator and enter the informatio
n needed to log into the
database server. In this case because the server is local we have used 127.0.0.1
which is a local database and root user.


MacSeie


Installation  Manual

22



NOTE: If you are connecting to a database your network make sure that you login
with a user that can re
store the database or ask database administrator to resotre the
database for you give your user full access to that database.


2

Now select Restore on the right hand menu

MacSeie


Installation  Manual

23


3

Now click on Open Backup File button and select the
emrdb.sql
file from open
menu


4

After opening the file just click on start restore button without changing any value

MacSeie


Installation  Manual

24


A progress bar shows the restore process



5

Now you can check the database from the Catalogs menu in the right

MacSeie


Installation  Manual

25



3.6.1.2

Preparing  the  ODBC  Connection
 
You should
have installed the tools described in MySQL ODBC Connection in order to
be able to go through these steps. In here we are preparing an ODBC connection that
our .NET server program can connect to MySQL using this connection.

1

From control panel go to “A
dministrative Tools” folder

MacSeie


Installation  Manual

26


2

Now in here select “Data Sources (ODBC)”


3

In Data Sources Go to System DNS tab

MacSeie


Installation  Manual

27


4

Click on Add to add a new Data Source


5

In here select “MySQL ODBC 5.1 Driver” and click on Finish


6

Now in this form you sho
uld fill the MySQL connection information.


NOTE: Remember the Data Source Name because it is the name you need to
configure the service server with it. We assumed that this name is “MySQL”. As you
MacSeie


Installation  Manual

28

can see if server is in another location you need to ente
r the IP address of that server
and the username and password that the server administrator will bring to you. After
setting the Database by clicking on Test you can your connection with server.


You can see the connection on System DSN afterwards.



3.6.1.3

Ins
talling  the  Service  Server
 
For installing the Service Server you need to configure the IIS so that it will publish the
EMR services through the network.


1

copy the service files into a directory in which you want the web
-
service binaries to
be. For exam
ple I copied them to C:
\
EMRWebService


2

Now you need to run, the Microsoft IIS. There are two ways to run IIS, the most
convenient one is to run “inetmgr” in the run or command line. The second way is to
run it from “Administrative Tools” in Control Pan
el.


3

Now Go to “Your Computer Name”
-
> “Web Sites”
-
> “Default Web Site”

MacSeie


Installation  Manual

29


4

From “Action” menu select “New” and “Virtual Directory”


5

Click Next and in Alias Write “EMRWebService”

MacSeie


Installation  Manual

30


6

In here select the directory where you copied the binaries.


7

Just click Next and Finish in here.


MacSeie


Installation  Manual

31


8

Now on EMRWebService web site in “Actions” menu select “Properties”


9

In Properties select “Directory Security” tab

MacSeie


Installation  Manual

32


10

Now click on Edit button in “Anonymous access and authentication control”
sect
ion and select “Integrated Windows Authentication”



11

Click on “OK” and again in Properties select “Documents” tab

MacSeie


Installation  Manual

33


12

In here click on “Add” and write down “service1.asmx” in it. This way service will
be recognized by default.


Now you can test t
he service by opening the Browser and go to the
http://localhost/EMRWebService/
to see the service interface.

MacSeie


Installation  Manual

34


NOTE: if you cannot see the interface there read carefully through the steps again.
One of the
reasons may be because of the ODBC connection. If you have selected a
different name for ODBC connection then you need to go the Server binary directory
which the web site is located and in and look for “Web.config” file in that file in the
following sect
ion, you need to change the ODBC connection name to the name you
have chosen during ODBC configuration:




3.6.2

Client  Section
 
In here we will describe the steps that you need to go through to install the client. In
out case we will install client and server o
n the same machine. However client and
server need not to be on the same machine. During the configuration processes the
differences to be on one and more machines will be described.

<connectionStrings>



<remove name="DefaultConnStr" />



<add name="DefaultConnStr" connectionString="DSN=MySQL;"/>



</connectionStrings>

MacSeie


Installation  Manual

35

3.6.2.1

Installing  Client  on  IIS
 
First of all you need copy the client binaries o
n a permanent directory you want to be.
In this case I copied “Client” directory binaries to “C:
\
EMRWebApp”. Now here is the
installation process for installing the client:


1
-
Now you need to run, the Microsoft IIS. There are two ways to run IIS, the mos
t
convenient one is to run “inetmgr” in the run or command line. The second way is to
run it from “Administrative Tools” in Control Panel.


2
-
Now Go to “Your Computer Name”
-
> “Web Sites”
-
> “Default Web Site”



3
-
From “Action” menu select “New” and “
Virtual Directory”

MacSeie


Installation  Manual

36



4

In Alias section write “EMRWebApp”


5

Now in here select the “C:
\
EMRWebApp” Directory in which you put the binaries
into.

MacSeie


Installation  Manual

37



6

Just click Next and Finish in here.


MacSeie


Installation  Manual

38


7

Select EMRWebApp website and from Action menu select “
Properties”

8

In Properties select “Directory Security” tab


9

Now click on Edit button in “Anonymous access and authentication control”
section and select “Integrated Windows Authentication”

MacSeie


Installation  Manual

39



Now click OK and IIS configuration for client is ready.

3.6.2.2

Configuring  and  Testing  the  client
 
In the folder where you put the binaries of client (“C:
\
EMRWebApp” In our case) find
the “Web.config” file. In this file following sections are important in configuring the
client:

The first bold part is the address of
the server. If server is on another network location
just change the address from
localhost
to that location. And in the second bold
section is the address for the Java Based CDSS Web Service. After changing these
two to desired values. Just open the Brows
er and go to
http://localhost/EMRWebApp

and if you can see the first screen and you can also log in the server. Everything
<applicationSettings>



<EMRWebApp.Properties.Settin
gs>



<setting name="EMRWebApp_EMRWebReference_WsEMRCore" serializeAs="String">


<value>
http://localhost/EMRWebService/Service1.asmx
</value>



</setting>




<setting name="EMRWebApp_CDSSWebRef_CDSSService" serializeAs="String">


<value>
http://13
0.113.65.30:8080/axis2/services/CDSSService.CDSSServiceHttpSoa
p11Endpoint
</value>


</setting>




</EMRWebApp.Properties.Settings>



</applicationSettings>

MacSeie


Installation  Manual

40

works fine.