Three Palm Software – Document # 86 (4.

0)

Three Palm Software

CadOne™ Service Manual

Three Palm Software

367 Penn Way
Los Gatos, CA 95032
(408) 356-3240
support@threepalmsoft.com

Copyright © Three Palm Software 2008-2011 Page 1

 Three Palm Software – Document # 86 (4.0)

Contents

CadOne™ Service Manual .............................................................................................. 1

Contents.......................................................................................................................... 2
1. System Components ................................................................................................ 3
1.1. Hardware ......................................................................................................... 3
1.2. Software .......................................................................................................... 3
1.2.1. XP Professional Large Memory Setting .................................................... 4
1.2.2. Vista or Windows 7 Large Memory Setting ............................................... 4
1.2.3. Message Queuing .................................................................................... 5
1.3. User login ........................................................................................................ 6
1.3.1. Windows Security..................................................................................... 6
2. Software Installation ................................................................................................. 6
3. Connectivity Configuration ....................................................................................... 9
3.1. Store Configuration .......................................................................................... 9
3.2. SrOutput Configuration .................................................................................. 10
3.3. Queue Setup.................................................................................................. 11
3.4. Procedure Log ............................................................................................... 12
3.5. Computer Resources ..................................................................................... 13
3.6. Change Configuration .................................................................................... 14
4. License Install ........................................................................................................ 14
5. Acceptance Test .................................................................................................... 16
6. System Logs .......................................................................................................... 17

Copyright © Three Palm Software 2008-2011 Page 2

 Three Palm Software – Document # 86 (4.0)

1. System Components
Three Palm Software (TPS)’s Mammography CAD product – CadOne™ is a vendor-
neutral mammography Computer-Aided Detection system.

1.1. Hardware
The system consists of following hardware pieces:
 A general purpose computer based on the Intel Core i3 processor or better,
running at 2.4 GHz or higher, with minimum of 3GB RAM.
 For disk, minimal is required – typically the machine is configured to auto-delete
cases as they are processed, so only a small set of images reside on disk (for
example, a 100GB system drive should be fine). The only exception to this is if
there is a need to collect data at a site (e.g., for analysis of some problem), then
the auto-cleanup could be turned off, and the data retained on disk, requiring
more space depending on how much data is being collected.
 If no remote access, display monitor, keyboard and mouse.
 The computer has to have a network card compatible with the site (gigabit or 100
megabit typically).
CadOne is a 32 bit install, but can be installed on either a 32 bit or a 64 bit machine.
There are usually two different hardware configurations used in the field with CadOne:
1. Standalone install on a machine near the FFDM
2. Install on the same machine as WorkstationOne
The first configuration is more “standard” and is certainly the best idea if there are
multiple FFDM acquisition devices, and the radiologist workstations are at a different
location to the FFDM. This model results in less load on the network (for-processing data
not going to the workstation), and of course less CPU usage on the workstation. When
this configuration is selected, CadOne can have a 32 or 64 bit operating system, it does
not need any graphics (except for service usage), it should have at least 3GB RAM
(probably 4GB in most cases), and should have a “modern” CPU (e.g., a Core i3 or
better), but even a core-2 Duo would suffice
The second model appeals to sites with only one acquisition device and one workstation,
typically with the workstation located close to the FFDM. When CadOne shares the
computer with WorkstationOne, then it is highly recommended that the machine be an
x64 (e.g., XP-x64, Vista-x64 or windows7-x64) OS and have at least 6GB RAM. A Core
i7 or better (e.g., Xeon-based workstation) is suggested. This configuration also should
also have disks configured for speed (e.g., 2 in a RAID-0 setup).

1.2. Software
This workstation is designed to run on Microsoft Windows with all Microsoft
recommended patches installed. In particular, the following targets are supported by the
installation package:
 Windows XP Professional (SP3 and later), 32 bit and 64 bit
 Windows Vista (SP2 and later) or Windows 7 (SP1 and later), 32 bit and 64 bit

Copyright © Three Palm Software 2008-2011 Page 3

 Three Palm Software – Document # 86 (4.0)

The installation package is:

 TPS.CadOne.v.v.v.zip
where v.v.v is version number of the installation package.
The installation package includes the TPS specific dependencies that are needed to run
this software on the target platforms. The operating system dependencies generally do
not need to be installed separately. However the computer is required to be connected
to the internet during installation in order for the install to automatically download the
required .NET framework and other run-time pre-requisites.
The package includes the Intel ippi libraries. If the computer already has a version of the
Intel ippi libraries, the user needs to ensure the system is setup so the correct version is
found.

1.2.1. XP Professional Large Memory Setting

No setting changes are needed for Windows XP Professional x64, however for x86
(32bit), the large memory setting in the boot.ini file should be set to allow the application
to take advantage of more than 2 GB on machines that have that much memory. This
can be conveniently set using “System Properties” from the Control Panel:
 Advanced tab
 Click Settings in the “Startup and Recovery” group
 Click Edit in the “System startup” group
 In the Notepad window, add the string “/3GB” to the end of any line in the
[operating systems] section, which specifies a 32bit operating system, for
example:

Note that some graphic cards may require another switch: /USERVA=2800.
 Exit with save, then exit.
This change will take effect on the next reboot.

1.2.2. Vista or Windows 7 Large Memory Setting

No setting changes are needed for Vista x64, however for x86 (32bit), the large memory
boot setting should be specified to allow the application to take advantage of more than
2 GB on machines that have that much memory. This can be conveniently set using an
administrator command line tool (which can be started by right clicking “Command
Prompt” and selecting “Run as administrator” under Program Files>Accessories). In this
command window, enter:
bcdedit /set increaseuserva 3072

Copyright © Three Palm Software 2008-2011 Page 4

 Three Palm Software – Document # 86 (4.0)

The bcdedit command can be found windows\system32.

1.2.3. Message Queuing

If it has not added, the message queuing component needs to be added before installing
CadOne. This can be done using Windows Component Wizard from Add/Remove
Programs. Only the “Common” or “Core functionality” needs to be selected:

Or on Vista or Windows 7, using “Turn Windows features on or off” menu with “Programs
and Features”:

Copyright © Three Palm Software 2008-2011 Page 5

 Three Palm Software – Document # 86 (4.0)

1.3. User login

No user login is required. The service personnel should use a login that has
administrator rights on the local machine.

1.3.1. Windows Security

The system’s Firewall must be marked ON. Any DICOM ports (e.g. the default listen port
is 5004) that are used should be added to the firewall’s Exceptions list.

2. Software Installation
The system is installed using an automated install package. The install is invoked by
executing the accompanying “setup.exe”, which checks if any pre-requisites such as the
VC run-time dlls are missing, and first installs those. Once the pre-requisites are
installed, the system install itself (TPS.CadOne.msi) is automatically started. The install
of the pre-requisites may require a re-boot of the machine, depending on the state of the
operating system patches. In all cases the install should be started by running setup.exe.
Once the CadOne install starts, you will see the following screen:

Click the Next button to go to the End-User License Agreement:

Copyright © Three Palm Software 2008-2011 Page 6

 Three Palm Software – Document # 86 (4.0)

Check “I accept the terms in the License Agreement” and click the Next button:

Select one of options - you should normally select “Typical”,

Copyright © Three Palm Software 2008-2011 Page 7

 Three Palm Software – Document # 86 (4.0)

Click the Install button to begin the installation. Once the installation finishes, you will
see this window:

Copyright © Three Palm Software 2008-2011 Page 8

 Three Palm Software – Document # 86 (4.0)

Then click the Finish button to complete the installation. On Windows XP, you can check
the “Run Configure tool after finish” checkbox to start the CadOne service configure tool
Configure CadOne to change the site setting (see the following sections). Please note,
on Vista or Windows 7, you should follow the next section to start the Configure CadOne
tool (as any configuration updates require administrator privileges).

3. Connectivity Configuration
The system is typically networked with PACS or FFDM device in order to receive images
for CAD to process. In the case where the system is configured to support a legacy push
model, the images likely are sent directly from an FFDM device. The default setups on
completion of the install are two DICOM interface instances: Input_1 (of class Store) and
Output_1 (of class SrOutput). These settings can be viewed and edited using the tool
called “Configure CadOne”, which can be found on the Start menu, then All Programs ->
Three Palm Software -> CadOne -> Configure CadOne, and select the tab “DCM
interfaces”. An example screen looks as following:

3.1. Store Configuration

In order to setup an FFDM (or PACS) to push images to CadOne, the following
parameters from the configuration of the “Input_1” instance need to be recorded after the
installation, and supplied to the person configuring DICOM on the FFDM device:

Copyright © Three Palm Software 2008-2011 Page 9

 Three Palm Software – Document # 86 (4.0)

CadOne settings Values

Host name or IP address

AE title of the “Store” instance

Port used by the “Store” instance

Accepted (remote) source AE titles of

the “Store” instance (if not “*”)

Note that the port used by the Store instance needs to be opened in the Firewall. For
example, if the Windows Firewall is being used, the port should be added to the list on
the Exceptions tab.
The property “CaseEndChange” has value of: “Series”, “Study”, or “ignore”. Check with
FFDM device conformance statement to fill in an appropriate value.

3.2. SrOutput Configuration

The properties for CAD SR output can be configured on the same tab by selecting the
interface instance name Output_1. The typical DICOM parameters need to filled in:

CadOne settings Values

AE title of the "SrOutput" instance

Destination Host

Destination Port

Destination AE

Copyright © Three Palm Software 2008-2011 Page 10

 Three Palm Software – Document # 86 (4.0)

Then fill in the appropriate entries in the table on right side.

3.3. Queue Setup

There are two private message queues used in CadOne: input queue toCADS and
output queue toDCMS. On the Queues tab of the configuration tool, the queue host
names can be entered. If the queue is on local host, click the “Check Queue” buttons for
each queue to check the queues are exist or created successfully:

Copyright © Three Palm Software 2008-2011 Page 11

 Three Palm Software – Document # 86 (4.0)

3.4. Procedure Log

The procedure log is a local database for case being processed. The procedure log can
be configured on the tab “Procedure log”:

Copyright © Three Palm Software 2008-2011 Page 12

 Three Palm Software – Document # 86 (4.0)

3.5. Computer Resources

The CAD server can run a number of parallel jobs in order to take advantage of
computer resources (such as multi-core). The default of 2 jobs works with a typical
computer configuration. However when the CAD server runs on the same computer as
other application, such as, WorkstationOne or another PACS viewer, the maximum
parallel job should be changed to 1. The process priority should be set to “BelowNormal”
in order to avoid competing for CPU resources with other applications.

The memory use can be adjusted on the tab “Recovery”. The default settings on that tab
usually work with most FFDM images.

Copyright © Three Palm Software 2008-2011 Page 13

 Three Palm Software – Document # 86 (4.0)

3.6. Change Configuration

Once changes to the configuration are complete, click the button “Restart”, then the
changes are automatically saved and the new configuration parameters are loaded into
the CAD server and DCM server. You will see that the servers have started when the
messages display “OK”. Then quit the configuration tool.

4. License Install
Skip to the section 5 if this is a software upgrade.
There are two types of license: Professional and Subscription Edition.
After completing the installation, the license can be installed using a serial number
issued by Three Palm Software. Start the Configure CadOne tool (described in previous
section), you will see the following screen:

Copyright © Three Palm Software 2008-2011 Page 14

 Three Palm Software – Document # 86 (4.0)

Click the Register button and provide the information as shown in the following screen:

Once a correct serial number is entered, click the register button. With a subscription
edition, now you can get the configuration UI.

Copyright © Three Palm Software 2008-2011 Page 15

 Three Palm Software – Document # 86 (4.0)

If the license is the professional edition, at this point the system generates a machine
code that is displayed. The code can be copied and needs to be sent to Three Palm
Software in order to generate the corresponding “Activation Code” that is entered into
the same license dialog:

5. Acceptance Test
Once the license is installed, the configure tool UI is started. Click the Status button to
check if both CAD (algorithm) server and DICOM server in the status of “Running”.

Copyright © Three Palm Software 2008-2011 Page 16

 Three Palm Software – Document # 86 (4.0)

A FFDM study can now be pushed to the configured CadOne (make sure the correct
DICOM parameters are used, for example, the default AE is DcmStore and port is 5004),
and waiting for a minute or two (by check if CPU starts busy and returns to idle) until the
CAD process finishes. You can open the trace file trace_algs.svlog (see next section) to
check if the case is processed; then open a mammo viewer that supports CAD SR to
check the CAD results.

6. System Logs
The log for CAD server is located in the directory called temp under the installation
folder, typically it is at C:\Program Files\TPS\CadOne\temp. The log file name is
trace_algs.svclog. The log for DCM server is located in the same directory and the log
file name is trace_dcms.svclog. It also can be opened on the Configure CadOne tool
using the button "View trace file" in the group box "CAD server tracing" or "DCM server
tracing":

The file is easier to view using the “Microsoft Service Trace Viewer”
(SvcTraceViewer.exe) that is part of the Microsoft SDKs (for example, at C:\Program
Files\Microsoft SDKs\Windows\v6.0A\bin).
An example of screen of the viewer is shown as following:

Copyright © Three Palm Software 2008-2011 Page 17

 Three Palm Software – Document # 86 (4.0)

Copyright © Three Palm Software 2008-2011 Page 18