> ![](media/image1.png){width="1.0673611111111112in"
> height="1.0416666666666667in"}
>
> ![](media/image2.png){width="2.6215277777777777in"
> height="1.5680555555555555in"}

![](media/image3.wmf)

**Table of Contents**

[Introduction 1](#introduction)

[MIRCsite Installation Prerequisites
1](#mircsite-installation-prerequisites)

[Required Software---Not Included with MIRCsite
1](#required-softwarenot-included-with-mircsite)

[Required Hardware 1](#required-hardware)

[MIRCsite Software 1](#mircsite-software)

[Installing MIRCsite Software 2](#installing-mircsite-software)

[Upgrade MIRCsite Software 12](#upgrade-mircsite-software)

[Configure MIRCsite in NCICBIMAGE Storage Service Admin
23](#configure-mircsite-in-ncicbimage-storage-service-admin)

[Contacting Technical Support 34](#contacting-technical-support)

[NCICB Application Support 34](#ncicb-application-support)

####  {#section .unnumbered}

## Introduction 

The *MIRCsite Installation Guide* provides the procedures to install and
configure the Medical Imaging Resource Center (MIRC) software. MIRC is a
project of the Radiological Society of North America (RSNA), creating an
online community of medical imaging resources. The MIRCsite Installer
installs and configures the software components required to run a MIRC
site on an existing instance of Tomcat. This program allows you to
upgrade an existing MIRC site or to install a new one.

## MIRCsite Installation Prerequisites

+-------------+--------------------------------------------------------+
| ##### Re    | > You must download and install the software in Table  |
| quired Soft | > 1*.*                                                 |
| ware---Not  |                                                        |
| Included wi |                                                        |
| th MIRCsite |                                                        |
+-------------+--------------------------------------------------------+

  -------------------------------------------------------------------------------------------------------------------------------------------------------
  Software Name            Version   URL                                                                                Installation Note
  ------------------------ --------- ---------------------------------------------------------------------------------- ---------------------------------
  Java JDK or JRE          5.0       <http://java.sun.com/j2se/1.5.0/download.jsp>                                      

  Java Advanced Imaging    1.0_01    <http://java.sun.com/products/java-media/jai/downloads/download-iio-1_0_01.html>   
  Image I/O Tools                                                                                                       

  Apache Tomcat            5         <http://tomcat.apache.org/download-55.cgi>                                         

  Java Cryptography        5.0       http://java.sun.com/javase/downloads/index.jsp                                     Unzip the file and extract
  Extension (JCE)                                                                                                       local_policy.jar from it and
  Unlimited Strength                                                                                                    replace this jar file with the
  Jurisdiction Policy                                                                                                   one under
  Files                                                                                                                 /usr/jdk1.5.x/jre/lib/security.
  (jce_policy-1_5_0.zip)                                                                                                
  -------------------------------------------------------------------------------------------------------------------------------------------------------

Table 1 Required software for MIRCsite

+-------------+--------------------------------------------------------+
| #           | > A common PC is required (for example, a Pentium 4    |
| #### Requir | > with 512MB memory). The space requirement depends on |
| ed Hardware | > your storage requirement since all the images are    |
|             | > saved under MIRC software.                           |
+-------------+--------------------------------------------------------+

+-------------+--------------------------------------------------------+
| #           | > You can either download the MIRCsite installer or    |
| #### MIRCsi | > build it from the build.xml script in the source     |
| te Software | > code.                                                |
+-------------+--------------------------------------------------------+

> **Important** Before you install MIRCSite Software, **change your
> tomcat port to 58080 for Oracle OR 58081 for MySQL.** This is required
> because we found a bug in MIRC Version T32, eXist database use this
> port to build MIRC index.

## Installing MIRCsite Software 

> Complete the following steps to install the MIRCsite software.

+--------+-------------------------------------------------------------+
| Step   | Action                                                      |
+========+=============================================================+
| e.     | Start MIRCsite Installer. (In Linux, use java --jar         |
|        | /path/to/MIRCInstaller.jar after using a tool such as       |
| 1      | Reflection X to port the display to your Windows desktop)   |
|        |                                                             |
|        | ***[Important Note]{.underline}**: In order to avoid        |
|        | filesystem permission issues on a Linux installation, be    |
|        | sure to be install MIRC using the same user that will be    |
|        | executing the system.*                                      |
+--------+-------------------------------------------------------------+
| f.     | The **MIRCsite Installer** dialog displays. Make sure       |
|        | Tomcat is not running. Click **Next**.                      |
| 2      |                                                             |
|        | ![](media/image4.png){width="5.033333333333333in"           |
|        | height="3.775in"}                                           |
+--------+-------------------------------------------------------------+
| g.     | Verify if the instance of Tomcat is correct. If not, click  |
|        | **Browse** to find the right one. Once correct, click       |
| 3      | **Next**.                                                   |
|        |                                                             |
|        | ![](media/image5.png){width="5.033333333333333in"           |
|        | height="3.775in"}                                           |
+--------+-------------------------------------------------------------+
| h.  5  | Click **Install** to install a new MIRC query service.      |
|        |                                                             |
| 4      | ![](media/image6.png){width="5.033333333333333in"           |
|        | height="3.775in"}                                           |
+--------+-------------------------------------------------------------+
|        |                                                             |
+--------+-------------------------------------------------------------+
| i.  5  | Type a description for the name of the MIRC site. Click     |
|        | **OK**.                                                     |
| 5      |                                                             |
|        | ![](media/image7.png){width="4.03125in"                     |
|        | height="2.0833333333333335in"}                              |
|        |                                                             |
|        | Example: NCICBIMAGE MIRC Site                               |
+--------+-------------------------------------------------------------+
| j.  5  | Click **Yes** if you want your site\'s IP to be dynamic.    |
|        | Otherwise, click **No**.                                    |
| 6      |                                                             |
|        | ![](media/image8.png){width="4.572916666666667in"           |
|        | height="3.8020833333333335in"}                              |
+--------+-------------------------------------------------------------+
| k.  5  | Click **Install** to install a new Storage Service.         |
|        |                                                             |
| 7      | ![](media/image9.png){width="5.033333333333333in"           |
|        | height="3.775in"}                                           |
+--------+-------------------------------------------------------------+
| 8      | Enter a new one-word storage service servlet name. Click    |
|        | **OK**.                                                     |
|        |                                                             |
|        | ![](media/image10.png){width="3.9791666666666665in"         |
|        | height="1.3333333333333333in"}                              |
|        |                                                             |
|        | Example: NCICBIMAGE                                         |
+--------+-------------------------------------------------------------+
| 9      | Enter a descriptive name for the new storage service. Click |
|        | **OK**.                                                     |
|        |                                                             |
|        | ![](media/image11.png){width="4.03125in"                    |
|        | height="1.53125in"}                                         |
|        |                                                             |
|        | Example: NCICBIMAGE Storage Service. This is a descriptive  |
|        | name for the storage service you enter in step 8 above.     |
+--------+-------------------------------------------------------------+
| 10     | Type ***SS*** for the standard designator. Click **OK**.    |
|        |                                                             |
|        | ![](media/image12.png){width="4.34375in"                    |
|        | height="3.6458333333333335in"}                              |
+--------+-------------------------------------------------------------+
| 11     | Leave the one-line site description as blank. Click **OK**. |
|        |                                                             |
|        | ![](media/image13.png){width="4.8125in"                     |
|        | height="1.7291666666666667in"}                              |
+--------+-------------------------------------------------------------+
| 12     | Click **Yes** for automatic indexing. Click **Yes.**        |
|        |                                                             |
|        | ![](media/image14.png){width="5.031944444444444in"          |
|        | height="2.373611111111111in"}                               |
+--------+-------------------------------------------------------------+
| 13     | Click **Next**.                                             |
|        |                                                             |
|        | ![](media/image15.png){width="5.033333333333333in"          |
|        | height="3.775in"}                                           |
+--------+-------------------------------------------------------------+
| 14     | Click **Next** to skip installing a testing storage         |
|        | service.                                                    |
|        |                                                             |
|        | ![](media/image16.png){width="5.033333333333333in"          |
|        | height="3.775in"}                                           |
+--------+-------------------------------------------------------------+
| 15     | Click **Create** to create or update a Tomcat user.         |
|        |                                                             |
|        | ![](media/image17.png){width="5.035416666666666in"          |
|        | height="3.0416666666666665in"}                              |
+--------+-------------------------------------------------------------+
| 16     | Enter a user name for the administrator roles. For example, |
|        | enter ***admin*** to update user **admin** to have MIRC     |
|        | administrator roles. Click **OK**.                          |
|        |                                                             |
|        | ![](media/image18.png){width="4.15625in"                    |
|        | height="1.9270833333333333in"}                              |
+--------+-------------------------------------------------------------+
| 17     | Enter a password. For example, enter a password **admin**.  |
|        | Click **OK**.                                               |
|        |                                                             |
|        | ![](media/image19.png){width="3.09375in"                    |
|        | height="1.53125in"}                                         |
+--------+-------------------------------------------------------------+
| 18     | Confirm previous password. For example, enter the password  |
|        | **admin again** and click **OK**.                           |
|        |                                                             |
|        | ![](media/image20.png){width="3.09375in"                    |
|        | height="1.3333333333333333in"}                              |
|        |                                                             |
|        | Note down the username and password you have created as you |
|        | will need it later to login to your service.                |
+--------+-------------------------------------------------------------+
| 19     | As a result, the **admin** user has all the MIRC roles      |
|        | highlighted in red. Click **Next**.                         |
|        |                                                             |
|        | ![](media/image21.png){width="5.033333333333333in"          |
|        | height="3.775in"}                                           |
+--------+-------------------------------------------------------------+
| 20     | Click **Next** to enable Tomcat Smart Memory Realm.         |
|        |                                                             |
|        | ![](media/image22.png){width="5.033333333333333in"          |
|        | height="3.775in"}                                           |
+--------+-------------------------------------------------------------+
| 21     | Click **Next** to enable Tomcat Single Sign On              |
|        | Authenticator.                                              |
|        |                                                             |
|        | ![](media/image23.png){width="5.033333333333333in"          |
|        | height="3.775in"}                                           |
+--------+-------------------------------------------------------------+
| 20     | Click **Next**. This will not set up a redirector.          |
|        |                                                             |
|        | ![](media/image24.png){width="5.033333333333333in"          |
|        | height="3.775in"}                                           |
+--------+-------------------------------------------------------------+
| 21     | Click **Finished**. This completes the installation.        |
|        |                                                             |
|        | ![](media/image25.png){width="5.033333333333333in"          |
|        | height="3.775in"}                                           |
+--------+-------------------------------------------------------------+
| 22     | Restart tomcat.                                             |
+--------+-------------------------------------------------------------+

## Upgrade MIRCsite Software

> Complete the following steps to upgrade to the latest MIRCsite
> software

+--------+-------------------------------------------------------------+
| Step   | Action                                                      |
+========+=============================================================+
| l.     | Start MIRCsite Installer.                                   |
|        |                                                             |
| 1      |                                                             |
+--------+-------------------------------------------------------------+
| m.     | The **MIRCsite Installer** dialog displays. Make sure       |
|        | Tomcat is not running. Click **Next**.                      |
| 2      |                                                             |
|        | ![](media/image4.png){width="5.033333333333333in"           |
|        | height="3.775in"}                                           |
+--------+-------------------------------------------------------------+
| n.     | Verify if the instance of Tomcat is correct. If not, click  |
|        | **Browse** to find the right one. Once correct, click       |
| 3      | **Next**.                                                   |
|        |                                                             |
|        | ![](media/image5.png){width="5.033333333333333in"           |
|        | height="3.775in"}                                           |
+--------+-------------------------------------------------------------+
| o.  5  | MIRC Software has found an existing MIRC Site at this       |
|        | tomcat. Click Upgrade to upgrade your current MIRC          |
| 4      | Software.                                                   |
|        |                                                             |
|        | ![](media/image26.png){width="5.033333333333333in"          |
|        | height="3.775in"}                                           |
+--------+-------------------------------------------------------------+
| p.  5  | Click **Install** if you want to install a new Storage      |
|        | Service beside the storage service you already have;        |
| 5      | otherwise, click **Next**.                                  |
|        |                                                             |
|        | ![](media/image9.png){width="5.033333333333333in"           |
|        | height="3.775in"}                                           |
+--------+-------------------------------------------------------------+
| 6      | Click **Next** to skip installing a testing storage         |
|        | service.                                                    |
|        |                                                             |
|        | ![](media/image16.png){width="5.033333333333333in"          |
|        | height="3.775in"}                                           |
+--------+-------------------------------------------------------------+
| 7      | Click **Next**. This will not set up a redirector.          |
|        |                                                             |
|        | ![](media/image24.png){width="5.033333333333333in"          |
|        | height="3.775in"}                                           |
+--------+-------------------------------------------------------------+
| 8      | Click **Finished**. This completes the installation.        |
|        |                                                             |
|        | ![](media/image27.png){width="5.033333333333333in"          |
|        | height="3.775in"}                                           |
+--------+-------------------------------------------------------------+
| 9      | Restart tomcat.                                             |
+--------+-------------------------------------------------------------+

## Configure MIRCsite in NCICBIMAGE Storage Service Admin 

> Complete the following configuration steps to after installing
> MIRCsite software.

+--------+-------------------------------------------------------------+
| Step   | Action                                                      |
+========+=============================================================+
| q.     | Make sure you have replaced local_policy.jar in MIRC        |
|        | system. Please refer to the "MIRCsite Installation          |
|        | Prerequisites" session on page 1 of the documentation for   |
|        | installation information. This step occurs one time only on |
|        | the MIRC server system.                                     |
+--------+-------------------------------------------------------------+
| r.     | Mount drive K to a system where the generated keyfile.txt   |
|        | located. Assume the key file path is K:\\keyfile.txt.       |
| 1      |                                                             |
|        | Perform this step only if you are using Central Remapping   |
|        | feature of MIRC software; otherwise, you cans skip to step  |
|        | 3.                                                          |
+--------+-------------------------------------------------------------+
| s.     | If you do update MIRC, you need to remove                   |
|        | Tomcat                                                      |
| 2      | x.x.x\\webapps\\YourStorageName\\trial\\idtable.properties. |
|        | If you install MIRC, you can skip this step and go to step  |
|        | 3.                                                          |
+--------+-------------------------------------------------------------+
| t.     | Start tomcat, and go to the query service that you have     |
|        | just installed. For example, if you install in your local   |
| 3      | PC machine with port 58080, your url will be                |
|        | <http://localhost:58080/mirc/query>                         |
|        |                                                             |
|        | ![](media/image28.png){width="5.029166666666667in"          |
|        | height="3.748611111111111in"} click "Log In To Server" link |
|        | on the right, a window pops up for accepting userId and     |
|        | password                                                    |
|        |                                                             |
|        | ![](media/image29.png){width="3.3958333333333335in"         |
|        | height="3.0104166666666665in"}                              |
|        |                                                             |
|        | Enter username and password you have created in step 16 --  |
|        | 18 above and click OK                                       |
+--------+-------------------------------------------------------------+
| u.     | The following page will be displayed                        |
|        |                                                             |
| 4      | ![](media/image30.png){width="5.034722222222222in"          |
|        | height="4.795833333333333in"}                               |
+--------+-------------------------------------------------------------+
| v.     | Click on the "Admin Service" link, NCICBIMAGE Storage       |
|        | Service Admin window will be displayed as:                  |
| 5      |                                                             |
|        | ![](media/image31.png){width="5.028472222222222in"          |
|        | height="4.8069444444444445in"}                              |
+--------+-------------------------------------------------------------+
| w.     | Click **Update Configuration** button under **DICOM,**      |
|        | "**DICOM Service Configurator"** window pops up.            |
| 6      |                                                             |
+--------+-------------------------------------------------------------+
| x.  5  | In top section, set **Autostart** to yes, **Log** to yes    |
|        | then click **Update the Anonymizer** button, **DICOM        |
| 7      | Anonymizer Configurator** window will pop up (see step 8)   |
|        |                                                             |
|        | ![](media/image32.png){width="5.030555555555556in"          |
|        | height="3.0194444444444444in"}                              |
+--------+-------------------------------------------------------------+
| y.  5  | Make sure all checkboxes are unchecked except following 4   |
|        | checkboxes.                                                 |
| 8      |                                                             |
|        | Fill **\@remove()** in the text fields for these 4          |
|        | elements.                                                   |
|        |                                                             |
|        | ![](media/image33.png){width="5.034027777777778in"          |
|        | height="4.509722222222222in"}                               |
|        |                                                             |
|        | Move the scrollbar to the bottom and click **Update         |
|        | anonymizer properties** tab. Close the window.              |
+--------+-------------------------------------------------------------+
| z.  5  | Move down to **Central Remapper Parameters** section, set   |
|        | key file path in **External key file** field: Set these     |
| 9      | value only if you use Central Remapping feature of MIRC     |
|        | Software, otherwise, you can skip to this step.             |
|        |                                                             |
|        | ![](media/image34.png){width="4.958333333333333in"          |
|        | height="4.0625in"}                                          |
+--------+-------------------------------------------------------------+
| a.  5  | DICOM Import Service and Export Service Use Default Values. |
|        |                                                             |
| 10     | ![](media/image35.png){width="5.030555555555556in"          |
|        | height="3.8006944444444444in"}                              |
+--------+-------------------------------------------------------------+
| b.  5  | HTTP Import Service and Expert Service Use Default Values.  |
|        |                                                             |
| 11     | Unless you have any preprocessor for your HTTP Import       |
|        | Service, than set the **Preprocessor** **enabled** to yes   |
|        | and enter the name of the **Preprocessor class name**       |
|        |                                                             |
|        | ![](media/image36.png){width="5.030555555555556in"          |
|        | height="4.746527777777778in"}                               |
+--------+-------------------------------------------------------------+
| c.  5  | Move down to **Database Export Service** section, set       |
|        | **Mode** to auto, set **Anonymizer enabled** to yes, change |
| 12     | **sleep interval(ms)** to 10000, and enter                  |
|        | gov.nih.nci.ncia.util.NCIADatabase in **Database class      |
|        | name** field.                                               |
|        |                                                             |
|        | Click **Update trial.xml** button.                          |
|        |                                                             |
|        | Close **DICOM Service Configurator** by click window red    |
|        | close icon.                                                 |
|        |                                                             |
|        | ![](media/image37.png){width="5.030555555555556in"          |
|        | height="3.1145833333333335in"}                              |
+--------+-------------------------------------------------------------+
| d.  5  | Now you come back to NCICBIMAGE Storage Service Admin       |
|        | window. In **Storage Service** column, click **Update       |
| 13     | Configuration** button:                                     |
|        |                                                             |
|        | ![](media/image38.png){width="5.034027777777778in"          |
|        | height="2.6993055555555556in"}                              |
+--------+-------------------------------------------------------------+
| 14     | **Storage Service Configurator** pops up, scroll the window |
|        | down to the area below:                                     |
|        |                                                             |
|        | Change **DICOM Service Enabled** value to **yes**, then     |
|        | click Update storage.xml button.                            |
|        |                                                             |
|        | ![](media/image39.png){width="5.032638888888889in"          |
|        | height="4.6097222222222225in"}                              |
+--------+-------------------------------------------------------------+
| 15     | Close **Storage Service Configurator** window, click the    |
|        | **Start/Restart** button in DICOM column, wait for a couple |
|        | of seconds, click the **Status** button on the top left     |
|        | window in SAIC MIRC Storage Service Admin, the status table |
|        | will be updated as below. Check following parameters to     |
|        | confirm the MIRC service is running properly.               |
|        |                                                             |
|        | 1.  Submit Service enabled: yes                             |
|        |                                                             |
|        | 2.  Author Service enabled: yes                             |
|        |                                                             |
|        | 3.  DICOM Service enabled: yes                              |
|        |                                                             |
|        | 4.  DICOM Service autostart: yes                            |
|        |                                                             |
|        | 5.  DICOM Service: running                                  |
|        |                                                             |
|        | ![](media/image40.png){width="5.028472222222222in"          |
|        | height="4.447916666666667in"}                               |
+--------+-------------------------------------------------------------+
| 16     | Restart Tomcat. You must do this step to ensure the         |
|        | keyfile.txt is read by MIRC service.                        |
+--------+-------------------------------------------------------------+
| 17     | Unmount the drive K from MIRC service system.               |
+--------+-------------------------------------------------------------+
| 18     | Done.                                                       |
+--------+-------------------------------------------------------------+

## Contacting Technical Support

+-----------+----------------------------------------------------------+
| #####     | <http://ncicbsupport.nci.nih.gov/sw/>                    |
|  NCICB Ap |                                                          |
| plication | Telephone: 301-451-4384                                  |
|  Support  |                                                          |
|           | Toll free: 888-478-4423                                  |
+-----------+----------------------------------------------------------+