Web Services

You can use the function "Web services" to define the settings for the portal’s individual web services.


Web Services


Dialog boxes are available for the following services:







Signature and



You can see for each web service what the current Status of the web service is.


In addition to easily enabling and disabling the service with the "Web service enabled" switch,



In the case of certain web services, you will not be able to enable them until the underlying service has been tested successfully.


you can use this function to access various settings that apply to all web services:


Number of instances

Use this value to specify the maximum number of instances that are allowed to run at the same time. By doing so, you can define the maximum number of requests that can be handled simultaneously by the web service. This allows you to influence the performance of the server.


Please note:


a) That every additional instance will require additional memory and that this might make it necessary to modify the server's memory allocation settings (see ".vmoptions").


b) That the number of instances should be set in relation to the number of processor cores available on a system. The following rule of thumb applies:


Instances = Number of processor cores x 2


c) That the max. number of instances is limited by the license.

Max. number of requests in the queue

If an instance reaches this number of requests, the current instance will be closed and replaced with a new instance.

Max. runtime for a single instance

Use this value (in seconds) to specify the maximum runtime for an individual process within an instance. If this time is exceeded, the process will be cancelled.


dialog admin webservices



When you disable a web service, none of the functions connected with it are available any longer.


Settings "Font path" for "Converter" and "PDF/A"


For these two web services, you can also specify a font path which serves as the basis for the search for fonts. Normally, you do not need to provide any input here because webPDF automatically uses the system-specific directories (Linux: /usr/share/fonts/; Windows: c:\windows). Input is only necessary, for example under Linux, if the sum of all directories exceeds 256 characters. In this case, use the setting to specify a different base directory which contains fewer subdirectories.


Settings for “URL”


You can also define a time limit for the web service URL (in milliseconds) indicating when a page is considered to be unreachable and thus the URL conversion fails.


Settings for "Converter"


You can also use SharePoint for the conversion with the Converter web service. To do this, enter your SharePoint URL, username, and password. For more details, please refer to the SharePoint Bridge chapter.


If you have Microsoft Office installed on the server, you can use it directly for Office formats. To do this, enable the Enable Office Bridge option. Click on the Test button to check whether the connection worked.


You can use the Chromium bridge to convert various HTML-based formats (this option will be enabled by default). If you do not want Chromium to search for an available port automatically for the conversion, you can assign one here instead (0 in order for a port to be assigned automatically).



A restart is required after changing these options.