Plossys Netdome

Transcript

PLOSSYS netdome Guide Version 4.4.0 2011-05-03 SEAL Systems Copyright This document and all its parts are protected by copyright. Their use without prior written consent by SEAL Systems is prohibited and subject to prosecution. In particular, this applies to reproduction, translation, microfilming and the storing and processing in electronic systems. Customers that currently own a valid SEAL Systems software license for the product(s) described within the contents of this documentation, may freely distribute this documentation in electronic form (e. g. CD/file server or intranet) for internal usage only. All product names mentioned are the registered trademarks of the associated companies. Copyright 2011 SEAL Systems AG Lohmühlweg 4 D91341 Röttenbach Germany Contents 3 Contents 1 Introduction ..................................................................................................................... 5 2 What Is New in PLOSSYS netdome 4.4.0?................................................................... 6 3 Installation of PLOSSYS netdome 4.4.0 ....................................................................... 7 3.1 With a New Installation ........................................................................................ 7 3.2 With an Update ...................................................................................................... 7 4 Converter and Gates ....................................................................................................... 8 4.1 Converter or Gate?................................................................................................ 9 4.2 Configuration Interface ...................................................................................... 10 4.3 Changing the Old Process (Gate) to the New One (Converter) ...................... 11 5 Logging........................................................................................................................... 12 6 Assignment Using the IPP Interface............................................................................ 13 7 PLOSSYS netdome and System Status ....................................................................... 14 8 What Am I Doing If ... .................................................................................................. 15 8.1 ... I Want to Catch the Files of a Job?................................................................ 15 8.2 ... My Job Is Not Output? ................................................................................... 15 8.3 ... the Job Files Disappear Although the Gate Has Been Stopped? ................ 15 8.4 ... the Job Files Disappear Although the Converter Has Been Stopped? ....... 15 8.5 ... the Database Does Not Start? ......................................................................... 15 Bibliography ....................................................................................................................... 16 Index.................................................................................................................................... 17 SEAL Systems www.sealsystems.com 2008-09-09 Version 1.2.4 Base Configuration of DMS Modules System Description 4 Base Configuration of DMS Modules System Description Contents 2008-09-09 Version 1.2.4 SEAL Systems www.sealsystems.com 1 Introduction 1 5 Introduction ........................................................................................................................................................ This document provides a quick overview of what is new in the version 4.4.0 of PLOSSYS netdome and what must be taken into account. purpose ........................................................................................................................................................ The description how the single steps are executed can be found in the correspondent documentation. reference ........................................................................................................................................................ This document is intended for use by the PEs at SEAL Systems. target group ........................................................................................................................................................ SEAL Systems www.sealsystems.com 2011-05-03 Version 4.4.0 PLOSSYS netdome Guide 6 2 What Is New in PLOSSYS netdome 4.4.0? 2 What Is New in PLOSSYS netdome 4.4.0? ........................................................................................................................................................ conversion service The preprocessing of the jobs (gates) has been renovated completely and uses now a conversion service running on a JBoss application server. With this, a higher performance and a better utilization of resources are possible. The old process via the gates can still be used in parallel if required or if the specific gate has not yet been replaced by a converter. ........................................................................................................................................................ monitored input directory The new process via the conversion server makes a difference between the converters and the monitored input directories. The conversion service monitors the input directories and passes the jobs to a suitable converter. ........................................................................................................................................................ configuration The conversion service and the converters are configured using the web-based configuration interface, PLOSSYS netdome Settings (short: PNE; German: PLOSSYS netdome Einstellungen). The configuration is held in the database of the PLOSSYS netdome system. Therefore, editing configuration files for the converters is no longer required. ........................................................................................................................................................ logging The conversion service does not write log files to the file system, but stores its messages in the database of the PLOSSYS netdome system. The logs can be evaluated via PLOSSYS OCON. ........................................................................................................................................................ new cover and missing sheets The cover sheets previously created in the set gate using GKSM templates now use the standards XML and XSL-FO. With this, the layouts of the additional sheets can be created using modern tools and Unicode is supported by default. This also applies to the error sheets which can be generated in the case of conversion errors. ........................................................................................................................................................ LPR daemon PLOSSYS netdome can operate as LPR daemon, so that the client systems can assign jobs via LPR. ........................................................................................................................................................ IPP support PLOSSYS netdome can operate as IPP server and accept jobs via IPP. The transfer to the output devices is also possible using the IPP protocol. ........................................................................................................................................................ output method PUTPJL Using the PUTPJL output method, both secure printing output and restarting at a specific page in the case of error can be implemented. ........................................................................................................................................................ PLOSSYS netdome Guide 2011-05-03 Version 4.4.0 SEAL Systems www.sealsystems.com With a New Installation 3 Installation of PLOSSYS netdome 4.4.0 7 3 Installation of PLOSSYS netdome 4.4.0 3.1 With a New Installation ........................................................................................................................................................ In master.pl, the module files are selected as before. All modules required additionally are checked out, too. as before ........................................................................................................................................................ 3.2 With an Update ........................................................................................................................................................ In master.pl, set the version of am to 4.4.0. Everything else is set to the correct version automatically. am 4.4.0 ........................................................................................................................................................ Older versions of PLOSSYS OCON are possible with PLOSSYS netdome 4.4.0, however, the functionality of PLOSSYS netdome 4.4.0 is missing then. hint ........................................................................................................................................................ If the installed version of PostgreSQL is less than 8.4.0.1, the data\postgresql directory must be deleted. This is indicated when starting PLOSSYS netdome. old PostgreSQL version ........................................................................................................................................................ SEAL Systems www.sealsystems.com 2011-05-03 Version 4.4.0 PLOSSYS netdome Guide 8 4 Converter and Gates 4 Converter and Gates ........................................................................................................................................................ in this chapter This chapter deals with the following topics: Topic Page Converter or Gate? 9 Configuration Interface 10 Changing the Old Process (Gate) to the New One (Converter) 11 ........................................................................................................................................................ PLOSSYS netdome Guide 2011-05-03 Version 4.4.0 SEAL Systems www.sealsystems.com Converter or Gate? 4 Converter and Gates 4.1 9 Converter or Gate? ........................................................................................................................................................ In new installations, all conversions that are possible over the new process (converter) are executed using this process. new installation ........................................................................................................................................................ Some few conversions (such as hpglgate) still need the gate process. In the configuration interface, PLOSSYS netdome Settings, you can see which conversions must be executed using the old process (gate). old process ........................................................................................................................................................ As input directories, the former gate directories can be used. Default is that all jobs are collected here and are processed then. input directory ........................................................................................................................................................ When updating, changing the preprocessing to the new process (converter) is not mandatory. However, it makes sense because the new process is essential faster than the old one and can manage "problematic" files better, too. hint ........................................................................................................................................................ The main gate and the star gate are changed to the new process (converter) automatically. main and star gate ........................................................................................................................................................ SEAL Systems www.sealsystems.com 2011-05-03 Version 4.4.0 PLOSSYS netdome Guide Configuration Interface 4 Converter and Gates 10 4.2 Configuration Interface ........................................................................................................................................................ web-based user interface For configuring the conversion service, the converter and the gates and for changing the old process (gate) to the new process (converter), the web-based configuration interface, PLOSSYS netdome Settings, is available. ........................................................................................................................................................ call The configuration interface, PLOSSYS netdome Settings, is opened via http:/ with server specifying the server where the PLOSSYS netdome server is running. /server:8080/pcgui, ........................................................................................................................................................ menu On the bottom left, open Migrate Legacy System and select Migrate Gates: ........................................................................................................................................................ PLOSSYS netdome Guide 2011-05-03 Version 4.4.0 SEAL Systems www.sealsystems.com Changing the Old Process (Gate) to the New One (Converter) 4 Converter and Gates 4.3 11 Changing the Old Process (Gate) to the New One (Converter) ........................................................................................................................................................ Changing one gate after the other makes sense, in particular if you do this for the first time. Beginning with the gate which has the fewest customizations is the best way. procedure ........................................................................................................................................................ scripts and maingate.pl are still supported. They can be customized using the configuration interface, PLOSSYS netdome Settings. gate_ched.pl gate scripts ........................................................................................................................................................ More complex gate_ched.pl scripts must be tested in any case. In particular, it could happen that some Perl libraries, which were included via gate25.pl before, are no longer available in gate_ched.pl. These must be included explicitly then. test ........................................................................................................................................................ When editing, note that the .../${ENV.PLSGT}/.../gate_ched.pl scripts are possibly called by several converters: color/gate_ched.pl GIF to PDF, JPEG to PDF, PDF to PDF, PS to PDF, XSLT:FO to PDF tiff/gate_ched.pl CALS to PDF, MIL to TIFF, TIFF to PDF Caution: several converters ........................................................................................................................................................ Via the old process (gate), PDF/A could be generated, for example in the color gate. This is no longer possible over the new process (converter). Now, PDF/A can only be generated via the output queue. Caution: PDF/A ........................................................................................................................................................ SEAL Systems www.sealsystems.com 2011-05-03 Version 4.4.0 PLOSSYS netdome Guide 12 5 Logging 5 Logging ........................................................................................................................................................ database Because the log messages are now saved in the database, viewing them using PLOSSYS OCON is the best way. In the previous log directory, you no longer find all required information. ........................................................................................................................................................ export The new script, logexport.pl, collects the log messages according to certain criteria. With -h, the usage is output. ........................................................................................................................................................ delete (clrlog) Because the logs (log messages) are saved in the database, the database must be running when executing clrlog. If the database is not running, it will be started automatically. ........................................................................................................................................................ Caution: not deleted cannot delete all log files in data\log when the system is running due to some are being accessed in this case. clrlog ........................................................................................................................................................ files (clrplots) For clrplots, JBoss and PLOSSYS netdome must not be running, but the database must be running. If the database is not running, it will be started automatically. ........................................................................................................................................................ -dbonly parameter For clrlog and clrplots, the new parameter -dbonly is available. For more information about it, call the correspondent script with -h. ........................................................................................................................................................ PLOSSYS netdome Guide 2011-05-03 Version 4.4.0 SEAL Systems www.sealsystems.com 6 Assignment Using the IPP Interface 6 13 Assignment Using the IPP Interface ........................................................................................................................................................ Using the IPP interface, jobs can be passed to PLOSSYS netdome. However, not all header parameters are supported at the moment. pass job ........................................................................................................................................................ This is how you output an output job using the IPP interface: call %PLSTOOLS%\ipp\ippclient.pl -nodialog -uri http://IPP-SERVER:PORT/printers/PLS_SERVER:PRINTER -jobname NAME -username USER –copies NN –filetype MIMETYPE GRAPH with: IPP-SERVER: PORT: PLS_SERVER: PRINTER: NAME: USER: NN: MIMETYPE: GRAPH: Server where the IPP server is running; usually, the PLOSSYS netdome server Port via which the IPP server can be reached; default is 631 on Windows and 2631 on UNIX and Linux. Server where PLOSSYS netdome is running Output device; is passed as PLS_PLOTTER. Name of the job User name; is passed as PLS_USER. Number of copies; is passed as PLS_PLOTCOPY reduced by 1. MIME type describing the file format of the document to be output; is passed as PLS_PLOTTYPE. The special value application/seal-native is mapped to NATIVE. If nothing is specified, PLOSSYS netdome evaluates the file format. Path and name of the graphic file to be passed to PLOSSYS netdome ........................................................................................................................................................ Other header parameters are not supported at the moment. header parameter ........................................................................................................................................................ SEAL Systems www.sealsystems.com 2011-05-03 Version 4.4.0 PLOSSYS netdome Guide 14 7 PLOSSYS netdome and System Status 7 PLOSSYS netdome and System Status ........................................................................................................................................................ separate It is recommended that PLOSSYS netdome and SEAL Control Center including System Status are installed in separate home directories. ........................................................................................................................................................ patches must be called after the installation for both System Status and PLOSSYS netdome. install\systemstatus\activatepatch.pl ........................................................................................................................................................ PLOSSYS netdome Guide 2011-05-03 Version 4.4.0 SEAL Systems www.sealsystems.com 8 What Am I Doing If ... 15 8 What Am I Doing If ... 8.1 ... I Want to Catch the Files of a Job? (Previous: via gatestop gate and gatestart gate) • Deactivate the input directories (in the configuration interface, PLOSSYS netdome Settings) • Or call java -jar omngcli.jar -stop/start 8.2 • • • ... My Job Is Not Output? In PLOSSYS OCON, check if the job can be found and, if this is the case, check the log file Or call logexport.pl -time dnumber_days or -time hnumber_hours Or call logexport.pl –plotid PLOTID or logexport.pl –job JobNo if PLOTID or JobNo is known 8.3 ... the Job Files Disappear Although the Gate Has Been Stopped? (Scenario: A gate is still using the old process.) • In the configuration interface, PLOSSYS netdome Settings, check if the input directory is monitored by the conversion service, this means if the input directory is active. 8.4 • ... the Job Files Disappear Although the Converter Has Been Stopped? In the configuration interface, PLOSSYS netdome Settings, check if the input directory is still active. (Background: As long as the input directory is being active, the job files are fetched by the conversion server and moved to data\omng\..., regardless of whether the converter is running or not. Therefore, deactivating the input directory is important instead of stopping the converter.) 8.5 • • ... the Database Does Not Start? Increase the kernel parameter SHMMAX. Call the setmaxdbconnections.pl script alternatively. The script adjusts the database configuration to the server configuration. (Background: The maximum number of database connections in the data base configuration does not match to the configuration of the kernel parameter.) SEAL Systems www.sealsystems.com 2011-05-03 Version 4.4.0 PLOSSYS netdome Guide 16 Bibliography Bibliography ............................................................................................................................................................................................... [NETDOME_DETAIL_TEC] PLOSSYS® netdome Details, System Description, SEAL Systems [NETDOME_TEC] PLOSSYS® netdome, System Description, SEAL Systems [NETDOME_USR] PLOSSYS® netdome, User Manual, SEAL Systems [OCON_INS] PLOSSYS® OCON, Installation Guide, SEAL Systems [OCON_ONL] PLOSSYS® OCON, Online Documentation, SEAL Systems [SEALCC_TEC] SEAL Control Center, System Description, SEAL Systems [SYSTEMSTATUS_TEC] System Status, System Description, SEAL Systems ............................................................................................................................................................................................... PLOSSYS netdome Guide 2011-05-03 Version 4.4.0 SEAL Systems www.sealsystems.com Index 17 Index A H additional sheet 6 hpglgate 9 C I catch job files 15 change gate to converter 9, 10, 11 main gate 9 star gate 9 clrlog 12 -dbonly 12 clrplots 12 -dbonly 12 color gate 11 configuration 6, 10 conversion service 6 configure 10 logging 6 converter 6, 9 change gate to 9, 10, 11 configure 10 cover sheet, layout 6 input directory 9 deactivate 15 job files disappear 15 monitored 6 installation activate patches after 14 PLOSSYS netdome 4.4.0 7 separate for PLOSSYS netdome and System Status 14 System Status 14 IPP interface 13 IPP server 6 ippclient.pl 13 D database configuration 6 delete 7 export log 12 log message 6, 12 database does not start 15 -dbonly 12 deactivate input directory 15 delete database when updating 7 log 12 documentation 5 E error sheet, layout 6 G gate 6, 9 change to converter 9, 10, 11 configure 10 job files disappear 15 gate directory 9 gate_ched.pl 11 gate25.pl 11 SEAL Systems www.sealsystems.com J JBoss application server 6 job catch 15 not output 15 pass per IPP 6 pass via IPP 13 pass via LPR 6 restart in the case of error 6 job files disappear from gate 15 job files disappear from input directory 15 L layout cover, missing, error sheet 6 log delete 12 export database 12 view in PLOSSYS OCON 12 log directory 12 log message 12 logexport.pl 12, 15 logging 6 LPR daemon 6 M main gate, change 9 maingate.pl 11 master.pl 7 Migrate Gate 10 Migrate Legacy System 10 missing sheet, layout 6 2008-01-01 Version 1.0.0 PLOSSYS netdome User Manual 18 Index N U new in PLOSSYS netdome 4.4.0 6 new process 6, 9 Unicode 6 update, PLOSSYS netdome 4.4.0 7 O V old process 6, 9 omngcli.jar 15 output method PUTPJL 6 version PLOSSYS OCON 7 PostgreSQL 7 P X patches, activate 14 PDF/A 11 Perl library 11 PLOSSYS netdome 4.4.0 installation 7 System Status 14 update 7 what is new? 6 PLOSSYS netdome Settings 6, 9, 10, 15 open 10 PLOSSYS OCON find job 15 version 7 view log 12 PNE 6 PostgreSQL, version 7 preprocessing 6 new process (converter) 6, 9 old process (gate) 6, 9 purpose 5 PUTPJL 6 XML 6 XSL-FO 6 R restart in the case of error 6 S script gate_ched 11 gate25.pl 11 ippclient.pl 13 logexport.pl 12, 15 maingate.pl 11 SEAL Control Center including System Status 14 secure output 6 set gate 6 star gate, change 9 System Status 14 installation 14 T target group 5 PLOSSYS netdome User Manual 2008-01-01 Version 1.0.0 SEAL Systems www.sealsystems.com