AGFA IMPAX AS300 Installation Guide

AS300 Preparing to Upgrade GuideIMPAX 4.5, 5.2, 5.3,or WEB1000 to IMPAX 6.5.3Preparing to Upgrade an AS300 Clusteror to Migrate a WEB1000 Site to IMPA

IMPAX 6.5.1 included:• Improved speech synchronization in IMPAX Reporting• Instant Messaging to easily connect with colleagues• Validation of new spee

3. At the dsdbutil prompt, typeactivate instance AgfaHealthcare4. At the dsdbutil prompt, typeifm5. At the ifm prompt, typecreate full locationwhere l

Adjusting default toolbars, screen formats, andwindow level presets(Topic number: 6732)10.You can now customize the toolbars, screen formats, and wind

6Preparing the IMPAXdatabase and archivefor the upgradeYou must perform certain tests and backup tasks to prepare the IMPAX 5.2 or 5.3 Database andArc

To update study comments after upgrading to IMPAX 5.2 from IMPAX 4.51. Launch CLUI.2. TypeUpdate DOSR_STUDY set study_comments_utf8=study_comments whe

On Solaris, launch CLUI.2.Type select count(*) from map_event.3.On Windows, click Execute.4.Type select count(*) from map_event_audit.5.On Windows, cl

Identifying the report source(Topic number: 68030)5.When upgrading the database, you will be prompted for the report source. When prompted, supplythe

6.To start the backup, click OK.7. Exit the SQL Server Enterprise Manager.Saving the map_event_audit tables from anAS300 SQL Server database(Topic num

Backing up critical AS300 server files(Topic number: 147687)8.Prior to a forklift upgrade of an IMPAX AS300 Network Gateway, Archive Server, or Curato

mvf-check-cache -q d:\cache (Windows)A report and additional diagnostic messages are written to the log file.Note:If the cluster has only one local ca

For example:move_cmds.sh (Solaris)move_cmds.bat (Windows)Generating a report of lost images(Topic number: 58357)This procedure is designed to be run o

IMPAX 6.2 built on the IMPAX 6.0 foundation to deliver new mammography and user administrationfeatures, along with some Image area enhancements.IMPAX

AMigration Toolscommands andparametersThe IMPAX 6.5.3 Migration Toolbox relies on parameters to configure the command line applicationsto suit a parti

Additional informationValuesParametersdatabase_reconnection_attempts-ROutput to stdout. Differs formigration_inventory.exe (refer to page 115) andmigr

build-impax-mig-schema.batdatabase-upgrade-script.bat(Topic number: 10613)Upgrades the IMPAX 5.2 or later SQL Server database schema to IMPAX 6.5.3. T

Default valueValuesParametersadd{list | add}-mMigrateTRServer.exe(Topic number: 10617)Utility that migrates worklist or report data or both from the t

migrate-users.exe(Topic number: 10621)Not required for IMPAX 6.2 or later migrations. Exports user IDs, preferences, and privileges andmigrates this d

• To extract user data for user1 and user2 from IMPAX to default XML file (users.xml):-m mvf2xml -d myDB -U myDBUser -P myDBPass -uid user1,user2• To

Default valueValuesParametersNot applicableNone; output unarchived studies to a file which may beused by CLUI to initiate a store job. The file is not

BPMTS scripts overviewThe following table shows an overview of the PMTS scripts included in the IMPAX DAA package.FunctionPMTS script namesUpgrades sc

CIMPAX 5.2 preferencesmigrated to IMPAX6.5.3DetailsMigrated?User preferencesList areaThe keywords created to drive workflows continue to beused in IMP

DetailsMigrated?User preferencesThe implementation of patient name has changed.IMPAX 6.5.3 can provide single-byte, phonetic, andideographic versions

For a complete list of differences, see “WEB1000 and IMPAX 6.5.3 feature comparison” (topicnumber 55002) in the IMPAX Migrations Reference Guide.Vali

DetailsMigrated?User preferencesFormats are consistent between IMPAX 5.2 andIMPAX 6.5.3.YesFormatsLUTs are consistent between IMPAX 5.2 and IMPAX 6.5.

DetailsMigrated?User preferencesConfigurable Study Save tool settings are controlled in theuser profiles in IMPAX 6.5.3 and must be redefined.NoConfig

DetailsMigrated?User preferencesMagnification is consistent between IMPAX 5.2 andIMPAX 6.5.3.YesMagnificationGeometry is consistent between IMPAX 5.2

DRunning osql to accessSQL Server dataThe osql utility can be used to access and change data in instances of SQL Server. This commandprompt utility ca

3.After you have run the last batch of SQL statements, to terminate the utility, type exit or quitat the start of a new line.For more information abou

EExternalsoftware licensesSome of the software provided utilizes or includes software components licensed by third parties,who require disclosure of t

The licenses for most software are designed to take away your freedom to share and change it. Bycontrast, the GNU General Public License is intended t

2. You may copy and distribute verbatim copies of the Program's source code as you receive it,in any medium, provided that you conspicuously and

b. Accompany it with a written offer, valid for at least three years, to give any third party,for a charge no more than your cost of physically perfor

through you, then the only way you could satisfy both it and this License would be to refrainentirely from distribution of the Program.If any portion

• To migrate an IMPAX cluster from Oracle for Solaris to Oracle on Windows, contact AgfaProfessional Services for assistance. This migration process i

2. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITINGWILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/ORREDISTRIBUT

RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED INTHIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIALDAMA

6. Redistributions of any form whatsoever must retain the following acknowledgment: "Thisproduct includes software developed by the OpenSSL Proje

([email protected])" The word 'cryptographic' can be left out if the routines from the librarybeing used are not cryptographic related

libraries, source files, header files, and data files), any updates or error corrections provided byOracle, and any user manuals, programming guides a

PARTY, WHETHER IN AN ACTION IN CONTRACT OR TORT, EVEN IF ORACLE HAS BEENADVISED OF THE POSSIBILITY OF SUCH DAMAGES. ORACLE'S ENTIRE LIABILITY FOR

inconsistent or conflicting terms in the Binary Code License Agreement, or in any license containedwithin the Software.A. COMMERCIAL FEATURES. You may

of any and all Programs and/or Software. The license set forth in this Section D does not extend tothe Software identified in Section G.E. DISTRIBUTIO

I. SOURCE CODE. Software may contain source code that, unless expressly licensed for otherpurposes, is provided solely for reference purposes pursuant

License Restrictions Warranty/Consequential Damages DisclaimerThis software and related documentation are provided under a license agreement containin

2. An upgrade period, typically performed over a weekend, during which the IMPAX softwareand database are upgraded from the previous to the new versio

Xerces C++ Parser, version 1.2(Topic number: 121761)This product includes software developed by The Apache Software Foundation(http://www.apache.org/)

AADAMActive Directory Application Mode. Directoryservices for an individual application thatcontrols user login and privilege information.AEApplicatio

containersIn the navigation pane of the Configure area- Stations section, containers hold stationcontainers. Much like a file folder, containersorgani

installed on Application Servers and areassigned to roles.log fileA file or set of files containing a record of theactions and modifications made in a

permissions, IMPAXPermissions define the available IMPAXfeatures and types of studies that users in aparticular role have access to. Permissions arema

Configure area - Stations section. Stations areorganized under station containers. You canset configuration options, such as diagnosticmonitor setting

.NETand SQL Server 2008 R2...42installing Framework...51, 59, 60system requirements...3832

AD LDS...99critical server files...107SQL 2000 database...

requirements...32speed...34creating...

duplicate user IDs...97, 114DVD burners...35Eeditingbuild-impax-mig-schema.b

When a DAA consolidation involves two IMPAX clusters (in a parallel migration), the DAA libraryserves as the legacy archive, while the Hierarchical St

IIBM server...32ICU software license...130IDsduplicate...

MigrateTRServer.exe...113migrate-users...87, 97, 100migration_inventory...77

parallel migration...13parallel migration tools...117installing...

hanging protocols...89inheritance...88mapping WEB1000 privileges...

storage requirements...35HSM...35storingpasswords...

exporting...15, 18, 97gathering data...81hanging protocols...

• Image area wizards• Hanging protocols• Comparative review modes• Teaching file foldersKey items that are not migrated include:• Worklists• Select wi

Valid WEB1000 migration paths and transitionstrategy(Topic number: 6606)A site running WEB1000 or a combination of WEB1000 and IMPAX can transition it

For a more detailed list of the differences between WEB1000 and IMPAX, refer to “WEB1000 andIMPAX 6.5.3 feature comparison” (topic number 55002) in th

Phase 3: IMPAX 6.5.3 and WEB1000 coexistence(Topic number: 6642)IMPAX 6.5.3 and WEB1000 run as separate systems, but with image routing based on IMPAX

Copyright information© 2012 Agfa HealthCare N.V., Septestraat 27, B-2640, Mortsel, Belgium. All rights reserved. Noparts of this document may be repro

Also consider site performance—measure the time to acquire the first image. If current performanceis inadequate or borderline, this may be another rea

and earlier. Hold a kick-off meeting for the key stakeholders in the upgrade to explain this and toidentify:• Site requirements• Preparations required

• Study commentsRelated documentation(Topic number: 6634)IMPAX includes documentation for IMPAX Client, IMPAX Application Server, and IMPAX Server.The

Opening the Client Knowledge Base from the List, Text, or Configure area(Topic number: 57440)Once the IMPAX documentation is installed, you can access

Opening the IMPAX 6.5.3 Server Knowledge Base(Topic number: 11528)The IMPAX 6.5.3 Server Knowledge Base is a reference tool for PACS IT specialists an

Opening a PDF guide from the documentation DVD(Topic number: 57808)All IMPAX guides can be viewed directly from the IMPAX documentation DVD.To open a

IMPAX Application Server guide(Topic number: 6683)Provides instructions onFile nameTitleimpax_application_server_install.pdfIMPAX 6.5.3Application Ser

Provides instructions onFile nameTitleservers. This guide coverssingle-server, all-in-one,single-host, and multi-hostconfigurations.Installing and ini

IMPAX Quick References(Topic number: 54853)Quick References are intended for clinical users. These abbreviated publications provide instructionsfor co

IMPAX Client Quick References(Topic number: 54856)Describes common IMPAXprocedures and references forFile nameTitleRadiologists who specialize inbreas

2012 - 9 - 17Manufacturer’s responsibilityThe manufacturer, installer, or importer will be responsible for the safety, reliability, and performanceof

IMPAX Server Quick References(Topic number: 54859)Describes commonIMPAX proceduresand references forFile nameTitleConfiguring IMPAXServer using theAdm

Prerequisite software installations(Topic number: 59235)Note:For each package, ensure that the most current Service Update (SU) packages available att

• If intending to use the IMPAX Reporting integration with the IMPAX Client, IMPAX RIS mustbe upgraded to version 5.7 or later. For upgrade instructio

RequirementsComponent100/1000 MbpsNetwork interfacesKVM or Integrated videoVideoRedundantPower suppliedKVM or mouse and keyboardPeripherals* The use o

IMPAX AS300 Server: Hardware requirements(Topic number: 6690)The following hardware configuration is recommended for IMPAX AS300 servers (includingsin

Additional AS300 hardware requirements: Storage requirements(Topic number: 6733)Additional hardware can be used to meet archive requirements.IMPAX AS3

RequirementsComponent• Upgrades only: Microsoft SQL Server 2008 R2 SP1 (64-bit),Standard Edition.Oracle Instant Client 11.2.0.1.0 including Basic, ODB

RequirementsComponentThe Agfa preferred supplier is HP.SystemHP xw4400, xw4600, xw6400, xw6600, z400, or z600Dell Precision™ 490 or 690, T5400, T7400,

RequirementsComponentMXRT200 and 7300 (high-endboard for IMPAX ClinicalApplications such as Oasis forIMPAX)Windows XP and Vista:Windows 7 (WDDM):RIS/A

The IMPAX Client will run on 64-bit operating systems in 32-bit compatibility mode. The IMPAXClient is not a 64-bit application and therefore does not

ContentsGetting started 81About this IMPAX Preparing to Upgrade Guide...8New IMPAX

2Performing initialinstallationsOnly some IMPAX installations can be performed during the preparing to upgrade period. In manycases, installation deta

Obtaining Server licenses for Windows stations(Topic number: 10699)To obtain new license keys, if this is required, email [email protected]. To gene

In the IMPAX 6.5.3 AS300 Installation and Configuration Guide, Oracle for Windows is therecommended database for new AS300 (Windows) installations. H

6.On the Product Key screen, enter the product key. Click Next.7.On the License Terms screen, read the license agreement and select the I accept the l

19. On the next two screens, Error Reporting and Installation Configuration Rules, accept thedefault values by clicking Next.20.On the Ready to Instal

Troubleshooting: Server name registered in SQL Server is incorrect(Topic number: 7625)IssueIf the server name registered in SQL Server is not the same

3. Type your name (minimum three characters).This information is recorded in the installer log file.4.On the Welcome screen, click Next.5. On the Sele

If the mvf.lic file is not located in C:\mvf, the file is copied to that location. A dialog informsyou of the success of the copy task.12. If an Archi

Windows Server 2008Installation or configuration taskOrderInstalling Windows Server 20081Setting the primary DNS suffix2Configuring Windows Server 200

3. Setting up one or more IMPAX Client stations, connected to this Application Server, to usefor training and configuration. For instructions, refer t

Performing initial installations 402Evaluating system requirements...

Installing external hardware and softwareActionInstall Windows Server 2008 R2 software followed by Windows Server 2008 R2 ServicePack 1Activate Window

To install the IMPAX documentation1. Insert the IMPAX Documentation DVD or access the ISO file.2.Double-click IMPAXDocumentationSetup.exe.A Preparing

• .NET Framework 3.5 SP1 (installed with AD LDS)• Visual C++ 2008 RedistributableIf any of these packages are listed in the InstallShield Wizard dialo

Verifying the Business Services installation(Topic number: 7598)You can verify the IMPAX Business Services installation by checking whether IIS works.

Preparing a training plan(Topic number: 55171)Without the full participation of the entire radiology staff, the upgrade from IMPAX 5.2 or 5.3 toIMPAX

Installing the Migration Toolbox on a Windows server(Topic number: 11493)To install the Migration Toolbox, you must be logged into Windows as an admin

If the production system is not using DAA, you do not have to install these tools.To install the PMTS package on the IMPAX production system1. Copy th

9.If necessary, select the Connect to SQL Server checkbox and supply a Login ID and Password.10.If necessary, change the network library by clicking C

9.If necessary, change the network library by clicking Client Configuration. Under Networklibraries, select the protocol used to communicate with the

minutes and, although staggered, performance issues have been reported when many Clientsare downloading the new IMPAX Client software.Therefore, we re

Migrating reports to the training server...75Collecting information on IMPAX cl

To run the IMPAX Installation Server package1.From the IMPAX Client CD or a network location, run IMPAXInstallationServerSetup.exe.A Preparing to inst

the site’s off-hours, as downloading and installing the Microsoft .NET framework can take over 30minutes, depending on network speed.To run the instal

To enable automated installation of the IMPAX Client software from a command prompt1. At a command prompt, typeImpaxClientSetup.exe /S /v"setting

Spacing rules for installation settings(Topic number: 7757)When specifying installation settings values using the /v flag, certain rules regarding spa

All users, if person installing hasadministrative privileges; otherwise, currentuserInstallation typeC:\Rad Tools\Agfa\IMPAX ClientInstallation direct

the new. It uses native components within IMPAX to send signals between the two systems that astudy’s dictation status has changed. During the install

5.Open the Windows Administrative Tools and select Services.6. Start the service.The install_signal_relay.bat file installs the mvf_signal_relay.exe a

DescriptionINI_VALUEINI_KEYINI_SECTIONthe IMPAX 5.2 or 5.3 ServiceTools.a radiologist. The defaultvalue is signal-relay.If you change this value, youm

5.In the Name field, type a name for the exception; for example,Study Status Relay or somethingsimilar.6. In the Port field, type the number of the TC

9.In the navigation pane, select the Study Status Relay role again.10.In the details pane, expand the Licensing bar.11.In the navigation pane, right-c

Generating a report of lost images...109Appendix A: Migration Tools command

Tip:If it is too difficult to copy the string from the command-line interface, output the resultto a text file, then copy the string from that file.5.

Note:Do not confuse CCDI with Dual Cluster Claim and Assign (DCCA), which allows two activeclusters of the same version (IMPAX 6.5.2 or later), runnin

3Taking system inventoryInstall and run key Migration Tools during the preparing to upgrade phase. You must completethese initial tasks when preparing

Creating the pre-migration schema on an AS300 or WEB1000 server(Topic number: 57475)These steps assume that the Migration Tools have been installed on

Migrating reports to the training server(Topic number: 119286)2.Migrating reports from the production server to the training server allows users to wo

Setting up the connection to the Oracle database(Topic number: 119284)The Oracle 10g Client software installs the drivers and programs required to com

b.In the Data Link Properties dialog, select Microsoft OLE DB Provider for SQL Server.Click Next.c. In the Data Source field, type mvf_ts.world or the

Collecting information on IMPAX clients, servers,stations, and printers(Topic number: 6721)3.Before upgrading to IMPAX 6.5.3, use the migration_invent

on the IMPAX Database Server itself. The studies to be identified can be moved to archive prior tomigration.The Study Archive Report tool uses various

mig_reporter.exe -d mvf_version_number -t mig-study-archive-reportwhere version_number is either 52 or 53.The report file is created in the C:\mvf-mig

1Getting startedIMPAX 5.3 and earlier versions are quite different from IMPAX 6.0 and later versions. WEB1000and IMPAX 6.5.3 also have a number of dif

• Windows firewall rules are created and applied to block external access to unused ports.• The Administrators group is automatically created by Windo

4Preparing foruser migrationThe following information outlines the steps for preparing the IMPAX 4.5, 5.2, or 5.3 and WEB1000user data for migration t

mig_reporter.exe -d mvf_version_number -U IMPAX_4.5_5.2_or_5.3_database_user -PIMPAX_4.5_5.2_or_5.3_database_password -t user_base_summaryViewing the

• Run the command to map the Client station names to machine identifiers• Verify that all Client station names have been mappedDetails on each of thes

If the administrator usernames and passwords are the same for all the IMPAX Client machines,do not include that information in the host_list file.4. S

Note:If you are logged into the server with a domain username and password that is the same asthe username and password on a remote station, error mes

Retrieving the IMPAX Client station name(Topic number: 57532)Once the appropriate Migration Tools are available on the Client station, you can use the

Exporting user data(Topic number: 9920)3.Follow this procedure to export all IMPAX 4.5, 5.2, or 5.3 or WEB1000 user information. For IMPAX,this export

Information about other parameters supported by this tool is available in migrate-users.exe (refer topage 114).Deleting special characters in user nam

2. Define which preferences will be getting migrated at the user level, therefore overriding roleinheritance, by consulting the exported user data (re

Information on performing the actual upgrade is available in the AS300 Upgrade and MigrationGuide—IMPAX 5.2 or 5.3 to IMPAX 6.5.3.If the cluster meet

For additional information on standard worklists, refer to the “Managing studies using worklists”section (topic number 8430) in the IMPAX 6.5.3 Clien

To ease the process, try the following:• Simple text editors such as Notepad or Wordpad do not handle large files very well. You willget better result

5Migrating user dataThe following information outlines the steps required to successfully migrate WEB1000 and IMPAX4.5, 5.2, or 5.3 user data into the

Password policy settings(Topic number: 6646)SettingPassword policyEnforce password historyMaximum password ageMinimum password ageMinimum password len

3. To modify the Password Policy information, double-click the policy to be changed.Change each password policy to have the following settings:Setting

9. On the Items to Backup screen, select the folder containing the ADAM data as well as theWorld Wide Web Publishing Service folder. Click Next.The de

The next task is to define what IMPAX or WEB1000 privileges this new role inherits.Mapping IMPAX or WEB1000 privileges tocustom roles(Topic number: 66

2. Compare the privileges in the database with the role mapping in the migrate-users.exe.configfile.3. To map an IMPAX or WEB1000 privilege to a custo

into XML (as described in Exporting user data (refer to page 87)), then transformed into LDF(Layered Data Format).Perform this task on the configured

To successfully migrate user data into AD LDS, the user currently logged into theIMPAX 6.5.3 Application Server component must have AD LDS administrat