ApogeeX 2.5.0 InstallGuide

:ApogeeX 2.
Installation Guide
2 TRADEMARKS AND COPYRIGHT
Trademarks and AGFA and the Agfa rhombus are registered trademarks of Agfa-Gevaert AG.
Copyright ApogeeX and Agfa Balanced Screening are registered trademarks of Agfa-Gevaert N.V.
Apple, Macintosh, Mac OS 9, and Mac OS X are trademarks of Apple Computer Incorporated.
Adobe, Acrobat, PageMaker, and PostScript are trademarks of Adobe Systems Incorporated.
Microsoft, MS, MS-DOS, Windows 2000, and Windows XP are registered trademarks of Microsoft Corporation.
PC is a registered trademark of International Business Machines Corporation.
QuarkXPress is a registered trademark of QuarkXPress Incorporated.
PitStop is a registered trademark of Enfocus Ltd.
Preps is a registered trademark of Creo ScenicSoft Inc.
UNIX is a registered trademark of UNIX System Laboratories, Inc.
WIBU is a registered trademark of WIBU-SYSTEMS AG.
Those names and product names not mentioned here are trademarks or registered trademarks of their respective
owners.
For more information about Agfa’s prepress products, visit www.agfa.com or contact us at the following address:
Agfa-Gevaert N.V.
Septestraat 27
B-2640 Mortsel, Belgium
Tel: (+)32 3 444 2111
Date of Issue: May 2005

Copyright © 2005 Agfa-Gevaert N.V.
All software and hardware described in this document are subject to change without notice.
:ApogeeX 2.5 Installation Guide

3
License Agreement
You should carefully read the following terms and conditions before using this software. If you do not agree with
these terms, return the package within 10 days of purchase, together with proof of purchase, and your money will
be refunded.
This package may include one or more diskette(s), CD-ROM(s), and/or DVD(s) containing copies of computer
software programs, all or part of which are owned by Agfa-Gevaert N.V. (“AGFA”). These media may also contain
complete software programs, all or part of which are owned by other parties (“the Other Owners”). This package
also contains documentation relating to these software programs. In this Agreement, the term “Programs” refers
both to the software programs and the related documentation. AGFA and the Other Owners retain ownership of
the Programs and the other contents of this package. You, and any other person acquiring the Programs pursuant
to paragraph 7 (b) below, are licensed to use the Programs on the terms and conditions outlined below.
Limited Use License

1 You are granted a non-exclusive license (“the License”) to use the Programs only on the terms and conditions
set in this Agreement.
2 The Programs may be used only by you.
3 You agree to use the Programs solely for your own customary business or personal purposes.
4 (a) You and your employees and agents will protect the confidentiality of the Programs.
(b) Except as provided in paragraph 7 (b) below, you will not sub-license, sell, lease, rent, distribute, disclose
or otherwise make the Programs available to any other person.
5 (a) Other than for normal use of the Programs, or to make one back-up copy of the Programs in machine
readable form, you may not copy or reproduce the Programs, in whole or in part, for any purpose.
(b) The Programs contain certain copyright notices. You must include all such copyright notices on any copy
or reproduction you make. Further, you must acknowledge that any such copy or reproduction will be owned
by AGFA and, if applicable, the Other Owners.
6 You may not alter, modify, or adapt the Programs. You may not merge all or any part of them into any other
computer software programs. You may not translate, decompile or disassemble the programs or, without prior
written permission of AGFA, create any computer software programs or other works derived from the
Programs.
7 (a) You may not sub-license, assign or transfer this License to any other person, either in whole or in part, other
than as provided in 7 (b) below.
(b) You may transfer your rights under the License to another person provided that, at the time of transfer:
You pass the Programs (and all copies in your control) to the person acquiring your rights under the License.
The person acquiring your rights signs and returns to AGFA a Registration Card (thereby agreeing to be bound
by the terms and conditions in the License). Registration Cards are available from AGFA upon request.
Following such a transfer, all your rights under the License will pass to the person acquiring the Programs.
8 If you violate any of the above conditions, this License will be automatically terminated.
Term
The License is effective until terminated. You may terminate it at any time by notifying AGFA in writing. The
License may also terminate in accordance with conditions set out elsewhere in this Agreement. You agree that upon
any termination, you will immediately destroy the Programs together with all copies, and will immediately notify
AGFA in writing.
Limited Warranty and Liability

1 If you discover any physical defect on the Program media, and return the media to AGFA within 90 days after
purchase, together with proof of purchase, AGFA will replace the media at no charge to you.
2 Although AGFA has tested the Programs and reviewed the documentation, AGFA does not warrant that the
Programs will meet your requirements, that they will function in every hardware/software environment, or
that their operation will be uninterrupted or error free.
3 Except for the above express limited warranties, AGFA and the Other Owners give no warranties, guarantees
or conditions whether express or implied, by statute or otherwise, in relation to the Programs, their quality,
description, or fitness for any particular purpose.

4
4 Since some countries do not allow the exclusion of implied warranties, the above exclusion may not apply to
you. This warranty gives you specific legal rights. You may also have other rights.
5 In no event whatsoever shall AGFA, and the Other Owners, have liability for any special, indirect or conse-
quential losses of profit or otherwise, or for losses of recorded data, in relation to the use or any inability to use
the Programs.
6 Since some countries do not allow the limitation or exclusion of liability for incidental or consequential
damages, the above limitation may not apply to you.
7 No distributor, dealer or agent of AGFA is authorized to make any modification or addition to this statement
of limited warranty and liability.
General
1 Should you have any questions about this Agreement you may contact Product Management GS (Digital
Solutions Division) by writing to:
Agfa-Gevaert N.V. at Septestraat 27, B-2640 Mortsel, Belgium.
2 This Agreement is governed by the laws of the country in which it was purchased.
3 If the Programs are used within a country of the European Community, nothing in this Agreement shall be
construed as restricting any rights available under the European Community Software Directive, O. J. Eur.
Comm (No. L. 122) 42 (1991).
4 If any provision of this Agreement is held invalid, the remainder of this Agreement shall continue in full force
and effect.
You acknowledge that you have read this Agreement, understand all of its provisions and agree to comply fully with
them. You further agree that this Agreement contains the complete and exclusive statement of the agreement
between you and AGFA in relation to the Programs, and that it supersedes any proposal or prior agreement, oral or
written, and any other communications relating to the subject matter of this Agreement.

About This Installation Guide
This Installation Guide provides installation and configuration information for
ApogeeX system administrators.
! Intended Audience ................................................................................................... 6

! Keyboard and Mouse Conventions ..................................................................... 6
! Related Documentation ......................................................................................... 7
5
6 INTENDED AUDIENCE
Intended Audience
This document is designed for people who need to install and configure the
ApogeeX software and related programs.
You should be familiar with your front-end workstations, imagesetters, plateset-

ters, proofers, and PostScript software applications, as well as prepress
processing methods, printing procedures, and network traffic. If this is not the
case, please refer to the relevant user or operator manuals.
NOTE: All of the screen illustrations provided in this Guide are taken from
Windows 2000 and Windows 2003 Server systems. Although the ApogeeX
Client has exactly the same functionality in both Mac OS and Windows
environments, you should make allowances for some small differences in the use
and appearance of the Macintosh-based Client interface.
Keyboard and Mouse Conventions

All key names are shown in capital letters. For example, the Control key is shown
as CTRL.
Keys are frequently used in combinations or sequences as shortcut keys. For

example, SHIFT+F3 means to hold down the SHIFT key while pressing F3.
The following mouse conventions are used:
To ... Do this ...

Click Point to an item, and then quickly press and release the mouse
button without moving the mouse.
Double-click Point to an item, and then quickly press and release the mouse
button twice.
Context-click on Windows Click the right mouse button.
Context-click on Macintosh Hold down the CTRL key while clicking the mouse button.
Drag Point to an item. Press and hold down the mouse button as you
move the mouse to a new location, then release the mouse but-
ton.

7
Related Documentation
Refer to the following documents for more information:
■ The ApogeeX Licensing Guide
■ The ApogeeX Service Guide
■ The ApogeeX Tutorial
■ The ApogeeX Online Help
■ The ApogeeX Release Notes and Readme First (for last minute information)

8 RELATED DOCUMENTATION

Contents
About This Installation Guide ....................................................................................... 5
! Intended Audience ............................................................................................................ 6
! Keyboard and Mouse Conventions .............................................................................. 6
! Related Documentation .................................................................................................. 7
Chapter 1 Before You Begin ............................................................................................................ 13
! The ApogeeX Starter Kit .................................................................................................. 14

! Supported Items ................................................................................................................. 14
! Disk Configuration ............................................................................................................. 15
! List of Components ........................................................................................................... 16
! ApogeeX DVD Structure .................................................................................................. 20
" ApogeeX 2.5.0 Root Folder ...................................................................................... 20
" Documentation Subfolder ........................................................................................ 21
" Resources Subfolder ................................................................................................... 21
" SupportFiles Subfolder .............................................................................................. 23
! Licensing ............................................................................................................................... 25
Chapter 2 Installing ApogeeX ....................................................................................................... 27
! Before Starting the Installation .................................................................................... 28

" ApogeeX Prerequisites .............................................................................................. 29
! Installing the ApogeeX Server System ...................................................................... 31
" Installing Prerequisites ............................................................................................. 33
" Installing Typical Components ............................................................................... 41
" Installing Custom Components ............................................................................. 49
! Installing Additional Components ............................................................................... 60
! Installing a Satellite System .......................................................................................... 64
" Before You Begin ......................................................................................................... 64
! Installing a Failover System ........................................................................................... 70
! Installing ApogeeX Clients ............................................................................................. 74
! Manually Installing Agfa Plugins/Extensions ......................................................... 84
Chapter 3 Uninstalling ApogeeX ................................................................................................ 87
! Uninstalling the Complete ApogeeX System .......................................................... 88

! Uninstalling an ApogeeX Component ....................................................................... 90
! Uninstalling a Satellite System .................................................................................... 93
! Uninstalling a Failover System ..................................................................................... 94
! Uninstalling ApogeeX Clients ....................................................................................... 96
! Unregistering Satellite Services ................................................................................... 97
! Unregistering Satellite Task Processors ....................................................................100
9
10
Chapter 4 Installing WebApproval .......................................................................................... 103
! Before You Begin ............................................................................................................... 104

" Where WebApproval Should Be Installed ......................................................... 104
" Recommended Configuration ................................................................................ 104
" Prerequisites ................................................................................................................. 106
" Installation Checklist ................................................................................................ 106
! Installing WebApproval on the ApogeeX Server ................................................... 107
! Installing the WebApproval Application Server ..................................................... 110
! Installing the WebServer ................................................................................................ 118
" Installing Windows 2003 on a Hardware-only System ................................ 119
" Setting up the WebServer Hardening ................................................................. 120
" Installing the WebApproval WebServer ............................................................. 123
! Configuring ApogeeX ....................................................................................................... 130
" Configuring a Mail Server in ApogeeX ............................................................... 130
" Configuring WebApproval Services in ApogeeX ............................................. 131
" ApogeeX Operator Prerequisites ........................................................................... 135
! Microsoft Updates ............................................................................................................. 136
" Installing Hotfix Updates ......................................................................................... 136
Chapter 5 Uninstalling WebApproval .................................................................................. 139
! Saving/Re-using your WebServer Configuration ................................................... 140

! Uninstalling WebApproval ............................................................................................. 140
Chapter 6 Upgrading ApogeeX .................................................................................................... 143
! Introduction ......................................................................................................................... 144

! Before You Begin ............................................................................................................... 144
! Upgrading the ApogeeX Server .................................................................................... 146
! Upgrading a Satellite System ....................................................................................... 155
! After Successfully Upgrading ........................................................................................ 158
! Upgrading a Failover System ........................................................................................ 158
! Upgrading a WebApproval Application Server ....................................................... 159
! Upgrading a WebApproval WebServer ...................................................................... 168
! Upgrading an ApogeeX Client ...................................................................................... 168
! Upgrading ApogeeX MSDE to SQL Server ................................................................ 168
! What to do if the Upgrade Installer Fails ................................................................. 175
! Manually Upgrading ApogeeX 2.1.1 to 2.5.0 .......................................................... 176
Chapter 7 Tutorial Prerequisites ................................................................................................ 179
! ApogeeX System Installation ....................................................................................... 180

! Downloading a Missing Resource ............................................................................... 180
! Setting your ApogeeX Preferences ............................................................................. 180

11
! Creating the Quick Tour Tickets ....................................................................................180

! Creating a WebApproval Ticket ....................................................................................181
! ApogeeX Macintosh Client Users .................................................................................181
! Creating Shortcuts .............................................................................................................182
Chapter 8 Installation Issues ..........................................................................................................183
! Installer Fails to Connect to the ApogeeX System ...............................................184

! Installer is Halted ...............................................................................................................184
! Cannot Open PDF Files on Macintosh Clients ........................................................184
! To Install ApogeeX Without a Network .....................................................................185
! Installing ApogeeX on a PC with Multiple Network Cards ................................185
! Checking Your WIBU Driver ...........................................................................................186
! Avantra25XT on Windows 2003 Server - SE ............................................................187
! Errors During the MDAC Update ...................................................................................187
! Hard Disks Not Available for Selection ......................................................................188
! Cannot Install Windows Client .....................................................................................188
Appendix ....................................................................................................................................189
! Starting and Stopping the ApogeeX System ...........................................................190

! What is Installed and Where? ........................................................................................193
" The ApogeeX Server ...................................................................................................194
" The Satellite System ...................................................................................................196
" The Failover System ....................................................................................................197
" WebApproval Application Server ...........................................................................198
" WebApproval WebServer ..........................................................................................199

12

CHAPTER
1 Before You Begin

This chapter describes the ApogeeX Starter Kit and 3-disk TKS configuration. It
also provides information on licensing, and a complete list of components and
supported devices.
! The ApogeeX Starter Kit ...................................................................................... 14

! Supported Items ..................................................................................................... 14
! Disk Configuration ................................................................................................. 15
! List of Components ............................................................................................... 16
! ApogeeX DVD Structure ...................................................................................... 20
" ApogeeX 2.5.0 Root Folder ......................................................................... 20
" Documentation Subfolder ........................................................................... 21
" Resources Subfolder ...................................................................................... 21
" SupportFiles Subfolder ................................................................................. 23
! Licensing ................................................................................................................... 25
13
14 THE APOGEEX STARTER KIT
The ApogeeX Starter Kit

The ApogeeX Starter Kit includes:
■ the yellow ApogeeX USB dongle
■ a DVD containing the ApogeeX installer, documentation, and End User

License Agreement
■ The ColorTune CD.
NOTE: The latest version of the ApogeeX Tutorial is available as a PDF file on
the ApogeeX DVD, and can also be accessed as a Help file from the ApogeeX
Client.
The ApogeeX software is protected by a combination of the hardware dongle

that must be attached to the ApogeeX System server, and a unique license file
that is linked to the installed dongle.
Supported Items
Refer to the ApogeeX 2.5.0 Release Notes for information on the following
supported items:
■ ApogeeX components
■ Operating systems
■ Multi-task processor instances
■ Satellite Task Processors
■ Agfa plug-ins and extensions for Quark and Acrobat
■ ApogeeX configurations
■ WebApproval configurations
■ Web browsers

1 BEFORE YOU BEGIN 15
Disk Configuration
The following table describes the TKS (Turnkey Solutions) configuration that is
bundled with the ApogeeX 3-disk system.
Partition C: Partition D:
8 GB (NTFS): Remaining GBs (NTFS) (at least 3 GB)
• Operating System • ApogeeX System
• Spooling • ApogeeX Client
Disk 0
• Page File • MSDE (SQL)

• Wibu dongle driver • ApogeeX Log (System and Job infor-
• ApogeeX Registration Utility mation)
• APIS card driver (when an APIS
device is installed)
E:
Maximum Size NTFS:
• Scratch directory
• HotFolderRoot
• PDF Data
Disk 1
• ExportRoot
• PressRoot
• JDFImportRoot
• PKGJDFRoot
For better performance, put all your PS/PDF/JDF data on this disk.
F:
Maximum Size NTFS:
• System Data
Disk 2
• Raster Data
• ArchiveRoot
• TIFFRoot (Imagesetter, Platesetter, and Proofer)
For better performance, put all your raster (TIFF) data on this disk.
CD-ROM
Drive Z:
NOTE: You cannot install the ApogeeX software from a FAT 32 disk.
You are advised to run a virus detection application on the ApogeeX Server. This
will have little influence on the performance of the system, and offers a higher
degree of security. Internal tests have been made using McAfee Virus Scan
v7.0.0 (Networks Associates Technology Inc.). We suggest that you only enable
the “Scan when writing to disk” option.

16 LIST OF COMPONENTS
List of Components
The following list summarizes all the ApogeeX components.
Module Component Description

Agfa CTF Devices AccuSet 1000, Provides output capability to AccuSet imageset-
1000W, 1500, ters.
1500W, 800
Avantra 20, 25, 25G, Provides output capability to Avantra imageset-
25S, 25XT 30, 30E, ters.
36, 36S, 44, 44E,
44S, 44XT
Avanxis IV, VIII Provides output capability to Avanxis imageset-
ters.
Phoenix 2000, 2250, Provides output capability to Phoenix imageset-
Phoenix News ters.
Agfa CTP Devices Acento E and S, Provides output capability to Agfa platesetters.
Galileo Classic, S,
Talant, Palladio,
XCalibur 45, XCali-
bur VLF 50, 60, 70,
80
Agfa Generic Devices PS Imagesetter Provides a raster file in Adobe’s PostScript format.
TIFF Imagesetter Provides an imagesetter engine emulation in TIFF

format.
TIFF Platesetter Provides a platesetter engine emulation in TIFF
format.
PDF Proofer Provides a proof file in Adobe’s PDF format.
PS Proofer Provides a proof file in Adobe’s PostScript format.
TIFF Proofer Provides a proofer device emulation in TIFF for-
mat.
Agfa PrintDrive PrintDrive Provides output capability to Agfa's Apogee
Devices Series3 PrintDrives.


Agfa Proofing Devices 4D GrandSherpa 50, Provides output capability to Agfa Proofing
4D GrandSherpa 64, devices
4D GrandSherpaM-
atic, 4D Sherpa2,
4DA GrandSherpa
50, 4DA GrandSh-
erpa 64, 4DA Grand-
SherpaMatic, 4DA
Sherpa2, 6D Grand-
Sherpa 50, 6D
GrandSherpa 64, 6D
Sherpa 24, 6D
Sherpa 24M, 6D
Sherpa 43, 6D
Sherpa 44M, 6D
Sherpa 54, 6D
Sherpa 62, 6D Sher-
paMatic, 6DA
Sherpa 43, 6DA
Sherpa 54, 6DA
Sherpa 62, 6DA
SherpaMatic, 7DA
GrandSherpa 50,
7DA GrandSherpa
64, 7DA GrandSher-
paMatic, 7P Sherpa
24M, 7P Sherpa
44M
Framework DefaultApo- Essential for ApogeeX server to run correctly.
geeServer
CustomerDBService Essential for ApogeeX server to run correctly.
DelanoService Essential for ApogeeX server to run correctly.
ImpositionService Essential for ApogeeX server to run correctly.
JDF Service Essential for JDF Import and PackagingJDF.
DefaultJobstore- Essential for ApogeeX server to run correctly.
Server
DefaultLogging- Essential for ApogeeX server to run correctly.
Server
DefaultNotification- Essential for ApogeeX server to run correctly.
Server
PreviewLocatorSer- Essential for ApogeeX server to run correctly.
vice
ProcessResourceS- Essential for ApogeeX server to run correctly.
ervice
ReplicationService Essential for ApogeeX server to run correctly.

18 LIST OF COMPONENTS

DefaultStorag- Essential for ApogeeX server to run correctly.
eServer
StrippingServer Essential for ApogeeX server to run correctly.
DefaultTaskServer Essential for ApogeeX server to run correctly.
DefaultTranslation- Essential for ApogeeX server to run correctly.
Server
WebApproval Essential for WebApproval.
OptionalServices CMSService Essential for ApogeeX server to run correctly.
PPDGeneratorSer- Essential for ApogeeX server to run correctly.
vice
ResourceInforma- Essential for ApogeeX server to run correctly.
tionService
TestPagesService Essential for ApogeeX server to run correctly.
TrappingService Essential for ApogeeX server to run correctly.
Press Engines Press The Press Task Processors represent your presses.
For each press, you can specify its characteristics
for specific job requirements.
Generic Press The Generic Press has no specific characteristics,
and can be used to simulate any press.
Preview PDFPreviewService Essential for ApogeeX server to run correctly.
PreviewService Essential for ApogeeX server to run correctly.
ThirdPartyCTF Katana Provides output capability to Screen’s Katana
Devices 5055 imagesetter.
Tanto Provides output capability to the Tanto 6120
imagesetter.
ThirdPartyCTP PlateRite 4100, Provides output capability to PlateRite plateset-
Devices 4300 ters.
PlateStream 34, 46, Provides output capability to PlateStream plate-
SC, SCX setters.
TrendSetter Provides output capability to TrendSetter plate-
setters.
FlatRite 1050 Provides output capability to Screen’s FlatRite
platesetter.
ThirdPartyProoferDe- 6D Epson 10000 All supported 3rd party proofers.
vices 7P Epson 4000
4D HP 1050
6D HP 130
4D HP 2500
6D HP 30
4D HP 3500
4D HP 5500_42
4D HP 5500_60
4D HP 750


AppleTalk AppleTalk Enables the use of the (Macintosh) AppleTalk
Channel. To print files directly from a Macintosh
front end application.
Digital Press DSPP Provided for R&D test purposes only.
the.Factory Provided for R&D test purposes only.
Export Export The Export Task Processor allows you to export
the processing results to a specific directory in
PDF or PostScript format.
Hotfolder Hotfolder The Hot Folder acts as an Input Channel in which
the files to be processed are dropped.
Impose Impose The Impose Task Processor allows you to pre-
define the final layout of the job. You need this TP
in order to use Templates or PJTFs inside Apo-
geeX.
JDF Import JDF Import The JDF Import Processor is similar to the Hot
Folder but it handles JDF files.
Caution: This component requires the Frame-
work JDF service.
LPR Lpr The LPR input channel uses the LPR protocol,
based on TCP/IP. It is especially used for
MAC OS X, UNIX and Windows NT workstations
or servers.
NamedPipe NamedPipe This is the standard input channel for Windows-
based workstations. Through the Windows server,
Named Pipe allows you to send jobs to the Win-
dows spooler from either a Windows or a Macin-
tosh front-end system.
Normalize Normalize The Normalize Task Processor converts PostScript
or EPS files to standardized or “normalized” PDF
files. This process generates a PDF file that is
suitable for reliable high-end prepress production.
Open Connect Open Connect Provided for R&D test purposes only.
PackagingJDF PackagingJDF The Packaging JDF Task Processor is similar to
the Hot Folder but it handles JDF files (MIME for-
mat) that are created by Packaging applications.
Caution: This component requires the Framework
JDF service.
PDFReady PDFReady Resolves transparent PDF 1.4 (and higher) files,
and traps PDF documents.
Public Page Store Page Store Provides Public Pagestore functionality.
Preflight Preflight The Preflight Task Processor checks that incom-
ing PDFs meet your requirements. The Preflight
component can also change the document prop-
erties with an Action list.

20 APOGEEX DVD STRUCTURE

Digital StepAn- Digital StepAn- Steps, repeats and nests artwork that is first ren-
dRepeat dRepeat dered and screened.
RenderOnce Render The Render Task Processor performs Trapping,
Separating, Rendering and Screening. Optionally,
there is the RenderOnce Task Processor that gen-
erates the high-resolution bitmap, and at the
same time provides a de-screened and downsam-
pled file for proofing purposes.
Remote Proofer Con- Remote Proofer Essential for remote proofing devices (Agfa proof-
troller (RPC) Controller (RPC) ers only).
Runlist Runlist The Run List Task Processor determines which
pages or artwork elements of a job are going to
be processed.
StepAndRepeat StepAndRepeat This Task Processor steps, repeats, and nests art-
work prior to rendering.
TCP IP Tcpip The TCP/IP Task Processor acts as the TCP/IP
input channel.
TIFFRenderOnce TIFF Render Provided for R&D test purposes only.
WebInput WebUpload Web Input acts as an Input Channel to which
Web Approval Client users can submit files to be
processed.
Caution: This component requires the Frame-
work WebApproval service.
ApogeeX DVD Structure

ApogeeX 2.5.0 production DVDs are high quality. However, there have been
some cases of malfunctioning DVDs. We therefore recommend that you verify
the integrity of the DVD and your DVD reader by copying the complete ApogeeX
2.5.0 DVD to your computer’s hard drive (4,5 GB) before starting the installer.
We also advise you not to duplicate the ApogeeX 2.5.0 DVD for the same reason.
CAUTION: The DVD structure has a very deep directory structure. The DVD
cannot therefore be copied to any location on your hard disk. You should
create a folder on the root of your hard disk, and copy the DVD contents there.
ApogeeX 2.5.0 In the root folder of the DVD you will find the Setup.exe file which you can use
to install ApogeeX. The ApogeeX and Bin subfolders provide data which is used
Root Folder by the ApogeeX installer.

Documentation In the root of the Documentation subfolder, you will find the following:
Subfolder ■ ApogeeX Installation Guide
■ ApogeeX Licensing Guide
■ ApogeeX Tutorial
■ ApogeeX ReadMe
The ApogeeX Tutorial is automatically installed on workstations where the

ApogeeX Client is installed, and can be accessed from the Client Help.
AgfaCTIFF subfolder
Provides documentation of the Agfa Colorized TIFF extension for QuarkXPress.
ApoColorConvertor subfolder
Provides documentation for importing Apogee Series2/3 color books.
ApogeeXDocuBoxManager subfolder
Provides documentation for ApogeeX Document Box Manager plugin for

Acrobat.
ImageViewer subfolder
Provides documentation of the Adobe Acrobat extension to view the ApogeeX

alternate images.
Trapping subfolder
Provides documentation on the Trapping extensions/plugins for QuarkXPress

and Acrobat.
Resources The Resources subfolder contains a copy of all the resources (most of the
resources are installed automatically).
Subfolder
ColorBooks subfolder
This subfolder contains all ApogeeX color books, most of them are automatically
installed.

ColorProfiles subfolder
■ Press: all press profiles which are installed.
■ Proofer: all proofer profiles which are installed.
ColorSpaces subfolder
The Black.mime file provides a Black InkSet and a Black press profile when you
download this file to the Press-ColorSpaces resource. This Black InkSet and
Press profile are identical to the Gray InkSet and Press Profile. The Black InkSet
and Press Profile must be used when working with JDF files. Refer to the
JDF_Prepress_AX25.pdf file in the Supportfiles\JDFSupport folder.
Dotshapes subfolder
These resources are not installed by default. The dotshapes resources can be
used to add a dotshape (e.g. square) to your Accurate and/or Rational Tangent
screens (System Overview > Output Device > Halftone Screens > Select a
screen + frequency + dotshape and select the Import button).
Fonts subfolder
This subfolder contains all the Fonts that are installed by default.
■ TwoByteSupport: This subfolder contains a PDF document which explains

how to download 2-byte Fonts (After Market Fonts) and a special resource
that needs to be downloaded into ApogeeX prior to installing 2-byte fonts.
Halftones subfolder
This subfolder contains all the default installed halftone screens and several
additional screens such as ABS Flexo, ABS Gravure, CristalRaster Galileo,
Sublima Flexo Silver, etc.
InkTables subfolder
This subfolder contains all proofer InkTables which are installed.
Marks subfolder
This folder contains the default-installed ApogeeX marks, and some additional
ApogeeX marks.
Patches subfolder
Contains two subfolders:

■ Custom: All custom patches are not installed by default.
■ Standard: All standard patches are automatically installed.
Custom patches are only useful for certain customer sites and should only be
installed at sites where the custom patch is needed. Each patch has a short
readme which provides installation instructions.
NOTE: Patches were previously called Boot Resources.
PreFlight subfolder
This subfolder contains all the Preflight actions and profiles that are installed by
default.
ProfileExceptions subfolder
This subfolder contains all the ProfileExceptions that are installed by default.
PSHeaders subfolder
This folder contains the default-installed PostScript Headers that can be used to
control output on various printers (e.g. the PS Proofer Task Processor).
SupportFiles The SupportFiles subfolder contains all the support files that are automatically
shared on the ApogeeX system after installation.
Subfolder
ApogeeX Logging Toolkit subfolder
Documentation for the database access option.
ClientInstallerMac subfolder
Provides the Macintosh ApogeeX Client Installer (including QmsX). The

CarbonLib dll is only provided for R&D testing purposes.
ClientInstallerPC subfolder
Provides the Windows ApogeeX Client Installer (including QmsX).
Drivers subfolder
Drivers for the output devices.

DriverTools subfolder
Tools to test the output device drivers.
JDFSupport subfolder
Documentation for JDF Support.
Misc subfolder
Contains some sample Visual Basic Scripts.
PPD subfolder
Contains the ApogeeX PPD and Oemprint.inf file for creating printer queues.
SampleFiles subfolder
These files are necessary in order to perform the ApogeeX Tutorial.
Utilities
The Utilities subfolder contains the following:
■ AgfaCTIFF: Contains the QuarkXPress Colorized TIFF Xtension for Windows

and Macintosh (for more information, refer to the Documentation folder).
■ ApoColorConvertor: ColorConversion utility to convert Apogee Series2/3

proofer RIP “.dat” files.
■ ApogeeX DocuBox Manager: Acrobat Apogee Document Box Manager plug-

in for Windows and Macintosh (for more information, refer to the Documen-
tation folder).
■ DataStore Recovery Tool: Resource utility for R&D only.
■ Image Viewer: Acrobat Alternate Image Viewer plug-in for Windows and
Macintosh (for more information, refer to the Documentation folder).
■ PRUpgrader: Resource utility for R&D only.
■ RegistrationUtility: The Registration Utility which is provided with this

version of ApogeeX.
■ RPR: The Remote Proofing Receiver application which needs to be provided

to customers which will receive proofing files from the Remote Proofer

Controller Task Processor (indicated in System Overview as a proofer with a

small arrow)
■ Trapping: QuarkXPress Trapping Xtension and Acrobat Trapping plug-in for

Windows and Macintosh (for more info refer to Documentation folder).
■ WebGrowth: Provides sample files in order to perform WebGrowth

configuration.
Licensing
ApogeeX is dongle-protected, using a yellow USB dongle. The dongle is supplied
with the ApogeeX Starter Kit when you purchase your ApogeeX System. The
dongle has a serial ID number.
To use ApogeeX, you will also need a license key. The license key is a unique file
that can be generated via the Agfa Licensing Portal, and is linked to your dongle
ID number. You can purchase additional licenses for extra functionality.
NOTE: The Satellite system does not need a dongle, since the ApogeeX Satellite
software is registered to the ApogeeX Server System.

26 LICENSING

CHAPTER
2 Installing ApogeeX
This section explains how to install the ApogeeX Server, Satellite and Failover
systems, as well as the Client applications and additional components.
! Before Starting the Installation ........................................................................ 28

" ApogeeX Prerequisites ................................................................................. 29
! Installing the ApogeeX Server System .......................................................... 31
" Installing Prerequisites ................................................................................ 33
" Installing Typical Components ................................................................. 41
" Installing Custom Components ................................................................ 49
! Installing Additional Components ................................................................... 60
! Installing a Satellite System ............................................................................. 64
" Before You Begin ............................................................................................ 64
! Installing a Failover System .............................................................................. 70
! Installing ApogeeX Clients ................................................................................ 74
! Manually Installing Agfa Plugins/Extensions ............................................. 84
27
28 BEFORE STARTING THE INSTALLATION
Before Starting the Installation

■ The server on which you install ApogeeX must have a working network
connection: If there is no network connection, the installer will fail. Refer to
the ApogeeX Service Guide for a detailed overview of these network settings.
■ If you are using multiple network cards, check the network card order.
ApogeeX registers on the first network card. You should not change the order
of the network cards after installation, since this will prevent ApogeeX from
starting up.
■ The computer name on which you install ApogeeX should use only the
following characters: a-z, A-Z, 0-9. The name should not contain spaces,
dashes, underscores, or names longer than 14 characters since some DNS
servers do not support these characters.
■ Make sure that File sharing for Macintosh and Windows is enabled.
■ Have your ApogeeX dongle ready, but do not yet connect it to your system.
■ If you are going to use Agfa output devices, make sure that you have installed
an APIS card.
■ Reserve sufficient time for the installation: It will take approximately 45

minutes for a complete install.
■ Make sure you logged on with Administrator rights.
■ The ApogeeX production DVDs are high quality DVDs. However, there have
been some reports of malfunctioning DVDs. You are therefore advised to
verify the integrity of your DVD and DVD reader by copying the entire
ApogeeX DVD to the hard drive of your computer prior to starting the
installer - Copy it to a shared folder on the ApogeeX Server (e.g. E:\ApogeeX
2.5.0 DVD). This requires 4.5 GB of free disk space. For the same reason, we
advise you not to duplicate the ApogeeX DVD.

2 INSTALLING APOGEEX 29
ApogeeX In addition to the ApogeeX System software, the following prerequisite compo-
nents need to be installed:
Prerequisites
■ Microsoft Data Access Components (MDAC). This is not required for
Windows Server 2003.
■ Microsoft SQL Desktop Engine (MSDE).
■ Dongle Driver (WIBU-KEY).
■ Registration Utility
Microsoft Data Access Components (MDAC)
Microsoft Data Access Components (MDAC) is a universal set of data access tools
developed by Microsoft. ApogeeX uses these tools to manage its data.
When installing ApogeeX, the installer will check if MDAC is installed on your
PC, if not or if MDAC needs upgrading, the installer will install/update MDAC
before installing ApogeeX.
NOTE: If you are running Windows Server 2003, MDAC is already installed.
Microsoft SQL Desktop Engine (MSDE)
Microsoft Desktop Engine (MSDE) is a client/server database engine that

provides local data storage. MSDE is a restricted version of Microsoft SQL
Server: It is designed and optimized for use on smaller computer systems, such
as a small workgroup server. However, unlike SQL Server, MSDE has a 2 Gbyte
database size limit. MSDE is not supported on Windows Advanced Server,
Limited Edition.
Dongle Driver (WIBU-KEY)
WIBU-KEY is the most technically advanced copy protection and license

management system currently available. It is a hardware copy protection system
based on genuine encryption. It’s purpose is to protect data and programs from
unauthorized use.
A WIBU-KEY comprises:
■ software which encrypts data
■ driver software

30 BEFORE STARTING THE INSTALLATION
■ a dongle hardware component
Registration Utility
The Registration Utility is used to generate a License Request file: Using the
Registration Utility, you merge the Fingerprint and Receipt Code file informa-
tion into a single License Request file. For more information, refer to the
ApogeeX Licensing Guide.

Installing the ApogeeX Server System

This section describes the installation procedures that you need to run on the
computer on which you are going to install ApogeeX.
" To start the Installer

1 Start the Installer by double-clicking the ApogeeX Setup.exe file.
This file is located in the root of the shared folder to which you copied the
ApogeeX DVD (e.g. E:\ApogeeX 2.5.0 DVD\Setup.exe).
2 Click Installation.

32 INSTALLING THE APOGEEX SERVER SYSTEM
3 Click ApogeeX System.
Your ApogeeX System installation options are displayed.
You can choose to install any of the following:
! Prerequisites: These include the MDAC, MSDE (which is used to store you
job log data), the Wibu Key driver, and the Registration Utility. You need
to install these Prerequisites before you can perform a Typical or Custom
Components installation (see “To install Prerequisites” on page 33).
! Typical Components: The standard ApogeeX components will be

installed. For more information, see “To install Typical Components” on
page 41.
! Failover: A Failover system is an exact duplicate of your ApogeeX System,

and provides you with a complete system backup in the event of a major
system crash. A Failover System does not require a unique hardware
platform: It can be installed on the Satellite platform, if you are using one.
However, the Failover Operating System and disk configuration must be
identical to the ApogeeX Operating System.
! Custom Components: You can specify which components will be

installed. For more information, see “To install Custom Components” on
page 49. You must also select this option in order to install a Satellite
system.

Installing The Prerequisites include the MDAC, MSDE (which is used to store all job log
and system-related data), the Wibu Key driver, and the Registration Utility. You
Prerequisites always need to install these Prerequisites first.
" To install Prerequisites

1 Click the Prerequisites Install button.
You will see the following Welcome information:
2 Click Next.
Tip: We recommend that 3 Browse to the locations where you want to create your MSDE Program and
you create your MSDE Data folders.
Program and Data folders on
the same disk. For more information, refer to “Disk Configuration” on page 15.
4 Click Next.

NOTE: The prerequisites are always installed: You cannot deselect them.
However, any components which are already available will not be reinstalled
if their version matches the version on the ApogeeX DVD.
5 Check your installation information, then click Next again to start the WIBU-
KEY installer.
The Registration Utility installer then starts automatically.
6 Click Next to continue.

7 Choose a location to which you want to install the Registration Utility, and
click Next.
8 Click Next.
The Registration utility is installed. When it has finished, you will see:
9 Click Finish.
If MDAC has not already been installed on this system (or if the system is
running MDAC version 2.6 or lower), the MDAC installer starts.

You can check which version of MDAC is installed by looking at registry key:
HKEY_CLASSES_ROOT\ADODB.Command\CurVer.
ApogeeX installs MDAC version 2.8.
10 Read the License Agreement, select the “I accept...” check box, and click
Next.
11 After a few moments, you will see:

12 Click Finish to begin the installation.
After a few moments, you will see the following.
13 Select “I will restart the system myself”, and click Finish.
After a few minutes, the installer automatically continues to configure the

Microsoft SQL Server Desktop Engine.
When this is done, you will see:

The MDAC, MSDE SQL server, Wibu Key driver, and Registration Utility are
now installed.
14 Select No, I will restart my computer later, and click Finish to switch back to
the main installer window.
15 Click the Exit button to quit the Installer.
16 Shut down your computer.
17 Attach the yellow ApogeeX dongle to your PC’s USB port.
18 Start your computer.

Windows 2003 Server Installations

If you are installing ApogeeX on a Windows 2003 Server, the procedure varies
slightly at this point. After installing the Prerequisites and restarting the server,
the system will inform you that new hardware has been found.
■ Select 'Install the software automatically (Recommended)', and click Next.
The following security alert is displayed:
■ Click Yes.
The wizard reports that the installation was successful.
■ Click Finish.
The installation continues as for a Windows 2000 server.
Tip: When temporarily The WIBU key should be detected and the driver should be located
removing a USB dongle, you automatically.
should always put it back in
the same USB port, since 19 Check that the SQL server is running: You should see a small server icon in
Windows installs the drivers the Taskbar.
for a specific port.

NOTE: The SQL server needs to be running, since the ApogeeX installer will
write information into the SQL database.
20 Continue with either a Typical or a Custom installation (see “To install

Typical Components” on page 41 and “To install Custom Components” on
page 49).

Installing Typical This is the “easy” installer (for demo or training purposes) which installs the
standard ApogeeX components.
Components
The typical installer installs every component that is selected by default in a
custom install. The components selection window is not displayed, but you are
asked which TIFF device you want to install.
What is installed in a Typical Install?
The following table lists the Task Processors/ApogeeX modules which are
installed, besides the essential framework components:
ApogeeX module Number of instances

AppleTalk
HotFolder
LPR
Named Pipe
TCP/IP
Normalizer 1
Preflight 1
PDFReady 1
Runlist
Impose
Step&Repeat
Render 1
Digital Step&Repeat
Public Pagestore
Export
Agfa Generic Devices Custom selection during installation.
Press 1
" To install Typical Components

1 Make sure you have already installed the Prerequisites.
This is described in “To install Prerequisites” on page 33.
2 Start the Installer by opening Windows Explorer, and double-clicking the

ApogeeX Setup.exe file.

5 Click the Typical Components Install button.
After a few moments, the ApogeeX installation wizard is started.
6 Click Next.
7 Read the License Agreement, and click Yes to accept it.
The Target Directory dialog box is displayed.
You should install the ApogeeX System to D:\Agfa. For more information, see
“What is Installed and Where?” on page 193.
8 Click Next.
The ApogeeX Setup Component Selection dialog box is displayed:

You are next presented with individual windows for each of the components
you selected. For example, if you selected TIFF Imagesetter, you will see:
9 In each of these windows, specify the Root Folder and Share Name for the
selected component, and click Next.
For more information, refer to “List of Components” on page 16.
10 Click Next.
After a few moments, you will see:

11 Enter a name for your ApogeeX System.
NOTE: Do not confuse the ApogeeX System with the ApogeeX Server: The
ApogeeX System comprises all system hardware modules, including the
ApogeeX Server and one or more Satellite servers; The ApogeeX Server is a
single hardware module which runs the core ApogeeX software.
ApogeeX System
ApogeeX Satellite
Server Server
12 Click Next.
Here you can select the disk and folder where your job archives will be stored.

For more information, see “Disk Configuration” on page 15 and “What is

Installed and Where?” on page 193.
13 Select the appropriate disk location, and click Next.
14 Specify the locations of the System and Job Logging files, and click Next.
15 Select the disks you want to use to store your data:
! PDF: For input files and processed PDF's.
! System: For system resources used in jobs -preflight actions, fonts,

calibration curves, etc.
! Raster: For your “Digital Film” raster files.
! Scratch: For temporary files.
NOTE: Instead of local disks, you can also select remote disk locations
(mounted via drive letters).


16 You need to specify the PressRoot.
This is the location where your Inkdrive files are stored (CIP3 Ink Key settings
files).
17 Click Next.
18 Select the disk and folder which will be used to export PostScript and PDF
documents.

19 Check the Hotfolder root location, change it if necessary.
20 Click Next.
21 Review your settings, then click Next to start the installation.
The installation takes approximately 45 minutes, depending on the perfor-

mance of your system. When it has finished, you will see:

22 Select ‘No, I will restart my computer later’ and click Finish.
The following applications should now be running (you can see them in your
Windows Taskbar):
! DefaultLauncher
! S_Launcher.exe
NOTE: This is the ApogeeX ! ApogeeX_System_COMPUTERNAME_2

System name you chose
during installation. ! ApogeeX_System_COMPUTERNAME_4
! FW_JobStoreServer2.exe
! DefaultJobStoreServer
! TrappingService
! S_TrappingService.exe
! S_Launcher.exe
! S_Launcher.exe
If you are running Windows 2003, some of the above components are
grouped together.
23 Shutdown the ApogeeX System as explained in Appendix A, and reboot the

the computer.

Installing Custom A Custom installation allows you to specify which components will be installed,
and where they will be installed.
Components
" To install Custom Components
1 Make sure you have already installed the Prerequisites, as described in “To
install Prerequisites” on page 33.
5 Click the Custom Components Install button.
After a few moments, the ApogeeX installation wizard is started.

6 Click Next.
7 Read the License Agreement, and click Yes to accept it.
The Target Directory dialog box is displayed.
You should install the ApogeeX System to D:\Agfa. For more information, see
“What is Installed and Where?” on page 193.
8 Click Next.
The ApogeeX Setup Component Selection dialog box is displayed:

9 Select the components you want to install.
For more information, refer to “List of Components” on page 16, and to the
ApogeeX 2.5.0 Release Notes which list the supported ApogeeX components.
10 Click Next.
NOTE: If the Installer detects a previous version of the PAC driver, you are
asked if you want to upgrade to the latest PAC driver. In this case, select Yes.
The installation program connects to the SQL Server and writes information
into the database. This may take a couple of minutes.
The installer next allows you to select multiple instances of the modules you
chose to install.
NOTE: You can install multiple instances of some Task Processors on one
hardware platform. For more information, refer to “Supported Multiple Task
Processor Instances” in the ApogeeX Release Notes.

11 Enter the number of instances of each of the components you want to install
(e.g. Press), and click Next.
12 Depending on the number of multiple-instance modules you selected, you

may see two or more windows which allow you to select multiple instances
of these modules. If so, enter your choices and click Next.
13 Click Next.
If you installed the TIFF_Imagesetter, you need to specify the location of the
Imagesetter TIFFroot Folder.
14 Select an appropriate disk for the Imagesetter TIFFroot Folder.
15 Click Next.
If you installed the TIFF_PlateSetter, you need to specify the location of the
PlateSetterTIFFroot Folder.
16 Select an appropriate disk for the PlateSetterTIFFroot Folder.
17 Click Next.

If you installed the TIFF_Proofer, you need to specify the location of the
ProoferTIFFroot Folder.
18 Select an appropriate disk for the ProoferTIFFroot Folder.
You can use this device to write 8-bit TIFF data to disk
19 Click Next.
NOTE: You may also need to specify PDF and PS root folders.
For each Agfa proofing device, ApogeeX asks you to specify if this is a local or
remote proofer. A remote proofer is a proofer which is located at a remote site
(i.e., not in local network).
20 Make your selection, and click Next.
NOTE: If you use remote proofers, you must install the RPC module.

21 Enter a name for your ApogeeX System.
NOTE: Do not confuse the ApogeeX System with the ApogeeX Server: The
ApogeeX System comprises all system hardware modules, including the
ApogeeX Server and one or more Satellite servers; The ApogeeX Server is a
single hardware module which runs the core ApogeeX software.
ApogeeX System
ApogeeX Satellite
Server Server
22 Click Next.
Here you can select the disk and folder where your job archives will be stored.


23 Select an appropriate disk, and click Next.
24 Specify the locations of the System and Job Logging files, and click Next.
25 Select the disks you want to use to store your data:
! PDF: For input files and processed PDF's.
! System: For system resources used in jobs -preflight actions, fonts,

calibration curves, etc.
! Raster: For your “Digital Film” raster files.
! Scratch: For temporary files.
NOTE: Instead of local disks, you can also select remote disk locations
(mounted via drive letters).


26 If you selected the Generic Press Task Processor, you need to specify the
GenericPressRoot.
27 Click Next.
28 If you selected the Press Task Processor, you need to specify the PressRoot.
29 Click Next.

30 Select the disk and folder which will be used to export PostScript and PDF
documents.
31 Check the Hotfolder root location, change it if necessary.
32 Click Next.
33 If you selected the JDF Import Task Processor, specify the JDFImportRoot,
and click Next.

34 If you selected the Packaging JDF Task Processor, specify the Root folder, and
click Next.
Next, you will see:
35 Review your settings, then click Next to start the installation.
The installation takes approximately 45 minutes, depending on the perfor-

mance of your system. When it has finished, you will see:
36 Select ‘No, I will restart my computer later’ and click Finish.
The following applications should now be running (you can see them in your
Windows Taskbar):
! DefaultLauncher

! S_Launcher.exe
NOTE: This is the ApogeeX ! ApogeeX_System_COMPUTERNAME_2

System name you chose
during installation. ! ApogeeX_System_COMPUTERNAME_4
! FW_JobStoreServer2.exe
! DefaultJobStoreServer
! TrappingService
! S_TrappingService.exe
! S_Launcher.exe
! S_Launcher.exe
If you are running Windows 2003, some of the above components are
grouped together.
37 Shutdown the ApogeeX System as explained in Appendix A, and reboot the

the computer.

60 INSTALLING ADDITIONAL COMPONENTS
Installing Additional Components

After you have installed the ApogeeX System, you may later want to add compo-
nents, such as extra output devices, press configurations, etc. You can do this by
again running the ApogeeX System Installer. The Installer automatically detects
if you have previously installed ApogeeX, and adapts the available installation
options accordingly.
NOTE: You can install additional components on both an ApogeeX Server and on
a Satellite system.
" To install components

1 Make sure that the ApogeeX System is running.
4 Double-click ApogeeX System.
5 Click the Custom Components Modify button.
6 Choose Custom Install and click Next.

7 Select the modules and/or components you want to install, and click Next.
If you are installing a component which can have multiple instances (such as
a Press or Proofer), then you will see an extra window where you can specify
the number of additional instances you require.
Refer to the ApogeeX Release Notes for information on supported multiple

Task Processor instances.
If you are installing a proofer, you need to specify whether ApogeeX will have
a direct or remote connection to the proofer:

62 INSTALLING ADDITIONAL COMPONENTS
8 Click Next.
You will see a summary of all selected components.
9 Click Next.
The selected components are installed.
10 Click Finish.

After installing additional components, you are advised to restart the

ApogeeX System.

64 INSTALLING A SATELLITE SYSTEM
Installing a Satellite System

To provide faster and more efficient use of tasks and resources, your ApogeeX
System processes may be distributed over 2 or more physical hardware systems,
providing hardware system scaleability. In this case, you need to install
additional “Satellite” systems.
When you start the ApogeeX Client, you will see the “satellite” Hardware System
icons in the Hardware pane. The Hardware System that is highlighted in bold is
the ApogeeX Server, which is running the “core” ApogeeX System software.
NOTE: After installing a Satellite system, you can later install additional
components, as described in “Installing Additional Components” on page 60.
Before You Begin ■ The ApogeeX System must be running, although it does not yet need to be
licensed.
■ Make sure that the ApogeeX Satellite has a working network which allows
communication with the ApogeeX Server.
■ Multiple Satellite Systems: You can install as many Satellite systems as you
need, although you will need the full SQL Server license if you use more than
one Satellite system (see “Upgrading ApogeeX MSDE to SQL Server” on
page 168).
■ Make sure that the name of the computer on which you are going to install
the Satellite using only the character a-z, A-Z, or 0-9. The name must not
contain dashes, underscores or spaces, since some DNS servers do not
support these characters.
■ You are advised to use the same Windows username and password on the
Satellite system as on the ApogeeX Server.
CAUTION: Do not try to install multiple Satellite systems at the same time. You
should install them one by one. You should only proceed with a second
Satellite installation when the first one has been completed.
" To install a satellite system

1 Start the normal ApogeeX installation on the Satellite system by double-
clicking the ApogeeX Setup.exe file.

4 Select Custom Components - Install.
After a few minutes, the Welcome screen is displayed.
5 Click Next.
6 Click Yes to accept the License Agreement.
7 Click Yes.
8 Choose an appropriate location to install the software, and click Next.
The Component Selection window is displayed.
9 First, clear all Module check boxes.
10 Select the Task Processors you want to install on the Satellite system.
Refer to the ApogeeX Release Notes for information on supported Task

Processors on a Satellite system.

CAUTION: If you install a high-resolution output device such as PrintDrive or

Palladio, then you must also select the Renderer component (RenderOnce
module). You also need to select the PreviewService component (Preview
module), when you install a local StorageServer (see below).
11 Click Next.
If you selected a High Resolution Output Device, you will see the following
screen:
The Satellite system can have a local storage server when using a High
Resolution Output Device. This is a service which keeps track of where the
data is stored.
If you do not install a local StorageServer, then the data will be stored on the
ApogeeX Server.
NOTE: If you installed a local StorageServer, then MDAC version 2.8 is

automatically installed.
12 Select Yes to install a local storage server.
13 Click Next.
Depending on the components you selected earlier, you will see one or more
windows which allow you to specify the number of instances you require of
each of the selected components.

14 Enter the number of instances for each of the components you want to install,
and click Next.
Refer to the ApogeeX Release Notes for information on supported multiple

Task Processor instances.
The installer searches the network for an ApogeeX System.
15 Select the ApogeeX System on which the Satellite should be registered.
Alternatively, if your ApogeeX System is not listed, you can manually enter
the IP address of the ApogeeX System.
16 Click Next.
NOTE: If you chose to install a local StorageServer, you will see the following
screen.

17 Select the Raster and Scratch folders, and click Next.
You are advised to place the Scratch and Raster folders on different disks.
Depending on the components you selected earlier, you will see one or more
windows which allow you to specify the locations and sharenames of each of
the selected components.
18 Click Next.
After a few moments, you will see the following:
19 Read the summary, and then click Next
The installation will start. This takes several minutes.
When it has finished, you will see:

20 Select No, and click Finish.
You now need to reboot the Satellite, but before doing this, you must first
close down the Satellite components.
21 Since the Satellite does not have a Console, you must close down the
ApogeeX components manually. You can do this by context-clicking the
components in the Windows taskbar, and selecting “Close”. You must close
down the components in the following order:
! ApogeeX_Server_3 (ApogeeXSYSTEMNAME_COMPUTERNAME3)
The remaining ApogeeX components will close automatically.
22 Shut down the ApogeeX System, and reboot the ApogeeX Server and
ApogeeX Satellites.

70 INSTALLING A FAILOVER SYSTEM
Installing a Failover System

A Failover system is an exact duplicate of your ApogeeX Server, and provides you
with a system backup in the event of a major system crash. A Failover System
does not require a dedicated hardware platform: It can be installed on the Satel-
lite platform.
Before You Begin
■ Make sure that the Failover operating system is identical to the ApogeeX
Server operating system.
■ Make sure that the Failover hard disk configuration is identical to the
ApogeeX Server hard disk configuration. The hard disks must have at least
the same capacity as the ApogeeX Server hard disks.
" To install a failover system

1 Before starting, install the ApogeeX Prerequisites on the Failover system.
You need to do this since MSDE is required (see “Installing Prerequisites” on

page 33). MSDE must be installed in the same location as the ApogeeX Server
software.
2 Copy the failover.ini file from the ApogeeX Server System to a location of
your choice on the Failover system.
You can find the Failover.ini file on the ApogeeX Server System, in the
Agfa\ApogeeX folder. The Failover.ini includes information regarding the
installed Task Processors on the server.
3 Double-click the Failover.ini file.

You will see a list of the ApogeeX components which are installed on the
Server for which you are creating a Failover system.
At the end of the Failover.ini file, you will see the computer name associated
with this Failover file.
CAUTION: Make sure that you select the correct Failover.ini file: An ApogeeX
Satellite also has a Failover.ini file, however this file cannot be used.
4 On the Failover system, open Explorer, and double-click the ApogeeX

Setup.exe file.

72 INSTALLING A FAILOVER SYSTEM
7 Click the Failover Install button.
8 Step through the Welcome and License screens.
You must next select the folder where you saved the failover.ini file.
9 Use the Browse button to locate the folder to which you copied the
Failover.ini file.
[
10 Click Next.
11 Select the location in which you want to install the Failover system.
We strongly recommend you use the same location as used on the ApogeeX
Server.

NOTE: You can also choose the same location as the Satellite system software:
In this case, a separate subfolder will be created.
12 Click Next.
You will see an installation summary.
13 Click Next again.
The Failover installation takes approximately 45 minutes. The Failover

installer will only install the ApogeeX software and MSDE: It creates share
folders for the installed components such as HotFolderRoot, JDFImport, etc.,
however it does not create ApogeeXDataStore folders, where you can choose
where to store your Raster, System, PDF, and Scratch data.
For more information, refer to “What is Installed and Where?” on page 193.
" To update a failover system

You will need to re-run the Failover system installation if you install a new Task
Processor on the ApogeeX Server after installing the Failover system.
1 Copy the updated Failover.ini file from the ApogeeX Server to your Failover
system.
2 Start the ApogeeX Failover installer, as described in “To install a failover

system” on page 70, and select the updated Failover.ini file.
This process will install only the new Task Processor.

74 INSTALLING APOGEEX CLIENTS
Installing ApogeeX Clients

The ApogeeX Client is available in two versions:
■ Windows Client
■ Macintosh Client
The Client runs on Mac OS 9.2 or higher, and Mac OS X (10.2 or higher).
The Installer for both clients is automatically shared on the computer on which
the ApogeeX Server is installed, in the following location:
...\\<ApogeeXServer>\ApogeeXSupportFiles\ClientInstallerMac
...\\<ApogeeXServer>\ApogeeXSupportFiles\ClientInstallerPC\setup.exe
NOTE: The Macintosh Client Installer requires 971 MBytes on older HFS disks.
This is not the case on HFS+ disks.
If you are upgrading your ApogeeX System from version 2.1.1, then new
ApogeeX Clients, including QmsX (Windows and Macintosh), must be used. An
ApogeeX 2.1.1 Client (or earlier) cannot be used with an ApogeeX 2.5.0 System
(the ApogeeX System will be grayed out in the logon window). In this case, you
should first uninstall the old clients and then install the new clients (see
“Uninstalling ApogeeX Clients” on page 96).
" To install the Windows Client

1 Start the Installer (setup.exe).
The ApogeeX Client installation wizard is started. This wizard installs the
ApogeeX software and Online Help.

2 Click Next.
o
3 Select ‘I accept the terms in the license agreement’, and click Yes.
You can choose a Complete or a Custom installation:
! Complete installation: Automatically installs the English documentation,

and installs all Agfa plug-ins for Quark and Acrobat (if these applications
are installed on your system).

! Custom installation: Allows you to select any of the available documenta-

tion languages, and to choose whether or not you want to install plug-ins
and QmsX.
4 Choose Custom, and click Next.
5 Select any of the available documentation languages, choose whether or not

you want to install plug-ins and QmsX, and click Next.
6 Click Install to start copying the files.

After the files have been copied, you will see:
7 Click Finish.
" To install the Macintosh Client on OS 9 systems

1 Copy the ApogeeX ClientInstaller.hqx file from the ApogeeXSupportFiles
folder to your Macintosh desktop.
2 Double-click the .hqx file to decompress it.
You need to use Stuffit Expander 7.0 or higher.
3 Start the ApogeeX ClientInstaller from your Macintosh desktop.
The ApogeeX Client Installer wizard starts.

4 Click Continue.
5 Click Continue.

You can choose an Easy Install or a Custom Install.
! Easy Install: Automatically installs all Agfa plug-ins for Quark and
Acrobat (if these applications are installed on your system).
! Custom Install: Allows you to select the plug-ins you require.
NOTE: All documentation languages are installed. By default, the selected

language will match the language of your operating system: This cannot be
changed.
6 Make your choice, and click Install.

7 Click Quit.
" To install the Macintosh Client on OS X systems

1 Copy the ApogeeX ClientInstaller.hqx file from the ApogeeXSupportFiles
folder to your Macintosh desktop.
2 Double-click the .hqx file to decompress it.
You need to use Stuffit Expander 7.0 or higher.
3 Start the ApogeeX ClientInstaller from your Macintosh desktop.
The following Authentication dialog box is displayed:
4 Enter your name and password, and click OK.
The ApogeeX Client Installer wizard starts.

5 Click Continue.
6 Click Continue.

You can choose an Easy Install or a Custom Install.
! Easy Install: Automatically installs all Agfa plug-ins for Quark and
Acrobat (if these applications are installed on your system).
! Custom Install: Allows you to select the plug-ins you require.
NOTE: All documentation languages are installed. By default, the selected

language will match the language of your operating system (which can be
changed if necessary).
7 Make your choice, and click Install.

8 Click Quit.
NOTE: The QmsX documentation is provided in English only. The ApogeeX Client
documentation is available in English, French, German, Italian, Spanish and
Japanese.

84 MANUALLY INSTALLING AGFA PLUGINS/EXTENSIONS
Manually Installing Agfa Plugins/Extensions

The Agfa plug-ins are normally installed automatically on Windows and Macin-
tosh systems during installation of the ApogeeX Client software, if Quark and/or
Acrobat are already installed on these systems. However, in some situations you
may have to install the plug-ins manually, as described below.
CTIFF Macintosh Windows

QuarkXPress • Copy the AgfaCTIFF.xnt file to the • Copy the AgfaCTIFF.xnt file to the
XTension folder of your QuarkXPress XTension folder of your QuarkXPress
application. application.
Trapping Macintosh Windows

QuarkXPress • Copy the AgfaTrapping.xnt file to • Copy the AgfaTrapping.xnt file to
the XTension folder of your QuarkX- the XTension folder of your QuarkX-
Press application Press application
Acrobat OS9: • Copy the AgfaRipTrap3.api and
• Copy the AgfaRipTrap file to the AgfaRipTrap.prefs files to the plug-
plug-ins folder of your Acrobat ins folder of your Acrobat applica-
application. tion
OSX:
1 Context click the Acrobat
application.
2 Select “Get Info”.
3 Expand the Plug-ins section, and
add the AgfaRIPTrap plug-in.
4 Close the “Get Info” window.
Spot Trapping Macintosh Windows

Acrobat OSX: • Not available.
application.
add both the ApogeeX
ResourceChecker.acroplugin and
the ApogeeX
SpotTrapping.acroplugin.

Alternate Image Macintosh Windows

Viewer Acrobat OS9: • Copy the ApogeeX Alternate
• Copy the ApogeeX Alternate Image.api file to the plug-ins folder
Image file to the plug-ins folder of of your Acrobat application.
your Acrobat application.
OSX:
application.
add the AlternateImage plug-in.
DocuBox Manager Macintosh Windows

Acrobat OS9: • Copy the ApogeeX DocuBox Man-
• Copy the DocuBox Manager file to ager.api file to the plug-ins folder of
the plug-ins folder of your Acrobat your Acrobat application.
application.
OSX:
application.
add the DocuBox plug-in.

86 MANUALLY INSTALLING AGFA PLUGINS/EXTENSIONS

CHAPTER
3 Uninstalling ApogeeX
This chapter describes how to uninstall the ApogeeX Server and the Satellite and
Failover systems. Information is also provided on uninstalling ApogeeX Clients
and components.
! Uninstalling the Complete ApogeeX System ............................................. 88

! Uninstalling an ApogeeX Component ........................................................... 90
! Uninstalling a Satellite System ........................................................................ 93
! Uninstalling a Failover System ......................................................................... 94
! Uninstalling ApogeeX Clients ........................................................................... 96
! Unregistering Satellite Services ....................................................................... 97
! Unregistering Satellite Task Processors ..................................................... 100
87
88 UNINSTALLING THE COMPLETE APOGEEX SYSTEM
Uninstalling the Complete ApogeeX System

To uninstall a complete ApogeeX System, you must uninstall the software in the
following order:
1 ApogeeX Patches - Server and Satellite
2 ApogeeX Failover System
3 ApogeeX Satellite System(s)
4 ApogeeX Server
5 MSDE
6 WIBU
7 ApogeeX Clients
8 Registration Utility
NOTE: After you have finished uninstalling the software, you are advised to check
the Registry directory for any entries that were not removed by the uninstaller.
" To uninstall ApogeeX Patches
Refer to the Release Notes on the ApogeeX Patches. These can be found in the
Agfa\ApogeeX folder.
" To uninstall an ApogeeX Failover system
Refer to “Uninstalling a Failover System” on page 94.
" To uninstall an ApogeeX Satellite system
See “To uninstall an ApogeeX Satellite system” on page 88.
" To uninstall the ApogeeX Server

1 Shut down the ApogeeX System (see “Starting and Stopping the ApogeeX
System” on page 190) and reboot the computer.
2 When the computer has started, make sure that the SQL server is running so
that the databases can be removed while ApogeeX is being uninstalled.
You should see a small server icon in the Taskbar.

3 UNINSTALLING APOGEEX 89
3 Choose Start > Settings > Control Panel: Add/Remove Programs.
4 Click Yes to confirm.
If there are still Satellite systems which have not yet been uninstalled, then
the installer will report this as follows:
5 Click Next.
6 Deselect the shares which need to be removed by the ApogeeX uninstaller,

and click Uninstall to remove them.
" To uninstall MSDE/SQL

2 Select the Microsoft SQL Server Desktop Engine, and click Remove.
4 If SQL Server is installed, select the Microsoft SQL Server 2000, and click
Remove.

90 UNINSTALLING AN APOGEEX COMPONENT
NOTE: The MSDE/SQL databases will not be removed by the uninstaller.
" To uninstall the WIBU driver

2 Remove the Wibu key (software and hardware).
" To uninstall the ApogeeX Registration Utility

2 Remove the Registration Utility.
Uninstalling an ApogeeX Component

You can uninstall individual ApogeeX components (on an ApogeeX Server or a
Satellite system) as described below.
" To uninstall components

1 Make sure that the ApogeeX System is running.
3 Double-click ApogeeX System.
4 Click the Custom Components Modify button.

5 Choose Custom Uninstall and click Next.
You will see a list of only the installed modules.
6 Select the modules and/or components you want to uninstall.
NOTE: Do not uninstall any of the “essential” components (see “List of

Components” on page 16.
7 Click Next.

92 UNINSTALLING AN APOGEEX COMPONENT
8 Check the summary information, and click Next.
ApogeeX will stop, unregister, and then remove the selected modules and/or
components. When this process has completed, you will see the following:
Click OK.
NOTE: You will no longer be able to open any jobs, tickets, or ticket templates
which use components that you have uninstalled.

Uninstalling a Satellite System

You can uninstall an ApogeeX Satellite system as described below.
" To uninstall an ApogeeX Satellite system

1 Make sure that the ApogeeX Server is running.
2 Close the Satellite components.
3 On the Satellite system, choose Start > Settings > Control Panel: Add/
Remove Programs.
4 Select ApogeeX 2.5.0, and click Change/Remove.
5 Click Yes.
6 Select the ApogeeXDatastore if you want to remove it, and click Uninstall.
The Uninstaller starts to unregister the Satellite components on the ApogeeX

System, and to delete the Satellite System.
When this process is complete, you will see the following confirmation:

94 UNINSTALLING A FAILOVER SYSTEM
7 Click OK to finish.
8 Close the Add/Remove Programs dialog box.
Uninstalling a Failover System

You can uninstall an ApogeeX Failover system as described below.
" To uninstall an ApogeeX Failover system

1 Make sure that the ApogeeX Server is running.
2 On the Failover system, choose Start > Settings > Control Panel: Add/
Remove Programs.
3 Select ApogeeX 2.5.0 Failover, and click Change/Remove.

4 Click Yes.
The Uninstall shield starts to unregister the Failover components on the

ApogeeX System, and delete the Failover System.
5 When this process is complete, you will see the following confirmation:
6 Click OK to finish.
7 Close the Add/Remove Programs dialog box.

96 UNINSTALLING APOGEEX CLIENTS
Uninstalling ApogeeX Clients

You can uninstall the Windows and Macintosh Clients as described below.
" To uninstall ApogeeX Windows Client(s)

2 Remove the ApogeeX Client.
NOTE: You should also delete the Client Preferences from ApogeeX
(C:\Documents and Settings\<username>\Application
Data\Agfa\AgfaApogeeX.prefs). Normally, the plug-ins are also removed. If
not, you should manually delete them from the Plug-ins\Extensions folders.
The Application Data folder is a hidden folder: You therefore need to show
hidden files and folders in your operating system settings.
" To uninstall ApogeeX Macintosh Client(s)

1 Drag the ApogeeX Client application to the Trash Can.
2 Manually remove the Preferences file from the following folder:
OS9:
...System Folder\Preferences\Agfa\ApogeeX <version no>Preferences.
OSX:
...Users\<username>\Library\Preferences\Agfa\ApogeeX <version
no>Preferences.
3 Manually remove the plug-ins/extensions (see “Manually Installing Agfa

Plugins/Extensions” on page 84).

Unregistering Satellite Services

If you uninstalled a Satellite system while the system did not have an active
network connection with the ApogeeX Server, you must manually unregister the
Satellite services on the ApogeeX Server. Unregistering a service means that it
will be removed from the ApogeeX database. You will also need to manually
unregister the Satellite Task Processors as described in “Unregistering Satellite
Task Processors” on page 100.
This section explains how to unregister Satellite Services on the ApogeeX Server
using the Service Tool.
" To unregister Satellite Services

1 Start the ApogeeX Server.
2 Start the ApogeeX Console.
Services from the Satellite system are displayed in italics. Services which can
no longer be started because the Satellite software was removed will not
have a green checkmark. These services should be removed from the
ApogeeX Server using the Service Tool.
3 Click the Monitor button to start the Service Tool.

98 UNREGISTERING SATELLITE SERVICES
4 Type ‘a’ to select the ApogeeX Server.
5 Enter your Windows logon name and password.
A new list of commands is displayed.
6 Type ‘j’ to uninstall a Service.

7 Enter the name of the Service you want to uninstall.
CAUTION: Commands in the Service Tool are case-sensitive. You must enter
the name EXACTLY as it appears in the Console.
8 Press Enter.
9 Type ‘y’ to confirm.
10 Close and restart the Console.
You should see that the Service has been removed.

100 UNREGISTERING SATELLITE TASK PROCESSORS
11 Repeat this procedure for all Services that were installed for the Satellite
system (i.e. all services displayed in italics, without a green checkmark).
Unregistering Satellite Task Processors

If you uninstalled a Satellite system while the system did not have an active
network connection with the ApogeeX Server, you must manually unregister the
Satellite Task Processors on the ApogeeX Server. Unregistering a Task Processor
means that it will be removed from the ApogeeX database. You will also need to
manually unregister the Satellite services on the ApogeeX Server as described in
“Unregistering Satellite Services” on page 97
This section explains how to unregister the Satellite Task Processors using the
Service Tool.
" To unregister Satellite Task Processors

1 Start the ApogeeX Server.
2 Start the ApogeeX Client, and open the System Overview window.
3 Select the Satellite hardware system that you previously uninstalled, but
which is still registered in the ApogeeX database.
4 Check which ApogeeX Task Processors were installed on this Satellite

system.
5 Start the ApogeeX Console.
6 Click the Monitor button to start the Service Tool.

7 Type ‘a’ to select the ApogeeX Server.
8 Enter your Windows logon name and password.
A new list of commands is displayed.
9 Type ‘k’ to uninstall a Task Processor.

102 UNREGISTERING SATELLITE TASK PROCESSORS
10 Enter the name of the Task Processor you want to uninstall.

CAUTION: Commands in the Service Tool are case-sensitive. You must enter
the name EXACTLY as it appears in the System Overview!
11 Press Enter.
12 Type ‘y’ to confirm.
CAUTION: If the uninstall fails, you will have to use the internal name of the
Task Processor you want to uninstall. Open the Service Tool and type ‘a’ for
Apogee Server, then type ‘c’ for Monitor, then type ‘c’ again for Task
Processors.
13 Look in the System Overview - you should see that the Task Processor icon
has been removed from the Satellite system.
14 Repeat this procedure for all Task Processors that were installed on the Satel-
lite system.

CHAPTER
4 Installing WebApproval
This chapter provides installation and configuration information for the 2
components of WebApproval: the WebServer and the Application server. The
Application server runs on Windows® 2003 (Server) and Windows Server 2003
- Standard and Enterprise versions.
! Before You Begin ................................................................................................ 104

" Where WebApproval Should Be Installed .......................................... 104
" Recommended Configuration ................................................................. 104
" Prerequisites ................................................................................................. 106
" Installation Checklist ................................................................................. 106
! Installing WebApproval on the ApogeeX Server .................................... 107
! Installing the WebApproval Application Server ...................................... 110
! Installing the WebServer ................................................................................. 118
" Installing Windows 2003 on a Hardware-only System ................. 119
" Setting up the WebServer Hardening .................................................. 120
" Installing the WebApproval WebServer ............................................. 123
! Configuring ApogeeX ........................................................................................ 130
" Configuring a Mail Server in ApogeeX ................................................ 130
" Configuring WebApproval Services in ApogeeX ............................. 131
" ApogeeX Operator Prerequisites ........................................................... 135
! Microsoft Updates ............................................................................................... 136
" Installing Hotfix Updates .......................................................................... 136
103
104 BEFORE YOU BEGIN
Before You Begin

This section describes where WebApproval should be installed and how it needs
to be configured. It also describes the supported operating system and web
browsers.
Where The WebApproval Application Server can be installed:

WebApproval ■ On the ApogeeX Satellite Server system.
Should Be Installed
■ On the system where an Apogee PrintDrive or PDFRip is running. In this case,
be sure to select a different TCP/IP port than the default (5000).
NOTE: The WebApproval Application Server should not be installed on the

ApogeeX System server. This is not supported.
The WebApproval WebServer must be installed on a specific TKS system.

Installing the WebServer on a different system is not supported.
Recommended WebApproval comprises 2 components that need to be installed individually:

Configuration ■ The WebServer: Sets up the WebApproval website.
■ The Application Server: Contains the business logic, and connects to the
ApogeeX Server.
Outside customer ‘s Firewall Customer’s Intranet zone

F
I
WebApproval Port 5000
R Port 5000
WebApproval ApogeeX Server
WEBSERVER E APPLICATION
SERVER
Internet Information W
Server
A
L
L
Web Client user

4 INSTALLING WEBAPPROVAL 105
Normally, you should install these components on different machines. Typically

the WebServer is installed outside the customer’s firewall (the so-called demili-
tarized zone), and the Application Server is installed on the internal network
behind a firewall. In such a configuration, the firewall and routers have to be
configured to allow the following traffic:
■ Communication between WebServer and Application Server:
! one TCP/IP port: default 5000
■ Communication between Application Server and ApogeeX Server:
! File and Print sharing: 139
! CORBA
■ Communication between ApogeeX Server and Mailserver (SMTP)
! Port 25
■ Communication between WebServer and Internet (WWW)
! Port 80 HTTP
! Port 443 HTTPS
■ Communication between ApogeeX and ApogeeX Client
! CORBA
No Firewall Between WebServer and Application Server
If there is no firewall between the WebServer and the Application server (i.e.,
they are both on the internal network, as indicated in the illustration below),
then you will need to do some additional hardening that will restrict access to
the WebServer. For more information, refer to “To apply additional Hardening”
on page 122.
NOTE: Because of possible security issues, this configuration is not

recommended: It should be used only if the customer requests it.

106 BEFORE YOU BEGIN
Outside customer ‘s Customer’s Intranet zone

Firewall
F
I
R Other systems
APPLICATION
WEBCLIENT E WEBSERVER on internal
SERVER
network
W
A
L
L
Prerequisites ■ ApogeeX must already be installed before you install the WebApproval Appli-
cation Server.
■ To configure the ApogeeX WebApproval service you need Service Level

Access.
■ Use full duplex for your entire network structure (network cards, switches,
routers, etc.). We recommend that you use the Autosense option if available,
and that you use a 100 Base T network structure or better.
■ In order to send e-mails, a correct mail server must be configured in the

ApogeeX Client.
Installation Before continuing...

Checklist Write down the following names, numbers, and IP addresses. You will need this
information during each of the installation procedures.
Required for the WebApproval Application Server installation...

ApogeeX Server Computer Name
ApogeeX Server IP Address
WebServer Port Number (default 5000)
Required for the WebApproval WebServer installation...

Application Server IP Address
Application Server Port Number (default 5000)
Virtual Directory Name
Port Number for Website (default 80)

Required for the ApogeeX Server configuration...

WebApproval URL
E-mail Domain Name (or E-mail
Address)
Printer Company Name
Mail Server Name
Installing WebApproval on the ApogeeX Server

This section describes how to install WebApproval on the ApogeeX Server. You
must do this first.
" To install WebApproval on the ApogeeX Server

1 Go to the ApogeeX Server and make sure that ApogeeX is running.
Your installation options are displayed.

108 INSTALLING WEBAPPROVAL ON THE APOGEEX SERVER
5 Click the Custom Components - Modify button.
6 Select Custom Install, and click Next.
7 Select the Framework module, then select the WebApproval component.

8 Browse to the bottom of the modules list, select the WebInput module, then
select the WebUpload component.
9 Click Next.
10 Check the summary information, and click Next.
After a few minutes, you will see the following:
11 Select ‘No, I will restart my computer later’, and click Finish.

110 INSTALLING THE WEBAPPROVAL APPLICATION SERVER
NOTE: The WebApproval service is automatically started, however the

WebUpload Task Processor is not started: It must be manually started.
Installing the WebApproval Application Server

This section describes how to install the WebApproval Application Server. The
Application Server contains the business logic, and connects to the ApogeeX
Server. Typically the Application Server is installed on the customer’s internal
network behind a firewall.
" To install the Application Server

1 Make sure that ApogeeX Server is running.
2 Go to the system which will be used to run the WebApproval Application

Server.

5 Click ApogeeX WebApproval.
You can choose to install either of the following:
! Application Server: Contains the business logic, and connects to the

ApogeeX Server.
! Web Server: Sets up the WebApproval Web Server.
You need to install the Application Server before you install the Web Server.
6 Click the Application Server - Install button.

7 Click ‘Yes’ to install the Microsoft.Net 1.1 framework.
Microsoft.Net 1.1 framework must be installed.
8 Select ‘I agree’, and click Install.
The Microsoft.Net 1.1 framework and Service Pack 1 are installed. Be

patient, as it takes some time to finish.
9 Click OK to finish the Microsoft.Net framework setup.

You need to reboot the system. However, if any applications are running on
the system, you need to stop them before rebooting.
10 Click Restart to reboot the system.
After rebooting, the WebApproval Application Server Installation wizard

starts automatically.
NOTE: If the wizard does not start automatically, you need to manually run
the Application Server installer.
11 Click Next to display the License Agreement.

Next.
13 Change the folder, or accept the default location for installing the WebAp-
proval Application Server, and click Next.

14 For ‘The computer name of the ApogeeX server’, enter the name or IP address
of the computer on which the ApogeeX framework is installed (you can enter
a computer name if a DNS server is available).
15 The “network traffic originating from the web server...” option is only
required if:
! The firewall between the Application server and the Web server uses port
forwarding. In this case, enter the IP address of the firewall.
! The Application server has 2 network cards, and the network card used to
communicate with the Web server is not the first (in order). In this case,
enter the IP address of the second network card (i.e., of the Application
server).
NOTE: For more information on the order of network cards, refer to the
ApogeeX Service Guide.
16 For ‘The Port number to communicate with the Web server’, choose your
TCP/IP port number, or accept the default choice (5000).
NOTE: The Apogee PrintDrive and Apogee PDFRip joblog also use the same
default TCP/IP port number (5000). You must choose a different port
number than used by these or any other applications.
The WebApproval Application server only needs 1 TCP/IP port number to

communicate with the Web server.

17 Select a folder to cache all files that are submitted/uploaded to

WebApproval.
NOTE: For security reasons, you should choose a folder that is not on the same
drive as the Operating System and the Application.
18 Click Next.
19 Select a folder which the Application server will use to store log files, and
click Next.
20 Choose Complete and click Next.

21 Click Install.
The Installer starts copying files. When all files are installed, it will attempt
to start the Service.
If this is a new install of the Application server, you must have entered the
ApogeeX Server name exactly, and the ApogeeX Server must be running and
available on the network.
When the installation is finished, you will see the following:

118 INSTALLING THE WEBSERVER
22 Click Finish.
The WebApproval Application Server is now installed.
The following three services are added:
! The ApogeeX Server Monitor
! ApogeeX WebApproval
! ApogeeX WebApproval Logging
Installing the WebServer

This section describes how to install the WebApproval WebServer. The
WebServer sets up the WebApproval website.
The WebServer is located outside your company’s firewall, and can be accessed
by all Internet users who log on to it. However, the only communication between
the WebServer and the Application server (located behind the firewall) is via

port 5000 (default), or the port you specified when installing the Application
server.
The WebApproval WebServer must be a dedicated hardware system (i.e. no

software other than the WebApproval software should be installed on it). Refer
to the WebApproval PIM for the hardware specifications.
There are two possible hardware configurations:
■ A hardware-only system.
■ The pre-installed WebApproval WebServer TKS system.
Installing Windows Before you begin...

2003 on a
Hardware-only Before installing the WebServer on the WebServer system, you have to reinstall
the whole Operating System with a prepared CD for “hardening”. This will
System format all disks on the WebServer machine, install Windows 2003 Server with
Service Pack 1, and secure your system.
■ You should have your Windows 2003 Server license key available (Full
Version).
■ Disconnect from the network: During the automatic installation, an IP

address will be assigned to the network card. You can change this IP address
during installation.
■ All disks will be formatted during the install!

CAUTION: You should not perform this procedure if you ordered the pre-
installed WebApproval WebServer TKS system.
" To install Windows 2003

1 Open the BIOS settings of the computer and enable 'boot from CD'.
Set the system to boot first from CD.
2 Insert the WebApproval Hardening CD.
3 Reboot the Web server machine.
4 You will see a ‘Press any key to boot from CD’ message during the boot proce-
dure. You need to press any key during startup to boot from CD.
The Windows installer starts. After formatting and copying the files, the
server reboots automatically.

After reboot the installation continues, and finally the Windows 2003
License Agreement is displayed.
5 Select ‘I accept this agreement’, and click Next.
The installer continues installing devices. After a few minutes, you are asked
to enter your license key.
6 Enter the Win2003 license key that uniquely identifies your copy of the
operating system, and click Next.
NOTE: The administrator’s password is set to blank.
Setting up the You need to run the following procedure for a hardware-only configuration and
for a pre-installed WebApproval WebServer TKS system.
WebServer
Hardening
" To set up the WebServer Hardening
1 Check if there are new Windows security patches available (refer to
“Microsoft Updates” on page 136).
2 If there are, copy them into the corresponding Updates folder on the C drive
(there are 3 different Updates folders).
Any new patches found in the Updates folders will be automatically installed.
For more information on installing these security patches, refer to “Microsoft

Updates” on page 136.
3 Double-click the WebServer Hardening shortcut that appears on your

Desktop.
NOTE: This program will enable/disable/install all the necessary settings for
you.
A message appears asking if you are sure you want to start the hardening
now.
4 Click Y (Yes).
For the next few minutes, a series of windows is displayed during the
WebServer hardening procedure. The WebServer then reboots. After reboo-
ting, you are automatically logged on and the partitions are created. The
hardening then continues, installing the .NET and IIS applications, and
security updates.

NOTE: This step does not The following message then appears:
occur on TKS systems!
'Remove the Windows CD from the CD drive'
5 Remove the Windows CD, and click OK.
The system automatically reboots.
After the system reboots, some additional hardening is performed, and the
system reboots again.
WARNING: After the second reboot, a message appears: “Windows File Protection”, and you
are asked to insert a CD. Ignore this message and click Cancel, then click Yes to
confirm. You will need to repeat these steps several times!
The system automatically reboots a third time, and then the following
message appears:
'Make sure that the network cable is connected before continuing'
6 Connect your network cable, and click OK.
The Finalize Installation dialog box is displayed.
7 Enter the Password for the renamed Administrator account.
NOTE: The network 8 Enter the network address, the subnet mask, the default gateway and the
address fields do not Application Server address and Port number.
provide standard text-
editing behavior. You 9 Click OK.
need to position your
cursor in the exact NOTE: Remember the renamed Administrator name and password for the
insertion point. next time you logon. The default name is “dmzwebadmin”.
10 Choose your regional and language options and click OK.
11 Choose the date and time properties and click OK.
The system will be restarted.
12 Press CTRL+ALT+DEL.
The following message appears:
‘ATTENTION: Authorized users only, violators may be prosecuted to the

fullest extent of the law. Your access may be monitored and recorded for
quality assurance, security, performance, and maintenance purposes.’
13 Click OK.

14 Log on with the renamed Administrator username and password.
After some final hardening, a message appears indicating that the hardening
is complete.
15 Click OK.
16 Close the DOS window.
On the desktop you will see a shortcut to the WebServer Hardening Log file,
which describes all the steps of the installation.
17 After installing Windows 2003 Server, disable boot support from CD in the
BIOS.
NOTE: Your Windows system will stop working unless it is activated within the
30-day evaluation period. Follow the activation wizard instructions to activate
your Windows license: This can only be done via the telephone.
" To apply additional Hardening
NOTE: This procedure is required only when there is no firewall between the
WebServer and the Application Server.
1 Select Start > Administrative Tools > Local Security Policy.
2 Select IP Security Policies on Local Computer.
3 Double-click ApogeeX WebApproval WebServer.
4 Edit HTTP server.
NOTE: If you also use secure HTTP, repeat the following steps for HTTPS.
5 Select Edit again for HTTP server.
6 Select Edit for a third time.
7 Change the source IP address to: 'A specific IP address'.
8 Enter the IP Address of the firewall.
9 Confirm and save your settings.

Installing the Once you have run the WebApproval Hardening CD installer, you are ready to
install the WebServer.
WebApproval
WebServer
" To install the WebServer
1 Go to the system which will be used to run the WebApproval WebServer.
2 Insert the ApogeeX 2.5.0 DVD, and start the Installer by double-clicking the
ApogeeX Setup.exe file.
o
4 Select ApogeeX WebApproval.

You can choose to install either of the following:
! Application Server: Contains the business logic, and connects to the

ApogeeX Server.
! Web Server: Sets up the WebApproval WebServer.
5 Select Web Server - Install.
6 The Web Server installer is started.

7 Click Next to display the License Agreement Screen.
8 Select ‘I accept the terms of the license agreement’ and click Next.

9 Enter the IP address of the computer where you installed the WebApproval
Application Server.
NOTE: If the firewall between the WebServer and the Application server uses
port forwarding, enter the firewall IP address!
10 Enter the same port number that you used for the WebApproval Application
Server's communication with the WebServer.
The default number is 5000.
11 Enter a value in minutes for the Web Server Session Time Out.
This is the amount of time a browser session will remain valid after the last
activity. After this timeout, the user will have to authenticate again.
12 Select a folder where logging information will be stored.
13 Click Next.

14 Enter a name for the WebApproval WebServer Virtual Directory.
The Virtual Directory is the directory where the WebApproval WebPages will
be stored. By default this is called WebApproval.
Remember this setting, because you will have to configure the ApogeeX
WebApproval Component later using the ApogeeX Client (see “Configuring
ApogeeX” on page 130).
15 Select the check box if you want to access the WebServer directly from the
root.
16 Select the port number for http traffic.
The standard HTTP port number is 80.

CAUTION: If you change the port number, you also need to change the IPSEC
rules (refer to the WebApproval Service Guide).
17 Click Next.

18 If you wish, choose a specific folder in which to install the WebServer.
19 Select ‘Complete’, and click Next.
20 Click ‘Install’.

When the WebServer has been successfully installed, you will see:
21 Click Finish.
The WebApproval WebServer is now installed.

130 CONFIGURING APOGEEX
Configuring ApogeeX
This section describes how to enable a guest account to allow users to submit
files, how to configure a mail server in ApogeeX so that e-mails can be sent out,
and how to automate the process creating a user/account login and sending a
mail to the new user.
Configuring a Mail In order to send e-mails, a correct mail server must be configured in the ApogeeX
Client.
Server in ApogeeX
" To configure a mail server
1 Start the ApogeeX Client.
2 From the System Overview, select the ApogeeX System icon.
3 Double-click the Configuration resource.
4 Select the Mail Server tab.
5 Enter the name and e-mail address of the sender.
The e-mail should be the address of the WebApproval/ApogeeX

administrator.
6 Enter either the name or IP address of your outgoing mail (SMTP) server.

7 Click OK.
NOTE: For more information on configuring the Mail Server, refer to the
Configuring When a user and/or an account is created, a login is created for the user/
account, and a mail is sent to the user containing a link to the Website's login
WebApproval page. To automate this process, a number of settings need to be configured in the
Services in ApogeeX WebApproval Component.
ApogeeX
" To configure WebApproval services in ApogeeX
1 Start the ApogeeX Client.
2 From the System Overview, select the ApogeeX System icon.
3 Double-click Components, and select the WebApproval Server from the

dropdown list.
4 Select the General tab.
The default settings in the General Tab are OK for most administrators:
Setting
! Max. login attempts: The maximum number of times the user can enter
the wrong password before being locked out.

! Min. lockout time: The first time a user reaches the maximum number of
login attempts, he is locked out for the amount of time (in minutes) speci-
fied here. After this time has elapsed, he can try to login again.
! Max. lockout time: The second time a user reaches the maximum login
attempts threshold, the lockout period is increased to the maximum
lockout time (in minutes) specified here.
! PostScript uploads: From the list, you can choose Not Allowed,
Wellformed PS only, or Allow All. This setting is used by ApogeeX to
prevent allowing the user to upload Postscript, or badly formatted PS,
which might contain malicious script code.
NOTE: Wellformed PS contains the following header: "%!PS-Adobe-"
! Max Transfer retries: The maximum number of times WebApproval will

automatically attempt to submit a file which failed to upload.
! Retry transfer time: The number of minutes WebApproval will wait

before automatically attempting to submit a file which failed to upload.
If after the specified number of retries the file still fails to upload, the
ApogeeX Operator receives a notification. He can then choose either to
remove the file or to try again.
! Time between mail retry: The number of minutes WebApproval will wait
before automatically attempting to resend an e-mail which was not
delivered.
If this value is set to 5 minutes, WebApproval will continue trying to

resend the e-mail every 5 minutes.
Expiration
! New Password: When a user is created, his initial password stays valid for
15 days. During this period, the user must login and must change his
initial password.
! Reset by user: When a user requests a reset of his own password (in case
he forgot it), an e-mail is sent to him to create a new password. This email
remains valid for 15 minutes only.
! Reset by administrator: When an administrator resets a password for a

user, the e-mail that is sent to the user remains valid for 24 hours.

5 Make any changes you require, and click Save.
6 Select the Printer tab, and enter the Company Name, the WebApproval URL
and E-mail Domain Name.
The information in the Company Name field is required. It is sent to newly

created users.
The WebApproval URL field is used to send a link to the user, and must be
configured correctly. You must use the full pathname, including the virtual
directory, irrespective of whether or not you selected the root access check
box during installation (see “Installing the WebApproval WebServer” on
page 123).
The information in this URL field comprises 3 parts:
! HTTP:// or HTTPS://
! The WebServer fully qualified domain name or IP address.
! The name that you selected as the virtual directory during the WebServer
installation (by default, this is ‘WebApproval’).
These parts are combined as:
http://<anyname>.registered domain name/virtual directory
For example:
! http://webapproval.printer.com/webapproval
! http://www.webapproval.printer.com/webapproval
! http://10.232.50.10/webapproval
NOTE: When using the fully qualified domain name, you must have a
registered domain name on the Internet. Domain name registration can be
done by various companies. Browse to www.iana.org, select iana ccTLD
Database and select your country. The URL for registration services brings
you to the website where domain name registration can be done.

E-mails to users are sent from:
noreply@<e-mail domain name>
or
<e-mail address>
The E-mail or domain name is important since many e-mail servers check the
domain name before allowing mail to be sent out. This depends on how you
configured your E-mail/domain name.
In the above example, the user will receive an e-mail from no-
reply@printer.com.
The ‘Send job activation...’ check box is a global setting. When selected,
emails will be sent to WebApproval users, informing them that results are
available for viewing. If this check box is not selected, no notifications will be
sent.
7 Click Save to store your settings.

ApogeeX Operator This section is intended for the ApogeeX Operator. It describes how the Operator
sets up a WebApproval customer account and first job on the ApogeeX System.
Prerequisites
Setting Up a Customer Account
The following steps need to be performed by the ApogeeX operator if a customer

asks for an account.
" To set up a customer account

1 Start the ApogeeX Windows Client.
2 Create a WebApproval account for the new customer.
To do this, open the System Overview, select the ApogeeX System icon, and
double-click the WebApproval Resource icon.
When the new account has been created, an e-mail is automatically gener-
ated and sent to the customer.
3 Open the WebApproval-Job001 Job Ticket from the Ticket Templates

Tutorial category:
4 In the Administrator tab, change the Job name “WebApproval Company

Name” to the name of the customer you just created.
5 Open the Customer contact details, and select the WebApproval company
from the drop-down list.
6 In the Plan tab, check that a valid template is selected for 16 pages.
e.g., 4 x 4 pages.
7 Submit the job.
8 Copy Brochure.pdf from

...\\ApogeeXServer\ApogeeXSupportfiles\samplefiles to the Hot Folder.
9 Drag the pages to the Run List, and Commit the changes.
10 Inform your customer that you have created a test job with which he can
practice. Also indicate which rights you have made available for the WebAp-
proval account.
NOTE: From the WebApproval Welcome screen, users can click on the ‘Get the
WebApproval User Guide’ link to download the pdf.
An email is sent to the user containing activation instructions, together with

his username and password.

136 MICROSOFT UPDATES
Microsoft Updates
This section describes how to check for and download the latest Microsoft
updates.
NOTE: Monthly security updates are also published on Graphics Direct.Microsoft

updates.
Installing Hotfix When installing the WebServer, you need to install Windows 2003 from the
provided bootable CD that includes the latest drivers, hardening tools and
Updates updates (hotfixes) available when the CD was created. The hotfixes are placed
in the C:\Updates folder (see “Installing the WebServer” on page 118).
" To check for and download new updates

1 After installing Windows, check for the availability of the latest hot fixes and
updates by browsing to http://www.microsoft.com/technet/security/
current.aspx.
NOTE: You should download these updates on a different machine - not on

the WebServer: Under no circumstances should the WebServer be connected
to the internet or the network before it is completely hardened! You should
download the updates on another PC and then burn them on a CD. You can
then use this CD on the WebServer. Avoid using the WebServer for surfing on
the internet at all times.
2 Select the Operating System (e.g. Windows 2003 server standard edition).
3 Select the Service Pack (e.g. Windows Server 2003 SP1).
4 Select the ‘Show only bulletins that contain updates that have not been
replaced by a more recent update’ check box.
5 Select all the severity rating check boxes.

6 Choose ‘All’ from the Bulletin release date list.
7 Click the ‘Go’ button.
8 Check if there are any updates available.
9 If updates are available, copy the downloaded patches to the appropriate

hotfix folders under the c:\Updates folder.
" To copy the three Microsoft update types
There are 3 types of Microsoft updates. To identify which type an update is:
1 Start a command line window.
2 Start each update executable with argument /?
! Type I: Displays the following type of information:
! Copy the executable to the C:\Updates\Hotfixes1 folder.
! Type II: Displays the following type of information:

138 MICROSOFT UPDATES
! Type III: Displays the following type of information:

CHAPTER
5 Uninstalling
WebApproval
This section explains how to uninstall the WebApproval Application and
WebServers.
! Saving/Re-using your WebServer Configuration .................................... 140

! Uninstalling WebApproval ............................................................................... 140
139
140 SAVING/RE-USING YOUR WEBSERVER CONFIGURATION
Saving/Re-using your WebServer Configuration

The WebApproval WebServer configuration is saved in the Web.config file. This
file contains all settings of the configuration manager. You can find this file in
the virtual directory root on the WebServer:
For example: D:\WWW\Public\WebApproval\web.config
If you are going to install a new version of the WebApproval WebServer, save
this file before uninstalling, and then copy it over the new version of the
Web.config file after installing the new version.
Uninstalling WebApproval
There is no specific order in which you have to uninstall WebApproval.
" To uninstall the Application Server

1 Go to the system which is running the WebApproval Application Server.
2 Select Start > Settings > Control Panel.
3 Select Add/Remove Programs.
4 Select WebApproval Application Server.
5 Select Change/Remove.
6 Select Remove, and click Next.
7 Click ‘Yes’ to confirm removal.
8 Click Finish.
" To uninstall the WebServer

1 Go to the system which is running the WebApproval WebServer.
2 Select Start > Settings > Control Panel.
3 Select Add/Remove Programs.
4 Select WebApproval WebServer.
5 Select Change/Remove.
6 Select Remove, and click Next.

5 UNINSTALLING WEBAPPROVAL 141
7 Click ‘Yes’ to confirm removal.
8 Click Finish.
9 Choose to restart the system.

CAUTION: Make sure that the Windows Services Management Console is
closed during the uninstall.
" To uninstall components in ApogeeX
To uninstall WebApproval components, refer to “Uninstalling an ApogeeX

Component” on page 90. The components you need to uninstall are:
■ Framework Module: WebApproval component.
■ WebInput module: WebUpload component.

142 UNINSTALLING WEBAPPROVAL

CHAPTER
6 Upgrading ApogeeX
This chapter describes how to upgrade your ApogeeX System from version 2.1.1
to version 2.5.0. You can only upgrade from version 2.1.1. You cannot upgrade
from any previous versions of the software.
! Introduction .......................................................................................................... 144

! Before You Begin ................................................................................................ 144
! Upgrading the ApogeeX Server ..................................................................... 146
! Upgrading a Satellite System ......................................................................... 155
! After Successfully Upgrading ......................................................................... 158
! Upgrading a Failover System .......................................................................... 158
! Upgrading a WebApproval Application Server ......................................... 159
! Upgrading a WebApproval WebServer ........................................................ 168
! Upgrading an ApogeeX Client ....................................................................... 168
! Upgrading ApogeeX MSDE to SQL Server ................................................. 168
! What to do if the Upgrade Installer Fails ................................................... 175
! Manually Upgrading ApogeeX 2.1.1 to 2.5.0 ........................................... 176
143
144 INTRODUCTION
Introduction
This chapter describes how to upgrade the following:
■ The ApogeeX 2.1.1 Server
■ ApogeeX 2.1.1 Satellite Systems
■ ApogeeX 2.1.1 WebApproval Application Server
■ MSDE to SQL Server
NOTE: You must first upgrade the ApogeeX Server, and then any ApogeeX
Satellites, and then the WebApproval Application Server.
You may also be using a Failover system. However, a Failover system cannot be
upgraded. You have to uninstall the Failover system completely, and then install
a fresh Failover system.
Before You Begin

If the Upgrade Installer fails to upgrade your ApogeeX 2.1.1 system to ApogeeX
2.5.0, it will perform a ‘rollback’ procedure which removes all the software
changes it has made. After the rollback, your ApogeeX System should be opera-
tional. However, to avoid any eventual problems, we recommend you backup
your data in case you need to reset your ApogeeX 2.1.1 configuration.
Before you start the Upgrade Installer, these are the procedures you should
follow:
1 Prepare your system for the upgrade.
2 Create backups of your data.
" To prepare your system for the upgrade

1 Copy the ApogeeX 2.5.0 DVD on the hard disk of your ApogeeX 2.1.1 Server
and share this folder for Windows.
2 Export all Render and PDFTrapping Parameter Sets.
To do this, create new folders on your system, and then export these param-
eter sets to these folders.

6 UPGRADING APOGEEX 145
3 Export all calibration curves
4 If you are using Hotfolder JDFInput, take screenshots of these parameter

sets.
5 Take screenshots of your Replication Service configuration, and save them in

a folder on your system:
System Overview > ApogeeX System > Components > ReplicationService
6 Ask the customer to delete as many jobs as possible.
7 Delete any temporary files located in:
C:\Documents and Settings\Windows User\Local Settings\Temp
C:\Temp (for Server and Satellites)
8 Make sure that there is enough free space on the disk where the ApogeeX
databases are located.
Databases can double in size during an upgrade install.
9 Shrink the ApogeeX Databases as follows:
! Start the ApogeeXBackup.exe:

...\\Agfa\ApogeeX\FrameWork\Bin\D_ApogeeXBackup.exe
! Click the Shrink button.
10 Rename the Render Task Processors back to their original names.
The original Render Task Processor name can be seen in the Windows Task
bar.
" To create backups of your data

1 Make a backup of the following sections of both your ApogeeX Server registry
and all ApogeeX Satellite registries:
HKLM\Software\Agfa
HKLM\Software\Microsoft\Windows\Current Version\Uninstall\ApogeeX
Patchx
You can do this as follows:
! Start ‘regedit’ and browse to the correct location in the registry.
! Select File > Export…, and save this file in a safe location.

146 UPGRADING THE APOGEEX SERVER
2 Copy any custom-made files or folders, located in any ApogeeX shared folder,
to a safe location.
3 Stop ApogeeX.
4 Stop MSDE/SQL by context-clicking the icon in the Taskbar, and selecting

MSSQLServer -Stop from the context menu.
5 Copy the MSDE/SQL Data folder from the ApogeeX Server (e.g. D:\Program
Files\MicroSoft SQL Server\MSSQL\Data) to a safe location.
6 Copy the Agfa\ApogeeX folder from the ApogeeX Server and ApogeeX Satel-
lites to a safe location.
7 Copy the ApogeeDataStore\System from the ApogeeX Server to a safe

location.
CAUTION: A safe location is a location which is not part of any ApogeeX shared
folder. ApogeeX shares are removed/cleaned by the ApogeeX upgrade/
uninstaller.
Upgrading the ApogeeX Server

You can use the ApogeeX 2.5.0 installer to upgrade from ApogeeX 2.1.1 systems.
However, there are some limitations, as described in this section.
Before starting, shut down the ApogeeX Server, and restart your system. Before
upgrading the ApogeeX 2.1.1 Server, the ApogeeX system should be stopped.
However, MSDE/SQL should be running (check the MSDE/SQL icon in the
Taskbar).
" To upgrade the Prerequisites from version 2.1.1 to 2.5.0

1 Start the Upgrade Installer by double-clicking the ApogeeX Setup.exe file.


4 Click the Prerequisites Install button.
You will see the following Welcome information:
5 Click Next.
6 Click OK to confirm that you want to update the Registration Utility.

7 Check the upgrade overview, and click Next.
When the WIBU dongle driver has been updated, the upgrade installer starts
to remove the previous version of the Registration Utility.
8 Click Next.
The Registration Utility installer starts automatically.

9 Click Next to continue.
10 Choose a location to which you want to install the Registration Utility, and
click Next.
11 Click Next.
The Registration utility is installed. When it has finished, you will see:
12 Click Finish.

The Wibu Key driver and Registration Utility are now upgraded.
13 Select Yes, I want to restart my computer now, and click Finish.
" To upgrade the ApogeeX Server from version 2.1.1 to 2.5.0


4 Click Custom Components - Modify to upgrade ApogeeX.
If a Satellite server is installed, you will see the following upgrade report:

5 Click Next.
The Installer should detect a previous ApogeeX installation on your system.

A message will pop up indicating your current version and the version to
which you will upgrade.
6 Click Yes to upgrade.
7 Click Yes if you are using PackagingJDF and/or HotFolderJDFInput.
The Installer asks for the location of the backup files.
8 Select a location.

Before upgrading the installer will create a full backup of your current
ApogeeX System, so that if the upgrade fails it can roll back to the previous
situation.
9 Click Next.
The upgrade starts.
You will see a succession of progress bar windows, as this process continues.
The entire process should take between between 45 minutes and 5 hours.
The Upgrade Installer will take longer to finish on systems which have a lot
of jobs.
NOTE: Some components may not be detected during the UpgradeInstall. In

this case, the installer will display a message (if, for example, the JDF Server
is not running). Click ‘Yes’ if you want to continue, or ‘No’ if you prefer to roll
back to the pre-upgrade situation. You should click ‘Yes’ in order to continue
the UpgradeInstaller.
After the upgrade, you will see:
10 Select No and click Finish.
11 Close down all launchers in the following sequence:
! ApogeeXSystem_ComputerName_4
! DefaultLauncher
! DefaultJobStore
12 Restart the computer.

Upgrading a Satellite System

Before starting, make sure that the ApogeeX System is running.
" To upgrade a Satellite System from version 2.1.1 to 2.5.0


156 UPGRADING A SATELLITE SYSTEM
4 Click Custom Components- Modify.
5 Click OK.
The Installer should detect a previous ApogeeX installation on your system.

A message will pop up indicating your current version and the version to
which you will upgrade.
6 Select Yes to continue.
The Installer asks for the location of the backup files.

7 Select a location.
Before upgrading the installer will create a full backup of your current
ApogeeX System, so that if the upgrade fails it can roll back to the previous
situation.
8 Click Next.
The upgrade starts.
You will see a succession of progress bar windows, as this process continues.
After the upgrade, you will see:
9 Select No and click Finish.
10 Close down all launchers in the following sequence:
11 Reboot the computer.

158 AFTER SUCCESSFULLY UPGRADING
12 After upgrading all the Satellites, you should stop and start the ApogeeX
System.
After Successfully Upgrading

" To prepare your ApogeeX Server for use...
1 Reboot the ApogeeX Server/Satellites.
2 Uninstall all ApogeeX 2.1.1 Client applications and install the latest Client
build.
3 If necessary, import all Render and PDFReady-PDFTrap ApogeeX 2.1.1

Parameter Sets you saved earlier (see “Before You Begin” on page 144).
4 If necessary, import all calibration curves.
5 Create JDF Import parameter sets in accordance with the screen shots you
took previously of the HotFolderJDFInput.
6 Update the ApogeeX Configuration > Database maintenance settings to

match the ApogeeX 2.1.1 ReplicationService settings of which you took
screenshots earlier (see “To prepare your system for the upgrade” on
page 144).
7 Shrink the ApogeeX Databases as follows:
! Start the ApogeeXBackup.exe:

...\\Agfa\ApogeeX\FrameWork\Bin\D_ApogeeXBackup.exe
! Click the Shrink button.
Upgrading a Failover System

The ApogeeX Failover system cannot be upgraded: You need to uninstall and re-
install the Failover system.
CAUTION: If the Failover system also acts as an ApogeeX Satellite, make sure
that you rename all ApogeeDataStores (which are part of the ApogeeX
Satellite) before uninstalling the ApogeeX 2.1.1 Failover system. Otherwise
the ApogeeX 2.1.1 Failover uninstaller will remove these datastores.

Upgrading a WebApproval Application Server

This section explains how to upgrade your WebApproval Application Server
from version 2.1.1 to 2.5.0.
" To upgrade a WebApproval Application Server from version 2.1.1 to 2.5.0

1 Make sure that ApogeeX Server is running.
2 Go to the system which will be used to run the WebApproval Application

Server.

160 UPGRADING A WEBAPPROVAL APPLICATION SERVER
5 Click ApogeeX WebApproval.
6 Click the Application Server - Install button.
7 Click ‘Yes’ to install the Microsoft.Net 1.1 framework.

8 Select ‘I agree’, and click Install.
The Microsoft.Net 1.1 framework and Service Pack 1 are installed. Be

patient, as it takes some time to finish.
9 Click OK to finish the Microsoft.Net framework setup.
You need to reboot the system. However, if any applications are running on
the system, you need to stop them before rebooting.
10 Click Restart to reboot the system.
After rebooting, the following message is displayed:

11 Click Yes.
The WebApproval Application Server Installation wizard starts.
NOTE: You will need to reboot your system a second time. If the wizard does
not then continue automatically, you need to manually run the Application
Server installer.
12 Click Next to display the License Agreement.

Next.
14 Change the folder, or accept the default location for installing the WebAp-
proval Application Server, and click Next.

15 For ‘The computer name of the ApogeeX server’, enter the name or IP address
of the computer on which the ApogeeX framework is installed (you can enter
a computer name if a DNS server is available).
16 The “network traffic originating from the web server...” option is only
required if:
! The firewall between the Application server and the Web server uses port
forwarding. In this case, enter the IP address of the firewall.
! The Application server has 2 network cards, and the network card used to
communicate with the Web server is not the first (in order). In this case,
enter the IP address of the second network card (i.e., of the Application
server).
NOTE: For more information on the order of network cards, refer to the
17 For ‘The Port number to communicate with the Web server’, choose your
TCP/IP port number, or accept the default choice (5000).
NOTE: The Apogee PrintDrive and Apogee PDFRip joblog also use the same
default TCP/IP port number (5000). You must choose a different port
number than used by these or any other applications.
The WebApproval Application server only needs 1 TCP/IP port number to

communicate with the Web server.

18 Select a folder to cache all files that are submitted/uploaded to

WebApproval.
NOTE: For security reasons, you should choose a folder that is not on the same
drive as the Operating System and the Application.
19 Click Next.
20 Select a folder which the Application server will use to store log files, and
click Next.
21 Choose Complete and click Next.

22 Click Install.
The Installer starts copying files. When all files are installed, it will attempt
to start the Service.
When the installation is finished, you will see the following:

23 Click Finish.
" To upgrade the WebApproval databases

1 Start the WebApproval database upgrade tool on the ApogeeX Server.
This tool is located in E:\ApogeeX 2.5.0 DVD\ApogeeX\Installer\WebAp-

proval\ AppServer\Upgrade\UpgradeTool.exe.
2 Enter the name of your ApogeeX Server, and click Upgrade.
3 Click OK.
The WebApproval Application Server has now been updated.

168 UPGRADING A WEBAPPROVAL WEBSERVER
Upgrading a WebApproval WebServer

The WebApproval WebServer cannot be upgraded. The WebApproval
WebServer for ApogeeX 2.5.0 is only supported on Windows 2003 systems while
the WebApproval WebServer for ApogeeX 2.1.1 was only supported on
Windows 2000 systems. You therefore need to re-install the operating system.
NOTE: We recommend you take screenshots of each tab of the WebApproval

WebServer configuration application.
Upgrading an ApogeeX Client

The ApogeeX and QmsX Clients cannot be upgraded. You need to uninstall and
re-install them.
Upgrading ApogeeX MSDE to SQL Server

ApogeeX is installed with MSDE (Microsoft Desktop Engine), a Microsoft data
engine built and based on core SQL Server technology. Since MSDE has some
limitations (only 5 concurrent connections, supports only 2 processors, 2GB
database limit, etc.) you might want to upgrade to SQL Server.
Before You Begin
■ ApogeeX must be installed correctly (running on MSDE).
■ MSDE must have been installed via the ApogeeX Installer Prerequisites
button - You should not have simply run the MSDE setup.exe file from within
the MSDE folder on the DVD.
■ You must have an ApogeeX SQL Server license.
■ You must have a SQL Server CD-Rom (and license).
" To upgrade to SQL server

1 Shutdown ApogeeX
2 Stop MSDE by context-clicking the icon and selecting MSSQLServer - Stop

from the context menu.

4 Insert the MSDE Installation CD.
5 Click Installation
6 Click the ApogeeX SQL Server button.

170 UPGRADING APOGEEX MSDE TO SQL SERVER
7 Click Install.
8 Click Next.
9 Choose Local Computer and click Next.

10 Choose ‘Upgrade, remove, or add components to an existing instance of SQL

Server’ and click Next.
11 Click Next.
12 Select ‘Upgrade your existing installation’, and click Next.

13 Select ‘Yes, upgrade my programs’ and click Next.
14 To specify your licensing mode, in the “Per Seat for” field, enter the number
of devices:
! If you have only a server: 2 devices
! If you have a server and 1 satellite: 3 devices
! If you have a server and 2 satellites: 4 devices
! If you have a server and 3 satellites: 5 devices
15 Click Continue.
16 Click Yes.

17 Select Management Tools, and click Next.
18 Click Next.
19 Click Finish.
CAUTION: The SQL Server upgrade has finished, but the Service Pack 3
installation is still running! You need to wait until D_SetupSQL2000.exe
program is finished. This takes about 10 minutes. There is no confirmation
that this process is busy, and no confirmation message when it is finished. You
will only see the application button in the Windows Taskbar:

20 If you select this process while it is running, you will see the following:
As soon as this process is finished, the D_SetupSQL2000.exe application

button automatically disappears from the taskbar.
21 Select Start >Settings > Control Panel > Add/Remove Programs to check
that the SQL Server is installed.
22 Select Microsoft SQL Server 2000.
23 Click the ‘support information’ link to check the SQL Server version.
If the SQL Server version is different from the version indicated in the screen
shot above, then Service Pack 3 is not correctly installed. The correct version
is 8.00.761. This version number is visible even before the SQL Server has
been fully installed - you do not have to wait until the button disappears from
the taskbar.

ApogeeX Failover
If you are using an ApogeeX Failover system, this should be running the same
MSDE-SQL version as the ApogeeX Server. Therefore, you must also upgrade
your MSDE-SQL software on the Failover system.
What to do if the Upgrade Installer Fails

You can use the following procedure to reset your ApogeeX 2.1.1 configuration,
if for any reason the Upgrade Installer fails.
" To fall back to your ApogeeX 2.1.1 configuration

1 Stop the ApogeeX Server and MSDE/SQL.
2 Stop the S_Logon Service on the ApogeeX Server (by context-clicking My

Computer, selecting Manage, and then selecting Services).
3 Delete the Agfa\ApogeeX folder on the ApogeeX Server and Satellite

systems.
4 Delete the SQL data folder (ProgramFiles\Microsoft SQL

Server\MSSQL\Data) and the System Apogee DataStore folder on the
ApogeeX Server.
5 Copy the SQL Data backup folder to ProgramFiles\Microsoft SQL

Server\MSSQL on the ApogeeX Server.
6 Copy the Agfa\ApogeeX backup folder to its original location on the ApogeeX
Server and Satellite systems.
7 Copy the ApogeeDataStore\System backup folder to its original location on

the ApogeeX Server.
8 Delete the following registry keys on the ApogeeX Server and Satellite
systems:
HKLM\Software\Agfa
9 Import the 3 Registry keys on the ApogeeX Server and Satellite systems by
starting Regedit, and selecting File > Import.
After performing the above steps, you should be able to start ApogeeX 2.1.1.

176 MANUALLY UPGRADING APOGEEX 2.1.1 TO 2.5.0
Manually Upgrading ApogeeX 2.1.1 to 2.5.0

To know what needs to be installed (which Task Processor on which platform,
etc.) we recommend you first take screenshots of the ApogeeX 2.1.1 System
Overview for each of the hardware systems prior to uninstalling ApogeeX 2.1.1
and installing ApogeeX 2.5.0.
" To update hot tickets and ticket templates

1 Save your ApogeeX 2.1.1 Hot tickets and ticket templates to a file (File >
Save as).
The Job/Hot tickets can be imported in ApogeeX 2.5.0. The job description
will be automatically upgraded if necessary (e.g. Flattener replaced by
PDFReady). Task Processors which are not available in ApogeeX 2.5.0 are
removed from the ticket: The user has to select the correct Task Processor
replacement.
" To update parameter sets
All of the ApogeeX 2.1.1 Parameter Sets can be imported in ApogeeX 2.5.0.
1 Create a folder for each Task Processor on your hard disk and save the Param-
eter sets in the correct folder.
2 If the Task Processor has multiple operations (e.g. the Renderer), then we
recommend you specify the operation name in the file (TPoperation-param).
The PDFReady-Flattener components no longer allow you to create Param-

eter Sets (you must use the initially provided Parameter Set).
NOTE: Make a note of the default Parameter Sets.
" To update resources
The following ApogeeX 2.1.1 resources can be exported and imported in

ApogeeX 2.5.0:
■ Linearization Curves
■ Quality settings (maps)
■ Calibration Curves.

Unfortunately most resources cannot be exported. For these resources, you need
to have the original resource (which you downloaded to ApogeeX 2.1.1) or take
some screenshots in order to recreate the resource in ApogeeX 2.5.0.
Resource Export? To update...

Fonts Not possible Search original resources
Content Profiles Not possible Search original resources
Pitstop Actions Not possible Search original resources
Pitstop Profiles Not possible Search original resources
Halftone Screens Not possible Search original resources
Marks Not possible Search original resources
Proofer Profiles Not possible Search original resources
Press Profiles Not possible Search original resources
WebGrowth Profiles Not possible Search original resources
Color Books Not possible • Search original resources (when ApoColorCon-
vertor used)
• Take screenshots
Ruling Maps Not possible Take screenshots
Output Sizes Not possible Take screenshots
Punch Calibration Not possible Take screenshots
Borders Not possible Take screenshots
Simulation Curves Not possible Take screenshots
Profile Link Exceptions Not possible Take screenshots (via QmsX)
Ink Tables Not possible Recalibrate with ApogeeX 2.5.0
Output Media Not possible • Most created automatically
• Take screenshots for Generic Devices
" To handle configuration settings
You cannot backup Task Processor configuration settings or ApogeeX System

Configuration settings (ApogeeX configuration, ApogeeX job Housekeeping,
ApogeeX Logging, ApogeeX WebApproval accounts, ApogeeX components-
ImpositionService, ApogeeX components-ReplicationService, ApogeeX compo-
nents-WebApprovalService, ApogeeX StorageSets).
We recommend you take screenshots of all possible configuration settings.

178 MANUALLY UPGRADING APOGEEX 2.1.1 TO 2.5.0
" To update jobs
NOTE: We only support ApogeeX 2.1.1 job archives which were created after
installation of the ApogeeX 2.1.1-patch4. Jobs created with a different ApogeeX
2.1.1 patch level can pose some reprocessing issues.
1 ApogeeX 2.1.1 job archives can be imported in ApogeeX 2.5.0. However, due
to the amount of time required for archiving/importing jobs, delete as many
ApogeeX 2.1.1 jobs (which are no longer needed) as possible.
2 Before uninstalling ApogeeX 2.1.1, rename the ArchiveRoot folder where all
your archives are located. This is because the ApogeeX 2.1.1 uninstaller will
delete the ArchiveRoot folder.
When the ApogeeX 2.1.1 job archives are imported, some conversion is
performed, and the job description will be automatically upgraded if needed
(e.g. Flattener replaced by PDFReady). Task Processors which are not avail-
able in ApogeeX 2.5 are removed from the ticket. Users will need to select the
correct Task Processor replacement.
NOTE: Only the pages which are used in the runlist will be imported. Unused
pages are not imported (previous revisions), therefore the page revision
number will not be provided.
CAUTION: Some imported ApogeeX 2.1.1 job archives may display an error
when reprocessing. This occurs for all jobs which have unsupported ApogeeX
2.5.0 Production Plans.
3 To archive jobs with pages from the Public PageStore, you must use the ‘all
available results’ archive option. Do not use the ‘results marked for archive
only’ option (pages will not be archived).
CAUTION: Archive-import will not provide the required results for Public
PageStore jobs (jobs where the last Task Processor is the Public PageStore).
You need to export all PDF documents from the Public PageStore manually.
Before doing this, we recommend that you ask the customer to delete as many
PDF documents from the Public PageStore as possible (deleting Public
Pagestore documents requires the ApogeeX 2.1.1-patch4).
CAUTION: Job Archives from ApogeeX 1.0.0 systems cannot be imported in
ApogeeX 2.5.0. The following message is displayed: ‘Upgrader is unable to
upgrade the given job description’.

CHAPTER
7 Tutorial Prerequisites
This chapter contains a number of short procedures you need to execute before
you start using the ApogeeX Tutorial.
! ApogeeX System Installation ......................................................................... 180

! Downloading a Missing Resource ................................................................ 180
! Setting your ApogeeX Preferences .............................................................. 180
! Creating the Quick Tour Tickets .................................................................... 180
! Creating a WebApproval Ticket ..................................................................... 181
! ApogeeX Macintosh Client Users ................................................................. 181
! Creating Shortcuts .............................................................................................. 182
179
180 APOGEEX SYSTEM INSTALLATION
ApogeeX System Installation

The Tutorial is based on a typical installation. The Generic Imagesetter and the
Generic Proofer are used in the exercises.
Downloading a Missing Resource

1 Make sure you have Administrator Access level in the ApogeeX Client
Preferences.
2 Open the Preflight settings.
3 Click the Import button.
4 Browse to the Resources\Preflight\Profiles folder.
5 Select 4 Color Press.ppp.
Setting your ApogeeX Preferences

Most of the ApogeeX Tutorial lessons need to be performed in Operator mode.
1 In any of the ApogeeX Client windows, choose Edit > Preferences.
2 In the Logging on tab, set the Access level to Operator.
3 In the Viewer tab, specify your Acrobat location.
Creating the Quick Tour Tickets

" To create the Quick Tour Hot Ticket
1 In the Hot Tickets window, choose File > New from Templates.
2 In the Hot ticket tab, select the Tutorial Category and open the ABS150-
2400DPI-POS Template.
3 Choose File > Submit.
The ABS150-2400DPI-POS Hot Ticket is part of the Hot Ticket list.

7 TUTORIAL PREREQUISITES 181
" To create the Quick Tour Job Ticket for ApogeeX Light users
! Go to the shared Sample Files folder and copy the Quick Tour job.ps in the
ABS150-2400DPI-POS Hot Folder in the HotFolderRoot.
The ABS150-2400DPI-POS job is part of the Job list.
" To create the Quick Tour Job Ticket for ApogeeX Commercial and Packaging
users
1 In the Jobs window, choose File > New from Templates.
2 Select the Tutorial Category and open the Quick Tour Template.
3 Choose File > Submit.
The Quick Tour Job is part of the Job List.
Creating a WebApproval Ticket

" To create a WebApproval Ticket
1 Start an ApogeeX Client, and open the WebApproval-Job001 Job Ticket from
the Webtickets folder in the SupportFiles\SampleFiles\WebTickets folder.
2 Save this Job Ticket as a Ticket Template in the Tutorial category.
ApogeeX Macintosh Client Users

When working on the Macintosh ApogeeX Client you need to have the
ApogeeX_PDFDataStore volume mounted on your desktop in order to view PDF
pages.
You are now ready to execute the lessons in the Tutorial.
CAUTION: The Hot Folder settings that are used in the Tutorial Ticket
Templates are set up to work with the default Hot Folder name and path
HotFolderRoot.

182 CREATING SHORTCUTS
Creating Shortcuts
The ApogeeX Client Installers do not automatically create shortcuts to the
default HotFolderRoot, ExportRoot or the SampleFiles.
It is recommended that you create these shortcuts.

CHAPTER
8 Installation Issues
This section explains how to resolve a number of problems that you may experi-
ence while performing an installation of the ApogeeX System.
! Installer Fails to Connect to the ApogeeX System ................................ 184

! Installer is Halted ................................................................................................ 184
! Cannot Open PDF Files on Macintosh Clients ......................................... 184
! To Install ApogeeX Without a Network ...................................................... 185
! Installing ApogeeX on a PC with Multiple Network Cards ................. 185
! Checking Your WIBU Driver ............................................................................ 186
! Avantra25XT on Windows 2003 Server - SE ............................................. 187
! Errors During the MDAC Update .................................................................... 187
! Hard Disks Not Available for Selection ....................................................... 188
! Cannot Install Windows Client ...................................................................... 188
183
184 INSTALLER FAILS TO CONNECT TO THE APOGEEX SYSTEM
Installer Fails to Connect to the ApogeeX System

During installation, the following error message may be displayed:
‘ApogeeXSystemName_ApogeeXServerName_4 is not running yet. Continue

with checking its status? Beware if you choose “No”, the installation will be
aborted'.
If you select “yes” to retry and the installation still fails (and the ApogeeX System
is still running), then you can try the following procedure:
1 When the message appears, start the Task Manager.
2 Select the “ApogeeXSystemName_ApogeeXServerName_4” application

which is described as not running.
3 Select End Task.
4 Double-click Agfa\ApogeeX\launcher.bat.
5 Confirm the message “ApogeeXSystemName_ApogeeXServerName_4 is not

running yet” with Yes.
The installation should continue.
Installer is Halted
The installer may stop working if you perform other actions on the system on
which you are installing ApogeeX. We therefore strongly recommend that you
do not do anything else on the system during installation. You should also leave
the installer running in the foreground.
Cannot Open PDF Files on Macintosh Clients

If you want to view PDF data on the Macintosh client, the ApogeeX PDFDa-
taStore folder needs to be shared for Macintosh users. When the folder is shared
for Macintosh users, you need to mount it on the Macintosh Desktop where you
are running your ApogeeX Client. Note that after mounting folders on the
desktop, you need to restart the Client.

8 INSTALLATION ISSUES 185
To Install ApogeeX Without a Network

If you want to install ApogeeX on a server which is not connected to a network,
you will first need to install a Microsoft loopback adapter, or connect the
network card to a hub.
1 Install a Microsoft loopback adapter.
For more information, refer to the ApogeeX Service Manual.
2 Enable this loopback adapter connection.
3 Put the loopback adapter to the top of the list of available connections.
For more information, refer to “Installing ApogeeX on a PC with Multiple

Network Cards” on page 185.
Installing ApogeeX on a PC with Multiple

Network Cards
ApogeeX can only be registered on 1 network card at a time. If there are 2 or
more network cards installed on the server, these connections are listed in the
order in which they are accessed by network applications. ApogeeX will
automatically register with the first network connection in the list.
However, you can change the order of the network cards as described below.
NOTE: This procedure is valid for the ApogeeX System as well as for the ApogeeX
Windows Clients.
1 Right-click My Network Places, and select Properties.
2 In the Network and Dial-up Connections window, Select

Advanced > Advanced Settings...
All the network connections are listed in the Connections pane.
3 Use the arrows to move the Network connection on which ApogeeX needs to
register to the top of the list.

186 CHECKING YOUR WIBU DRIVER
NOTE: ApogeeX will not register on a Network connection which is disabled: In

this case, the next Connection in the list will be used.
Checking Your WIBU Driver

You can verify if the ApogeeX USB dongle is recognized by the system as follows:
1 Right-click My Computer, and select Manage.
2 Select Device Manager and double click the entry ‘WIBU-BOX/U’ under
WIBU-KEY Software Protection.
The information window confirms that the USB Wibu dongle is working
properly.

8 INSTALLATION ISSUES 187
Avantra25XT on Windows 2003 Server - SE

If you Installed the ApogeeX System on a Windows 2003 Server - Standard
Edition, and you are using an Avantra25XT, you will receive the following “user
intervention required” notification:
“The PAC driver could not be initialised. The driver may not be installed or it
may already be in use”
In this case, you must manually install the PAC driver using Device Manager to
solve the problem.
" To manually install the PAC driver

1 Select My Computer.
2 Context-click and select Manage.
3 Select Device Manager.
4 Select the PAC board.
5 Context-click, and choose to install the driver.
6 Choose Install from a list of specific locations, and browse to:
...DVD\ApogeeX\drivers\Agfa Plug&Play Pac Driver.
7 Click Finish.
Windows 2003 Installations

If you receive a ‘User intervention needed’ message, then the PAC driver could
not be initialized: It may not be installed or may already be in use. In this case,
you also need to install it manually.
Errors During the MDAC Update

You may receive an error when updating the MDAC. This could happen if you
installed the Q832483 Microsoft MDAC security patch.
The solution to this problem is as follows:
1 Install MDAC 2.8.
2 Re-install the security patch.

188 HARD DISKS NOT AVAILABLE FOR SELECTION
NOTE: You do not have to uninstall it first.
3 Start the Prerequisites Installer again.
MDAC will not be updated, since you now have the latest version.
Hard Disks Not Available for Selection

The Installer checks which disks are available at the start of the installation
process. Any disks that you format after starting up the Installer will not be avail-
able for selection. In this case, you must restart the Installer.
Cannot Install Windows Client

When trying to instrall the Windows Client, you may see a ‘Files in Use’ window.
This is because some active ApogeeX components are using these files. In this
case, just select Ignore, and the installation will continue.

APPENDIX
A Appendix
This Appendix explains how to start up and shut down ApogeeX. Information is
also provided on where the software is installed, and the currently supported
third-party software.
! Starting and Stopping the ApogeeX System ............................................ 190

! What is Installed and Where? ........................................................................ 193
" The ApogeeX Server ................................................................................... 194
" The Satellite System .................................................................................. 196
" The Failover System ................................................................................... 197
" WebApproval Application Server ........................................................... 198
" WebApproval WebServer .......................................................................... 199
189
190 STARTING AND STOPPING THE APOGEEX SYSTEM
Starting and Stopping the ApogeeX System

This section describes how to start and stop the ApogeeX System. Note that there
are two ways to shut down the ApogeeX System:
■ Automatically, using the ApogeeX Console
■ Manually, by closing each of the individual System Task Processors
" To start the ApogeeX System

1 Start the Windows computer on which you installed the ApogeeX System.
2 Choose Start > Programs > ApogeeX > ApogeeX Console.
The ApogeeX Console Main window is displayed.
3 Click Start to start the ApogeeX System.
4 Click the Show Components triangle to display the status of the components
that have been started.

APPENDIX 191
5 Wait until everything has been started.
It takes about 5 minutes to load all the Task Processors. When all the major
Services and Server components are started, the ApogeeX Console tool will
display the following message:
“ApogeeX_System” is active
NOTE: Task Processors are not shown in the components section of the
ApogeeX Console. Task Processors which are not licensed will not start.
6 If you have one or more Satellite systems, then you should next start the
ApogeeX Launcher on the Satellite system(s).
" To shut down the ApogeeX System automatically (recommended)

1 Go to the computer on which you installed the ApogeeX System.
2 Choose Start > Programs > ApogeeX > ApogeeX Console.
The ApogeeX Console Main window is displayed.

192 STARTING AND STOPPING THE APOGEEX SYSTEM
3 Click Shut Down.
You may see the following confirmation message:
4 Click Yes.
The ApogeeX System is shut down.
NOTE: Satellite components are automatically stopped.
" To shut down the ApogeeX System manually
NOTE: Only do this if automatic shutdown fails.
If you use this method, you must close the Task Processors in a specific order, as
described below:
1 First, close the three ApogeeX System components which have the same
name as your ApogeeX System (the first three, illustrated below). To do this,
right-click on the Task, and select Close from the context menu.
Close first _4, then _3, and last _2.

APPENDIX 193
2 Normally, all the remaining Task Processors are closed one after another,
until only four components are still left running:
3 Close the DefaultLauncher.
4 The ApogeeX System is shut down.
5 If you have a Satellite system, then this system will also shut down
automatically.
What is Installed and Where?

This chapter describes which components are installed on each of the following
systems:
■ The ApogeeX Server
■ The Satellite System
■ The Failover System
NOTE: The Satellite and Failover systems are normally installed on the same
hardware platform.

194 WHAT IS INSTALLED AND WHERE?
The ApogeeX All the ApogeeX System software is by default installed in the Agfa\ApogeeX
folder. This comprises:
Server
■ The ApogeeX Console
■ The Service Tool
■ Preview Server
■ Optional Services
■ Support Files
■ Task Processor Components
Depending on the selected ApogeeX Task Processor components, the following

folders are shared by default for Macintosh and Windows:
■ PDF Datastore
■ ExportRoot
■ HotFolderRoot
■ ArchiveRoot

APPENDIX 195
■ StorageServerRoot
■ ImageSetterTIFFRoot
■ PlateSetterTIFFRoot
■ ProoferTIFFRoot
■ PressRoot
■ GenericPressRoot
■ SupportFiles folder
■ JDFImportRoot
■ PKGJDFRoot
NOTE: The shares are created by the ApogeeX installer, and are activated after
the computer has been rebooted.
Each Task Processor comprises a bin folder where the software of this Task
Processor is placed:

The Satellite If you installed a Satellite system, then the folder structure on this system will be
as follows:
System

APPENDIX 197
The Failover If you installed a Failover system, then the folder structure on this system will be
as follows:
System
NOTE: In the example above, the Failover system is also used as a Satellite
system. This is why you can see an ApogeeX folder with the installed
components.

WebApproval If you installed WebApproval, then the folder structure on the WebApproval
Application Server will be as follows:
Application Server

APPENDIX 199
WebApproval If you installed WebApproval, then the folder structure on the WebApproval
WebServer will be as follows:
WebServer


ApogeeX 2.5.0 InstallGuide

Загружено:

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

Исходное описание:

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

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

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

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

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

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

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

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

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

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

ApogeeX 2.5.0 InstallGuide

Загружено:

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

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

:ApogeeX 2.

Date of Issue: May 2005

:ApogeeX 2.5 Installation Guide

Limited Use License

Limited Warranty and Liability

:ApogeeX 2.5 Installation Guide

:ApogeeX 2.5 Installation Guide

! Intended Audience ................................................................................................... 6

You should be familiar with your front-end workstations, imagesetters, plateset-

Keyboard and Mouse Conventions

Keys are frequently used in combinations or sequences as shortcut keys. For

The following mouse conventions are used:

To ... Do this ...

:ApogeeX 2.5 Installation Guide

■ The ApogeeX Licensing Guide

■ The ApogeeX Service Guide

■ The ApogeeX Tutorial

■ The ApogeeX Online Help

:ApogeeX 2.5 Installation Guide

:ApogeeX 2.5 Installation Guide

Chapter 1 Before You Begin ............................................................................................................ 13

! The ApogeeX Starter Kit .................................................................................................. 14

Chapter 2 Installing ApogeeX ....................................................................................................... 27

! Before Starting the Installation .................................................................................... 28

Chapter 3 Uninstalling ApogeeX ................................................................................................ 87

! Uninstalling the Complete ApogeeX System .......................................................... 88

Chapter 4 Installing WebApproval .......................................................................................... 103

! Before You Begin ............................................................................................................... 104

Chapter 5 Uninstalling WebApproval .................................................................................. 139

! Saving/Re-using your WebServer Configuration ................................................... 140

Chapter 6 Upgrading ApogeeX .................................................................................................... 143

! Introduction ......................................................................................................................... 144

Chapter 7 Tutorial Prerequisites ................................................................................................ 179

! ApogeeX System Installation ....................................................................................... 180

:ApogeeX 2.5 Installation Guide

! Creating the Quick Tour Tickets ....................................................................................180

Chapter 8 Installation Issues ..........................................................................................................183

! Installer Fails to Connect to the ApogeeX System ...............................................184

! Starting and Stopping the ApogeeX System ...........................................................190

:ApogeeX 2.5 Installation Guide

:ApogeeX 2.5 Installation Guide

1 Before You Begin

! The ApogeeX Starter Kit ...................................................................................... 14

The ApogeeX Starter Kit

■ the yellow ApogeeX USB dongle

■ a DVD containing the ApogeeX installer, documentation, and End User

■ The ColorTune CD.

The ApogeeX software is protected by a combination of the hardware dongle

■ Multi-task processor instances

■ Satellite Task Processors

■ Agfa plug-ins and extensions for Quark and Acrobat

:ApogeeX 2.5 Installation Guide

• Page File • MSDE (SQL)

:ApogeeX 2.5 Installation Guide

Module Component Description

TIFF Imagesetter Provides an imagesetter engine emulation in TIFF

:ApogeeX 2.5 Installation Guide

Module Component Description

:ApogeeX 2.5 Installation Guide

Module Component Description

:ApogeeX 2.5 Installation Guide

Module Component Description