IMPAX 6.
Copyright information © Copyright 2007 Agfa-Gevaert N.V., B-2640, Mortsel, Belgium. All rights reserved. No parts of this document may be reproduced, copied, translated, adapted, or transmitted in any form or by any means without prior written permission of Agfa-Gevaert N.V. Trademark credits Agfa, the Agfa rhombus, and IMPAX are trademarks or registered trademarks of Agfa-Gevaert N.V., Belgium or its affiliates.
• The electrical installation of the site in which the equipment is used is according to an applicable safety standard (UL, CSA, or IEC/CDE). • The equipment is used according to the instructions provided in the operation manuals. Additional documentation This guide is intended for service and administrative personnel who are installing or upgrading, configuring, and maintaining the server components of the IMPAX 6.3 system.
Contents 1 Summary of IMPAX AS300 Server configuration steps 6 Configuring IMPAX on an AS300 single-host server ........................................ 6 Configuring IMPAX on a dedicated AS300 Database Server ........................... 7 Configuring IMPAX on an AS300 Archive Server ............................................. 7 Configuring IMPAX on an AS300 Network Gateway ........................................
Configuring Scavenger ................................................................................... 29 IMPAX services that can write to the LOGS partition on Archive Servers and Network Gateways ......................................................................................... 29 Updating the IMPAX Server log file locations ........................................ 30 Creating IPSEC filters to allow access to specified hosts .............................. 31 Installing and configuring Curator ..
Summary of IMPAX AS300 Server configuration steps 1 The following provides an overview of all steps required to configure an IMPAX AS300 Server. Details are provided in subsequent chapters. Configuring IMPAX on an AS300 single-host server To configure the single-host server, perform the tasks listed in the table that follows.
Action If required, change the default Curator INI settings (refer to page 19) Configuring IMPAX on a dedicated AS300 Database Server You must configure the Database Server in the order listed in the table that follows. For more complete instructions, refer to Configuring an AS300 single-host Server or dedicated Database Server (refer to page 9).
Configuring IMPAX on an AS300 Network Gateway You must configure the Network Gateway in the order listed in the table that follows. For more complete instructions, refer to Configuring the Archive Server or Network Gateway (refer to page 22).
Configuring an AS300 single-host Server or dedicated Database Server 2 After you have installed the necessary IMPAX packages on an AS300 single-host or AS300 Database Server and have installed the Application Server, configure the system components for initial use. If the database is an Oracle Database Server on a Solaris host (in a mixed-host configuration), refer to the IMPAX 6.3 AS3000 Installation and Configuration Guide instead.
CAUTION! If backups are not created on a regular basis, the transaction log fills up and eventually halts the operation of your system. To back up a database using the Enterprise Manager 1. Select Start > All Programs > Microsoft SQL Server > Enterprise Manager. 2.
5. In the Jobs dialog, right-click schedule_backup and select Properties. 6. Switch to the Schedules tab. 7. Click New Schedule. 8. In the New Job Schedule dialog, in the Name field, type Daily Backup. 9. To change the default weekly recurrence, click Change. 10. In the Edit Recurring Job Schedule dialog, under Occurs, select Daily. 11. If required, change the default time under Daily Frequency using the Occurs Once at option. 12. To apply the change, click OK. 13.
13. To exit the setup dialog, click OK. 14. Close the ODBC Data Source Administrator dialog. Logging into the Administration Tools Many IMPAX Server configuration tasks must be performed in the Administration Tools. This topic explains how to log into the Administration Tools. A valid user ID and password are required. Note: Passwords are case-sensitive; PASSWORD is not the same as password. To launch the Administration Tools locally 1.
Identifying remote PACS in IMPAX This topic applies only to a dedicated Database Server. When installing a new IMPAX 6.3 cluster, the database is automatically updated with the details for all Archive Server, Network Gateway, Curator, and CD Export server components within the cluster. These do not have to be configured as stations in Network Management. By contrast, any PACS systems external to the IMPAX cluster must be added as stations using Network Management in the Administration Tools.
Understanding IMPAX image and web caches When images are sent into IMPAX from an acquisition station or retrieved from an archive, they must be stored temporarily in an accessible location. This temporary storage area is called a cache. A cache is a set of directories on local or external hard disks. IMPAX supports two types of caches: image and web. The image cache contains what in the IMPAX Client is called original images—the images as they are sent from the acquisition station.
• When creating a cache on a Windows system, do not use a trailing slash or backslash at the end of the volume path. For example, when creating an image cache, do not type \\server\f$\CACHE1\; instead, use \\server\f$\CACHE1. Defining the cache volume with a trailing slash or backslash can cause problems in retrieving images from the cache. • If Curator and Network Gateway components are installed on the same server, all caches on the system (image and web) must be shared.
Configuring the default log file location When IMPAX was installed, the operational log files location is set to C:\mvf\data\logs. If you have created a separate log file partition as outlined in the IMPAX 6.3 AS300 Installation Guide, you may want to update the default logging location to write to that partition. Note: The subdirectory must exist before logs are written to that path.
Updating the IMPAX Server log file locations Ensure that you have noted or referenced which IMPAX services are to be modified. To update the IMPAX log file locations 1. Select Start > Administrative Tools > Services. 2. For each service to be updated: a. Right-click the service and select Properties. b. Under Service status, click Stop. c. In the Start parameters field, type: -f For example, -f g:\log\mitra.log. d. To restart the service, under Service status, click Start. e.
Creating IPSEC filters to allow access to specified hosts The IMPAX security policy blocks some TCP ports used to communicate with hosts outside the IMPAX cluster. If you are connecting to other hosts, such as a domain controller or proxy server, create IPSEC filters to allow IMPAX to access the host. The filter allows all traffic to and from the host on all ports.
Wizard Screen Options Example: Open access to the domain controller 3. Ensure that Use Add Wizard is enabled. 4. Click Add. The IP Filter Wizard is launched. IP Filter Wizard IP Filter Description and Mirrored property 1. Add an appropriate description. Example: Open Access to the Domain Controller 2. Enable Mirrored. IP Filter Wizard IP Traffic Source 1. From the Source address list, select My IP Address. IP Filter Wizard IP Traffic Destination 1.
If you have installed Curator on a single-host, Archive, or Network Gateway server, configure the Curator settings. The Curator settings control how all Curators process images for the web cache. Although the Curator settings do not exist in the map_ini table when the system is first installed, the default behavior applies. To change the default behavior to suit your site, add the appropriate settings and values. To configure Curator INI settings 1.
ini_key Default Description of possible values value COLLECT_PERFORMANCE_ T METRICS T—Collect performance metrics on prepare jobs and store them in map_job_metrics table. F—Do not collect performance metrics. The following metrics are recorded in the map_job_metrics table: • SERVICE_REF—Service ref of the curator process that handled the prepare job. • NUM_OBJECTS—Number of objects in the study being curated. • STAT1—Number of frames that were curated. • STAT2—Input size of study in MB.
Configuring the Archive Server or Network Gateway 3 After you have installed the necessary IMPAX packages on the Archive Server or Network Gateway, the system components can be configured for initial use. Configuration must be performed after the IMPAX Server software and the Application Server software is installed. For procedures and information on how to configure the IMPAX system using the Administration Tools, refer to the Administration Tools component of the IMPAX 6.3 Server Knowledge Base.
PACS Store and Remember Archiving is also known as PACS Archiving. To set up PACS Store and Remember archiving 1. Obtain and install (refer to page 23) an archive license key on the PACS Store and Remember archive server. 2. Add the PACS Store and Remember archive in Network Management (refer to page 23). 3. Register the PACS Store and Remember archive services (refer to page 24). 4. Test the PACS Store and Remember archive functionality (refer to page 24).
6. In the Host field, type the hostname or IP address. 7. Click Save. 8. Switch to the Capabilities tab. 9. From the list at the bottom of the manager, select the external PACS archive. 10. Under Station Type, select PACS. 11. Under Server is Allowed to, select Query/Retrieve from Station. 12. Click Save. 14. Register the PACS Store and Remember archive services in Windows (refer to page 24).
To test store and retrieve functionality 1. Launch and log into the Administration Tools. 2. On the Daily tab, click Job Manager. 3. Ensure that a PACS Archive queue exists. 4. On the Daily tab, lick Study Manager. 5. Search for and select a study to store to the PACS Store and Remember archive. 6. To test the store functionality, click Store to Archive. 7. If you are using more than one archive, from the Archive list, select the PACS Store and Remember archive and click OK. 8.
This step is necessary because studies can be received from a machine that belongs to the PACS and that the PACS Store and Remember archive stores to and remembers from, but that is not the store or remember AE. Note: For the PAP to automatically register studies as PACS archived, at least one open PACS volume must exist. When a PACS Store and Remember archive is installed, ensure that it works by storing a study to the archive, then retrieving it back from the archive.
3. Change the study status from the default 'D'. By default, the PAP is configured to set the study status to 'D' (Dictated) if the incoming DICOM objects do not have the study status as part of the private tags. Details on how to perform each step follow. Note: As with any database change, signal the process that the database has been updated. In CLUI, type: signal database_updated 0 MVF_PAP. Or, stop and restart the affected process. To disable HIS verification 1. Log into CLUI. 2.
Where is the status set for incoming objects without a study status as part of their private tags. Configuring an HSM archive This topic applies only to an Archive Server, or to the Archive component of a single-host server (including standalone with archive and single-server configurations). If using an HSM archive, ensure that the mounted location is set up properly and is ready for storage and retrieval of files before HSM starts to store to or retrieve data from the mounted location.
2. At a command prompt, type: cd \mvf\bin config-disk-image.bat where is the new location for the VOLUMES partition, for example, E:\volumes. Configuring Scavenger This topic applies only to an Archive Server, or to the Archive component of a single-host server (including standalone with archive and single-server configurations).
Note: The subdirectory must exist before logs are written to that path. For the Archive Server, the following IMPAX services can be modified to write to the LOGS partition.
a. Right-click the service and select Properties. b. Under Service status, click Stop. c. In the Start parameters field, type: -f For example, -f g:\log\mitra.log. d. To restart the service, under Service status, click Start. e. To exit the Properties dialog, click OK. Note: You must start the service before exiting the Properties dialog; otherwise, your changes are not saved.
Wizard Screen Options Security Rule Wizard Tunnel Endpoint 1. Accept default selection, This rule does not specify a tunnel. Security Rule Wizard Network Type 1. Change to Local area network (LAN). Security Rule Wizard Authentication Method 1. Accept the default authentication method. Security Rule Wizard IP Filter List 1. Click Add. Security Rule Wizard IP Filter List 1. In the Name field, type an appropriate name for the filter. Example: Domain Controller Filter List 2.
Wizard Screen Options Security Rule Wizard IP Filter List 1. Click OK. Security Rule Wizard IP Filter List 1. Select the filter you just created. Example: Domain Controller Filter List 2. Click Next. Security Rule Wizard Filter Action 1. Select Impax Permit Action.
Troubleshooting A As you install or upgrade IMPAX servers, you may encounter various installation and configuration problems. Cannot connect to the Administration Tools Issues You cannot log into the Administration Tools. Details Two possibilities exist for this problem: • The Administration Tools service can encounter problems when you first attempt to log in. • The IMPAX Server tries to communicate with the Administration Tools over the default port range of 1200-1270.
To modify the default port range 1. To determine which ports are in use, at a command prompt, type netstat -a. 2. Ports within the 1200-1270 range with a state of LISTENING do not have to be modified. If you find that the ports within that range do not have a state of LISTENING: a. In a text editor, open C:\mvf\java\etc\jserver.properties. b. Search for jmtk.rmiPortRange=1200-1270. c. Modify the range to suit the needs of the site. d. Save the modified file. IMPAX 6.
Archiving considerations B IMPAX supports various types of archives. Types of archives A jukebox archive has one or more drives where media is loaded, multiple slots that hold the media for easy storage retrieval, and a robotic changer to move media around within the jukebox. Tip: For more details on archive functionality, refer to the Archive Server component of the IMPAX 6.3 Server Knowledge Base.
CD-R and DVD-R CD-R is a small, portable, round medium used to store information in digital form. DVD-R can store much more information than CD-R using the optical disk technology. CD-R and DVD-R archives use logical volumes. Logical volumes are valid archive locations independent of cache and media. They are not intermediate data structures used for staging data prior to burn and they cannot be manually deleted without risk of permanent data loss.
Glossary A CLUI acquisition station Command Line User Interface. A command line tool to help in the service of IMPAX. CLUI allows you to execute SQL statements. Any station that sends images to IMPAX. A station must be defined as an acquisition station in the Source Manager if the station is sending original acquisition images or third-party images into the IMPAX system. AE title Application Entity title of a DICOM station. This is a unique identifier within the network, assigned to the station.
E M external PACS archive master Curator A PACS archive that resides outside the IMPAX cluster. When using multiple Curators, the first Curator that runs, which owns the job queue. H MVF_SCU HIS Hospital Information System. The database used by a hospital to manage patient information and scheduling. A process that runs on the Network Gateway to handle store and retrieve jobs for the PACS Store and Remember archive.
PACS archived A status in the IMPAX system indicating that a study is stored on an external archive using PACS Store and Remember archiving. PACS Store and Remember archive An IMPAX server computer set up with the PACS Store and Remember archiving functionality. Usually has Network Gateway functionality. S SCP Service Class Provider. A DICOM server that receives requests from an SCU.
Index A accessing Knowledge Base ................................... 3 acquisition stations defining caches for .............................. 14 adding caches ................................................. 14 settings ............................................... 19 Administration Tools cannot connect ................................... 34 setting up PACS Store and Remember archive ............................................... 23 archive adding scavenger source .....................
I O image caches ............................................. 14 creating .............................................. 14 deleting images from .......................... 20 Impax Server Policy, modifying ............ 18, 31 INI settings, Curator .................................. 19 IPSEC filters ........................................ 18, 31 ODBC ........................................................ 11 opening Knowledge Bases .................................. 3 original images ..................
scheduling database backups .............. 10 starting Administration Tools ..................... 12, 34 stations caches for ........................................... 14 statistics, collecting for performance ......... 20 stopping Administration Tools .......................... 34 Store and Remember archiving ................. 25 strategies for configuring caches ............... 14 STUDY-SIMPLIFIED MAP signal, sending to Client ........................................................