Imaging:virtualPACSInstallation

Prerequisites for virtualPACS on a Windows machine (in order of installation):

1. *NOTE: You need to have rights to install tools on your Windows machine to install the Prerequisites
2. Install Java
   1. Set the JAVA_HOME in the system environment to match the install location (e.g. C:\Progra~1\Java\jdk1.5.0_16)
3. Install caGrid 1.2
   1. Unzip the installer
   2. Double-click on the caGrid-installer-1.2.jar file
   3. Uncheck install caGrid Services
   4. Set the install location for each piece (i.e. Ant, Globus and caGrid) to C:\
   5. Follow the instructions on the last installer window
      1. Create a system environment variable for ANT_HOME
      2. Set it to C:\apache-ant-1.6.5
      3. Create a system environment variable for GLOBUS_LOCATION
      4. Set it to C:\ws-core-4.0.3
4. Install Subversion tool
   1. *NOTE: TortoiseSVN integrates itself with Windows Explorer
   2. You will have to reboot the computer to get TortoiseSVN to work properly

1. Obtain the trunk folder for IVIM from the OSU subversion repository:
   1. Right-click on the Desktop and select SVN Checkout
   2. Enter https://project.bmi.ohio-state.edu/svn/ivi/trunk in the URL of the Repository field
   3. Enter c:\virtualPACS in the Checkout directory field
   4. Click OK
   5. Click "Yes" to make the C:\virtualPACS directory on your machine
   6. Click "Accept permanently" on the prompt about validating the server certificate
   7. At the prompt for the username and password, enter "anonymous" and your e-mail address
   8. Click OK
2. Copy ivy-2.0.0-beta2.jar from C:\virtualPACS\antfiles\ivy\lib to the Apache Ant library folder (e.g. C:\apache-ant-1.6.5\lib)
3. Go to Start -> Run
   1. Enter cmd and click OK
   2. At the command prompt, type "set CAGRID_LOCATION=C:\caGrid" and hit Enter
   3. Then type "cd C:\virtualPACS" and hit Enter
   4. From within the virtualPACS installation folder, type "%ANT_HOME%\bin\ant clean all" and hit Enter
   5. Once the ant build finishes, type "cd clients\virtualPACS\resources" and hit Enter
   6. To edit the virtualPACS.properties file, type "notepad virtualPACS.properties" and hit Enter
      1. Under the Edit Menu, select Find
      2. Type "Dicom.RemoteAEs" in the "Find what:" field and click "Find Next" twice
      3. Click Cancel
      4. Add the name of the PACS Workstation software (e.g. kpacs) to the end of the Dicom.RemoteAEs line
      5. Copy the Dicom.RemoteAEs.tony lines to the end of the file, just above the ModelMapPropertiesFile line
      6. Replace "tony" with the name of the PACS Workstation software (e.g. kpacs) for each of the four lines
      7. Replace "TONY" in the CalledAETitle line with the name of the PACS Workstation in uppercase (e.g. KPACS)
      8. Replace "140.254.80.125" in the HostNameOrIPAddress line with the IP address of the computer that the PACS Workstation software is installed on (e.g. 10.162.37.48)
      9. Replace "4057" in the Port line with the port that the PACS Workstation software utilizes on the computer it is run from (e.g. 4008)
      10. Repeat the previous six steps for each PACS Workstation that will be connecting to the virtualPACS
   7. Save and close the file
   8. To edit the virtualpacs-ui-configuration.xml file, type "notepad virtualpacs-ui-configuration.xml" and hit Enter
      1. Copy the ividemo.bmi.ohio-state.edu "<value>" line under the data-services <values> and paste it on the next line in the file
      2. Replace "ividemo.bmi.ohio-state.edu" with "imagingvm.cvrgrid.org" in the copied line
      3. Delete the other "<value>" lines so that only the new "imagingvm.cvrgrid.org" remains
   9. Save and close the file
   10. To go to the virtualPACS client folder, Type "cd .." and hit Enter
   11. To run the virtualPACS client, type "%ANT_HOME\bin\ant ui" and hit Enter
       1. *NOTE: This command is case-sensitive
       2. It also requires that the CAGRID_LOCATION variable (see Step 2) be active and set properly
   12. From within the virtualPACS User Interface, click on the “Virtual PACS” button in the toolbar.
   13. In the screen that appears, select “DICOMDataService” from the drop-down menu and click the “Locate” button.
   14. Highlight the line for the “imagingvm.cvrgrid.org” DICOMDataService and click the “Start” button at the bottom of the screen.