Run as a service

Start server, dispatcher or satellite as a service

The callas pdfaPilot Services application is only available for Windows at the moment.

Installation

1. Ensure there is an installation of callas pdfaPilot Server/CLI on the system and the application has been activated successfully.

2. A special executable, which is needed to run pdfaPilot as a service, is located in /cli/var/Service. Copy the executable into the subfolder "/cli" of the application folder of the server installation.

3. To install, the following command has to be executed on the command line:

pdfaPilotService.exe –-install

  • Note: Please confirm the security question of Windows if shown.

4. Open the "Services dialog" of Windows. This dialog can easily opened by typ-­ing the following string into the search field of the Windows start menu or use the following command on the command line:

Services.msc

5. There should show up 3 new services:

  • callas pdfaPilot Server
  • callas pdfaPilot Satellite
  • callas pdfaPilot Dispatcher

 

6. Select pdfaPilot Server and use the right-click menu item Action [or Properties depending on the Windows-version] in order to use this service and set in General the Startup Type to Automatic or Manual. When Automatic is choosen, every started job will continue processing, even when no user is logged on the system. It will even start processing, when the operating system is started. When using Automatic, also user details have to be entered into the Log On tab. It must be ensured, that all folders used in the jobsettings can be accessed by the defined user (especially when network paths shall be used by the job).

 

Configuration of a job

Now a job can be configured using the ServerUI, which can be accessed using the Standalone version (Menu: Tools - Server). When a job is started, pdfaPilot Standalone can be closed. The services aplli-­cation ensures, that the processing will continue even when the user is log-­ging off.

Access by remote

It is possible to connect to a Server running as a service by remote via the local network. Start pdfaPilot standalone, select menu: Tools - Server and choose Con-­nect with remote server. Enter the IP of the remote server where the service is running. After connecting all jobs on the remote server are shown and can be started, stopped or even modified. (Hotfolder paths of any server jobs (IN, OUT, etc.) have to be configured so that they are valid from the service's perspective (the system where the service is running) - and not from the perspective of the controlling standalone application.)

Troubleshooting

If network paths are used for processing jobs, the user should have sufficient rights to access them.

There may be special requirements for converting Office files to PDF when using pdfaPilot as a service. Check http://www.callassoftware.com/goto/apl_ENU_faqs  for the latest details.

Additional settings for Office conversion with restricted user permissions

If Office conversion is needed out of services using Windows it is recommend­ed to grant the respective service user administrator privileges. If this level of rights can not set due to internal regulations, some additional settings within the operating system are recommended.

The following folders should allow the user the respective access right:

For 64-bit machines
C:\Windows\Temp
Modify
C:\Windows\syswow64\config
Read
C:\Windows\syswow64\config\systemprofile
Read
C:\Windows\syswow64\config\systemprofile\AppData
Modify
C:\Windows\syswow64\config\systemprofile\Desktop
Modify (Create it, if it does not exist)
C:\Windows\syswow64\config\systemprofile\AppData\Local\Microsoft\Win­dows\INetCache
Modify (Create it, if it does not exist)
For 32-bit machines
C:\Windows\Temp
Modify
C:\Windows\system32\config
Read
C:\Windows\system32\config\systemprofile
Read
C:\Windows\system32\config\systemprofile\AppData
Modify
C:\Windows\system32\config\systemprofile\Desktop
Modify (Create it, if it not exist)
C:\Windows\system32\config\systemprofile\AppData\Local\Microsoft\Win­dows\INetCache
Modify (Create it, if it not exist)

Additional settings:

  • Set the 32-bit folder preferences (for details see above) in addition to the 64-bit preferences on 64-bit systems running 64-bit versions of Micro­soft Office
  • Set the default printer to XPS Document Writer

DCOM settings:  

  • Launch DCOMCNFG by using:
C:\WINDOWS\SysWOW64> mmc comexp.msc /32 
  • Go to Computers  MyComputer DCOM Config.
  • Right-click the application that you want to automate. The application names are listed in the table below:
Application
DCOM Name
Microsoft Access 2007/2010/2013/2016
Microsoft Access Application
Microsoft Excel 2007/2010/2013/2016
Microsoft Excel Application
Microsoft Office Word 2007
Microsoft Office Word 97 - 2003 Document
Microsoft Word 2010/2013/2016
Microsoft Word 97 - 2003 Document
  • On some systems Microsoft Word is not displayed and you will have to use      {00020906-0000-0000-C000-000000000046} instead.
  • Click Properties to open the property dialog box for this application.
  • Verify Identity and Security tabs

0 Comments

Send Your Comment

E-Mail me when someone replies to this comment