Difference between revisions of "Mi2b2 (i2b2 instance with the STAR-D software) specifications and installation instructions"

From NAMIC Wiki
Jump to: navigation, search
Line 18: Line 18:
 
== mi2b2 Installation Instructions ==
 
== mi2b2 Installation Instructions ==
  
 +
 +
''' Prerequisites '''
  
 
* For Windows XP, make sure all of the latest updates are installed to your machine
 
* For Windows XP, make sure all of the latest updates are installed to your machine
 
* Make sure that DotNet framework 2.0 is installed on your workstation.
 
* Make sure that DotNet framework 2.0 is installed on your workstation.
 +
 +
''' Download Software '''
  
 
* Download the zip file (mi2b2.zip) by going to i2b2.slicer.org/downloads [http://i2b2.slicer.org/downloads]
 
* Download the zip file (mi2b2.zip) by going to i2b2.slicer.org/downloads [http://i2b2.slicer.org/downloads]
Line 26: Line 30:
 
* Extract the zipped file to C:\
 
* Extract the zipped file to C:\
  
* Navigate to C:\MI2B2\installs, and double click on '''jdk-6u20-windows-i586.exe'''
+
''' Install JDK '''
 +
 
 +
* Navigate to C:\MI2B2\installs, and double click on ''jdk-6u20-windows-i586.exe''
 
* Accept the license agreement
 
* Accept the license agreement
 
* Click next on all prompts accepting default settings.
 
* Click next on all prompts accepting default settings.
 
* Reboot Workstation
 
* Reboot Workstation
  
* Navigate to C:\MI2B2\installs, and double click on '''SQLEXPR32.exe'''
+
''' Install Sql Server Express '''
 +
 
 +
* Navigate to C:\MI2B2\installs, and double click on ''SQLEXPR32.exe''
 
* Wait for extraction to finish, accept license, and click next.
 
* Wait for extraction to finish, accept license, and click next.
 
* Continue to click Next until you come to the Registration Information screen
 
* Continue to click Next until you come to the Registration Information screen
* On the Registration Information screen, uncheck '''Hide advanced configuration options'''. Click Next.
+
* On the Registration Information screen, uncheck ''Hide advanced configuration options''. Click Next.
 
* Accept Default settings and click next
 
* Accept Default settings and click next
* On the Instance Name screen, change to '''Default instance'''
+
* On the Instance Name screen, change to ''Default instance''
 
* Use the default settings for service account. Click Next.
 
* Use the default settings for service account. Click Next.
* On Database Security selection screen. Select '''MIXED MODE''', and enter a password (you choose)
+
* On Database Security selection screen. Select ''MIXED MODE'', and enter a password (you choose)
 
* Click Next three more times (accepting default settings each time), and click Install to finish.
 
* Click Next three more times (accepting default settings each time), and click Install to finish.
 +
 +
''' Modify Sql Server Configuration '''
 +
 +
* Click Start > Programs > Microsoft SQL Server 2005 > Configuration Tools > SQL Server Configuration Manager
 +
* Expand SQL Server 2005 Network Connection on the left.
 +
* Click on PROTOCOLS for MSSQLSERVER
 +
* Right Click on TCP/IP and select ''Enable''
 +
* Click on SQL Server 2005 Services
 +
* On the right, right click on SQL Server (MSSQLSERVER) and select Restart.
 +
 +
''' Modify Enviroment Variables '''
  
 
* Right Click on My Computer and select Properties, select Advanced, select Environment Variables, select new System Variable.
 
* Right Click on My Computer and select Properties, select Advanced, select Environment Variables, select new System Variable.
** Name: '''JAVA_HOME'''
+
** Name: ''JAVA_HOME''
** Variable: '''C:\Program Files\Java\jdk1.6.0_20'''
+
** Variable: ''C:\Program Files\Java\jdk1.6.0_20''
 
* Select New System Variable again
 
* Select New System Variable again
** Name: '''JBOSS_HOME'''
+
** Name: ''JBOSS_HOME''
** Variable: '''C:\Mi2b2\jboss-4.2.2.GA'''
+
** Variable: ''C:\Mi2b2\jboss-4.2.2.GA''
 
* Reboot Workstation
 
* Reboot Workstation
  
* Click Start > Run > Type '''CMD''' and press enter.
+
''' Install Databases and Windows Service '''
* In the command window, type '''cd C:\MI2B2\Database''' and press enter
+
 
* In the command winder, type '''install_database''' and press enter
+
* Click Start > Run > Type ''CMD'' and press enter.
 +
* In the command window, type ''cd C:\MI2B2\Database'' and press enter
 +
* In the command winder, type ''install_database'' and press enter
 
* Let the Database install finish
 
* Let the Database install finish
* Next in the same command window, type '''cd C:\Mi2b2\jboss-4.2.2.GA\Bin''' and press enter
+
* Next in the same command window, type ''cd C:\Mi2b2\jboss-4.2.2.GA\Bin'' and press enter
* Type '''install_service server''' and press enter
+
* Type ''install_service server''' and press enter
 
* Close command window.
 
* Close command window.
  
* Click Start > Programs > Microsoft SQL Server 2005 > Configuration Tools > SQL Server Configuration Manager
+
''' Modify MI2B2 Configurations '''
* Expand SQL Server 2005 Network Connection on the left.
 
* Click on PROTOCOLS for MSSQLSERVER
 
* Right Click on TCP/IP and select '''Enable'''
 
* Click on SQL Server 2005 Services
 
* On the right, right click on SQL Server (MSSQLSERVER) and select Restart.
 
  
 
* Navigate to this directory C:\Mi2b2\jboss-4.2.2.GA\server\default\conf\stardapp
 
* Navigate to this directory C:\Mi2b2\jboss-4.2.2.GA\server\default\conf\stardapp
Line 73: Line 89:
 
** #stard.pacs.remote.address=
 
** #stard.pacs.remote.address=
 
** #stard.pacs.remote.port=11112
 
** #stard.pacs.remote.port=11112
** stard.pacs.remote.aetitle=('''YOUR TEST AETITLE''')
+
** stard.pacs.remote.aetitle=(''YOUR TEST AETITLE'')
** stard.pacs.remote.address=('''YOUR TEST PACS IP OR HOSTNAME''')
+
** stard.pacs.remote.address=(''YOUR TEST PACS IP OR HOSTNAME'')
** stard.pacs.remote.port=('''YOUR TEST PACS PORT''')
+
** stard.pacs.remote.port=(''YOUR TEST PACS PORT'')
 
* Save File
 
* Save File
 
* Edit Same File and give the local I2B2 workstation an AETitle, Hostname and Port.
 
* Edit Same File and give the local I2B2 workstation an AETitle, Hostname and Port.
Line 81: Line 97:
 
** # Local PACS System Registration
 
** # Local PACS System Registration
 
** #######################################
 
** #######################################
** stard.pacs.local.aetitle=('''Your MI2B2 workstation Name''')
+
** stard.pacs.local.aetitle=(''Your MI2B2 workstation Name'')
** stard.pacs.local.address=('''Your MI2B2 workstation Hostname''')
+
** stard.pacs.local.address=(''Your MI2B2 workstation Hostname'')
 
** stard.pacs.local.port=104
 
** stard.pacs.local.port=104
 
* Save the file again and reboot workstation.
 
* Save the file again and reboot workstation.
 +
 +
''' Start I2B2 Hive Server '''
  
 
* Right Click on My Computer and select services.
 
* Right Click on My Computer and select services.
 
* Right Click on I2B2 Hive Server Service and select start (if not already started)
 
* Right Click on I2B2 Hive Server Service and select start (if not already started)
 +
 +
''' Test Software '''
  
 
* Navigate to C:\MI2B2\ C:\Mi2b2\mi2b2_workbench\
 
* Navigate to C:\MI2B2\ C:\Mi2b2\mi2b2_workbench\

Revision as of 14:48, 20 May 2010

Home < Mi2b2 (i2b2 instance with the STAR-D software) specifications and installation instructions

Back to CTSC:ARRA supplement

Specifications

This server will need to be inside the institutional firewall, have PACS access via institutional intranet, and a fixed IP address. It will not need access to the outside world.
2 GHZ processor
2 GB RAM
40 GB free space

Software
Windows XP SP1 or CentOS (other Linux version possible)
JDK 6.0
JBoss 4.2.2
Apache Ant 1.6.5
Apache Axis2 1.1
Oracle 10g Express Edition (for Linux Servers) or Sql Server 2005 Express Edition (for Windows)

mi2b2 Installation Instructions

Prerequisites

  • For Windows XP, make sure all of the latest updates are installed to your machine
  • Make sure that DotNet framework 2.0 is installed on your workstation.

Download Software

  • Download the zip file (mi2b2.zip) by going to i2b2.slicer.org/downloads [1]
  • Save MI2B2 file to your desktop.
  • Extract the zipped file to C:\

Install JDK

  • Navigate to C:\MI2B2\installs, and double click on jdk-6u20-windows-i586.exe
  • Accept the license agreement
  • Click next on all prompts accepting default settings.
  • Reboot Workstation

Install Sql Server Express

  • Navigate to C:\MI2B2\installs, and double click on SQLEXPR32.exe
  • Wait for extraction to finish, accept license, and click next.
  • Continue to click Next until you come to the Registration Information screen
  • On the Registration Information screen, uncheck Hide advanced configuration options. Click Next.
  • Accept Default settings and click next
  • On the Instance Name screen, change to Default instance
  • Use the default settings for service account. Click Next.
  • On Database Security selection screen. Select MIXED MODE, and enter a password (you choose)
  • Click Next three more times (accepting default settings each time), and click Install to finish.

Modify Sql Server Configuration

  • Click Start > Programs > Microsoft SQL Server 2005 > Configuration Tools > SQL Server Configuration Manager
  • Expand SQL Server 2005 Network Connection on the left.
  • Click on PROTOCOLS for MSSQLSERVER
  • Right Click on TCP/IP and select Enable
  • Click on SQL Server 2005 Services
  • On the right, right click on SQL Server (MSSQLSERVER) and select Restart.

Modify Enviroment Variables

  • Right Click on My Computer and select Properties, select Advanced, select Environment Variables, select new System Variable.
    • Name: JAVA_HOME
    • Variable: C:\Program Files\Java\jdk1.6.0_20
  • Select New System Variable again
    • Name: JBOSS_HOME
    • Variable: C:\Mi2b2\jboss-4.2.2.GA
  • Reboot Workstation

Install Databases and Windows Service

  • Click Start > Run > Type CMD and press enter.
  • In the command window, type cd C:\MI2B2\Database and press enter
  • In the command winder, type install_database and press enter
  • Let the Database install finish
  • Next in the same command window, type cd C:\Mi2b2\jboss-4.2.2.GA\Bin and press enter
  • Type install_service server' and press enter
  • Close command window.

Modify MI2B2 Configurations

  • Navigate to this directory C:\Mi2b2\jboss-4.2.2.GA\server\default\conf\stardapp
  • Open the File stard.properties with Wordpad
  • Add your local PACS Server information to the section below without the parenthesis.
    • #######################################
    • # Remote PACS System Registration
    • #######################################
    • #stard.pacs.remote.aetitle=DCM4CHEE
    • #stard.pacs.remote.address=
    • #stard.pacs.remote.port=11112
    • stard.pacs.remote.aetitle=(YOUR TEST AETITLE)
    • stard.pacs.remote.address=(YOUR TEST PACS IP OR HOSTNAME)
    • stard.pacs.remote.port=(YOUR TEST PACS PORT)
  • Save File
  • Edit Same File and give the local I2B2 workstation an AETitle, Hostname and Port.
    • #######################################
    • # Local PACS System Registration
    • #######################################
    • stard.pacs.local.aetitle=(Your MI2B2 workstation Name)
    • stard.pacs.local.address=(Your MI2B2 workstation Hostname)
    • stard.pacs.local.port=104
  • Save the file again and reboot workstation.

Start I2B2 Hive Server

  • Right Click on My Computer and select services.
  • Right Click on I2B2 Hive Server Service and select start (if not already started)

Test Software

  • Navigate to C:\MI2B2\ C:\Mi2b2\mi2b2_workbench\
  • Double Click on i2b2workbench.exe
  • Logon as
    • User: Demo
    • Password: demouser
  • You should be able to search your local Test Pacs System via MRN.