Web Services
The Web services function in the sidebar allows you to define settings for the server's individual web services.
For each web service, you can see the current status of the web service.
The list has a menu option (expand for configuration) for each one of the individual web services. This option will indicate the current web service status with the use of an icon. Following are the corresponding status icons:
| Symbol | Description |
|---|---|
 | The web service is enabled and is running correctly |
 | The web service has been disabled (paused) |
 | The web service is not available with the current license |
 | Web service error |
 | Unknown web service status |
If a web service is not available, the corresponding functions in the portal are also deactivated.
For a detailed error analysis, please check the webPDF server logs.
For example, the options of the Converter web service.
In addition to the simple activation or deactivation of the web service via Web service enabled, various settings (1) are available that apply to all web services. Individual settings (2) for each web service can be found below the general options.
Certain web services can only be activated once the underlying service has been successfully tested using the Test button.
Instances
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
In the default setting, the Queue mode setting is Automatic. The server automatically calculates the size of the queue depending on the maximum number of instances. The setting can only be changed if the setting is changed to Manual. In this case, you can enter the size manually in the Maximum number of requests in the queue field.
If possible, you should leave the setting at Automatic, as the server automatically adjusts the size to the number of instances (see “Performance”)
Max. runtime of an instance
Use this value (in seconds) to specify the maximum runtime for a single web service request within an instance. If this time is exceeded, the process is canceled. A watchdog monitors the running web service requests on the instances and cancels the request after this specified time.
You should be very careful when adjusting this execution time. If you set the value too high, you may increase the load on the server if many requests are executed.
Special settings
There are also special settings for some web services (2).
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. 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 Online for the conversion with the web service Converter. To do this, you can activate the use of the SharePoint Bridge here. Further information, particularly the configuration settings required here, can be found in the chapter SharePoint Bridge.
If you have Microsoft Office installed on the server, you can use it directly for Office formats. To do this, activate the Office Bridge option. Click on the “Test” button to check whether the connection is working.
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).