PDF HandShake UB64 User manual (Version 5.0.0)  
 

8 Create PDF Server

Workflow: Create PDF Server

Fig. 8.1: Workflow: Create PDF Server

PDF HandShake has a feature to automate the PDF creation of any PostScript job. This is done by creating a new printer queue in HELIOS Admin, with the connection type Create PDF. This queue prints the PostScript job over the network to a dedicated Mac or Windows based workstation which is used to create the PDF file. After a PDF file is successfully created, it is returned to the HELIOS printer queue.

Create PDF Server utilizes Adobe Acrobat Distiller, which must be purchased separately. It is important to comply with the licensing terms of Adobe Acrobat. Specific terms related to using Acrobat on a server can be found in the Acrobat license file. The purpose of Create PDF Server is to use Acrobat Distiller more efficiently, reduce administrative and training costs, and to ensure consistent, reliable PDF job production.

Alternatively, you may use Ghostscript to convert the PostScript print job into a PDF file. Ghostscript is license-independent and is available for major platforms. However, it can only generate low-end PDF documents.

Ghostscript binary

Ghostscript (“gs” binary) is available in various distributions, free of charge. HELIOS supports all current Ghostscript 8.x and 9.x versions. The Ghostscript executable (“gs” on UNIX, “gswin32c.exe” on Windows) must be installed in some standard directory, or the ghostscript preference must be set to the executable path.

The benefits of Create PDF Server are:

Note:

There is no speed up for the Adobe Distiller or Ghostscript from multi-processor machines.

Section 8.2 “Setting up a “Create PDF” printer queue with HELIOS Admin”, presents and explains the features within HELIOS Admin which are specific to Create PDF Server. However, other features which are already described in the corresponding chapter in the HELIOS Base manual are merely referenced.

8.1 Installation

8.1.1 Prerequisites

Mac OS 9
OS X
Windows
All platforms

In order to ensure trouble-free server operation it is most important that the “dedicated” server is not employed with tasks other than running the Create PDF Server process.

Ghostscript

During the installation of the HELIOS software modules, “createpdf” is created in the “HELIOSDIR/sbin” directory. It is started every time a print job is sent to port 2018 (see “TCP ports used by HELIOS” in the HELIOS Base manual).

8.1.2 Server memory requirements

The performance of Create PDF Server on the dedicated server increases with the size of the available RAM memory.

8.1.3 Mac server installation

For instructions to install Create PDF Server on different Mac systems, refer to the “README.txt” document:

hsymInstruction

Mount the “HELIOS Applications” volume and open MacOS > PDF Tools > Create PDF Server.

8.1.4 Windows server installation

For instructions to install Create PDF Server on different Windows systems, refer to the “README.txt” document:

hsymInstruction

Connect the “HELIOS Applications” network drive and open Windows > PDF Tools > Create PDF Server.

There are two ways to make use of Create PDF Server, by installation as a service or by use in a console window:

Installation

Advantages:

hsymInstruction

Double-click “InstallPDFService”, which installs “HELIOS Create PDF Server” as a Windows Service. This means that it is started each time the Windows PC is booted. Calling this install script will also start the server immediately.

Verification of the installation:

hsymInstruction

Start the Windows “cmd” program and change to the “Create PDF Server” directory. Type "Create PDF Server.exe" -s and press RETURN (-s = “status”).

Your Create PDF Server service installation was successful if the line Service is installed. appears in the Windows “cmd” program command line.

Alternatively, you can do the following:

hsymInstruction

Open “Start > Control Panel > Administrative Tools > Services”. Then double-click the “Create PDF Server” entry.

Removal of the service:

hsymInstruction

In the Create PDF Server folder double-click “RemovePDFService.bat”.

Use in a console window

Advantage:

hsymInstruction

To start Create PDF Server manually (in a console window), double-click the Create PDF Server icon.

hsymInstruction

To stop Create PDF Server use “Ctrl-Pause” (Break key functionality) or close the console window.

Important:

Create PDF Server can run as a service or in a console window – but never simultaneously!

Error logging

In the event of an error, respective messages are written to the “Windows Event Log” and can be displayed with the Windows Event Viewer.

Adopt settings (Acrobat 5 and later)

If Create PDF Server is used as a service, you need to run the “AdoptSettings.exe” program each time you change the Font Locations... settings within Acrobat Distiller. This is because Acrobat stores its settings in user-dependent trees of the Windows Registry. In order to make these settings available to the service, “AdoptSettings.exe” copies the settings to a global node.

Note:

When running Create PDF Server on Windows as a system service, jobs may get stuck if Adobe Acrobat tries to display a dialog. System services on Windows run as user “SYSTEM”, so Acrobat's dialogs about registration, activation, demo expire time or updates are not shown to the user that is currently logged-in. To make dialogs being shown to the currently logged-in user, open the service's properties (Computer Management > Services > HELIOS Create PDF Server), select the tab Log on, and check Allow service to interact with desktop. To avoid these dialogs and stuck jobs, you should activate Acrobat and disable registration and automatic updates.

8.2 Setting up a “Create PDF” printer queue with HELIOS Admin

Creating or editing printer queues with HELIOS Admin, which is essential for the following, is described in detail in the HELIOS Base manual. In this chapter, the focus is on the “Create PDF” printer queue only.

8.2.1 Create PDF connection

hsymInstruction

In the HELIOS Admin Printers tab select File > New and specify a new printer according to the instructions given in the Base manual. Select Create PDF from the Connection pop-up menu, so the Interface tab comes into the foreground (Fig. 8.2).

<code>Create PDF</code> printer connection

Fig. 8.2: Create PDF printer connection

hsymInstruction

Enter the IP address of the host where Create PDF Server and Acrobat Distiller are installed in the Host Name field, and specify the port number in the Port field.

Note:

The port number allows you to specify whether the PDF is generated via Create PDF Server (2005) or Ghostscript (2018).

Instead of the IP address you may also specify the server host name on the network. However, this requires a configured and working DNS server on the network.

The directory path to the location where the processed PDF print jobs are saved must be specified in the Directory field. You may also use the Browse... button to select the spool directory. If the option Create Folder for Each User is active, a subfolder for each print job “owner” is created in the directory path where the print jobs are stored. The user name is the Owner Name as stated in the %% For: (name) string inside the PostScript job.

Note:

If the user name is not known to the HELIOS server, the PDF will be stored inside a folder “nobody”.

If the Send Notification checkbox is activated, the “Create PDF” interface reports events to all listening services.

Note:

Note that with the option Send Notification activated, layouts are generated if the target volume is configured to create layouts.

If desired, you can enter a Name Prefix and a Notify Program. The prefix serves to identify the files that are coming from this specific printer queue (in case you have several “Create PDF” printer queues which print to the same destination). The Notify Program option lets you enter a path that leads to a specific program. Again, you may also use the Browse... button to select a notify program.

This program will be started automatically after printing has been finished successfully. A notify program can perform any arbitrary action. If a PDF preflight profile is selected, then a notify program must be used to specify the pdfToolbox command to be executed. The “inspectPDF” sample script is included for this purpose, in the HELIOS “Settings > Printer Scripts” volume. The “inspectPDF” script can be used as-is, modified (various options are included as comments), or as a reference for a new script. Job information (e.g. user, title, pages) is exported by the server as environment variables, for use by the notify program, see distillnotifyprog in 14.3.1 ““pdfif” preference keys”.

Select PDF Preflight Profile

If a Notify Program was specified, the Select PDF Preflight Profile option allows you to specify a profile for the PDF preflight functionality (see 9.1 “PDF preflighting with “pdfToolbox””). If no Notify Program was specified, no preflighting is done at all.

If a queue has a PDF profile assigned, you can display the contents of that file in a text window, and root and members of the “SysAdm” or “QueueAdm” group can edit the file:

hsymInstruction

Click the Edit PDF Profile... button.

Select Distiller Settings

To set up the preferred Distiller settings for the “Create PDF” printer queue, do the following:

hsymInstruction

Start Acrobat Distiller and select a pre-defined PDF job option from the Default Settings pop-up menu in the Adobe PDF Settings section.

hsymInstruction

Open Settings > Edit Adobe PDF Settings.... Modify the settings according to your needs (see 16 “Create PDF files using Acrobat Distiller”) and save your changes – under a new name – to the Distiller “Settings” folder by clicking Save as.... Optionally, the job options file can be saved to the HELIOS “Settings” volume, in the “Distiller Settings” folder. Then highlight your “Create PDF” printer queue in the HELIOS Admin Printers tab and select Settings from the Printer menu. In the Interface tab activate the Select Distiller Settings checkbox and enter the path to the job options file in the text field or click Browse... to search for it.

Now your job option settings have been saved to the “Create PDF” printer queue on the host and are stored in the “SETTINGS” file of the spool directory.

Edit Distiller Settings

In the Interface tab of the “Create PDF” printer queue you can display the contents of the Distiller settings file in a text window. “root” and members of the “SysAdm” or “QueueAdm” group can edit it:

hsymInstruction

Click the Edit Distiller Settings... button.

Note:

It is not recommended to edit the “SETTINGS” file manually because this can introduce syntax errors.

Edit Distiller Security

You may want to protect your created PDF documents against unauthorized use, e.g. from being opened, printed, or changed.

The different types of protection can be set in any Acrobat Distiller:

hsymInstruction

Start Acrobat Distiller and go to Settings > Security.... In the “Security” window (Fig. 8.3) specify the required options, and finally confirm your entries with the OK button.

Acrobat Distiller “Security” dialog

Fig. 8.3: Acrobat Distiller “Security” dialog

Likewise, Create PDF Server can tag PDF documents, during the generation, with security settings which restrict the opening, printing, changing (i.e. editing) of a PDF document.

Create PDF Server stores the security information in “HELIOSDIR/var/spool/​qmeta/<printer>/​SECURITY”. To use security settings with Create PDF Server, proceed as follows:

hsymInstruction

Start HELIOS Admin and select the desired “Create PDF” printer queue. Open the security settings window (Fig. 8.4) of the respective “Create PDF” printer queue by clicking the Edit Distiller Security... button in the Interface tab of the printer queue configuration window.

Select “SECURITY” file

Fig. 8.4: Select “SECURITY” file

hsymInstruction

Apply your changes in the “SECURITY” window, then close the window and confirm your changes.

Create PDF Server will produce PDF files which behave according to the specifications in the “SECURITY” file.

Note:

If no security settings are specified in the “SECURITY” file, Create PDF Server does not put up any restrictions. However, if security settings are defined in the used Distiller they will be applied! So make it a habit to remove all PDF security related restrictions in the Distiller settings, and apply such restrictions via Create PDF Server only.

8.2.2 Composite PDF without color space transforms

When printing composite PostScript to a “Create PDF” queue, if color matching is turned off (i.e. the Default Printer Profile in the HELIOS Admin tab ICC is set to None), then no color matching will take place, and all objects will be sent in their original color space to be Distilled. However, color space conversion may still occur if the Distiller “Adobe PDF Settings” are set to do so.

8.3 Print to the “Create PDF” printer queue

Printing to a “Create PDF” printer queue is almost the same as printing to any other HELIOS printer queue. The only difference is that here a Mac or Windows host with Acrobat Distiller acts as a “Create PDF” printer. So any (authorized) user on the network can benefit from the functionality of Create PDF Server.

hsymInstruction

In the application from which you want to print, open the print menu and choose the “Create PDF” printer queue. There, specify the required settings (e.g. paper size and PostScript options) and start the job.

Create PDF Server then starts processing the jobs – one at a time – according to their order in the spool queue. You can monitor the process and the state of each print job in the “Create PDF Server” window.

While idling, the window states with a “Welcome” message that the server is ready to receive print jobs. When a print job is being processed the window displays information about where the job comes from and via which port as well as the total print job size and the transfer rate. After Create PDF Server has completed the job and the PDF file has been created, the window shows the size of the PDF file and the transfer rate (Fig. 8.5).

“Create PDF Server” window

Fig. 8.5: “Create PDF Server” window

If there should arise a problem during the print processing, a warning message appears in the “Create PDF Server” window specifying the cause of the problem (Fig. 8.6).

“Create PDF Server” window

Fig. 8.6: “Create PDF Server” window

After that, Create PDF Server is idle again and ready to accept new print jobs.

Obtaining the PDF file

There are two ways to obtain the printed PDF file: from the “hold” queue of HELIOS Admin, provided that the “Create PDF” printer queue is configured to pass printed jobs to the “hold” queue.

“Create PDF” print job on the “hold” queue

Fig. 8.7: “Create PDF” print job on the “hold” queue

hsymInstruction

Double-click the “hold” queue in the Printers list to access the file in the job window (Fig. 8.7). The PDF icon in front of the file name indicates that PDF generation has been successful. Double-clicking a job’s PDF icon in the “hold” queue automatically starts your Acrobat application. Also, you can select the job in the “hold” queue window and go to Save as... in the File menu of HELIOS Admin.

You can also obtain the created PDF file via the HELIOS volume (which should be described by the path in the Directory entry) and get access to the file there or, if you checked Create Folder for Each User, in the directory’s subfolder.

Note:

Please note that the PDF file still remains in the HELIOS directory even if the print job is erased from the “hold” queue. This is because the printer queue only references the PDF file.

8.3.1 Balancing “Create PDF” print jobs (Balance queue)

To enhance the data throughput you may group two or more “Create PDF” queues in one balance queue. The user then prints to this “balance” queue where the print server distributes the job to the next idle “Create PDF” queue.

Because the PDF job options and security settings are sent along with the print job, the print job can be sent to any of the Create PDF Server hosts.

For comprehensive and more detailed information about how to set up a balance queue, see the respective chapters in the HELIOS Base manual.

hsymInstruction

Activate the Printers list and choose New from the File menu. HELIOS Admin then opens a new printer data window, which – to some extent – is already filled out with default values from the “Server Settings” window.

hsymInstruction

Fill out the Printer Name, select a PPD, and if desired, assign “hold” and “error” queues. In the Connection pop-up menu select Balance Group. From the Printers list drag the “Create PDF” queues you want to group for load balancing into the Printer field (Fig. 8.8). To finish, enter the TCP and SMB names in the Mac and Windows tabs, and click Save.

Grouping “Create PDF” queues for balance queue

Fig. 8.8: Grouping “Create PDF” queues for balance queue

Important:

It is most important that the “Create PDF” printer queues which form the “Balance Group” have been assigned the same Distiller and Security settings (see Select Distiller Settings and Edit Distiller Security). Also select the same PPD for the “Balance Queue” which is already assigned to the “Create PDF” printer queues in the Printers field. Otherwise the printing results may not be predictable.

8.4 Possible problems

Acrobat Distiller sometimes produces strange error messages if it is running out of memory. Sometimes there is an error message no PDF file created or a PostScript error message. Please verify the failed PostScript job by dropping it on the Distiller application icon, maintaining the same Distiller Settings and Memory allocation.

If no PDF file is created the reasons could be:

The status in the “Printer” window issues “Waiting for printer…”. The possible cause is:


HELIOS Website © 2015 HELIOS Software GmbH  
HELIOS Manuals April 1, 2020