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
Server
This is the server for which will do the operations to add/remove multiple services
Available
This column contains all the services that are not yet installed on the selected server
Selected
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.
Name
The friendly name of the service as it appears in the SAFEQ Cloud system tree
Type
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.
Enabled
Control the running status of the Service
Location
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).
Server
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.
Post your comment on this topic.