Services are software agents in SAFEQ Cloud that manage the workflow of the document process, for example authentication, printing or storing the document.

Adding/Removing multiple services

Multiple services can be added or removed to the SAFEQ Cloud system under a server node in the system tree. When a service is placed under a server node in the tree, it is owned by that parent node and will inherit any security and access control permissions granted to the parent.

To add and remove multiple services click ‘Add Services’ on the top header bar a window is displayed or by clicking the ‘ADD MULTIPLE’ button

This is the server for which will do the operations to add/remove multiple services

This column contains all the services that are not yet installed on the selected server

This column contains all the services that are installed on the selected server

Click Save to create and run the services moved from Available to Selected column and remove the ones moved from Selected to Available column on the target server.

Service information settings

When adding a service, specify the following configuration settings to determine the service role, the host server, and other configurations.

The friendly name of the service as it appears in the SAFEQ Cloud system tree

Choose the type of service to create from the drop down menu.

In SAFEQ Cloud, the following services exists:

Service type Description
API For programmatically interacting with SAFEQ Cloud, for example from external applications, automation scripts or similar
Authentication The Authentication Service is the service which communicates with AD/LDAP directories, Azure AD and similar to authenticate users
Conversion The conversion service is responsible for converting or preparing documents in one format to another, for example, converting a Word document to PDF
Document Output Responsible for delivering print job data to printers or MFP’s
IPP The IPP service receives print job data from PC clients (Windows, Mac and Linux)
Mobile The Mobile Print service is a service handling communication from YSoft Apps, MDM solutions, Wide Area Mobile Print DNS communication and similar
Storage The Storage Service is responsible for transferring and storing documents
Terminal Client The service which deploys embedded software release terminal clients running inside MFP’s, and the service to which MFP’s communicate back for authentication, retrieving jobs etc
Message The Message Service is responsible for delivering messages, such as emails, from SAFEQ Cloud to external systems, such as email SMTP servers

Use Separate JVM
Select this option to have the service run within its own JVM on the target server.
Running the service within its own JVM instance eliminates potential Java class or system resource conflicts and ensures that the service does not affect any existing services or the main application.
It can be helpful if you need:
- to constrain the resources (CPU and memory) consumed by a service
- to monitor the behavior of each service instance
Be aware that enabling separate JVM mode demands higher requirements for the hardware, in particular, more RAM is typically needed.

Control the running status of the Service

This value indicates the Service location. If no location is set on the Service, it will retrieve and display the inherited location of the parent (Account).

Select the target Server or Servers where the service should run. The Service will be hosted on the selected server(s) after it is created. Only servers that exist on the same branch within the SAFEQ Cloud system tree will be displayed.

Some services can run only on a single server (such as Storage), but other services can run on multiple servers (such as Document Output). This is useful for load balancing a service across multiple servers and providing redundancy for a service, so if one server goes down, the service will just continue to run on the other server.

Click Save to create and run the service on the target server(s).

Editing a Service

Edit a Service by clicking on the Service name within the SAFEQ Cloud System tree and selecting Settings. Settings are read only until the Edit button is clicked.

Services can also be managed on the Services menu of the host server. Click the icon in the list to edit or delete the Service from the SAFEQ Cloud system.

Request rate limiting

In order to minimize the denial of service attack possibility the API and IPP services can be configured to limit number of requests per second from a given IP address. This can be changed in the service configuration screen:

If number of requests exceeds a given limit the client will receive HTTP error 425.


Was this helpful?

Yes No
You indicated this topic was not helpful to you ...
Could you please leave a comment telling us why? Thank you!
Thanks for your feedback.

Post your comment on this topic.

Post Comment