05 Offline Config Tool Installation

HEALTHCARE Chapter 5
Imaging Services Software Options

Document No: DD+DIS262.08E
NX 2.0.8000 / 3.0.8000
Type 4406/303
Offline Config Tool Installation and Use
► Purpose of this Document
This manual describes the installation and use of the NX Offline Config Tool.
► Document History
Edition. Release Changes

Revision Date
1.0 01-2009 Initial Release
► Referenced Documents
Document Title
DD+DIS254.08E NX 2.0.8000 / 3.0.8000 Service Manual
DD+DIS276.08M NX 2.0.8000 / 3.0.8000 Spare Parts List
DD+DIS266.08E NX 2.0.8000 / 3.0.8000 Troubleshooting Guide No.1
DOCUMENT CONTROL NOTE:

The controlled version of this document resides on MedNet. Any printed copy of this document is uncontrolled.
Edition 1, Revision 0
01-2009 printed in Germany Document Node ID: 26219760-6
sw_05_software-options_e_template_v05
Agfa Company Confidential Copyright © 2009 Agfa HealthCare N.V.
DD+DIS262.08E Software Options
► Manufacturer
Agfa HealthCare N.V.
Publisher
Agfa-Gevaert HealthCare GmbH
Tegernseer Landstraße 161
D - 81539 München
Germany
Copyright © 2009 Agfa HealthCare N.V.
All rights reserved.
Technical modifications reserved.
AGFA and the Agfa-Rhombus are trademarks of Agfa HealthCare N.V.
WARNING:
Improper operation or service activities may cause damage or injuries.
INSTRUCTION:
(1) Read the "Generic Safety Directions" document
(see MEDNET GSO => General Info => Agfa HealthCare => Publications =>
Service Manual) prior to attempting any operation, repair or maintenance task on
the equipment.
(2) Strictly observe all safety directions within the "Generic Safety Directions" and on
the product.
NOTE:
To verify the latest version of single documents and of Service Manuals refer to the
Document Type ‘Order List’ in the GSO library.

Edition 1, Revision 0 NX 2.0.8000 / 3.0.8000 Chapter 5 / 2

01-2009 Type 4406/303 Agfa Company Confidential
LIST OF CONTENTS
1 INTENDED USE OF THE OFFLINE CONFIG TOOL...............................................................4

2 PREREQUISITES.....................................................................................................................4
3 OBTAINING THE OFFLINE CONFIG TOOL............................................................................5
4 INSTALLING THE OFFLINE CONFIG TOOL...........................................................................5
5 USING THE NX OFFLINE CONFIG TOOL ..............................................................................6
5.1 Importing and exporting Configuration Files .............................................................................6
5.2 Information about Configuring Bitmap Images to be printed on Film .......................................8
6 LIMITATIONS OF THE OFFLINE CONFIG TOOL ...................................................................9

7 ADDITIONALLY INSTALLED TOOLS ....................................................................................10
7.1 ExamTree Conversion Tool ....................................................................................................10
7.2 Logging Viewer .......................................................................................................................10
7.3 Age Group Copy Tool .............................................................................................................10
7.3.1 Using the Agegroup Copy Tool...............................................................................................10
7.4 Verify Signature of NX Import-Export File Tool.......................................................................14
7.5 Configuration Tool Online Help...............................................................................................14


1 Intended Use of the Offline Config Tool
The Offline Config Tool is an auxiliary tool for the Field Service Engineer (FSE).
The FSE can load and configure any NX configuration file on the Offline Config Tool
installed e.g. on his service PC. This enables him/her to prepare the configuration file
before going to the site:
Export Configuration Export Configuration
Load Configuration Load Configuration
Configuration Tool Offline

(On NX system) Config Tool
(e.g. on service PC)
Figure 1
NOTE:
The Offline Config Tool provides basically the same functionalities and user interface
as the online config tool (= the one installed on a real NX system). There are some
limitations which are described in this document in section 6.
2 Prerequisites
Make sure the PC that you use for installing the Offline Config Tool meets
following requirements:
• Operating System: Windows 2000 or Windows XP
• Account rights: Local administrator rights.
• Monitor: Minimum screen resolution: 1024 x 768 pixels.


3 Obtaining the Offline Config Tool
NOTE:
Every NX version starting from NX2.0.6805 has its own version of the Offline Config
Tool. The different versions can be installed parallel. The version number is part of the
name of the installation path:
C:\Agfa\Healthcare\NX\Offline Config Tool <Version>\Bin
To obtain the Offline Config Tool you have two possibilities:
• Either download the Offline Config Tool installer from the MedNet FTP Server
(Intranet Link / Extranet Link).
• Or order it via the spare part channel.
For the CM+ number of the correct version refer to the NX spare parts list
DD+DIS276.08M (Intranet Link / Extranet Link).
4 Installing the Offline Config Tool
(1) Log in to an account that has administrator rights on the PC you want to
perform offline configurations.
(2) Double-click the file Offline Config Tool X.0.8000.exe and observe
the progress of the installer.
Result After the installer is done, it displays a message that the Offline Config Tool is
installed successfully.
NOTE:
When not logged in with administrator rights, the installer may indicate that the
installation succeeded even if it has actually failed.


5 Using the NX Offline Config Tool
NOTE:
The Offline Config Tool can only be used from an account that has
local administrator rights (see prerequisites in section 2).
5.1 Importing and exporting Configuration Files
(1) Start the Offline Config Tool:

Start Æ Programs Æ Agfa Æ NX Æ Offline Config Tool Æ
Start Offline Config Tool
(2) Enter these settings into the startup screen of the tool:
Setting Task/Meaning
Enable Central Station Check this box if you use the tool on a CMS.
Configuration This choice can be made only here!
Enable Exposure Index (EI) Check this box if you want to configure an NX that uses
Dose Registration Exposure Index instead of LGM.
Refer to chapter 1 of the Service Manual
DD+DIS254.08E for more information.
Edition Choose between NX 2.0.8000 and NX 3.0.8000.
Load configuration from an You can load an already existing configuration file into
external file the config tool. This can also be an export file made by
an online config tool or a previous version of the NX
config tool.
Load minimal configuration The minimal configuration is different for a non-CMS
and CMS NX. This functionality is not available in the
online config tool. On the online config tool the NX
database makes sure that a minimal configuration is
always foreseen.
NOTE:
Load active configuration and Restore NX configuration is never active
in this screen of the Offline Config Tool.


(3) Disable all licenses that will not be present on the online NX in order to
represent the online situation as much as possible.
NOTE:
• No Application License file (ALF) is needed to activate licenses
on the Offline Config Tool. By default, all licenses are enabled.
• The status of the licenses is not stored in the configuration file
that is exported later on in step (5).
If special license settings are required, they have to be applied
on the online NX Service and online Configuration Tool.
(4) Set all configuration settings that can be done on the Offline Config Tool.
(For information that cannot be configured on the Offline Config Tool,
refer to section 6)
(5) Export the configuration to a file.
Before exporting, the configuration is automatically verified. When verification
errors occur, you can still save the export file by clicking <Continue>:
Figure 2
(6) Import this export file to an online NX Configuration Tool, finish the configuration
and activate it.


5.2 Information about Configuring Bitmap Images to be printed on Film
When configuring bitmaps to be printed on film, you can upload a bitmap file in the
Offline Config Tool:
(1) Click the button <Copy Image> in the Bitmapcell editor. The file will be copied
to a specified folder on the PC: C:\Agfa\Healthcare\NX\OfflineConfig.Tool
\Bin\DataFiles\Configuration\BitmapFiles
Figure 3
(2) On site, copy the files manually from the offline BitmapFiles-folder to the
BitmapFiles-folder on the NX Workstation:
From the offline PC path:

C:\Agfa\Healthcare\NX\OfflineConfig.Tool\Bin\DataFiles\Configuration
\BitmapFiles
to the NX workstation path:

C:\Agfa\Healthcare\NX\Configuration\BitmapFiles


6 Limitations of the Offline Config Tool
IMPORTANT:
It is not possible to export the configuration to a previous version of NX!
The config tool must always be used for the same NX version as its own version
number indicates.
NOTE:
There is no access to the NX database. Input and output is handled via
export files (xml). These are the same type of files as used in the previous NX versions
with the online config tool.
Following configurations/functions have to be set/used on the online configuration tool
since they can not be done on the Offline Config Tool:
Configurations:
• Enabling/disabling of active licenses
• Applying special license settings
• Configuration of X-ray generator
• Authentication configuration (users and roles) as there is no authentication
management offline
Functions:
• Loading active configuration
• Activating configuration
• Restoring configuration
• Test connection functionalities
• Query RIS
• Test image for the monitor check
• Scan for in-room NXs (CMS functionality)
• Delete session (as there is no NX Database)
• Automatic backup


7 Additionally installed tools
Following tools are installed on your offline PC together with the Offline Config Tool:
7.1 ExamTree Conversion Tool
This tool is used to convert exam trees in Customer Parameter File (CPF)-file format
or in QS-XML-file format to a format that can be imported in the NX Offline
Configuration Tool.
For more information about using this tool refer to Chapter 05 Installation and
Configuration Appendices DD+DIS254.08E, section
“Import Available Configuration Settings” (Intranet Link / Extranet Link).
7.2 Logging Viewer
This tool is used to view NX log files.

For more information about this tool refer to the NX 2.0.8000 / 3.0.8000
Troubleshooting Guide No.1 DD+DIS266.08E section Fault Finding
(Intranet Link / Extranet Link).
7.3 Age Group Copy Tool
Premium Musica2 packages on NX require separate pediatrics exams.

The NX Configuration Tool does not allow copying the existing 17+ age group
exposure types into the pediatric age groups.
This can be done using the Agegroup Copy Tool.
7.3.1 Using the Agegroup Copy Tool
NOTE:
• The Agegroup Copy Tool can only work with full configuration export xml files
that contains only 17+ exposure types. Using the exam tree export file only is not
supported.
• The file you import must be a NX 2.0.8000 / 3.0.8000 configuration file. If only
lower version of the configuration file is available, import the file in the
NX 2.0.8000 / 3.0.8000 Offline Configuration Tool first and export it again.


(1) Open the Agegroup Copy Tool:

Start Æ Programs Æ Agfa Æ NX Æ Offline Config Tool NX X.0.8000 Æ
AgeGroup Copy Tool
(2) Go to File Æ Select Configuration:
Figure 4
(3) Browse to the full export configuration file and click the button <Open>.
(4) If you also want to copy the X-ray Generator (XRG) modality settings of the
selected exposures check the checkbox in the main window:
IMPORTANT:
If the modality settings are copied, they should be adjusted manually
since in most cases the adult XRG modality settings cannot be used
for pediatric exposures.
Figure 5


(5) Click <Start> to start copying the age group.

(6) After the file has been loaded, select one of the two options:
• Select all exposures from Exam Groups (Mammography and
Quality Assurance (QA)) -Exams are not included in the selection).
• Select all exposures from Exposures Groups.
Figure 6
Explanation If exposures are selected via exposure groups:

• Only the exposure types listed in the selected exposure group are
duplicated to the pediatric age groups.
• The copied exposures are added into the corresponding exposure group.
• If the source exposure types were included in a printsheet, similar
printsheets will be created for the duplicated exposure types in the target
age group.
If exposures are selected via exam groups:

• All exposures of the selected exam groups are duplicated to the pediatric
age groups.
• If the exposure belongs to an exposure group, then the copied paediatric
exposures are included into the exposure group.
• Exposure types which are included in the exposure group but did not occur
in the original selected exposure list are copied to the paediatric exam
groups as well.
• If the source exposure types where included in a printsheet, similar
printsheets will be created for the duplicated exposure types in the target
age group.


NOTE:
The copy operation will be stopped in case one of the target exam
groups already contain pediatric exposure types.
(7) Select the exam groups/exposure groups to be copied and click <OK>.
NOTE:
Warnings are submitted in case that incomplete printsheets are created.
This could occur in case printsheets contain Mammo or QA-exams
combined with exposure types that are selected for duplication.
(8) After duplication has finished, click <Done>:
Figure 7
Result The export file is stored on the same location as the import file but with the string
"Duplicated_" inserted at the start of the filename.
NOTE:
The documentation to the Age Group Copy Tool can also be found in the Offline Config
Tool via Start Æ Programs Æ Agfa Æ NX Æ Offline Config Tool NX X.0.8000 Æ
AgeGroup Copy Tool Documentation


7.4 Verify Signature of NX Import-Export File Tool
This tool can be used to verify whether an export/import xml file is correctly signed.
Since the export/import xml file is verified by the Configuration Tool on NX this tool is
not needed anymore.
7.5 Configuration Tool Online Help
The Offline Config Tool is installed with an online help.

NOTE:
• To be able to view the online help you might need to ‘allow blocked content’
in the browser.
• The content of the online help is identical to the NX Key User Manual.
(1) Press the functional key <F1> to access the online help to the currently active
screen of the Offline Config Tool.
(2) Navigate through the online help by using the displayed links or by clicking the
left arrow button:



05 Offline Config Tool Installation

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

05 Offline Config Tool Installation

Uploaded by

Copyright:

Available Formats

HEALTHCARE Chapter 5

Imaging Services Software Options

Offline Config Tool Installation and Use

► Purpose of this Document

Edition. Release Changes

DOCUMENT CONTROL NOTE:

DOCUMENT CONTROL NOTE:

Edition 1, Revision 0 NX 2.0.8000 / 3.0.8000 Chapter 5 / 2

1 INTENDED USE OF THE OFFLINE CONFIG TOOL...............................................................4

5.2 Information about Configuring Bitmap Images to be printed on Film .......................................8

6 LIMITATIONS OF THE OFFLINE CONFIG TOOL ...................................................................9

7.2 Logging Viewer .......................................................................................................................10

7.3 Age Group Copy Tool .............................................................................................................10

7.3.1 Using the Agegroup Copy Tool...............................................................................................10

7.4 Verify Signature of NX Import-Export File Tool.......................................................................14

7.5 Configuration Tool Online Help...............................................................................................14

DOCUMENT CONTROL NOTE:

Edition 1, Revision 0 NX 2.0.8000 / 3.0.8000 Chapter 5 / 3

1 Intended Use of the Offline Config Tool

Export Configuration Export Configuration

Load Configuration Load Configuration

Configuration Tool Offline

DOCUMENT CONTROL NOTE:

Edition 1, Revision 0 NX 2.0.8000 / 3.0.8000 Chapter 5 / 4

3 Obtaining the Offline Config Tool

To obtain the Offline Config Tool you have two possibilities:

4 Installing the Offline Config Tool

DOCUMENT CONTROL NOTE:

Edition 1, Revision 0 NX 2.0.8000 / 3.0.8000 Chapter 5 / 5

5 Using the NX Offline Config Tool

5.1 Importing and exporting Configuration Files

(1) Start the Offline Config Tool:

DOCUMENT CONTROL NOTE:

Edition 1, Revision 0 NX 2.0.8000 / 3.0.8000 Chapter 5 / 6

DOCUMENT CONTROL NOTE:

Edition 1, Revision 0 NX 2.0.8000 / 3.0.8000 Chapter 5 / 7

5.2 Information about Configuring Bitmap Images to be printed on Film

From the offline PC path:

to the NX workstation path:

DOCUMENT CONTROL NOTE:

Edition 1, Revision 0 NX 2.0.8000 / 3.0.8000 Chapter 5 / 8

6 Limitations of the Offline Config Tool

DOCUMENT CONTROL NOTE:

Edition 1, Revision 0 NX 2.0.8000 / 3.0.8000 Chapter 5 / 9

7 Additionally installed tools

7.1 ExamTree Conversion Tool

7.2 Logging Viewer

This tool is used to view NX log files.

7.3 Age Group Copy Tool

Premium Musica2 packages on NX require separate pediatrics exams.

7.3.1 Using the Agegroup Copy Tool

DOCUMENT CONTROL NOTE:

Edition 1, Revision 0 NX 2.0.8000 / 3.0.8000 Chapter 5 / 10

(1) Open the Agegroup Copy Tool:

DOCUMENT CONTROL NOTE:

Edition 1, Revision 0 NX 2.0.8000 / 3.0.8000 Chapter 5 / 11

(5) Click <Start> to start copying the age group.

Explanation If exposures are selected via exposure groups:

If exposures are selected via exam groups:

DOCUMENT CONTROL NOTE:

Edition 1, Revision 0 NX 2.0.8000 / 3.0.8000 Chapter 5 / 12

(8) After duplication has finished, click <Done>:

DOCUMENT CONTROL NOTE: