Installing ApogeeX 3.

0
JDF & JMF
February 21, 2006

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

Content

Installing JDF

Installing JMF

Verifying JMF

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

Install ApogeeX 3.0 JDF Option

Use Custom Install, leave default options

Add "FrameWork"->"JDFServer"

Add "JDFImport" -> "JDFImport"

(Packaging JDF if requested)

Start Client and load license file with proper

JDF Options (grouped as JDF-Input later)

Recommend to restart server

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

Config JDF Server

System Overview tab

Click Server in top part

Click JDFServer in bottom part

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

Most important

Job Administration tab

Planless Submission tab

Specify default output devices

Debug tab

Set Job Name to: Product.DescriptiveName

Specify the required hold points

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

Job Administration tab

Set Job Name to

Recommend: ProductNode

Automatic = ApogeeX 2.5 compatible

MIS and Acrobat jobs

uses JobPartID which is bad for MIS and Acrobat jobs

Milestones

Notification xx hours before time scheduled by MIS

Script can disable notifications if needed

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

Planless Submission: dynamically

Choose to build the production plan

Dynamically (as described in JDF) OR from a
Hot Ticket

Build dynamically:select the real default

devices here (overridden by JDF if needed)

Put Job on Hold

Allows to make changes to the plan

Intent jobs (Acrobat) always go on hold

Choose to expand JDF PrePressPreparation

with

For demo: TIFF Platesetter, TIFF Proofer

TaskProcessors and parameterset

Note that JDFImport Normalize Parameter
set selection overrides this definition

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

Planless Submission: Ticket Template

Select Hot Ticket Category and Template

JDF parameters applied to Hot Ticket

Similar to dropping JDF in JDFImport (but

available to JMF)

Can also select Hot Ticket Category and

Template with URL extension

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

MIS Integration tab

Select a script to preprocess JDF files

Can select also in JDFImport

See JDFSupport/Scripts folder for details

ApogeeX Webserver Port

Set to the same port as TomCat was configured

Does NOT change the real port!

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

Debug Tab

JMF Support
Disable if not needed to avoid overhead
Save debug files
Saves incoming/outgoing JDF&JMF messages
Add collect for output, hold point
To add hold points to dynamic plans
Allows to check output before proceeding
Hostname for URLs
Default: leave empty

enter server IP address if

10

AX will use servername if multiple NIC and IP if single

Other side cannot resolve dns name of server
running in a DMZ that adapts IP address

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

JDF Tracing setup

Select JDFServer Tracing tab

Select what part to trace

General

JMF

JDF Param Convers.

JDF Job Parsing

ItemStore

Trace Options

11

Default usually OK
Tracing is shown in DOS
window: FW_JDFServer.exe

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

Setting Parameter sets

12

If changes are needed for JDF, duplicate Initial,

rename to "JDF" and set as default (just to
make it clearer)

Example:

Set Imposition to from Input

Turn off Pantone name conversion in Normalizer

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

Configuring Press TP: InkDrive

13

For a triangle connection (MIS, ApogeeX, press controller) it

is recommended to use JDF variables for the
CIP3AdmSheetName/SeparationNames (and filepath)

Use $JDF_SHEET and

$JDF_SEPARATION

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

Installing ApogeeX 3.0 JMF

14

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

License report details

Always included
JDF_Import: absolute minimum,

JDF_Layout: needed to process JDF Layouts

needed to import customer (Admin) and job info

From file in Impose TP (unpopulated)

JDF Input License group

JDF_Param_Conversion: for

Creating dynamic jobs (no plan)

Read JDF parameters (e.g. screening, nr of pages) to
override the ones defined in ApogeeX plan
Reading populated JDF Imposition file through JDF Import

JDF_JMF: needed to send and receive JMF

STRIPPING: needed use Stripping (high-level MIS imposition)
Technology demo only now

15

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

Install JMF Webserver

Start from Main Installer: JMF Webserver

Third party installers may need some time

Installs Java 1.4.2 (not pre-installed on TKS)

An intermediate wait after JAVA install, do not exit!
Installs TomCat 5.0

includes specific settings for Agfa

includes AXJMF.war and ResourceGet.war applet for
Agfa JMF communication
Actions

16

Preferred to set Connector port to 80, leave other options

unchanged
If connector port is changed to a different port, need to
enter this port nr into JDFServer/MIS Integration tab
Webserver port

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

Configure/start TomCat 5.0

Port

Start

ApogeeX Installer configures auto start of service

Verification

TomCat tray icon green

Tomcatw.exe process running (also if stopped??)

Stop

17

make sure that no other server (like IIS for WebApproval

or Delano uses port 80. If needed, stop IIS to avoid
conflict

TomCat tray icon

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

Configuring Press TP: JDF/JMF

18

DeviceID is used to select the press with JDF

Enable Notify press at" and type URL of press controller

that should receive info/commands on previews/plates

Tab for Generic Press is in Parameter Set

Applies to new jobs only!

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

Verifying / tracing JMF TomCat

19

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

Checking JMF ApogeeX using Internet

Explorer

URL <ipadress server> URL

e.g. "http://10.232.22.10"
or "localhost/" when testing on server
Shows Tomcat version Tomcat running OK
URL <ipadress server>/AXJMF/
e.g "http://10.232.22.10/AXJMF/"
Different URL from AX2.5 or AX3.0b2, note trailing '/
Shows You have reached the AXJMF webinterface
Shows "JDFserver is running!"
Neglect invalid HTTP contenttype warning
Include port number in URL if not at 80

20

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

Checking with Agfa tools

HTTPPoster 3.0

On server :

21

Run "HTTPPost_TestMessage.bat" and check

response
Run "HTTPPost_TestJob.bat" and check if job
appears

On different server: adapt IP address in

DefineServer.bat first

Available on DVD beta3 JDFSupport??

See also JDF_JMF Tools presentation

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

If not working

Check if TomCat is running

Check TomCat console

Check if port is not used by e.g. IIS (log file)
Check if port was set to 80 (no requirement if host knows the address)
Tomcat console monitor, begin: Initializing Coyote HTTP/1.1 on port 80
Open Tomcat 5.0\conf\server.xml

Check if ApogeeX is running

Check if JDF Input license is installed

Basic report: JDF_INPUT, JDF_IMPORT, JDF_JMF, JDF_Layout option

needed

Troubleshoot

22

Check Connector port label 'non-SSL'. Can change this if needed

Shutdown TomCat (from task icon)

Shutdown AX server and restart (from Console)
Restart TomCat

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

TomCat logging view

Live

Click on TomCat icon in task bar

Select: Open Console Monitor (live)

Log file

23

!! Logging view usually stops after a hundred

messages
C:\Program Files\Apache Software foundation\TomCat\Logs\stdout.log

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

TomCat logging
2
1

24

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

TomCat inside log

Info that http is properly running (and port nr)

Scroll to start of log

-> "Initializing Coyote HTTP/1.1 on port 80"

Info that job is submitted

25

Can be any port but MIS must define this port

then

Shows IP address
Show content-type: important, sometimes
wrong
Shows if a job is a duplicate
Install JDF/JMF ApogeeX3.0beta3
21

Koen Van de Poel 2006-02-

TomCat JMF Servlets

in TomCat 5.0\WebApps folder

AXJMF.war file (incoming JMF comm.)

ResourceGet.war file (retrieve PPF and JDF)

Hints

Delete older ApogeeXJMF.war if still present

Date of .war files should be 2006

26

Delete AXJMF and ResourceGet folders if

problems after upgrade to clear caching
JMFServer (including TomCat) should be installed
BEFORE applying a ServicePack
Install JDF/JMF ApogeeX3.0beta3
21

Koen Van de Poel 2006-02-

Testing ResourceGet servlet

If you are in doubt on ResourceGet, try this

URL in a web browser and it should return a
PDF file

Replace localhost with the ip address or

computer name

27

http://localhost/ResourceGet/?type=delanoimg&rt=pdf&ct=pdf&rl=Defaul
tStorageServer/ProcessResourceDisk/eps_files/X_PunchVerificationMark
.pdf

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

TomCat logging info

Info that http is properly running (and port nr)

Scroll to start of log

-> "Initializing Coyote HTTP/1.1 on port 80"

Info that job is submitted

28

Can be any port but MIS must define this port

then

Shows IP address
Show content-type: important, sometimes
wrong
Shows if a job is a duplicate
Install JDF/JMF ApogeeX3.0beta3
21

Koen Van de Poel 2006-02-

JMF most common problems

Clean install

TomCat configured to a different port, not

matching JDF Server config
No JDF Input license

Demo install

29

TomCat not running

Conflict with other webservers (IIS,

WebApproval, Delano)
AXJMF and ResourceGet servlets not installed

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

Future (TomCat 5.5)

30

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

Install JMF Webserver (Future)

Start from Main Installer: JMF Webserver

Third party installers may need some time

Installs Java 1.5 (not pre-installed on TKS)

An intermediate wait after JAVA install, do not exit!
Installs TomCat 5.5

includes specific settings for Agfa

includes ApogeeXJMF and ResourceGet applet
for Agfa JMF communication
Actions

31

Preferred to set Connector port to 80, leave other

options unchanged
do not change TomCat location (C:)

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

Configure/start TomCat 5.5 (future)

Port

make sure that no other server (like IIS for WebApproval or

Delano uses port 80. If needed, stop IIS to avoid conflict

Start

Installer configures auto start of service

Verification (different from 5.0)
tomcat5.exe running in processes (also tomcat5w.exe) or
Start: TomCat 5.5-> Monitor TomCat

Stop

Start: TomCat 5.5-> Monitor TomCat

32

Appears in Task bar, context click should show Stop Service

Appears in Task bar, context click to select Stop Service

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-

If not working (future)

Check if TomCat is running

tomcat5.exe running in Taskmanager processes (also

tomcat5w.exe)
C:\Program Files\Apache Software Foundation\Tomcat 5.5\logs\
Check if port is not used by e.g. IIS (log file)
Check if port was set to 80 (other ports are OK if host knows this)
catalina.xx.log: INFO: Initializing Coyote HTTP/1.1 on http-80
To change port after install

Tomcat 5.0\conf\server.xml

Check Connector port label 'non-SSL'. Can change this if needed

<!-- Define a non-SSL HTTP/1.1 Connector on port 8080 -->
<Connector port="80"

Check if ApogeeX is running

Check if JDF Options and JDF_JMF license is installed (adapt!!)

Troubleshoot

33

Basic report: JDF_INPUT, JDF_IMPORT, JDF_PARAM_CONVERSION, JDF_JMF,

JDF_Layout option needed
Shutdown AX server and restart (from Console)

Install JDF/JMF ApogeeX3.0beta3

21

Koen Van de Poel 2006-02-