VPMC-08370E ViTALConnect 4.1.5 Administration Guide PDF

4.1.
Server Administration Guide
VPMC-08370E
© Vital Images, Inc. July 15, 2008
Protected by U.S. Patents 6,219,059; 6,662,918; 7,039,723; Other Patents Pending in the U.S. and other countries.
VPMC-08370E ViTALConnect version 4.1.5 Server Administration Instructions (06/2008)
No part of this work may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic
or mechanical, including photocopying and recording, or by any information storage or retrieval system without permission
in writing from Vital Images.
Trademarks
ViTALConnect is a trademark of Vital Images, Inc.
Microsoft, Microsoft Windows, and Microsoft Word are registered trademarks of Microsoft Corporation.
Restricted Rights Legend

If this software or documentation is delivered to the Department of Defense (DOD) of the U.S. Government, it is delivered
with Restricted Rights as follows:
Use, duplication or disclosure of the software by the U.S. Government is subject to restrictions as set forth in subparagraph
(c)(l)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013.
If this software or documentation is delivered to any unit or agency of the U.S. Government other than DOD, it is delivered
with Restricted Rights and use. Duplication or disclosure by the U.S. Government is subject to the restrictions as set forth in
FAR 52.227-19 (c)(2). If the software or documentation is delivered to NASA, it is delivered with Restricted Rights subject to
the restrictions set forth in 18-52.227-86(d) of the NASA FAR Supplement.
Limits of Liability and Disclaimer of Warranty

VITAL IMAGES SHALL HAVE NO LIABILITY OF ANY KIND FOR ANY DIRECT, INCIDENTAL OR CONSEQUENTIAL DAMAGES BASED
ON ANY DEFECT, FAILURE OR MALFUNCTION OF THE SOFTWARE,OR USE OF ANY VITAL IMAGES DOCUMENTATION, WHETHER
THE CLAIM IS BASED UPON WARRANTY, CONTRACT, TORT OR OTHERWISE. VITAL IMAGES MAKES NO WARRANTY, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE
WHETHER ARISING FROM STATUTE, COMMON LAW, CUSTOM OR OTHERWISE.
Notice of Confidentiality
This software and the information in this software including, but not limited to, the ideas, concepts and know-how are
proprietary, confidential and trade secret to Vital Images, and the information contained therein shall be maintained as
proprietary, confidential and trade secret to Vital Images and shall not be copied or reproduced in any form whatsoever. This
software and any information contained therein shall not be disclosed to anyone other than authorized representatives of
the user's employer who is contractually obligated not to disclose same, without the express written consent of Vital Images.
The user of this software and any information contained therein shall not attempt to discern Vital Images' confidential and
trade secret information and shall not reverse compile, disassemble, or otherwise reverse engineer this software or any
information contained therein.
Software License Notice

This software is a licensed product of and distributed by Vital Images, and may only be used according to the terms of that
license on the system identified in the License Agreement. In the event of any conflict between these terms and the terms of
any written agreement or agreement assented to through electronic means with Vital Images, the terms of such written or
assented agreement shall control.
MediMark® Europe
11 rue Emile ZOLA, BP 2332, 38033
GRENOBLE CEDEX 2, France
Tel: +33 476 86 43 22
Fax:+33 476 17 19 82
email: medimark@easynet.fr
MediMark® Europe is an authorized representative in the European Community and acts on behalf of Vital Images, Inc. in
the communication of safety-related incidents and regulatory matters with Competent Authorities in the European
Community. Distributors are still the first line of communication with their customers regarding service and complaints.
VPMC-08370E
ViTALConnect version 4.1.5 Server Administration Instructions
About This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Purpose and Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
How This Guide is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Configuring the System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Accessing the Server Management Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Contact Us. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
ViTALConnect Image Server Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Accessing the ViTALConnect Image Server Configuration Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Main Server Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Basic Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Configuring ViTALConnect 4.1.5 SSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
SSL Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Pre-Installation Considerations: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Secure Socket Layer Configuration and Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Obtain an SSL Certificate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Enable SSL on the ViTALConnect Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Enable SSL on Internet Information Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Export a Certificate/Key Pair from an IIS with SSL Certificate Installed . . . . . . . . . . . . . . . . . . . . . 11
Install SSL Certificate in an Image Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
SMTP Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Configuring Email Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
PACS Broker Report Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Configuring the PACS Broker Report Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Licensing Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Configuring the ViTALConnect License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Server Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Configuring the Server Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Client FTP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
VPMC-08370E 1
Configuring the Client FTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Server FTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Configuring the Server FTP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Server Load Balance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Router Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Configuring a Load Balancing Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
LDAP Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Configuring the Microsoft Active Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Configuring LDAP Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
ViTALConnect System Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Accessing the System Management Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
User Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Accessing the User Manager Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Adding User Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Editing User Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Deleting User Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Logs Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Monitor Logs Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Study Statistics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Vital ECF Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Accessing the ViTAL ECF Management Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
DICOM Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Installing PACS Server or Modality Using the Web Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Installing PACS Server or Modality Using VICommunicator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Adding DICOM Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Configuring PACS in ViTALConnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Configuring Other VICommunicator DICOM Server Edit Options . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Configuring Printers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
DICOM Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Configuring DICOM Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Compress Ratio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
2 VPMC-08370E
Setting the Compress Ratio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Adding a Compress Ratio for an image type not listed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
DICOM Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Performing a Local DICOM Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Exporting a selected study, series, or image to a remote DICOM server . . . . . . . . . . . . . . . . . . . . 52
Deleting a study, series, or image from the local server database . . . . . . . . . . . . . . . . . . . . . . . . . 52
Scheduling a study, series, or image for automatic deletion the next time auto-delete runs . . . . 52
Remote DICOM Query. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Performing a Remote DICOM Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
DICOM Forward Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Setting up DICOM Forwarding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Editing DICOM Forward Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
DICOM Auto Deleting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Configuring DICOM Auto Deleting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
DICOM Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Displaying a list of configured DICOM devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Institution Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Adding a New Institution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Deleting an Institution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Report Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Reviewing Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Uploading a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
DICOM Error Report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Displaying the DICOM Error Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Load Balance Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Accessing the Load Balance Management Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Server Load Balance Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Accessing the Server Load Balance Status Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Third Party Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
XML-Based URL Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Building the Request XML String. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
VPMC-08370E 3
Sample URL Invocations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Encrypting the XML with Secure URL Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Patient Reconciliation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Debugging URL Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Interfaces to Open Series for Third Party Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
1. OpenSeriesByAccessionNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
2. OpenSeriesByStudyUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
3. FetchSeriesByStudyUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
4. FetchSeriesByAccessionNumber. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
5. Open Snapshot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Login and Authentication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
2D Configuration Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Image Compression Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Compression Ratios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Setting the compression ratios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Adding a Compress Ratio for an image type not listed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Modifying a Compress Ratio Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Removing a Compress Ratio Definition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Prefetching - Administrator Level. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Enabling Prefetching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Settings for prefetch entire study . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Settings for interactive prefetch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Dialing into ViTALConnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
2D At Home . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
2D Over a Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Background Image Streaming - User Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Accessing the User Preferences Background Image Streaming . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Settings for prefetch entire study . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Settings for interactive prefetch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Appendix A: Upgrading ViTALConnect Hardware Configuration Settings . . 89

Switching patient data from a non-shared drive to a shared drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
4 VPMC-08370E
Appendix B: ViTALConnect 4.0 URL Integration - To Be Deprecated in a Future

Release 91
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Interfaces to Open Series for URL Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
1. OpenSeriesByAccessionNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
2. OpenSeriesByStudyUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
3. FetchSeriesByAccessionNumber. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
4. FetchSeriesByStudyUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
5. Open Snapshot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Notes for Using 3rd Party Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Appendix C: Using 3D Presets and Anatomy Protocols . . . . . . . . . . . . . . . . 97

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Anatomy Protocol Assignment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Picking an Anatomy Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
VPMC-08370E 5
6 VPMC-08370E
About This Document
Purpose and Scope
Purpose
This document comprises the administration guide for ViTALConnect 4.1, the latest release of the Vital Images’
medical diagnositc tool that allows physicians to use PCs or notebook computers to access 2D, 3D and 4D
advanced visualization using a Microsoft Web-enabled browser. The goal of the software is to enable users to
measure, rotate, analyze and segment images. Its conferencing feature allows physicians at multiple locations
to consult while simultaneously interacting with a study.
Scope
The scope of the document is to provide a detailed description of the configuration processes related to
ViTALConnect 4.1.5. Refer to the ViTALConnect 4.1.1 Installation Guide for a detailed description of the
ViTALConnect 4.1.1 installation process.
Intended Audience
This document is intended for experienced administrators who wish to configure a ViTALConnect 4.1.5 server on
Windows, or one of its variants. The authors assume that the audience knows how to perform standard
administrative tasks and are also familiar with the ViTALConnect system architecture, components, and
concepts. As such, this document covers ViTALConnect 4.1.5 configuration on Windows operating systems only.
How This Guide is Organized

This guide is organized into sections grouped according to the intended use by the user:
• ViTALConnect Image Server Configuration (Chapter 2)

• ViTALConnect Connect System Management (Chapter 3)
• ViTAL ECF Management (Chapter 4)
• Load Balance Management (Chapter 5)
• Third Party Integration (Chapter 6)
• 2D Configuration Settings (Chapter 7)
• Upgrading ViTALConnect Hardware Configuration Settings (Appendix A)
• ViTALConnect 4.0 URL Integration - To Be Deprecated in a Future Release (Appendix B)
• Using 3D Presets and Anatomy Protocols (Appendix C)
Purpose and Scope VPMC-08370E 1

Before You Begin

CAUTION: For general ViTALConnect Safety and Regulatory Considerations, refer to the Safety and
Regulatory Considerations section of the ViTALConnect User Guide.
NOTE: The ViTALConnect server must have been previously installed before you can use this guide.
Before you begin configuring the ViTALConnect system, you need to know the following information and have
the following materials:
• System Administration user name and password

• Knowledge of the institution’s server and network environment
• Remote DICOM server information
• SMTP server configuration
• Certificate file and Key file (for Secure Sockets Layer)
• Email addresses for monitoring and support destinations
• ViTALConnect License key (supplied by Vital Images)
• Load Balanced system topography
Configuring the System

Once you have installed the server software, you must perform additional steps to configure the system for your
specific network, DICOM devices, IP addresses, ports, user accounts and miscellaneous other components.
ViTALConnect system configuration consists of the following components:
• Configuring ECF (DICOM server)

• Configuring the Image Server
• Configuring user accounts
• Configuring user logging and reporting
• Configuring load balancing
NOTE: Every time you change the DICOM server configuration, you must open the Services Control Panel and
restart the “VICommunicator” or “VIServices” Service or reboot the server for the changes to take effect.
2 VPMC-08370E Before You Begin

Accessing the Server Management Pages

You access the administration pages through the ViTALConnect Server Management System menu.
NOTE: Start from this menu to access all sub-menus described in this manual.
To access the ViTALConnect Server Management System menu:

1. In the Address line of Internet Explorer, type “/main.aspx” after the URL that accesses the ViTALConnect server (for
example: “http://172.29.8.200/main.aspx”) or from the Start menu, select Programs | ViTALConnect | ViTALConnect
Server.
2. Click GO.
The ViTALConnect Server Management System login screen displays.
3. Log in, using the following login and password combination:
TABLE 1. Login and Password Description
Field Enter
Login hinnovation
Password hinnØvatiØn
Password format: hinn0(zero)vati0(zero)n
4. Click Login.
The ViTALConnect Server Management Menu displays.
• The Server Management System menu provides access to the following sub-menus:
Accessing the Server Management Pages VPMC-08370E 3

FIGURE 1. The ViTALConnect Server Management Menu System Diagram
ViTALConnect Server Management System
ViTALConnect Image Server Configuration

System Management
ECF Management
Load Balance Management
ViTALConnect Image System Management ECF Management Load Balance

Server Configuration Management
See chapter 2. See chapter 3. See chapter 4. See chapter 5.
Main Server Page, p. 6 User Manager, p. 27 DICOM Management, p. 36 Server Load Balance
SMTP Server, p. 14 Logs Query, p. 32 DICOM Options, p. 49 Status, p. 60
PACS Broker Report Monitor Logs Query, p. Compress Ratio, p. 50
Service, p. 15 33 DICOM Query, p. 51
Licensing Manager, p. 17 Study Statistics, p. 33 Remote DICOM Query, p. 52
Server Monitor, p. 18 DICOM Forward Management,
Client FTP, p. 19 p. 53
Server FTP, p. 19 DICOM Auto Deleting, p. 55
Server Load Balance, p. 21 DICOM Devices, p. 55
LDAP Integration, p. 23 Institution Management, p. 56
Report Management, p. 57
DICOM Error Report, p. 58
Contact Us
If you have general, non-technical support questions, contact us through our Web site:
www.vitalimages.com.
For customer technical support, contact us using one of the following methods:
• Send an email to support@vitalimages.com.

• Click Enter Support at http://support.vitalimages.com/contact.asp.
• In the U.S., call the Customer Support line at 1.800.208.3005.
• Outside the U.S., contact your Vital Images distributor. For a list of international distributors, go to
http://support.vitalimages.com/contact.asp.
4 VPMC-08370E Contact Us
ViTALConnect Image Server

Configuration
Introduction
Once you have installed both the DICOM server and the image server, and configured the DICOM server, you
must also configure the image server. Configuration includes a few additional steps for the following
components:
• Configuring ViTALConnect 4.1.5 SSL

• SMTP Server
• PACS Broker Report Service
• Licensing Manager
• PACS Broker Server Monitor
• Client FTP
• Server FTP
• Server Load Balance
• LDAP Integration
Accessing the ViTALConnect Image Server Configuration Page
To access the ViTALConnect Image Server Configuration page
Access the ViTALConnect Server Management System menu:

1. In the Address line of Internet Explorer, type “/main.aspx” after the URL that accesses the desired
ViTALConnect client (for example: “http://172.29.8.200/main.aspx”) or from the Start menu, select
Programs | ViTALConnect | ViTALConnectServer.
2. Click GO.
The ViTALConnect Server Management System login page displays.
3. Log in, using the following login and password combination:
TABLE 1. Login and Password Description
Field Enter
Login hinnovation
Password hinnØvatiØn
Password format: hinn0(zero)vati0(zero)n
4. Click Login.
Introduction VPMC-08370E 5
The ViTALConnect Server Management Menu displays.
FIGURE 1. ViTALConnect Server Management System Menu
NOTE: Load Balance Management will only be listed for load balancing installs.
5. Select ViTALConnect Image Server Configuration.
The ViTALConnect Server Configuration - Main Server Page displays.
FIGURE 2. ViTALConnect Server Configuration - Main Server Page
6 VPMC-08370E Accessing the ViTALConnect Image Server Configura-

Main Server Page
Basic Settings
To configure basic Image Server settings (Main Page):

• Complete the entries as follows:
TABLE 2. Basic Image Server Settings
Setting Description
ViTALConnect Server Verify the default 8888.

Port
NOTE: In a load balanced system, each port must be different. Vital Images
recommends numbering the ports sequentially, starting with 8888, for the Main
server, then 8889, 8890, etc. for the Load Balance nodes.
Maximum of Studies Leave blank, or enter a maximum number of studies a user can open during one
user can open session. Fewer studies open leaves more system memory available, reducing the
possibility of slow performance due to low memory resources.
Referring Physician • Checked: Referring physicians can view only images associated with their own
Match patients.
• Clear: referring physicians can view all images for all patients.
Enable mark study • Checked: Workflow features such as mark read are enabled, and the resulting
as read study status (Scanned, Dictated, Approved) will be listed on the Study Directory.
• Clear: the Mark Read menu options are not visible, nor is the Status column in
the Study Directory.
NOTE: See ViTALConnect online Help for more information about these features.
Server process auto The amount of time the server can remain idle before an automatic process restarts
restart time interval it. Accept the default interval of 1 Days, 0 Hours, and 0 Minutes, or enter a different
time interval.
Built-in Account for This provides an alternate method of authenticating URL integration calls. This User
3rd Part Interface Name and Password is a “built-in” account that can be used in lieu of LDAP or local
user account authentication while submitting a URL call.
Configuring ViTALConnect 4.1.5 SSL
SSL Overview
Secure Sockets Layer (SSL) allows the server to provide secure data transmission over a network, necessary for
patient confidentiality and HIPAA compliance over the Internet.
Main Server Page VPMC-08370E 7

Responsibility for SSL Management
The customer has responsibility for SSL management as part of their network security management. Should
they not have in-house expertise, the customer should identify and hire a security consultant. Vital Images has
a policy not to assume responsibility for the customer's network security.
CAUTION: If you do not use SSL in Internet Information Services (IIS) and ViTALConnect this system should
not be exposed to the Internet. It should only be run on the Local Area Network (LAN) or via a Virtual Private
Network (VPN) connection.
Pre-Installation Considerations:
Prior to going live with SSL, the customer must consider the following:
WAN Network Speed
Vital Images recommends a minimum connection speed of 2 Mbps (T1) from the client browser to the Internet.
The nominal and optimal server connection speeds are 6 Mbps and 45 Mbps, respectively.
External Access
The customer must modify their external firewall to open access to WAN clients on port 443 (for HTTPS/Secure
Sockets Layer). The firewall should be configured to route traffic on port 443 and port 8888 to the ViTALConnect
server.
Valid SSL Certificate
The customer must obtain a valid SSL certificate using one of two methods: (1) elect to have the SSL certificate
signed by a trusted third party Certificate Authority (CA) such as Verisign, Thawte, or Geotrust; or (2) choose to
sign their own SSL certificate with an internal CA.
NOTE: The customer site is responsible for tracking their own SSL certificates.
NOTE: The customer site should not store or keep their SSL certificates on the ViTALConnect. The files contents
are uploaded into the ViTALConnect database.
Power Supply for ViTALConnect server
Vital Images recommends that the ViTALConnect server be connected to an uninterruptible power supply (UPS)
or other constant power source. If power to the ViTALConnect server were to fail, all WAN Viewer services would
stop.
Portal Access
To ensure smooth SSL operation, customers are encouraged to direct users to a portal site that contains a link
to the ViTALConnect server. Users accessing the ViTALConnect server directly using HTTP will encounter different
behavior than users who access the server using HTTPS. Firewalls or routers can also be configured to redirect
HTTP requests (port 80) to the ViTALConnect server to HTTPS requests (port 443).
8 VPMC-08370E Configuring ViTALConnect 4.1.5 SSL

Secure Socket Layer Configuration and Policies
The Benefits of SSL
ViTALConnect’s HTTP transport, combined with SSL and Firewalls, provides the following benefits:
• Allows client to securely access ViTALConnect from the public network.

• Does not require the administration overhead of the VPN.
• Provides additional protection against worms that can invade from VPN-based solutions.
Obtain an SSL Certificate

A valid SSL certificate will need to be obtained. If this is a public facing device intended for use on the Internet
then a certificate from Thawte or Verisign will be the best choice; otherwise, the users will have to install the
certificate in the client browser manually.
1. Choose a Certificate Authority (CA).
Thawte and VeriSign are commonly used vendors of SSL certificates.

2. Generate a Server Key.
The server key is required to generate the Certificate Signing Request that is submitted to the Certificate
Authority. Each server key generated is unique. The key should be backed up to a secure location. If the key
is lost a new certificate will have to be obtained. This key must be kept private.
3. Generate a Certificate Signing Request (CSR).
Generate a Certificate Signing Request (CSR) using the server on which the SSL certificate will be installed.
The contents of the CSR file are needed when applying for the SSL certificate. It is critical that the
information in the CSR exactly matches the information in the Proof of Right. The most common Proof of
Right document is the Articles of Incorporation. As part of the CSR, the server's "Common Name" (CN) must
be entered. The CN is the fully qualified external hostname of the server. This is the hostname that remote
users will use to access the server. For instance, if remote users access the server as:
https://vitalconnect.myhospital.com, the Common Name will be
vitalconnect.myhospital.com
Do not include the https:// at the beginning of the Common Name.

4. Applying for the SSL Certificate.
Follow the instructions on the vendor's website to apply for the SSL certificate. Vital Images recommends
purchasing a 2-year certificate instead of a 1-year certificate, to avoid having to renew on a yearly basis.
Information on certificate renewal is provided by the Certificate Authority. See "SSL Certificate Expiration" in
the Troubleshooting section below for details on the impact certificate expiration has on the user
experience.
5. Installing the SSL Certificate.
Install the SSL certificate on the ViTALConnect server. Perform tests to verify that a user outside the
enterprise network can access the ViTALConnect client.
Configuring ViTALConnect 4.1.5 SSL VPMC-08370E 9

Troubleshooting
SSL Certification Expiration
If a certificate expires (and is not renewed), the user is presented with a warning dialog box indicating that the
certificate has expired. The user will be prompted with the following choices:
• Accept the certificate once

• Accept the certificate always
• Reject the certificate
An expired certificate has almost no impact on the security of SSL. Other than the warning dialog box, the
ViTALConnect application will continue to function normally. To avoid potential user confusion, renew your site's
SSL certificate prior to its expiration date. Details on the renewal process are provided by the Certificate
Authority that issued your certificate.
Hostname Mismatch
If there is a mismatch between the hostname ViTALConnect is connecting to and the hostname on the
certificate, a warning dialog box will appear, prompting the user to indicate whether to proceed or not.
For example, if a certificate has the hostname vitalconnect.myhospital.com and the configured host is
10.0.0.29, this error will occur, even if the "vitalconnect" host resolves to 10.0.0.29. When prompted to proceed
in such a case, the user must select [Yes]. If the user selects [No], the application will not launch.
Enable SSL on the ViTALConnect Server

To enable SSL, access the Administration pages:

Enable SSL on Internet Information Server

You must enable SSL on IIS on the Primary server to fully activate SSL on ViTALConnect.
NOTE: You cannot use both IIS and ViTALConnect encryption on a server running Windows XP. You can only use
ViTALConnect encryption.
To activate SSL on IIS:

1. From the Start menu, select Settings | Control Panel, double-click Administrative Tools, and double-click
Computer Management.
2. Select Services & Applications | Internet Info... | Web Sites | Default Web Site.
3. Right click on Default Web Site and select Properties.
The Default Web Site Properties dialog box displays.
4. From the Directory Security tab, click Server Certificate.
The SSL wizard displays.
5. Select either Create a New certificate (if you don’t have a certificate), or Assign Existing (if you have a
certificate)
• To create a new certificate, refer to Microsoft article #228821, “Generating a Certificate Request File
Using the Certificate Wizard in IIS 5.0,” then go to step 6 below.
• To create a new certificate, refer to “Securing Internet Information Services 6.0,” then go to step 6
below.
• To assign an existing certificate, go to step 6 below.
6. Navigate to the issued certificate.
7. Click Finish to complete the wizard.
• To access the secure server, always use “HTTPS” in the ViTALConnect access URL.
• For security reasons, port 80 should be blocked on the firewall to prevent access to the unsecured
server.
Export a Certificate/Key Pair from an IIS with SSL Certificate Installed
To Add Certificate Snap-in into Microsoft Management Console

1. From the Start menu, select Run and type mmc.
The Console 1 page displays.
2. Select File | Add/Remove Snap-in...
The Add/Remove Snap-in page displays.
3. Select Certificates and click Add.
The Certificates snap-in page displays.
4. Select Computer account and click Next.
The Select Computer page displays.
5. Select Local computer: (the computer this console is running on) and click Finish.
6. Click Close.

To Export the SSL certificate for key extraction

1. From the Console 1 page, select Certificates (Local Computer) and select the Personal folder.
2. In the Object Type section, double-click the Certificates folder.
The Web server certificate displays and is denoted by the “cn” (common name) found in the Subject field of
the certificate.
3. Right-click on the server certificate, select All Tasks, and click Export.
4. Export the server certificate to the desired directory (e.g., c:\).
NOTE: Use the .PFX format when exporting the server certificate and include the private key.
To Extract the Private Key File from the .PFX File
NOTE: Prior to running the commands listed below, make sure that \Program Files\HInnovation\Image Server is
defined in %PATH%.
• In the “Command Prompt” window, enter openssl pkcs12 -in <sourcefile> -clcerts -nokeys -out <destfile>.
EXAMPLE: Openssl pkcs12 -in c:\VitalImages.pfx -clcerts -nokeys - out VitalImagesPublic.pem
Install SSL Certificate in an Image Server
1. Click Browse next to the Certificate File (not specified): field.

2. Browse to and seelct the extracted public key (e.g. c:\VitalImagesPublic.pem).
3. Click Browse next to the Key File (not specified): field.
4. Browse to and select the extracted private key (e.g. c:\VitalImagesPrivate.pem).

5. Complete the SSL fields on this page. Refer to the steps below for detailed information on obtaining and
activating SSL encryption certificates and keys.
TABLE 3. Basic Image Server Settings -- SSL
Setting Description
Use SSL • Checked: Uses HTTPS (secure server) protocol and SSL (Secure Socket Layer).
and HTTPS
NOTE: A certificate file and key file are required to enter the below fields.
• Clear: Does not use HTTPS protocol and SSL.
Https port Port the ViTALConnect server uses to communicate via HTTPS. Verify that the default entry 443
is present. This is the default port that IIS uses; to change this port assignment, consult the IIS
documentation and enter the new port number.
Encrypt • Checked: Encrypts only the DICOM header (contains all patient information). This option
sensitive encrypts only the patient DICOM data, not the image, but offers the highest performance.
patient
info only • Clear: Encrypts both DICOM header and image data. This is the most secure option, but
uses the most server resources.
Certificate Navigate to the location you saved the certificate file and select the file (will have a default
File extension of *crt).
NOTE: You can generate your own certificate and key using an open source method (see
www.openssl.org), or purchase one from an authority such as Verisign (www.verisign.com).
Key File Navigate to the key file location.
6. Check the Use SSL and HTTPS box.

7. Enter or verify that 443 is entered in the Https port field.
8. Check or clear the Encrypt sensitive patient info only box (see the table above for details).
9. Browse to the location of the certificate file, and select the file.
10. Browse to the location of the key file, select the file, and click Save.
11. Stop the ViTALConnect server by selecting Start Menu | Programs | ViTALConnect | Stop Server.
12. Restart the ViTALConnect server by selecting Start Menu | Programs | ViTALConnect | Start Server.
13. Proceed to the next section, Enable SSL on Internet Information Server.
NOTE: You must also enable SSL on the Internet Information Server or SSL activation will be incomplete.

SMTP Server
Overview
Simple Mail Transfer Protocol (SMTP) is the standard for email transmissions across the internet.SMTP is a
relatively simple, text-based protocol, where one or more recipients of a message are specified (and in most
cases verified to exist) and then the message text is transferred.
Configuring Email Settings
To configure the SMTP Server:

1. On the left side of the ViTALConnect Server Configuration page, click SMTP Server.
The SMTP Server page displays.
FIGURE 5. SMTP Server page
2. Verify the default information or enter new information in the following fields:
TABLE 4. SMTP Server Settings
Setting Description
SMTP Server Address Local host or IP address of the mail server or mail relay.
Sender Email Address monitor_alert@hinnovation.net (email address of the server that will send
email to the addresses specified below)
Monitor Email Address monitor@hinnovation.net
Onsite Support Email Email address of the local support service, usually a contact at the institution
Address where the ViTALConnect system is installed.
14 VPMC-08370E SMTP Server

TABLE 4. SMTP Server Settings
Setting Description
Feed back Email Address Email address to receive feedback comments that are sent using the
email button at the upper-right-hand corner of the ViTALConnect page.
Login SMTP server with Checked: SMTP server logs into email server as anonymous. Check if mail
anonymous when send server allows anonymous login.
Email Enter the user name and password required to access the server.
Send report notify Email Checked: Sends an email report to the Referring Physician.
for Referring Physician Clear: Does not send an email report to the Referring Physician.
Sender Email address for Email address that displays in the “From” field of email sent to referring
report notify physicians.
Sender info: Information about the email sender.
Send notification Email Checked: Sends email to onsite support (as specified in Onsite Support
to onsite support if Email Address, above) in the event of a server error.
server has error Clear: Does not send email.
3. To send a test email:

a Enter the email address to which you want to send a test email into the Send a testing Email to field.
b Enter the subject in the Subject of Testing Email field.
c Click .
A confirmation message confirms the message has been sent. Confirm that the recipient has received
the test email.
4. Click to save all edits.
NOTE: If this server cannot send out emails, set up an SMTP server that can. Vital Images uses emails from the
in-house Image Server to monitor the product.
PACS Broker Report Service
Overview
The PACS Broker Report Service allows the system to connect to a vendor’s database via IP, and search for
Keywords.
PACS Broker Report Service VPMC-08370E 15

Configuring the PACS Broker Report Service
To configure the PACS broker report service:

1. On the left side of the Welcome to ViTALConnect Server Config page, click PACS Broker Report Service.
The PACS Broker Report Service page displays.
FIGURE 6. PACS Broker Report Service Page
2. Enter the database connection fields:
TABLE 5. PACS Broker Report Service Database Connection Fields
Setting Description
Server IP IP address of the vendor’s server.
User Name Server logon user name.
User Pwd Server logon password.
3. Click Test Connection to test the server connection.

• If the connection failed, review your entires and make any necessary changes. Test again.
4. After a sucessful test, click Save to save the report configuration.
5. Enter the remaining fields to establish database query criteria:
TABLE 6. PACS Broker Report Service Fields
Setting Description
Database Once a connection is established, select from the list of available

databases.
Impressions Keywords Keywords used to search the database records.
Impressions field to display Display either Impressions, Interpretation, or both fields.
Enable Impressions Formatting Checked: Impressions formatting enabled.
16 VPMC-08370E PACS Broker Report Service

Licensing Manager
Configuring the ViTALConnect License
To configure the ViTALConnect license:
Vital Images will configure your ViTALConnect license and give you the license key.
1. On the left side of the Welcome to ViTALConnect Server Config page, click Licensing Manager.
The Licensing Manager page displays. Once you have configured the ViTALConnect license, the page
displays information about the number and types of users that your license allows access.
FIGURE 7. Licensing Manager page
2. Obtain the MAC address (for each node in the load balancing configuration, if applicable): from the Start
menu, select Programs | Accessories | Command Prompt.
A command window opens.
3. In the command window, type ipconfig/all, then press Enter.
4. Find the physical address for the active ethernet adapter.
5. On the Licensing Manager page, enter the physical address into the Mac Address field, using all caps and
omitting the hyphens.
NOTE: For multiple servers, enter the MAC address of each node in the configuration, and separate each with a
dash.
6. Close the command window.
7. In the License Key field, enter the license key supplied by Vital Images.
8. Click to test that the license information is valid.
9. Click to save the license information.
Licensing Manager VPMC-08370E 17

Server Monitor
Overview
Use the server monitor configuration page to set how often the monitor checks the status of the server, and disk
space percentage and size. If the server is down, the monitor will reboot the server.
Configuring the Server Monitor
To configure the Server Monitor:

1. On the left side of the Welcome to ViTALConnect Server Config page, click Server Monitor.
FIGURE 8. Server Monitor page
2. Verify the default information or enter new information into the following fields:
TABLE 7. Server Monitor Settings
Setting Description
Server IP localhost
User Name himonitor
NOTE: Specify a different user name and password combination for access to the server.
When you create the Server Monitor user name and password combination, check the
Password never expires box. If the Server Monitor password expires, the Server Monitor
process will not be able to access the server.
User Pwd himonitor
Time Span 5 Minutes (the frequency with which the monitor checks the server status)
Disk Space Do not change the default values in the Disk Space Percentage (5%) or Disk Space
Percentage (500MB) fields.
Disk Space
Send Server Checked: Send email to the address specified in the Monitor Email Address of the SMTP
Monitor Email Server page when an error condition is encountered.
Clear: Does not send email.
3. Click Save.
18 VPMC-08370E Server Monitor

Client FTP
Overview
FTP or File Transfer Protocol is used to transfer data from one computer to another over the Internet, or through a
network. Specifically, FTP is a commonly used protocol for exchanging files over any network that supports the
TCP/IP protocol (such as the Internet or an intranet).
There are two computers involved in an FTP transfer: a server and a client. The FTP server, running FTP server
software, listens on the network for connection requests from other computers. The client computer, running
FTP client software, initiates a connection to the server. Once connected, the client can do a number of file
manipulation operations such as uploading files to the server, download files from the server, rename or delete
files on the server.
Configuring the Client FTP
To configure the Client FTP:

You use the client FTP configuration page to set up the server IP address and port.
1. On the left side of the Welcome to ViTALConnect Server Config page, click Client FTP.
The Client FTP page displays.
FIGURE 9. Client FTP page
2. In the Server IP field, enter the IP address of the server.
NOTE: You can retrieve the IP address using the same procedure you used to retrieve the physical address,
under Configuring the License.
3. In the Server Port field, verify 21 is listed.
4. Click Save.
Server FTP
NOTE: This is an option that you can choose to disable. It is not mandatory.
Overview
FTP or File Transfer Protocol is used to transfer data from one computer to another over the Internet, or through a
network. Specifically, FTP is a commonly used protocol for exchanging files over any network that supports the
TCP/IP protocol (such as the Internet or an intranet).
Client FTP VPMC-08370E 19

There are two computers involved in an FTP transfer: a server and a client. The FTP server, running FTP server
software, listens on the network for connection requests from other computers. The client computer, running
FTP client software, initiates a connection to the server. Once connected, the client can do a number of file
manipulation operations such as uploading files to the server, download files from the server, rename or delete
files on the server.
Configuring the Server FTP
To configure the Server FTP:

You use the server FTP configuration page to set up the server IP address, port, user name and password
combination, local path and server path.
1. On the left side of the Welcome to ViTALConnect Server Config page, click Server FTP.
The Server FTP page displays.
FIGURE 10. Server FTP page
2. Enter information in the following fields:
TABLE 8. Server FTP
Setting Description
Server IP Server IP address.
Server Port 21
User Name Server login user name.
User Password Server login password.
Local Path Local path on which to save data.
Server Path Server path on which to save data.
3. Click Save.
20 VPMC-08370E Server FTP

Server Load Balance
Introduction
NOTE: You must have an installed load balancing system with multiple nodes to use this option. If you have a
single-server system and check this option, your ViTALConnect system will not function properly.
A load balanced system consists of one Primary server and one or more Rendering Nodes. You will need to
configure each node in the system slightly differently. The settings you enter here depend on the type of node
you are configuring (Primary or Rendering Node), the topography of the system, and the setup as specified on
page 11 of the ViTALConnect 4.1. Installation Guide.
Router Configuration
Before configuring the load balanced nodes, you must first configure your router and internal network as
specified on page 11 of the ViTALConnect 4.1. Installation Guide. The settings you enter here are determined by
the router configuration.
Configuring a Load Balancing Server
To configure load balancing

1. On the left side of the Welcome to ViTALConnect Server Config page, click Server Load Balance.
The Server Load Balance page displays.
FIGURE 11. Server Load Balance page
Server Load Balance VPMC-08370E 21

2. Enter information in the following fields:
TABLE 9. Server Load Balance Settings
Setting Description
Load Balancing System Checked: Enables load balancing.
NOTE: You must have a configured load balancing system with multiple nodes installed
to use this option. If you have a single-server system and check this option, your
ViTALConnect system will not function properly.
Registration Port The port through which the Primary server communicates with the load balancing nodes.
Enter the Primary server’s port.
Registration Update Time The number of seconds the system waits before it attempts communication with the
(seconds) Primary server. Recommended: 59 seconds.
Router External IP Address IP address the router uses to communicate with the institution’s network.
Router Internal IP Address IP address the router uses to communicate exclusively with the load balanced “internal”
or private network. Recommended 10.10.10.1
Consider main server for load Selected: The load balanced system uses the main (Primary) server to share processing
balancing load functions, 2D MPR as well as 3D.
Clear: The load balanced system does not share processing functions with the Primary
server. Rendering Nodes perform 3D processing; the main server performs database,
communication, and 2D processing.
Static router configuration Selected: Primary server uses a static IP address, which does not enable fault tolerance.
All Dynamic router configuration settings below this point are disabled.
Clear: Dynamic router configuration is selected (see below).
Main Server IP Static IP address of the main (Primary) server.
Dynamic router configuration Selected: Enables fault tolerance. Enter Dynamic router configuration settings below.
Router login name Router login name (see page 11 of the ViTALConnect 4.1. Installation Guide).
Router login password Router login password (see page 11 of the ViTALConnect 4.1. Installation Guide).
Enable password required Checked: Router requires an enable password.

Clear: Router does not require an enable password.
Enable password Enter enable password here, if above field is checked.
Auto register ports with Server automatically communicates port information with the load balance router.
router
Enable Server Fault Tolerance Checked: Fault tolerance is enabled.
Number of acceptable faults The number of times the node can report a fault condition before fault tolerance removes
it from service. Example: an entry of 2 causes fault tolerance to remove the node from
service on the report of fault number 3.
3. Click Save to accept your entries.
22 VPMC-08370E Server Load Balance

LDAP Integration
Overview
This chapter consists of two separate pieces:
• Configuring the Microsoft Active Directory (AD)

• Configuring LDAP Integration
CAUTION: Currently, ViTALConnect can only support the following characters in the First Name and Last
Name of legal name entries:
• digits (0-9)
• letters (a-z and A-Z)
• slash (/)
• dot (.)
• underscore (_)
• colon (:)
Configuring the Microsoft Active Directory
To configure the Microsoft Active Directory

1. The Active Directory (AD) Administrator must create the following two groups:
• VITAL CLINICAL USERS
• VITAL DIAGNOSTIC USERS
NOTE: The AD Administrator must format both group names exactly as presented above.
2. The AD Administrator must create a system account that has access for LDAP authentication. The account is
used by the ViTALConnect server to authenticate Active Directory users.
3. The AD Administrator adds the users to the proper group(s).
LDAP Integration VPMC-08370E 23

Configuring LDAP Integration
To configure LDAP integration:

1. On the left side of the Welcome to ViTALConnect Server Config page, click LDAP Integration.
The LDAP Integration page displays.
FIGURE 12. LDAP Integration page
2. Enable LDAP and Force User Logon, if desired.
TABLE 10. LDAP Configuration Settings
Setting Description
Enable LDAP Integration Checked: Enables LDAP integration.

Clear: Disables LDAP integration.
Force User Logon Requires user to logon, even if present in the Directory.
3. Click Save.
4. Click New to add one or more domains to the directory service.
The LDAP Integration Configuration page displays:
FIGURE 13. LDAP Integration Configuration page
24 VPMC-08370E LDAP Integration

5. Enter the configuration settings as described below:
TABLE 11. LDAP Configuration Settings
Setting Description
Domain Fully qualified domain of the institution’s LDAP service.
Netbios Domain Netbios domain - not fully qualified.
LDAP Port Port of the LDAP service. This is port 389.
User Name Name of the LDAP Administrator.
User Password Password of the LDAP Administrator.
6. Click Test to verify that the settings are valid.

7. Click Save to save the domain settings.
The settings are added to the LDAP Domain List on the LDAP Integration page.
8. Add another Domain, if desired.
LDAP Integration VPMC-08370E 25

26 VPMC-08370E LDAP Integration

ViTALConnect System Management

Introduction
Once you have configured both ViTALConnect ECF and image server, you can also manage user accounts,
configure reporting and logging functions, and obtain various user reports. This Chapter describes the following
functions, available from the System Management menu:
• User Manager
• Logs Query
• Monitor Logs Query
• Study Statistics
CAUTION: Be sure to change the Administrator password of the ViTALConnect server before adding any more
users. Follow Microsoft standards for complex passwords.
Accessing the System Management Page
To access the System Management page:
1. From the ViTALConnect Server Management System menu, click System Management.
The System Management page displays the User Manager.
2. Select the desired page from the menu on the left.
User Manager
Access the User Manager page to:
• Add a user account of any type

• Edit a user account profile
• Delete a user account
Accessing the User Manager Page
To access the User Manager page:

• Click User Manager, on the System Management page (see Accessing the System Management Page).
The User Manager page displays.
FIGURE 2. User Manager page
Adding User Accounts
To add a user account:

1. Click New.
The Add New User page displays.
FIGURE 3. Add New User page
2. Complete the entries as follows:
TABLE 1. Add New User entries
Setting Description
User Name The login name of the user.
User Password The user’s login password.
NOTE: As a security precaution, you cannot set the HInnovation account to use the
default administration password once it is changed.
28 VPMC-08370E User Manager

TABLE 1. Add New User entries
Setting Description
Confirm Password Confirm the above password by entering it again.
First Name The user’s first name.
Last Name The user’s last name.
Email Address The user’s email address.
Privilege The level of access given to the user. The access level varies depending upon
whether on the client side or server side.
• Client Side: the main VC product accessed via the standard login page.
• Server Side: the Server Management System web pages accessed via the
main.aspx protocol.
Refer to the tables listed below.
Institution Name The user’s institution affiliation, available only to the Institution User and Referring
Physician privilege levels.
Password will expire Checked: This user’s password will expire after the number of days specified, forcing
in __ days the user to change passwords on a regular basis.
Clear: This user’s password never expires.
User must change Checked: The initial password entered above will expire on the first login, forcing the
password next login. user to enter a new password on the first login.
TABLE 2. User Privileges - Client Side
Publish to Mark
Delete Save DICOM Heart DICOM Vessel
License Type Privilege Level Clinician As
Study Image Query Segmentation Send Probe
(see below) Read
Administrator Administrator Y Y N Y Y N Y N
Diagnostic Radiologist Y Y Y Y Y Y Y Y
Technologist Y Y N Y Y N Y N
Clinician Institution N N N N Y N N N
User
Referring N N N N Y N N N
Physician
Transcriber cannot log on
NOTE: If Referring Physician Matched is checked, the DICOM Query option is available for Administrator,
Radiologist, and Technologist.
NOTE: You are limited to Publishing to 16 Clinicians.
NOTE: If you are using LDAP (Microsoft Active Directory, Open LDAP), Radiologist uses a Diagnostic license and
Referring Physician uses a Clinician license.
User Manager VPMC-08370E 29

TABLE 3. User Privileges - Server Side (Table 1 of 3)
Image Load
Privilege System DICOM DICOM Compress DICOM
License Type Server Balance
Level Mgmt Mgmt Options Ratio Query
Config Mgmt
Administrator Administrator R/W R/W R/W R/W R/W R/W Y
Diagnostic Radiologist N N N N N N Y
Technologist N N N R/W R/W R/W Y
Clinician Institution N N N N N N Y
User
Referring N N N N N N Y
Physician
Transcriber N N N N N N N
Remote DICOM
Privilege DICOM Delete by DICOM Auto Enable Auto
License Type DICOM Forward
Level Send Schedule Deleting Delete
Query Mgmt
Administrator Administrator Y Y Y Y Y Y
Diagnostic Radiologist Y Y Y N N Y
Technologist Y Y Y Y Y Y
Clinician Institution N N Y N N N
User
Referring N N Y N N N
Physician
Transcriber N N N N N N
Privilege Disable DICOM Institution Report DICOM Error

License Type
Level Auto Delete Devices Mgmt Mgmt Report
Administrator Administrator Y Y R/W R/W Y
Diagnostic Radiologist Y Y N R/W Y
Technologist Y Y R/W R/W Y
Clinician Institution N Y N R Y
User
Referring N Y N R Y
Physician
Transcriber N N N R/W N
30 VPMC-08370E User Manager

NOTE: R/W denotes Read/Write. Read access allows a user to read the entries. Write access allows a user to
write new entries or modify existing entries.
NOTE: If Referring Physician Matched is checked, a Referring Physician can only view the images that belong to
his/her patients and Institution Users can only view the images that belong to his/her institutions.
NOTE: If you are using LDAP (Microsoft Active Directory, Open LDAP), Radiologist uses a Diagnostic license and
Referring Physician uses a Clinician license.
3. Click when finished.
Editing User Accounts
To edit a user account:

1. Select the checkbox next to the name you want to edit and click Edit.
The Edit User page displays.
2. You can edit all fields except User Name:
TABLE 6. Edit User entries
Setting Description
User Password The user’s login password.
Confirm Password Confirm the above password by entering it again.
First Name The user’s first name.
Last Name The user’s last name.
Email Address The user’s email address.
Privilege The level of access given to the user. The access level varies depending upon
whether on the client side or server side.
• Client Side: the main ViTALConnect product accessed via the standard login
page.
• Server Side: the Server Management System web pages accessed via the
main.aspx protocol.
Refer to the tables listed on pages 29 and 30.
Institution Name The user’s institution affiliation, available only to the Institution User privilege level.
Password will expire Checked: This user’s password will expire after the number of days specified, forcing
in __ days the user to change passwords on a regular basis.
Clear: This user’s password never expires.
User must change Checked: The initial password entered above will expire on the first login, forcing the
password next login. user to enter a new password on the first login.
3. Click when finished editing.
User Manager VPMC-08370E 31

Deleting User Accounts
To permanently delete a user account:

1. Check the box next to each user account you want to delete.
NOTE: Be careful - you will not receive a delete confirmation message during this procedure.
2. Click .
All selected user accounts are permanently deleted, and a confirmation message displays.
Logs Query
• Access Logs Query to query session time, communications, and crash errors by user name
To access the Logs Query page:

1. Click Logs Query, on the System Management page.
The Logs Query page displays.
FIGURE 4. Logs Query page
2. Select the following fields to perform a query:
TABLE 7. Settings
Setting Description
UserName Enter the user name for which you want to query.
start date Select the year, month, and day you want to start the query.
end date Select the year, month, and day you want to end the query.
3. Click .
4. The results display, sorted by start time.
5. Perform one or more of the following actions:
• Check one or more rows you want to delete, and click .
• Click to delete all rows.
• Click to export the results to an Excel spreadsheet.

• Perform another query.
32 VPMC-08370E Logs Query

Monitor Logs Query

1. Click Monitor Logs Query.
The Monitor Logs Query page displays.
FIGURE 5. Monitor Logs Query page
2. Select the following fields to perform a query:
TABLE 8. Settings
Setting Description
from date Select the year, month, and day you want to start the query.
to date Select the year, month, and day you want to end the query.
restart type: Select the type of Restart: Schedule or Exceptional.
3. Click .
4. The results display, sorted by Restart time.
5. Perform one or more of the following actions:
• Scroll through multiple pages by clicking First, Previous, or Last.
• Go directly to a specific page by selecting the page number in the To Page field.
• Perform another query.
Study Statistics
1. Click Study Statistics.
The Study Statistics page displays.
FIGURE 6. Study Statistics page
• Select the User Name and start date desired and click Query.
Statistics about the studies the user accessed during the date range display.
Monitor Logs Query VPMC-08370E 33

34 VPMC-08370E Study Statistics

Vital ECF Management

Introduction
Once you have installed both the DICOM server and the image server, you must configure the DICOM server.
DICOM server configuration includes a few additional steps to set up the following components:
• DICOM Management - Associate local and remote DICOM servers.

• Local and Remote DICOM Server Queries - Perform queries on the local server and on remote queries.
Export and retrieve images.
• DICOM Forward Management - Set up automatic forwarding of DICOM images received on the local
server to remote servers.
• Automatic Deletion Criteria - Set criteria for automatically deleting old images to prevent running out of
disk space.
• Server Settings - Review and adjust the default identification and default maximum values established
for the local server during server software installation.
• Miscellaneous Device and Error Logs - Review system device and error logs.
• Compress Ratio -
Accessing the ViTAL ECF Management Menu
To log into the ViTAL ECF Management Menu:
1. From the ViTALConnect Server Management System menu, click ECF Management.
The ViTAL ECF Management menu displays.
FIGURE 2. ViTAL ECF Management Menu
DICOM Management
Installing PACS Server or Modality Using the Web Interface
Configuring DICOM Management

• Configure the AE titles for Local and Remote DICOM servers and Remote AE Title.
1. On the ViTAL ECF Management Menu, click DICOM Management.
The DICOM Management page displays.
FIGURE 3. DICOM Management page
36 VPMC-08370E DICOM Management

Editing the AE (Application Entity) Title/Modality/DICOM Entity

1. Select the radio button next to the AE Title you want to edit.
2. Click .
The Edit AE Title page displays.
DICOM Management page
3. Enter the following fields:
TABLE 1. New AE Title page fields
Field Description
Alias The alias, or alternative name, of the AE.
AE Title AE (Application Entity) name of the local DICOM server.
Host Name The IP address of the server.
DICOM Management VPMC-08370E 37

Field Description
Port Number Communications port number of the server.
PDU The PDU of the server.
Auto Forward Automatically forwards DICOM images saved from the ViTALConnect client to this AE
device.
Type Type of AE (ECF, CAD, ViTALConnect)
Comments Comments to about the AE, i.e. purpose, location.
Possible Services A list of services that are available for the AE. Select from this list.
Selected Services A list of services that are enabled for the AE (selected from the Possible Services list).
Storage Options Select all the storage options you want to enable for the AE.
Transfer Options Select all the transfer options you want to enable for AE.
4. After entering your changes, click .
Adding an AE Title/Modality/DICOM Entity
NOTE: This is where you configure the other DICOM servers from which you want to query and retrieve images,
and to which you want to export DICOM images. You must also configure the ViTALConnect DICOM server on
each of those devices.
1. Click New on the DICOM Management (see page 36 above) to display the New AE Title page.
The New AE Title page displays.
FIGURE 4. New AE Title page

Field Description
Alias The name of the remote DICOM server. This should be an easy-to-remember common
name.
AE Title The AE (Application Entity) name of the remote DICOM server.
Host Name The computer name/IP address where the remote DICOM server is installed.
Port Number The network port to which the remote DICOM server is listening.
Comments Enter comments, such as the name of the remote DICOM server's vendor.
3. Click Test to test the remote DICOM server.

If you receive the Test successful! message, the remote DICOM server is available. If you receive the Test
failed! message, either the information you entered for the remote DICOM server is wrong or the server is
not available.
4. Click to save the new DICOM server.

The new remote DICOM server information displays in the Remote AE Title list.
5. Click Main Page to return to the ViTAL ECF Management menu.
Installing PACS Server or Modality Using VICommunicator
VICommunicator Overview
VICommunicator is a Windows service that ViTALConnect software uses for DICOM communications.
VICommunicator is accessible through an interface that allows you to manage DICOM entries, customize the
autodelete function, and rebuild the patient database.
Testing the Functionality of VICommunicator
The VICommunicator service has a Graphical User Interface (GUI) that is installed with the software. The service
can be stopped and started through either the GUI or Windows Services.
To test the VICommunicator service:

1. Double-click on the small blue “V” icon on the toolbar (in the bottom right corner of the ) to launch the
VICommunicator window.
OR
Run ecfadmin from the Run window.

FIGURE 5. ECFAdmin Command Box
The VICommunicator window opens.

2. Click Test.
FIGURE 6. VICommunicator Test
Restarting VICommunicator
Verify that the VICommunicator test response indicates “Running”. If the test bar indicates “Not running”,
restart the VICommunicator.
To restart the VICommunicator:

1. From the Start menu, select Control Panel I Administrative tools I Services.
2. Restart VIServices.
VIServices starts VICommunicator.
3. Make sure the blue “V” is on the task bar, and verify that VICommunicator is now running.

Volume Archive and DICOM Archive Locations
The Volume Archive is the location for the AVOL storage listed under PatientCabinet in the ECF configuration file.
The DICOM Archive is the storage location for the DICOM files, listed as the last PatientCabinet node in the
configuration.
This is specifically useful for ViTALConnect sites that have the Volume and DICOM archives listed in different
locations. There can be multiple volume archives, but only one DICOM archive.
FIGURE 7. VICommunicator Config screen
The VICommunicator Config screen displays the location of the Volume Archives and DICOM Archive. Also, there
are fields to edit the Dropbox Location and Thumbnail Location.
Adding DICOM Devices
Overview
DICOM Printers, PACS, Vitrea, and other ViTALConnect workstations can be configured for communication.
VICommunicator uses wizards to set up these devices. It is also possible to make customizations and change
printer settings in VICommunicator.
Sending Images to the ViTALConnect
Vital Image’s DICOM Conformance statement outlines the image types the ViTALConnect workstation has the
ability to store. ViTALConnect Software will receive DICOM images without the sending device being added to
the software. There is no entry needed for any Scanners or PACS that are sending to ViTALConnect. By default,

ViTALConnect software is configured to receive only the following Storage Classes: CT, MR, Secondary Capture
(SC), and Presentation State (PR). Other Storage Devices need to be manually added.
Extended Storage Classes
To add extended Storage Classes:

1. Double-click the small blue “V” icon on the toolbar (in the bottom right corner of the ) to launch
OR
Enter ecfadmin in the Run window.

2. Click DICOM.
3. On the Config tab, select the Local entry.
4. Click Edit to edit ViTALConnect’s local AETitle information.
The VICommunicator DICOM Server Edit screen displays.
FIGURE 8. VICommunicator DICOM Server Edit
5. Click Storage Options to select Storage Classes.

The Storage Options screen displays.
FIGURE 9. Storage Options screen
6. Select the Storage Classes boxes for local ViTALConnect. If no checkboxes are selected, ViTALConnect
will only receive images of Standard Storage Classes (CT, MR, SC, PR). Check all four Standard Storage
Classes before any Extended Storage Classes. Vital Images does not limit the number of Extended
Storage Classes selected.
7. Click OK.
8. Close the DICOM Server Edit window and VICommunicator.
Configuring ViTALConnect’s DICOM Settings
The default DICOM settings are VCECF for the AETitle and Port 3002. Both of these settings are customizable, but
Vital Images recommends you set the Port at 3002.
To change the local ViTALConnect AE Title:

OR
Type ecfadmin in the Run window.

2. Click DICOM.


4. Click Edit to edit ViTALConnect’s local AE Title information.
5. Edit the AE Title field.
NOTE: Vital Images recommends that you not change information into the Alias, Host, PDU, Port, SC
Alias fields.
NOTE: Vital Images recommends that you do not use the Auto Forward or Archive Server checkboxes.
6. Click Save.
Turning on the Multi-frame Option in ViTALConnect
You can configure ViTALConnect to accept multiframe CT or MR images.
To turn on the multi-frame option:

OR

2. Click DICOM.
5. Click Storage Options to select Storage Classes.
6. Check the Multi-frame Computed Tomography (CTMF) and Multi-frame Magnetic Resonance (MRMF)
boxes.
7. Click OK.
Configuring PACS in ViTALConnect
ViTALConnect sends to and queries/retrieves from PACS (Picture Archiving Communication System). Set up the
ViTALConnect configuration information as a DICOM entry on the PACS so that query/retrieve functions properly.
Be sure you have the following information before you begin:
• AE Title
• IP address
• Port number of the PACS
To add a PACS entry:


OR

2. Click DICOM.
3. On the Config tab, click New to add the New PACS entry.
The DICOM Wizard displays.
FIGURE 10. DICOMWizard Archive Server Entry
4. Select Archive Server.

5. Click Next.
6. On the Archive Configuration , click Yes to setup query and retrieve of the PACS.
7. Click Next.
8. Enter the information in the Alias, Host, AE Title, and Port fields.
The Alias field is how the entry displays in the software.
9. Click Finish to continue.
10. Close VICommunicator.
The setup of the PACS is complete.
11. Start ViTALConnect software to test.
Configuring Other VICommunicator DICOM Server Edit Options
Use the DICOM Server Edit , shown below, when you want to configure ViTALConnect to receive photos from a
Vitrea node.
Configuring a Vitrea Node to Send Photos to ViTALConnect
To configure a Vitrea Node to Send Photos to ViTALConnect:

OR

2. Click DICOM.
4. Click Edit to edit Vitrea’s local AE Title information.
The DICOM Server Edit screen displays.
FIGURE 11. DICOM Server Edit screen
5. Type VCECF in the Alias field.

6. Select the Type dropdown box and select ViTALConnect.
7. Click Save.
8. Type
Modifying the Transfer Options
To modify the Tranfer Options:

OR
Enter ecfadmin in the Run window.

2. Click DICOM.
The DICOM Server Edit screen displays.
5. Click Transfer Options.

FIGURE 12. VICommunicator Transfer Options
6. Select the Transfer Syntax to add.

7. Click OK to continue.
Configuring Printers
Configuring DICOM Printers
To add a DICOM Printer entry:

OR

2. Click DICOM.
3. On the Config tab, click New to add the new DICOM Printer entry.
The DICOM Wizard displays.
FIGURE 13. DICOMWizard DICOM Printer Entry
4. Select DICOM Printer, then click Next.

5. Click Yes to accept the default printer settings, then click Next to continue.
The DICOMWizard Node Entry Window displays.
FIGURE 14. DICOMWizard Node Entry Window
6. Enter information in the Alias, Host, AE Title, and Port fields.

7. Click Finish.
After saving the new entry, the VICommunicator Admin screen displays.
FIGURE 15. ViCommunicator Admin Printer Config Tab
8. Select the Printer Config tab to verify the printer’s properties.

9. Select the appropriate printer under the Printer: drop-down arrow.
10. Click OK.
NOTE: The default settings will work for most printers, you may need to make changes in some cases.
DICOM Printer’s configuration settings will be listed in the DICOM Conformance statement of the printer.

11. Close VICommunicator.

The setup of the PACS is complete.
12. Start ViTALConnect to test.
DICOM Options
Configuring DICOM Options
To configure DICOM Options:

1. On the ViTAL ECF Management Menu, click DICOM Options.
The DICOM Options page displays.
FIGURE 16. DICOM Options page
TABLE 3. DICOM Options page fields
Field Description
ExportSCUAlias Export Service Class User alias
ImportSCPAlias Import Service Class Provider alias
CommitSCPAlias Commit Service Class Provider alias
ImportSCPTimeout Import Service Class Provider timeout value
CommitSCPTimeout Commit Service Class Provider timeout value
MaxAssoc Maximum handshake number
QueryLimit Limit to number of query results
Separate Series Checked: Allow separate series
Push Timeout Number allowed before timeout
DICOM Options VPMC-08370E 49

Compress Ratio
You can change the compress ratio for existing modalities, or add a new modality and compress ratio. The
higher the compression ratio, the more the image will be compressed; the ratio must be greater than 20.
Setting the Compress Ratio
To set the compress ratio:

1. On the ViTAL ECF Management menu, click Compress Ratio.
The Compress Ratio page displays.
FIGURE 17. Compress Ratio page
2. Set the compression ratio for each image type, as well as the default ratio that is to be used for all other
images.
3. Click Save to save the values.
Adding a Compress Ratio for an image type not listed
To add a compress ratio for an image type not listed:

1. Click Add.
The Add Compress Ratio page displays.
50 VPMC-08370E Compress Ratio

2. Select a Modality type, and enter a compress ratio greater than 20.
3. Click OK.
DICOM Query
Performing a Local DICOM Query
To perform a local DICOM query:

• Query the local server for DICOM worklist information and to send and delete studies, series, or images.
1. On the ViTAL ECF Management menu, click DICOM Query.
The DICOM Query page displays.
FIGURE 18. DICOM Query page
The default query will look for all DICOM information (studies). Blank fields represent a value of all.
Alternatively, you can enter query criteria in the following fields:
• PatientName
• PatientID
• AccessionNumber
• Modality
• Date of Last Study
2. To run the query, click .
The query can return three possible lists of DICOM data residing on the local server: studies, series, and
images.
• To sort the series list by a particular column, click the column header (such as “Patient Name”).
• To see the series in a study, click the study.
• To see the images within a series, click the series.
• To select or deselect all the items in the corresponding list, check or clear the Select All box.
DICOM Query VPMC-08370E 51

Exporting a selected study, series, or image to a remote DICOM server
To export a selected study, series, or image to a remote DICOM server:

1. Select the item(s) you want to export by checking the box(es) in the left column of the corresponding list.
2. Select the server to which you want to send the item(s) from the dropdown list next to the Send To button.
3. Click Send To.
NOTE: The data is not sent instantly. The Store SCU service will process the export in the background.
Deleting a study, series, or image from the local server database
To delete a study, series, or image from the local server database:

1. Select the item(s) you want to delete by checking the box(es) in the left column of the corresponding list.
2. Click Delete by Schedule.
Scheduling a study, series, or image for automatic deletion the next time auto-delete runs
To schedule a study, series, or image for automatic deletion the next time auto-delete runs:
NOTE: You set the criteria for the auto-delete process on the DICOM Auto Deleting page.
1. Select the item(s) you want to schedule for deletion by checking the box(es) in the left column of the
corresponding list.
2. Click Delete by Schedule.
The Store SCU service will process the deletion(s) in the background.
Remote DICOM Query
Performing a Remote DICOM Query

• Query a remote server for DICOM worklist information, and to retrieve studies, series, or images from the
remote device to the local DICOM server.
1. On the ViTAL ECF Management Menu, click Remote DICOM Query.
The Remote DICOM Query page displays.
52 VPMC-08370E Remote DICOM Query

FIGURE 19. Remote DICOM Query page
The default query looks for all DICOM information (studies). Blank fields represent a value of all.
Alternatively, you can enter query criteria in the following fields:
• PatientName
• PatientID
• AccessionNumber
• Modality
• Date of Last Study
2. To run the query, click .
The query can return three possible lists of DICOM data residing on the local server: studies, series and
images.
• To see the series in a study, click the study.
• To see the images within a series, click the series.
• To retrieve selected studies, series, or images, do the following steps:
a Select the item(s) you want to retrieve by checking the box(es) in the left column of the corresponding
list.
OR
To select all studies, series, or images for retrieval, check the Select All box for the corresponding list.
b Click .
The Store SCU service will retrieve the DICOM files in the background.
3. Click Main Page to return to the ViTAL ECF Management Menu.
DICOM Forward Management
Setting up DICOM Forwarding
To set up DICOM Forward Management:
Set up automatic forwarding to remote DICOM servers. Forward management will send all studies or just studies
with specific modalities that were processed on the client, then saved back on the server.
NOTE: This feature is ideal for PACS.
DICOM Forward Management VPMC-08370E 53

• On the ViTAL ECF Management Menu, click DICOM Forward Management.

The DICOM Forward Management page displays, containing a table listing all configured remote DICOM
servers:
FIGURE 20. DICOM Forward Management page
• Auto Forward indicates whether or not forwarding is turned on (Yes) or off (No) for the listed remote
server.
• Modality indicates the modality(ies) of images that are automatically forwarded to the listed remote
server.
Editing DICOM Forward Settings

1. To edit the settings for a remote DICOM server, select the radio button on the line associated with that server
and click .
The Edit DICOM Forward settings page displays.
FIGURE 21. Edit DICOM Forward settings page
2. Complete one of the following actions:

• To forward all images received by the local server, regardless of modality, leave the Modality dropdown
field set to All.
OR
• To forward only images the local server receives that belong to one specific modality, select a modality
from the Modality dropdown list.
• To turn forwarding on for the listed remote DICOM device, check the Auto Forward box.
54 VPMC-08370E DICOM Forward Management

OR
• To turn forwarding off for the listed remote DICOM device, clear the Auto Forward box.
• Click Test and Save to save the new settings.
DICOM Auto Deleting
Configuring DICOM Auto Deleting
To configure DICOM Auto Deleting

• Configure the auto-delete criteria for the local server.
1. On the ViTAL ECF Management menu, click DICOM Auto Deleting.
The DICOM Auto Deleting page displays.
FIGURE 22. DICOM Auto Deleting page
• To configure the server to automatically delete files when disk space reaches a certain limit, complete the
following steps:
a Select Enable DICOM Auto Deleting.
b Accept the default size of 5000 MB, or enter a different size.
c Click .
When the disk space used reaches the specified size, the DICOM server will start deleting saved
images, starting with the oldest studies.
NOTE: Disk space is the amount of logical disk space remaining on the partition where the DICOM files
are saved, not the space left on the entire hard disk.
2. Click Main Page or click Here (if you clicked Save in 1c above) to return to the ViTAL ECF Management menu.
DICOM Devices
Displaying a list of configured DICOM devices
To display a list of configured DICOM devices

• Review the log of the DICOM devices sending the local server DICOM data.
DICOM Auto Deleting VPMC-08370E 55

1. On the ViTAL ECF Management menu, click DICOM Devices.

The manufacturer, model name, and modality of all devices from which the local server has retrieved
images is displayed in the DICOM devices list:
FIGURE 23. DICOM Devices list
Institution Management
Adding a New Institution
To add a new institution

1. On the ViTAL ECF Management menu, click Institution Management.
The list of entered institutions displays.
FIGURE 24. Institution Management page
2. Click New.
The New Institution page displays.
3. Enter a name in the Institution Name field and click OK.
Deleting an Institution
1. Select the radio button next to the institution name you want to delete.
2. Click Delete.
56 VPMC-08370E Institution Management

Report Management
Reviewing Reports
To review reports:
1. On the ViTAL ECF Management menu, click Report Management.
The Report Management page displays.
2. Use the following pulldown menus to filter the results of your report query:
• Institution Name
• Study Date
• Status
NOTE: Use the Patient Name field to enter patient information.
3. After selecting the desired criteria, click .

The results display in the Report Management Results page.
FIGURE 25. Report Management Results page
• Sort the results by clicking on a header.

• Click First, Next, and Last to move through multiple report pages.
Uploading a Report
To upload a report
You can upload comments and attachments Dictated or Approved reports (you can only view other reports).
1. Click a report status (Scanned, Dictated, Approved) on the left side of the page.
2. A detailed view of the report displays.
3. Do any of the following:
• Enter text into the Comment box and click Upload.
• Click Upload with an attachment and select a file to attach, then click OK.
Report Management VPMC-08370E 57

DICOM Error Report
Displaying the DICOM Error Report
To display the DICOM Error Report

• Review a list of errors the DICOM server has encountered.
1. On the ViTAL ECF Management menu, click DICOM Error Report.
The DICOM Error Report page displays.
FIGURE 26. DICOM Error Report page
58 VPMC-08370E DICOM Error Report

Load Balance Management
Introduction
Once you have configured ViTAL Connect ECF and the DICOM and image servers, you can also change the main
server and control a variety of load balancing servers. This Chapter describes the following function, available
from the Load Balance Manangement menu:
• Load Balancing Servers
Accessing the Load Balance Management Page
To access the Load Balance Management page:
1. From the ViTALConnect Server Management System menu, click Load Balance Management.
The Server Load Balance Status screen displays by default.
FIGURE 2. Server Load Balance Status screen
2. Select the desired page from the menu on the left.
Server Load Balance Status

Access the Server Load Balance Status page to:
• Check the server load balance status

• Change the main server
• Control the load balancing servers
Accessing the Server Load Balance Status Page
To access the Server Load Balance Status page:

• Click Server Load Balance Status, on the Server Load Balance Status page.
The Server Load Balance Status page displays.
FIGURE 3. Server Load Balance Status page
To Change the Main Server

• Click Change Main Server, on the Server Load Balance Status page.
The Change Main Server page displays.
FIGURE 4. Change Main Server page
• Click the Desired main server: dropdown menu to select a different server to change.
• Click Change Main Server to make the server listed in the Desired main server: dropdown menu the main
server. It will take a few minutes for the server to perform this action.
To Control a Load Balancing Server

• Click Control a Server or select the radio button and click Control a Server next to a desired server on the
Server Load Balance Status page.
The Individual Load Balance Server Control: page displays.
60 VPMC-08370E Server Load Balance Status

FIGURE 5. Control a Server page
• Click the Server IP: dropdown menu to select a different server to control.
• Current number of processing requests: lists the number of 3D requests being processed by the machine listed in the
Server machine’s IP address: dropdown menu.
NOTE: This field is updated every minute by default. It is dependent upon the number listed in the Registration
update time (seconds): field on the Server Load Balance within the ViTAL Connect Image Server Configuration
view.
• Server Enabled Status: lists whether the server machine listed in the Server IP: dropdown menu is enabled for 3D
processing. When it is enabled, the selected node will be considered for 3D processing sessions.
NOTE: If this option is enabled for the main server and if the Consider main server for load balancing load
checkbox on the Server Load Balance within the ViTAL Connect Image Server Configuration view is not checked,
no load will be sent to the main server.
• Reboot pending: lists whether a user has requested a reboot (via the Reboot Server or Reboot/Enable Server buttons)
and it is still pending for the machine listed in the Server IP: dropdown menu.
NOTE: This field is checked every minute by default. It is dependent upon the number listed in the Registration
view.
• Autoenable pending: lists whether a user has requested a reboot (via the Reboot/Enable Server button) and it is still
pending for the machine listed in the Server IP: dropdown menu. This field will switch the server to Enable when it
reboots.
view.
• Restart pending: lists whether a user has requested a restart (via the Restart Image Service button) and it is still
pending for the machine listed in the Server IP: dropdown menu.
view.
Server Load Balance Status VPMC-08370E 61

• Last time this server registered (or table was updated): lists the last time the server machine listed in the
Server IP: dropdown menu was registered. This value also is updated when the Disable, Restart Image
Service, Reboot Server, or Reboot/Enable Server button is clicked.
NOTE: If this field is not updated within the time listed on the It is dependent upon the number listed in
the Registration update time (seconds): field on the Server Load Balance within the ViTAL Connect
Image Server Configuration view, then either the server is not running or there may an issue.
• Last time an image was requested from this server: lists the last time a 3D image was requested for the
machine listed in the Server IP: dropdown menu.
NOTE: This field can be used to track whether this server is being used for processing 3D rendering
sessions by the load balancer.
• Server with GPU box indicates if there is a GPU on that server. Usually only the server with the GPU can be
used to render 3D.
• Affinity For MainServer: dropdown menu is not used at this time.
• Click Save to save the changes you have made on the .
• Click Refresh to refresh the values on this .
• Click Disable/Enable to toggle between enabled or disabled for consideration for 3D processing by the load
balancing algorithm.
• Click Restart Image Service to stop the Image Server Service for the machine listed in the Server IP:
dropdown menu.
NOTE: This field is checked every minute by default. It is dependent upon the number listed in the
Registration update time (seconds): field on the Server Load Balance within the ViTAL Connect Image
Server Configuration view.
• Click Reboot Server to reboot the server machine listed in the Server IP: dropdown menu.
• Click Reboot/Enable Server to reboot the server machine listed in the Server IP: dropdown menu.
62 VPMC-08370E Server Load Balance Status

Third Party Integration
Overview
Traditionally, separate systems working independent of each other provide key components within a diagnostic
imaging department. For example, Picture Archiving and Communications Systems (PACS) are used as the
primary means for diagnostic image review; while specialized post processing applications such as
ViTALConnect are often purchased to compliment the PACS workstation by providing high end 3D reconstruction
functions.
In an effort to redesign the traditional workflow to interpret diagnostic exams, Vital Images has introduced
Uniform Resource Locator (URL) integration capabilities for ViTALConnect 4.1.5. URL based integration assists in
the consolidation of the traditionally heterogeneous applications used throughout the diagnostic imaging
department within a single desktop interface; reducing the need for additional Personal Computer (PC)
hardware and improving workflow for the physician.
As most PACS, EMR, RIS, and other healthcare technology vendors have native capabilities to dynamically
generate an "in context" URL for integration purposes, the ViTALConnect third party integration capability
facilitates a simple mechanism for:
• Enabling third party applications with intuitive access to real-time images, a crucial part of the patient's
medical history. 3D, MPI, and MPR tools are launched directly from the EMR with a single button click or
menu selection.
• Snapshot restore capabilities.
• Direct access, with single sign on , to the ViTALConnect visualization tools, dramatically reducing reading
turnaround time while maintaining user productivity.
• Consolidation of clinical applications on a single workstation in the reading room.
• Automatic transfer of study identifiers to ViTALConnect to begin 3D post processing "in context." Eliminating
error-prone manual input of image identifiers in multiple applications.
Prerequisites
The ViTALConnect Third Party Integration interfaces all are capable of supporting a remote DICOM retrieve from
the list of configured DICOM Archive Servers, if the series requested is not already resident on the ViTALConnect
server.
To enable the remote DICOM retrieve aspect of this feature, you must install the VIMS Gateway service on the
ViTALConnect server.
NOTE: The VIMS Gateway must be installed on the server that the ECF component was installed on, which is
typically the main ViTALConnect server.
If you do not install this service, the interfaces will allow you to open series if they are already present on the
ViTALConnect server, but no remote DICOM retrieve functionality will work. Note that this means that the
FetchSeriesBy* interfaces will not operate.
Overview VPMC-08370E 63
To install the server, execute either the setup.exe or VIMSGatewayInstaller.msi from the ViTALConnect install
media in the VIMSGateway folder, and follow the instructions in the dialogs. You may run the installer at a later
time to repair or ununinstall the service.
The VIMS Gateway exposes a web service which provides a programmable means for optimally routing
information to the ViTALConnect server. Refer to the VIMSGatewayAPIAndInstallation.doc file in the same folder
for further details.
XML-Based URL Call

ViTALConnect 4.1.5 supports XML-Based Call to invoke any 3rd party interfaces. XML-Based URL Call can be
invoked in either secure or unsecure mode.
To invoke a ViTALConnect 3rd party interface in unsecure mode:

1. Build the request xml string
2. Invoke the URL call and post the request xml to the url. With the xml data param as "id"
a http://vcserver/VCAccess.aspx
NOTE: Refer to the “Sample URL Invocations, POST example code” section on page 69.
or use get:
b http://vcserver/VCAccess.aspx?id=[xml data]
[xml data] - the URL encoded request xml string (refer to the “Building the Request XML String” section
below).
NOTE: When using the unsecure invocation, you will need to appropriately URL encode the request. Refer to IETF
standard RFC-3986 for further information. The secure method of invocation automatically encodes the request.
To invoke a VITALConnect 3rd party interface in a secure mode:

1. Build the request xml string
2. Encrypt the xml with Secure URL Builder
3. Invoke the URL call and transfer an encrypted request to url.
http://vcserver/VCSecureAccess.aspx?id=[param]
[param] -- the encrypted request xml string
Building the Request XML String

The request xml string populates all the interface call parameters. To use the URL based call, replace the
parameter parts (after =) with corresponding parameters. Those parameters are case sensitive. A sample
request xml like the following:
<URLRequest
AuthenticationURL="http://localhost/
ThirdPartyAuthenSvr.asp?fun=IsValidSession&forSessionID=1234567890'"
Vendor="McKesson"
SessionID="1234567890"
64 VPMC-08370E XML-Based URL Call

Method="OpenSeriesByStudyUID"
StudyUID="1.2.840.113619.2.108.1627425293.27972.1038258320.884"
SeriesUID="1.2.840.113619.2.108.1627425293.27972.1038258320.885"
StudyMode="0"
FirstName="Mckesson"
LastName="Vital"
ReconcilePatientFile="c:\sample.xml"
Email="adm@sina.com"/>
The request xml should provide:
• Authentication parameters
AuthenticationURL - a URL for ViTALConnect to validate a session id.
SessionID - the session id
FirstName - the first name of the user (user information)
LastName - the last name of the user (user information)
Email - the email address of the user (user information)
Vendor - Vendor name to distinguish different vendor
• Interface parameters
Method - Method Name
AccessionNumber - accession number
SeriesUID - series uid
StudyMode - study mode
StudyUID - study uid
ImageUID - image uid
ReconcilePatientFile -- the full path of the local stored patient reconciliation information file
The AccessionNumber, SeriesUID, StudyMode, StudyUID, ImageUID, ReconcilePatientFile are either required or
optional based on method name. Refer to the third party integration information on page 72.
Since the parameters may contains special characters like &, < > / may break the XML formation, we recommend
avoid using such characters or use a xml parser to create the request xml string.
Sample URL Invocations

POST example code:
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<title>ViTALConnect URL API Launch Sample</title>
</head>
<body onload="document.form1.submit()">




<form method="POST"
name="form1"
action="http://vcwest.vitalimages.com/VCAccess.aspx">
<input type="hidden"
name="id"
value='<URLRequest Method="OpenSeriesByAccessionNumber" Accession
Number="7527477"
StudyMode="2"/>'/>
</form>
<h2>Welcome to ViTALConnect!</h2>
<p>Now launching the URL Request to open the specified series.</p><br />
<p>Note that if you receive a prompt regarding blocked content, please grant access to
this page to run the ViTALConnect (digitally-signed) ActiveX control.
<i>(click the bar above and select "Allow Blocked Content...")</i><br />
</p>
</body>
</html>
Encrypting the XML with Secure URL Builder

Secure URL Builder includes a Web Service and a Web proxy page to encrypt the request xml string for invoking
the 3rd party interfaces in a secure way.
Both the Web Service and the Web proxy page are only accessible via HTTPS.
Web Service: Secure URL Builder

The Web Service (https://<Server>/VCSURLBuilderWS/WebService.asmx ) only contains the following method:
• string GetSecureURL(string strRequest)
strRequest - the request xml string which contains the 3rd party interface parameters.
Return value - a encrypted URL parameter to access the ViTALConnect.

Sample C# code to invoke the Secure URL Builder. The Web service is referenced as VCSURLBuilderWS.
static void Main(string[] args)
{
string strXML = "<URLRequest User=\"adm\" Pass=\"adm\" Domain=\"\"
Method=\"OpenSeriesByAccessionNumber\" AccessionNumber=\"123456\"
SeriesUID=\"1.2.826.0.1.3417726.1.0.0.1.2.808374.20031105142615572\" StudyMode=\"0\"/>";
VCSURLBuilderWS.WebService service = new VCSURLBuilderWS.WebService();
string strSecureURL = service.GetSecureURL(strXML);
Console.WriteLine(strSecureURL);
Console.ReadLine();
}

Web Proxy Page: Secure URL Builder

For those who cannot use the Web Service directly, ViTALConnect provides a proxy page to encrypt the request
xml. The request XML should be POST/GET to the proxy page. POST is preferred.
POST the [Request XML] to
https://<Server>/VCSURLBuilderWS/VCSURLWsProxy.aspx
Or
https://<Server>/VCSURLBuilderWS/VCSURLWsProxy.aspx?Req=[Request XML]
The proxy page will return a xml,
If successful, you will receive a response similar to the following:
<?xml version="1.0" encoding="iso-8859-1" ?>
<root result="0">
ff7d3c4a-9244-428c-913c-
d13f8ae0d0b8hCqO4QC0jXyjcEI8O5wkq6zmUalVS77xEDkXRy%2fRsRSyuh7ofdSiwv2f37z1TU7Ni3q1Hw3n
7l3peg8r9ysSCa5CHDwebom3at3bi4XbII%2fkjeHG29E6bZC7HDEKJpd3r%2bjc4%2bvdZ3D4YZjwYaL8g1EP
vikK%2bIsNVwbCm08%2bPvNc%2bjMiQ0hQ9ojKwY270Uq9%2b81sJuKoGaN7NFfLLgvNiz0%2fjanWlFMopRl6
LzNmNebDQHJsohV3R8ZUv1hsOXWi
</root>
The result attribute is the return code. 0 for success. The data in the root Element is the Encrypted request xml.
If failure occurs, you will receive a response similar to the following:
<?xml version="1.0" encoding="iso-8859-1" ?>
<root result="-1" errorDescription="RW1wdHkgUmVxdWVzdCBYTUw=" />
Result attribute is -1 indicates failed. The errorDescription attribute is an encrypted error description. The third
party vendor can just ignore it.
Patient Reconciliation
CAUTION: Limited Patient Reconciliation is supported by substituting information passed in for the DICOM
information in the ViTALConnect client. Note that this does not modify the original DICOM data. Also, note
that a conference joiner will not see the reconciled information.
Patient Reconciliation should be only used with the OpenSeriesByStudyUID method. To use it, please follow the
steps:
1. Store the patient reconciliation information to a local file, e.g. C:\sample.xml.
A sample of the xml file is the following:

<PatientReconciliation>
<Study UID = "XXX">
<PatientName>Sample name</PatientName>
<PatientID>Sample ID</PatientID>
<PatientDOB>Sample date of birth</PatientDOB>
<PatientSex>Sample sex</PatientSex>
<AccessionNumber>Sample Accession
Number</AccessionNumber >
</Study>
</PatientReconciliation>
XML-Based URL Call VPMC-08370E 67

2. Provide the path to the request xml to call the interface. See the "Building the Request XML String" section
on page 75.
ReconcilePatientFile -- the full path of the local stored patient reconciliation information file.
Debugging URL Integration

You may temporarily enable web server supported debugging of the URL integration to diagnose issues. You
may enable the following logging facility to perform this function.
CAUTION: Be sure to disable the logging after the issue is resolved or it may impact performance.
To debug URL Integration, complete the following procedure:
1. Navigate to inetpub\wwwroot and double-click the Web.Config file.
Listed below is the text displayed within the Web.Config file.
<?xml version="1.0"?>

<configuration>
<appSettings/>
<appSettings>
<add key="LogRequestXML" value="C:\temp\request.log" />
</appSettings>
2. Within the Web.Config file, delete <appSettings/> and then add
<appSettings>
<add key="LogRequestXML" value="C:\temp\request.log" />
</appSettings>.
3. Make sure the C:\temp folder exists and with Everyone Full control privilege.
4. Run the 3rd party interface call, and check the C:\temp\request.log, it will log the request xml.

Interfaces to Open Series for Third Party Integration

There are five interfaces provided by ViTALConnect control to open series directly.
1. OpenSeriesByAccessionNumber
Description
Remote query/retrieve is supported for this method. If the specified study/series is not found on local server,
image server will query from archive servers. If the study/series is found on one of the archive servers, image
server schedules a retrieve request from the first archive server on which the series is found.
NOTE: The archive server should be set correctly to enable auto-retrieve/fetch functionality. The archive must
support SCP CMove and SCP CFind service.
How to set archive server:

You can set one DICOM server as the archive server using one of the following methods:
• Within VICommunicator, navigate to the DICOM Server Edit screen and check the Archive Server box.
FIGURE 1. DICOM Server Edit screen
• Set on the Configuration Webpage.

1 Log on from http:/localhost/main.aspx.
2 Select ECF Management.
3 Select DICOM Management.
4 Select and edit the DICOM server.
The Edit AE Title screen displays.
Interfaces to Open Series for Third Party Integration VPMC-08370E 69

FIGURE 2. Edit AE Title screen
5 Check the Archive Server box and click Save.
Prototype
[id(16)] long OpenSeriesByAccessionNumber (BSTR AccessionNumber, BSTR SeriesUID, short StudyMode);
Functionality
Opens a series in 2D/3D mode in ViTALConnect based on Accession number and series UID.
Parameters
AccessionNumber: AccessionNumber of the study.

SeriesUID; SeriesInstanceUID of the series. Optional.
studyMode: The mode to enter view.
Valid input:
0: MULTISLICE, it means entering 2D view.
2: VOLUMERENDER, it means entering Volume Rendering 3D mode.
XML based URL call param:

<URLRequest
User="username"
Pass="password"
Method="OpenSeriesByAccessionNumber"
AccessionNumber="accessionnumber"
SeriesUID="seriesuid"
StudyMode="studyMode"
/>
To Invoke the URL call, see page 64 for details.
70 VPMC-08370E Interfaces to Open Series for Third Party Integration

Description:
On the client side, a message box prompts the user that the series is scheduled to transfer from archive server.
After clicking OK, the Q/R Status window displays:
This window indicates how many tasks are scheduled and how many tasks are finished.
• Right click on the window and select “Show Main Window” menu item to display detail information.
FIGURE 3. QueryInspector
After the series is transferred to local server, the following message box displays:
• Click Yes to open the series and enter view.

• If SeriesUID is not specified, a dialog with all 3D capable series listed will popup for user to choose one.
2. OpenSeriesByStudyUID
Description
Remote retrieve is supported for this interface. * Refer to OpenSeriesByAccessionNumber for details.
Prototype
[id(19)] long OpenSeriesByStudyUID(BSTR StudyUID, BSTR SeriesUID, short studyMode);

Functionality
Opens a series in 2D/3D mode in ViTALConnect based on StudyUID.
Parameters
StudyUID StudyInstanceUID of the study.

SeriesUID SeriesInstanceUID of the study. Optional.
studyMod: The mode to enter view.
Valid input:
0: MULTISLICE, it means the 2D view.
2: VOLUMERENDER, it means Volume Rerendering 3D mode.

<URLRequest
User="username"
Pass="password"
Method=" OpenSeriesByStudyUID"
StudyUID="studyuid"
StudyMode="studymode"
/>
3. FetchSeriesByStudyUID
Description
Remote retrieve is supported for this interface. * Refer to FetchSeriesByAccessionNumber for details.
Prototype
[id(20)] long FetchSeriesByStudyUID(BSTR StudyUID, BSTR SeriesUID);
Functionality
Fetch series based on StudyUID.
Parameters
StudyUID StudyInstanceUID of the study.


<URLRequest
User="username"
Pass="password"
Method="FetchSeriesByAccessionNumber"
/>
72 VPMC-08370E Interfaces to Open Series for Third Party Integration

CAUTION: For the FetchSeriesBy APIs to work, you must install the VIMS Gateway Web Service on the ECF
Server. This is required for the DICOM Query/Retrieve stage to operate correctly. If the VIMS Gateway Web
Service is not installed, the URL call will fail. Complete the procedure listed below.
To Install the VIMS Gateway Web Service on the ECF Server

1 Navigate to the ViTALConnect Setup folder.
2 Double click the VIMS Gateway folder.
3 Double click the VimsGateway.msi file.
The VIMS Gateway Web Service wizard dialog box displays.
4 Click Next and choose the default values.
4. FetchSeriesByAccessionNumber
Description
Remote retrieve is supported for this interface. It works like OpenSeriesByAccessionNumber, except that Client
will close automatically when the command is done.
Prototype
[id(21)] long FetchSeriesByAccessionNumber(BSTR AccessionNumber, BSTR SeriesUID);
Functionality
Fetch series based on AccessionNumber.
Parameters
AccessionNumber AccessionNumber of the study.


<URLRequest
User="username"
Pass="password"
Method="FetchSeriesByStudyUID"
StudyUID="studyuid"
/>
5. Open Snapshot
Description
Remote retrieve is supported for this interface. It works like OpenSeriesByStudyUID, except that VC will load the
snapshot image and restore the snapshot.

Prototype
[id(22)] long OpenSnapshot(BSTR StudyUID, BSTR ImageUID, short studyMode);
Functionality
Opens a snapshot in ViTALConnect based on parameters passed in.
Parameters
StudyUID StudyInstanceUIDof the study.

ImageUID SOPInstanceUID of the key (or snapshot) image.
studyMod The mode to enter view.
Valid input:

<URLRequest
User="username"
Pass="password"
Method="OpenSnapshot"
StudyUID="studyuid"
ImageUID="imagesuid"
/>
Login and Authentication

The ViTALConnect Third Party Integration interfaces allow a site to specify user account using a variety of
mechanisms. Uniquely identifying the originating user provides the following benefits:
• User Preferences: Customized user preferences will be maintained by user.

• Identification/Auditing: The specified user will be identified in features such as “email to clinician”, and in
the ViTALConnect study statistics and logging.
• Security: The user will be authenticated using appropriate credentials for your enterprise.
Note that the simplest integration uses a single, global user account for all requests. This may work for initial
test, or a small user base, but it is strongly recommended that either an LDAP or Alternate 3rdParty
authentication integration be implemented to achieve the full benefits.
The ViTALConnect Third Party Integration interfaces provide multiple mechanisms for authentication of the
request to suit different deployment and integration scenarios. Additionally, an encryption service is available
to protect credentials from being transmitted as a “clear text” URL (see “Encrypting the XML with Secure URL
Builder”) which is an important consideration when deploying an integrated solution for ViTALConnect for WAN
users (e.g. teleradiology).
74 VPMC-08370E Login and Authentication

No Authentication:
In the case that no extra authentication is required, omit the User and Pass XML attributes from the request. In
ViTALConnect server administration web pages, in the ViTALConnect Image Server Configuration page, you will
need to select a “proxy” account for these requests. (You may wish to create a new account specifically for this
purpose, e.g. “URLuser”.) Enter the account information in the Built-in Account for 3rd Party Interface: user
name and password, and press save.
All requests sent without User and Pass attributes will now use the account specified for authentication.
NOTE: If you are prompted to login, confirm that the “Force User Login” on the LDAP Integration is not checked.
Example:
<URLRequest Method="FetchSeriesByAccessionNumber" AccessionNumber="accessionnumber"
SeriesUID="seriesuid" StudyMode="studymode" />
Authenticate Using ViTALConnect User Database:
To authenticate a request against a the ViTALConnect User Database, insert the username and password into
the User and Pass XML attributes when you are forming the URL. If you intend to have all requests contain this
authentication information, you may clear the entries in the Built-in Account for 3rd Party Interface
administration page to disable the use of a “proxy” account when no User and Pass attributes are present (and
an request missing these fields will be fail authentication and be rejected.)
Example:
<URLRequest User="username" Pass="password" Method="FetchSeriesByAccessionNumber"
AccessionNumber="accessionnumber" SeriesUID="seriesuid" StudyMode="studymode" />
Authenticate Using LDAP or AD (ActiveDirectory):
If you are using an OpenLDAP or AD authentication service in your enterprise, and LDAP Integration has been
enabled on the ViTALConnect server (see “LDAP Integration”), you may specify this information by adding the
attribute Domain, e.g. Domain=“HEALTHNET”. You may optionally include the Pass attribute, if you wish to
provide a single-sign-on request. If the Pass attribute is omitted, you will be prompted to input your password. If
the specified domain is configured on the ViTALConnect LDAP Domain List, the credentials will be authenticated
using the specified server.
Example:
<URLRequest Domain="domain" User="username" Pass="password"
Method="FetchSeriesByAccessionNumber" AccessionNumber="accessionnumber"
SeriesUID="seriesuid" StudyMode="studymode" />
Alternate 3rd Party Authentication:
For some solutions, identity management may be provided by some other 3rd Party application or service (e.g.
an established PACS provider.) To support this scenario, the request can provide information to use an external
authentication provider by passing an AuthenticationURL attribute (containing the URL and associated
Login and Authentication VPMC-08370E 75

credentials) to a web site hosting the external authenticator. When ViTALConnect receives the request, it will
authenticate by invoking the AuthenticationURL, and checking the returned value.
To Authenticate against Third Party Authentication Server, authentication parameters should be specified in the
request xml - refer to the "Building the Request XML String" section on page 68 for details. All the parameters
listed are required.
When third party interfaces invoked, ViTALConnect Server will request the Authentication URL to validate the
session. The third party authenticate server should return a xml as the following:
<?xml version="1.0" ?>
<Result>
RETURN_VALUE
</Result>
RETURN_VALUE can be "Yes" for valid and "No" for invalid. The strings "Yes", "No" are case-insensitive when
ViTALConnect interpreting it.
If the session is valid, ViTALConnect will give the authenticated user (valid session) "Radiologist" privilege and
automatically generate a username based on the user information parameters (First Name, Last Name, Email
and so on). The user preference in ViTALConnect will be kept in ViTALConnect Server. When the user with same
user information invoke the third party interfaces again, saved user preference will be applied.
If the session is invalid, the following Error Page displays:
FIGURE 4. Image Server Configuration Error Message
Example:
<URLRequest AuthenticationURL="http://localhost/ThirdPartyAuthenSvr.asp?
fun=IsValidSession&forSessionID=1234567890'"
Vendor="McKesson" SessionID="1234567890" Method="FetchSeriesByAccessionNumber"
SeriesUID="seriesuid" StudyMode="studymode" FirstName="Mckesson" LastName="Vital"
Email="adm@sina.com"/>
76 VPMC-08370E Login and Authentication

2D Configuration Settings
This chapter contains the following information:
• Image Compression Overview

• Compression Ratios
• Prefetching
• Dialiing into ViTALConnect
• Background Image Streaming - User Level
• 2D Configuration Scenarios - presents a few common client configuration scenarios.
Image Compression Overview

As images are received by the ViTALConnect server they are automatically compressed using numerous layers.
These various levels allow ViTALConnect to display an image with progressively increased quality.
When configuring the system, a site will decide the quality level for initial display of the image as well as an
additional quality levels that will subsequently be displayed. For example, on a Wide Area Network (WAN) a site
might choose to display images with a diagnostic-quality compression without any further upgrades. On a Local
Area Network (LAN), the same site might configure the system to launch with diagnostic lossy data and
immediately upgrade to full-fidelity images (no user interaction required). These decisions are determined by
rules in the system known as interactive prefetch rules. Interactive prefetch rules are designed to allow sites to
configure viewing behavior around several environmental factors:
• LAN vs. WAN

• Modality
Based on these factors, the user can decide which compression levels are suitable for viewing.
For instance, sites that require only lossless viewing can alter their rules so that only the lossless image is ever
seen by the radiologist. It also allows sites to make their own determination as to what constitutes “diagnostic-
quality” lossless.
Compression Ratios
This section contains the following topics:
• Overview
• Setting the compression ratios
• Adding a Compress Ratio for an image type not listed
• Modifying a Compress Ratio Definition
• Removing a Compress Ratio Definition
Image Compression Overview VPMC-08370E 77

Overview
Each modality (e.g., CT, MR, etc.) has a specific Low and High compression ratio associated with it.
The higher the compression ratio, the more the image will be compressed. However, the more an image is
compressed, the more the visual quality worsens.
EXAMPLE: An image that is compressed at 30:1 will upload quicker across a LAN or WAN than an image that is
compressed at 10:1. However, the 10:1 image will have a much better visual quality.
As Administrator, you must define the common compression levels desired by the ViTALConnect users at your
location. If the users have a low bandwidth environment, they may want to receive low quality images at a fast
speed. If the users do not care about image quality, you can set the Low and High compression levels at 60:1
and 30:1 for example.
When you configure a ViTALConnect server, you define two compression levels: one for “review” and one for
“diagnostic compressed”. As the images arrive to the server, ViTALConnect creates three copies of the images:
one at review level, one at diagnostic compressed level, and one at full fidelity. Users can configure the server
to “stream” the images to them. For instance, a user can choose to receive the review version and then receive
the full fidelity images.
When an administrator changes these levels, it only impacts “new studies”. For example, if study A gets stored
as review compression of 30:1 and the user has configured his system to get “review” compressed images. A
year later the administrator changes review to mean 16:1. Study B arrives to the system and is compressed at
16:1 as per the new definition of review. Study A is still sent to the client at the old review meaning of 30:1.
Setting the compression ratios

To set the compression ratios
1. Log into the ViTALConnect Server Management System and select ECF Management.
FIGURE 1. ViTALConnect Server Management System
78 VPMC-08370E Compression Ratios

The ViTAL ECF Management menu displays:
FIGURE 2. ViTAL ECF Management Menu
2. Select Compress Ratio.

The Compress Ratio screen displays:
FIGURE 3. Compress Ratio screen
Compression Ratios VPMC-08370E 79

The Compress Ratio allows you to modify the compression ratio for existing modalities. The default modalities
are CT, MR, NM, and PT.
You can also add a modality and define its default compression ratios or remove a specific modality from the
Compress Ratio .
Recommended Compression Level Defaults

Vital Images recommends the following compression level defaults for four common modalities:
TABLE 1. Recommended Compression Level Defaults
Modality Low High
Computed Tomography (CT) 10 30
Magnetic Resonance (MR) 10 30
Nuclear Medicine (NM) 10 30
Position Emission Tomogrophy (PET) 10 30
NOTE: The ratio must be greater than 20.
NOTE: The default compression ratio should be applied only when the compression ratio of a specific modality
is not defined. For example, if you enter 30, that means the default compression ratio will be 30:1.
NOTE: If the users value download speed greatly over image quality, you can set the Low and High values to 30
and 60 respectively.
3. Set the low and high compression ratio for each image type.
4. Set the default ratio to be used for all other images.
5. Click Save to save the values.
Adding a Compress Ratio for an image type not listed
To add a compress ratio for an image type not listed:

1. From the Compress Ratio, click Add.
The following screen displays.
FIGURE 4. Compress Ratio - Add
2. From the Modality: dropdown menu, select a modality type.

3. Enter a value greater than 20 in the Low: and High: fields.
4. Click OK.
80 VPMC-08370E Compression Ratios

The new modality displays on the Compress Ratio .
Modifying a Compress Ratio Definition

Complete this procedure if you want to change the Low and/or High values for a specific modality.
To modify a compress ratio definition:

1. From the Compress Ratio , enter a new Low and/or High value for the desired modality.
2. Click Save.
Removing a Compress Ratio Definition

Complete this procedure if you want to remove a specific modality from the Compress Ratio list.
To remove a compress ratio definition:
FIGURE 5. Compress Ratio
• From the Compress Ratio, select a Modality type and click Remove.
The corresponding definition is removed from the list.
Compression Ratios VPMC-08370E 81

Prefetching - Administrator Level

• Overview
• Enabling Prefetching
• Modifying upper compression levels for study prefetch
• Modifying upper compression levels for interactive prefetch
Overview
Prefetching is the ability to fetch images when a dataset is loaded in the background to optimize the user
experience. It is only beneficial for 2D reading mode. As Administrator, you enable prefetching on the system
level and then modify the prefetch capabilities for each user.
When prefetching is enabled, and a study is selected from the Study Directory, the images are cached into
memory. Depending on the compression ratio settings, images set to Low compression (default value of 10:1)
will load much faster than images set to High compression (default value of 30:1).
The section contains the following topics:
• Enabling Prefetching
• Modifying upper compression levels for study prefetch
• Modifying upper compression levels for interactive prefetch
Enabling Prefetching
For images to take advantage of prefetching, you must enable the prefetch capability.
To enable prefetching
1. Log into ViTALConnect as Administrator.
The ViTALConnect Study Directory displays.
FIGURE 6. ViTALConnect Study Directory
82 VPMC-08370E Prefetching - Administrator Level

2. Click along the top of the .

The User Preferences ViTALConnect Preference screen displays.
FIGURE 7. User Preferences ViTALConnect Preference Screen
3. In the left panel, under the System heading, click Background Image Streaming.
The User Preferences Background Image Streaming displays.
FIGURE 8. User Preferences Background Image Streaming screen
NOTE: The LAN tab is selected by default. You can only enable prefetching for a LAN environment.
4. Check the Allow user to do study level prefetch box. This allows you to globally indicate that users are
allowed to do study prefetching.
Prefetching - Administrator Level VPMC-08370E 83

5. Check the Allow user to use disc cache box. This allows the local disc to store the fetched images. If at any
time a user wants to review these images again, they will be loaded from the local disc instead of server.
6. Click Save.
Settings for prefetch entire study

Overview
You can globally set that users are allowed to use study prefetching. You can also can set the upper
compression levels for various modalities to prefetch study in both LAN mode and WAN mode.
Listed below are three compression levels. Each level has a different compression ratio for each 2D image.
• Review - The lowest compression level for a lossy compression which has higher compression ratio.
• Diagnostic Compressed: The middle compression level for a lossy compression which has lower
compression ratio.
• Lossless Compression: The highest compression level for the lossless compression. This is the default
compression level for ViTALConnect image transfer.
Editing a Compression Level
NOTE: The default Modality is CT and its corresponding default Level is set to Lossless.
1. Navigate to the User Preferences Background Image Streaming.
2. In the Upper compression levels for prefetching a study, select a modality to edit and click Edit.
The Upper Compression Level for study prefetch screen displays.
FIGURE 9. Upper Compression Level for study prefetch screen
3. Select either Review, Diagnostic Compressed, or Lossless Compression.

4. Click OK.
5. Click Save.
Settings for interactive prefetch

Overview
Interactive Prefetch is the ability to fetch images when a user interacts with images in the background to
optimize the user experience. Two levels of images (Low level and High level) should be fetched for each slice
during user interaction. The low level image should be fetched at first, and then the high level image. But if the
high level image is already fetched due to some reason, such as image is fetched by study prefetching, then the
low level image will not be fetched.
84 VPMC-08370E Prefetching - Administrator Level

This procedure allows you to set the global setting for interactive prefetching. You can set the upper
compression levels (both low level and high level) for various modalities to do interactive prefetching in both
LAN mode and WAN mode.
NOTE: The default Modality is CT , with a default Low Res. level is set to Diagnostic , and its corresponding
default High Res. Level is set to Lossless.
1. On the User Preferences Background Image Streaming , in the Upper compression levels for interactive
prefetch, select a modality to edit and click Edit.
The Upper Compression Levels for study prefetch screen displays.
FIGURE 10. Upper Compression Levels for interactive prefetch screen
2. Select either Review, Diagnostic Compressed, or Lossless Compression for Low Res.
3. Select either Review, Diagnostic Compressed, or Lossless Compression for High Res.
4. Click OK.
5. Click Save.
Dialing into ViTALConnect

You have two options available to you:
• 2D At Home
• 2D Over a Network
Dialing into ViTALConnect VPMC-08370E 85

2D At Home
FIGURE 11. ViTALConnect Study Directory
1. In the lower right corner of the ViTALConnect Study Directory , left mouse click the icon.
The folllowing screen displays:
FIGURE 12. Icon Menu
2. Select Enterprise Mode. Your images will load at a slower speed (4MB) than those loaded over a network.
2D Over a Network
1. In the lower right corner of the ViTALConnect Study Directory , left mouse click the icon.
The Icon Menu (shown above) displays.
2. Select Local Network. Your images will load at a higher speed (20MB) than those loaded using Enterprise
Mode.
Background Image Streaming - User Level

• Accessing the User Preferences Background Image Streaming

• Compression levels for prefetching a study
• Compression levels for interactive prefetch
• Use best quality image available for display
86 VPMC-08370E Background Image Streaming - User Level

Accessing the User Preferences Background Image Streaming
1. From the ViTALConnect Study Directory , click along the top of the .
The User Prefernces ViTALConnect Preferences screen displays.
2. In the left panel, under the user heading, click Background Image Streaming.
The User Preferences Background Image Streaming screen displays.
FIGURE 13. User Preferences Background Image Streaming screen
Settings for prefetch entire study

1. On the User Preferences Background Image Streaming , in the Settings for prefetch entire study, select a
modality to edit and click Edit.
The Compression level for study prefetch screen displays.
FIGURE 14. Compression level for study prefetch screen
Background Image Streaming - User Level VPMC-08370E 87

2. Select either Review, Diagnostic Compressed, or Lossless Compression.

3. Click OK.
4. Click Save.
Settings for interactive prefetch

1. On the User Preferences Background Image Streaming , in the Settings for interactive prefetch, select a
modality to edit and click Edit.
The Compression Levels for interactive prefetch screen displays.
FIGURE 15. Compression Levels for interactive prefetch screen
2. Select either Review, Diagnostic Compressed, or Lossless Compression for Low Res.
3. Select either Review, Diagnostic Compressed, or Lossless Compression for High Res.
4. Modify the value in the Number of Slices field. 20 is the default value.
5. Click OK.
6. Click Save.
88 VPMC-08370E Background Image Streaming - User Level

Appendix A: Upgrading ViTALConnect

Hardware Configuration Settings
Switching patient data from a non-shared drive to a shared drive

This section explains how to manage migrating ECF from using a non-shared drive to a shared drive. You would
complete this procedure when you use the hard drives on a server and set up a DAS or SAN to store ECF and
DICOM volume data.
To switch data from a non-shared drive installation to a shared drive installation

Complete this procedure to switch the data from a non-shared drive (such as C:\vitreadata) installation to a
shared drive installation for ECF (such as \\machinename\VitreaData).
1. On the new device, make a folder called VitreaData on the volume that you want to store all of the data.
2. Right-click the VitreaData folder and select Sharing.
3. Name the folder appropriately and set the security permissions.
4. Uninstall ECF on the Primary server.
5. Reboot the Primary server.
6. Reinstall ECF using the ViTALConnect CD. Use the share drive \\machine1\VitreaData (created in step 2
above) as the data drive (reboot if instructed by install program).
7. Double-click the blue “V” on the task bar. The VICommunicator screen displays.
FIGURE 1. VICommunicator screen
Switching patient data from a non-shared drive to a shared driveVPMC-08370E 89

8. Click the Volume icon on the left panel. The VICommunicator Admin screen displays.
FIGURE 2. VICommunicator Admin screen
9. Verify the paths in all of the fields.

10. Click OK.
11. Copy the vitreadata\patients files from the old data directory to the new one.
NOTE: Depending on the amount of patient data, this step could take a long period of time.
12. After the patient files are copied, open ViCommunicator on the Primary server and navigate to Patient
Management.
13. Click Rebuild to rebuild the database.
90 VPMC-08370E Switching patient data from a non-shared drive to a

ViTALConnect version 4.1.5 Server Installation Instructions
Appendix B: ViTALConnect 4.0 URL

Integration - To Be Deprecated in a
Future Release
Overview
CAUTION: This version of URL Integration is still supported in ViTALConnect 4.1.5. This document will be
deprecated in a future release of ViTALConnect.
Traditionally, separate systems working independent of each other provide key components within a diagnostic
imaging department. For example, Picture Archiving and Communications Systems (PACS) are used as the
primary means for diagnostic image review; while specialized post processing applications such as ViTAL
Connect are often purchased to compliment the PACS workstation by providing high end 3D reconstruction
functions.
In an effort to redesign the traditional workflow to interpret diagnostic exams, Vital Images has introduced
Uniform Resource Locator (URL) integration capabilities for ViTALConnect 4.0.1.0. URL based integration assists
in the consolidation of the traditionally heterogeneous applications used throughout the diagnostic imaging
department within a single desktop interface; reducing the need for additional Personal Computer (PC)
hardware and improving workflow for the physician.
As most PACS, EMR, RIS, and other healthcare technology vendors have native capabilities to dynamically
generate an "in context" URL for integration purposes, the ViTALConnect URL integration capability facilitates a
simple mechanism for:
• Enabling third party applications with intuitive access to real-time images, a crucial part of the patient's
medical history. 3D, MPI, and MPR tools are launched directly from the EMR with a single button click or
menu selection.
• Snapshot restore capabilities.
• Direct access, with single sign on , to the ViTALConnect visualization tools, dramatically reducing reading
turnaround time while maintaining user productivity.
• Consolidation of clinical applications on a single workstation in the reading room.
• Automatic transfer of study identifiers to ViTALConnect to begin 3D post processing "in context."
Eliminating error-prone manual input of image identifiers in multiple applications.
Interfaces to Open Series for URL Integration

There are five interfaces provided by ViTALConnect control to open series directly.
1. OpenSeriesByAccessionNumber
Description
Prototype
[id(16)] long OpenSeriesByAccessionNumber(BSTR AccessionNumber, BSTR SeriesUID, short StudyMode);
Functionality
Opens a series in 2D/3D mode in ViTALConnect based on Accession number and series UID.
Parameters
AccessionNumber: AccessionNumber of the study.

SeriesUID; SeriesInstantUID of the series.
studyMode: The mode to enter view.
Valid input:
0: MULTISLICE, it means entering 2D view.
2: VOLUMERENDER, it means entering Volume Rerendering 3D mode.
URL based call:

http://VCServer/Default.asp?UserName=username&Password=password&MethodName=
OpenSeriesByAccessionNumber&AccessionNumber=accessionnumber&SeriesUID=seriesuid&StudyMode=
studymode
On the client side, a message box prompts the user that the series is scheduled to transfer from archive server.
After clicking OK, the Q/R Status window displays:
This window indicates how many tasks are scheduled and how many tasks are finished.
• Right click on the window and select “Show Main Window” menu item to display detail information.
92 VPMC-08370E Interfaces to Open Series for URL Integration

After the series is transferred to local server, message box displays:
• Click Yes to open the series and enter view.

• If SeriesUID is not specified, a dialog with all 3D capable series listed will popup for user to choose one.
Interfaces to Open Series for URL Integration VPMC-08370E 93

2. OpenSeriesByStudyUID
Description
Remote retrieve is supported for this interface. * Refer to OpenSeriesByAccessionNumber for details.
Prototype
[id(19)] long OpenSeriesByStudyUID(BSTR StudyUID, BSTR SeriesUID, short studyMode);
Functionality
Opens a series in 2D/3D mode in ViTALConnect based on StudyUID.
Parameters
StudyUID AccessionNumber of the study.

SeriesUID SeriesInstantUID of the study. Optional.
studyMod: The mode to enter view.
Valid input:
URL based call:

http://VCServer/Default.asp? UserName=username&Password=password&MethodName=
OpenSeriesByStudyUID&StudyUID=studyuid&SeriesUID=seriesuid&StudyMode=studymode
3. FetchSeriesByAccessionNumber
Description
Remote retrieve is supported for this interface. It works like OpenSeriesByAccessionNumber, except that Client
will close automatically when the command is done.
Prototype
[id(21)] long FetchSeriesByAccessionNumber(BSTR AccessionNumber, BSTR SeriesUID);
Functionality
Fetch series based on AccessionNumber.
Parameters
AccessionNumber AccessionNumber of the study.

URL based call:

FetchSeriesByAccessionNumber&AccessionNumber=accessionnumber&SeriesUID=seriesuid

4. FetchSeriesByStudyUID
Description
Remote retrieve is supported for this interface. * Refer to FetchSeriesByAccessionNumber for details.
Prototype
[id(20)] long FetchSeriesByStudyUID(BSTR StudyUID, BSTR SeriesUID);
Functionality
Fetch series based on StudyUID.
Parameters

URL based call:

FetchSeriesByStudyUID&StudyUID=studyuid&SeriesUID=seriesuid
5. Open Snapshot
Description
Remote retrieve is supported for this interface. It works like OpenSeriesByStudyUID, except that VC will load the
snapshot image and restore the snapshot.
Prototype
[id(22)] long OpenSnapshot(BSTR StudyUID, BSTR ImageUID, short studyMode);
Functionality
Opens a snapshot in ViTALConnect based on parameters passed in.
Parameters

ImageUID SOPInstanceUID of the key( or snapshot )image.
studyMod The mode to enter view.
Valid input:
URL based call:

OpenSnapshot&StudyUID=studyuid&ImageUID=imagesuid
Interfaces to Open Series for URL Integration VPMC-08370E 95

Notes for Using 3rd Party Interfaces

1. To use the URL based call, replace the parameter parts (after =) with corresponding parameters. Those
parameters are case sensitive.
2. In addition, you can specify user information in the URL, including Domain, UserName and Password. These
informations should be Base64 encoded.
And you can choose the following formation:
• All Domain, UserName, Password specified

Means 3rd part interface wants to login in as specified LDAP user and authenticate it with the password
provided.
• Domain and UserName
Means 3rd part interface wants to login in as specified LDAP user but do not want authenticate it.
• UserName, Password
Means 3rd part interface wants to login in as specified local user and authenticate it with the password
provided.
• None of the three.
For this case, if the "Built-in Account for 3rd Part Interface account" is set and "Force User Login" is
disenabled, ViTALConnect will use the built-in account to login. Otherwise, user should input login
information and click "Sign in" button to logon in the login web page.

Appendix C: Using 3D Presets and

Anatomy Protocols
Overview
When you load a volume or study, ViTALConnect selects an anatomy protocol based on the study description.
The protocol changes the color, opacity, and window/level to highlight relevant data elements for that exam
type. The default protocols are starting points; you can change the protocol to suit the exam type by selecting a
new one from the 3D Options pulldown menu.
ViTALConnect protocols and associated presets were developed by a leading institution in clinical radiology and
represent some of the foremost expertise in computer viewing of scanned images in the world today. However,
it is important that you regard each protocol and its views as a convenient starting point. As such, each protocol
may not necessarily provide the optimal viewing settings for any particular volume. For this reason,
ViTALConnect provides controls for fine-tuning each image.
Anatomy Protocol Assignment

The table below describes how ViTALConnect automatically selects an anatomy protocol based on the modality
and study description contents.
TABLE 1. Anatomy Protocol Assignment
Modality Study Description Default Protocol
MR Blank Generic
Body MRA Body

Thoracic
Abdominal
Liver
Breast Breast
CW MRA Head
COW
Head
Carotid
Brain
Periph Periphal
TABLE 1. Anatomy Protocol Assignment
Modality Study Description Default Protocol
CT Blank Generic
Ankle Bone
Bone
Knee
Shoulder
Wrist
CTA Carotid Carotid

Carotid
CACT
Lung Lung
Bronch
Nodule
Head Head
COW
CTA COW
Coronary Coronary
Heart CTA
Cardiac Angio
Cardiac CTA
AA
Cardiac
CW Renal
Renal
Donor
Colon
Airways
Periph Peripheral
AAA
PT Blank PET
98 VPMC-08370E Anatomy Protocol Assignment

Picking an Anatomy Protocol

You can keep the system-assigned anatomy protocol, or select a different one.
To select a protocol:
1. Click (if not already in 3D mode).

The Viewer changes to a 4-up, 3D mode.
2. From the 3D Options dropdown menu on the Visual tab, select the desired Anatomy Protocol from the
dropdown menu.
The presets associated with the selected protocol display as thumbnail preview images, as applied to the
3D image:
3. Double-click the preset that best presents the exam type.

The settings are applied to the 3D image.
Picking an Anatomy Protocol VPMC-08370E 99

100 VPMC-08370E Picking an Anatomy Protocol

VPMC-08370E ViTALConnect 4.1.5 Administration Guide PDF

Загружено:

Сведения о документе

Оригинальное название

Авторское право

Доступные форматы

Поделиться этим документом

Поделиться или встроить документ

Параметры публикации

Этот документ был вам полезен?

Это неприемлемый материал?

Авторское право:

Доступные форматы

VPMC-08370E ViTALConnect 4.1.5 Administration Guide PDF

Загружено:

Авторское право:

Доступные форматы

4.1.

Server Administration Guide

VPMC-08370E ViTALConnect version 4.1.5 Server Administration Instructions (06/2008)

Restricted Rights Legend

Limits of Liability and Disclaimer of Warranty

Software License Notice

About This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

ViTALConnect Image Server Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Configuring the Client FTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

ViTALConnect System Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Vital ECF Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Setting the Compress Ratio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Load Balance Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Third Party Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Sample URL Invocations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Appendix A: Upgrading ViTALConnect Hardware Configuration Settings . . 89

Appendix B: ViTALConnect 4.0 URL Integration - To Be Deprecated in a Future

Appendix C: Using 3D Presets and Anatomy Protocols . . . . . . . . . . . . . . . . 97

About This Document

Purpose and Scope

How This Guide is Organized

• ViTALConnect Image Server Configuration (Chapter 2)

Purpose and Scope VPMC-08370E 1

Before You Begin

• System Administration user name and password

Configuring the System

ViTALConnect system configuration consists of the following components:

• Configuring ECF (DICOM server)

2 VPMC-08370E Before You Begin

Accessing the Server Management Pages

To access the ViTALConnect Server Management System menu:

TABLE 1. Login and Password Description

Accessing the Server Management Pages VPMC-08370E 3

FIGURE 1. The ViTALConnect Server Management Menu System Diagram

ViTALConnect Server Management System

ViTALConnect Image Server Configuration

ViTALConnect Image System Management ECF Management Load Balance

• Send an email to support@vitalimages.com.

ViTALConnect Image Server

• Configuring ViTALConnect 4.1.5 SSL

Accessing the ViTALConnect Image Server Configuration Page

To access the ViTALConnect Image Server Configuration page

Access the ViTALConnect Server Management System menu:

TABLE 1. Login and Password Description

The ViTALConnect Server Management Menu displays.

FIGURE 1. ViTALConnect Server Management System Menu

FIGURE 2. ViTALConnect Server Configuration - Main Server Page

6 VPMC-08370E Accessing the ViTALConnect Image Server Configura-

Main Server Page

To configure basic Image Server settings (Main Page):

ViTALConnect Server Verify the default 8888.

Configuring ViTALConnect 4.1.5 SSL

Main Server Page VPMC-08370E 7

Responsibility for SSL Management

WAN Network Speed

Valid SSL Certificate

Power Supply for ViTALConnect server

8 VPMC-08370E Configuring ViTALConnect 4.1.5 SSL

Secure Socket Layer Configuration and Policies

The Benefits of SSL

• Allows client to securely access ViTALConnect from the public network.

Obtain an SSL Certificate

Thawte and VeriSign are commonly used vendors of SSL certificates.