Instruction for installing DCMSecure on Windows 7 and Higher 64 Bit Systems

Transcription

1 Instruction for installing DCMSecure on Windows 7 and Higher 64 Bit Systems Sam Shen, October 29, 2014 Aili Maki, October 08, 2015 System Requirement: The DCMSecure_x64 service has to run on a host computer with Microsoft Windows XP, Windows 7, or higher. This host computer must be visible (network-wise) to the mammography acquisition workstation, meaning there is no firewall separating the two computers. The host machine must have the privilege to connect to outside Internet. The installation of the DCMSecure_x64 service requires that the installer has Administrator privileges on the host computer. Image Flow Chart: Mammography Machine Acquisition Workstation (AWS) DICOM image transfer over internal network PC running DCMsecure_x64 (host computer) storescp.exe Secured DICOM image transfer over internet relays.exe SRI DICOM server DCM SECURE The DCMSecure_x64 service starts two programs that run in the background whenever the PC is turned on. storescp.exe receives DICOM images from the mammography machine s Acquisition workstation (AWS). relays.exe sends DICOM images securely over the internet to the SRI DICOM server, DCMSECURE. Procedures for setting up DCMSecure_x64 service: Determine your system type: Log-in with an account having Administrator privileges. As seen in Figure 1, Click on Start button (red arrow), then type system in the edit box above (red rectangle), then select menu item System (red ellipse). A window with the system type will appear (Windows 7 Professional and 64 bit in my case, circled in green).

2 Downloading executable files: If your system is running a 64 bit system, please download the DCMSECURE_x64.zip file (Orange Arrow in Figure 1) and matching instructions Instruction for installing DCMSecure_64Bit.pdf. If you are running Windows XP, please download the DCMSECURE_XP.zip file and matching instructions Instruction for installing DCM Secure_XP.pdf. If you are running a 64 bit system, or you are not sure, please download DCMSECURE.zip file. In the following text, I will just use the wording for 64 bit system and the reader can adjust accordingly. Create a folder on the C:\ drive called DCMSecure. Unzip the files, and copy them to C:\DCMSecure_x64 folder (Figure 2). Depending on the program you use to unzip the files, a new folder called DCMSecure_x64 may get created inside the first one. If this happens, delete both folders and try unzipping again, but this time select C:\ as the destination for the unzipping process. You will also need to install the Visual C++ Redistributable Package for Visual Studio From the same location as you downloaded the DCMSECURE_x64.zip file, download vcredist_x64.exe and run it. It can also be obtained from here: Click on the red Download button and choose vcredist_x64.exe. Follow the prompts to download and run the file this package will install the needed DLL files for relays to run correctly. Change User Account Control Settings Log-in with an account having Administrator privileges. In Windows 7 and higher, click the Windows Start button, then type user account in the search field and select Change User Account Control settings menu item. You will be given a pop-up window as seen in Figure 3. If the setting for when to be notified about changes to your computer is not Never notify : write down its current setting and then change the slider to Never notify. Then Reboot your computer to have this change take effect. If you don t change this setting, Windows will complain during the installation of the service, and it may not install correctly. Install DCMSecure service Log-in with an account having Administrator privileges. Click on the left lower Start button, then type cmd.exe and select cmd.exe menu item. You will be given the command line window. At the command line prompt, type cd \DCMSecure_x64 and enter. Type xyntservice -i and enter (Figure 4). Type type xyntservice.log and should see something similar to text box on right in Figure 4. You should see Service DCMSecure installed or words like that. But if you see something like OpenSCManager failed, error code = 5, then the service installation has failed. You need to verify that you have followed the steps above correctly.

3 Configure and Start DCMSecure service Modify the C:\DCMSecure_x64\XYNTService.ini file so that the values reflects your site information (yellow highlighted text in Figure 5). The XYNTService.ini file can be opened with Notepad or WordPad. The text highlighted in yellow can be changed include text identifying your site name and or location. Edit the C:\DCMSecure_x64\filter.ini file to decide what DICOM files should be forwarded to the DCMSECURE server (see Figure 6). Each row in this file is a rule. If the DICOM tag on the left contains the text on the right, the image will be forwarded to DCMSECURE. Tag is the tag for Patient Name. Note that * is used as a wild-card character and the string-matching is not case-sensitive. DICOM files that do not meet any of the rules in the filter.ini file will be deleted from the computer running DCMSecure without being forwarded on to the DCMSECURE server. Then follow the instructions in caption of Figure 7 to start the service. Configure your acquisition workstation Find out the IP address of the host computer (computer where you installed DCMSecure_x64 service) as instructed in Figure 8. Make note of the service port number as circled in blue in Figure 5. The DCMSecure_x64 s DICOM storescp service does not check the AE Title, so you or your mammography service person can create a DICOM node (image storage destination) in your mammography acquisition workstation with the IP address of the host computer and the service port number and any appropriate AE Title, such as TMISTQC. Testing DCMSecure Push a series of images from your acquisition workstation. If you don t see a complaint from the acquisition workstation (a good sign), then you can check the log file on the host computer (C:\DCMSecure_x64\yyyymmdd_InfoLog.log and/or yyyymmdd_errlog.log). If no error occurs, you don t see the yyyymmdd_errlog.log file. If the images are successfully passed to DCMSecure central server, the yyyymmddrelay.log file will record the event. Reset User Account Control Settings Reverse the change in the step of Change User Account Control Settings so that your system is safe. To do this: Log-in with an account having Administrator privileges. Click the Windows Start button, then type user account in the search field and select Change User Account Control settings menu item. You will be given a pop-up window as seen in Figure 3. Change the slider back to the setting it had before you started the install process. Then Reboot your computer to have this change take effect. If any problems are encountered in the installation process, or you have questions or concerns of any kind regarding this software, do not hesitate to call or us: Aili Maki: x1019, aili.maki@sri.utoronto.ca Sam Shen: x3274, sam.shen@sri.utoronto.ca

4 Figure 1: Terminology of Windows graphic user interface and getting system information.

5 Figure 2: Screen capture after unzipping the DCMSECURE_x64.zip file to the C:\ folder. Figure 3: Click on left lower corner button and you can type user account in the edit box right above, and you can see Change User Account Control settings menu item. Click it and you have pop-up window on the right side.

6 Figure 4: Click on the Start button, and type cmd.exe in the edit box, select the cmd.exe menu item and you are given a command line window as seen on right side. Figure 5: Open C:\DCMSecure\XYNTService.ini file, and change the string after -f to something related to your site (as circled in yellow). This string should not be more than 16 characters long and should only contain letters and/or numbers. Notice that the service will listen to port 104 as circled in blue.

7 Figure 6: Open C:\DCMSecure_x64\filter.ini file, and change the rules to suit your site s naming scheme for QC images. The number on the left is the DICOM tag (0x0010,0x0010, Patient name, is written as ). The string on the right is what is matched. The matching is not case-sensitive (qc and QC are the same). * is a wild card. Here files with a patient name such as SEMIANNUALPHYSICSTEST would be forwarded to DCMSECURE, but a file with the patient name TEST would not. Figure 7: Click Start button, type service, and select Services menu item (circled in yellow). You are given the Services window. You can scroll and verify the existence of OBSPSecure service (circled in red). Make sure the startup type is Automatic. You click the green triangular button to start the service (circled in green).

8 Figure 8: Type ipconfig and enter in a command line window. You should see IPv4 Address and 4 integers with dots as circled in yellow.