How to Restart a YSoft SafeQ Environment
It is recommended to test Windows Updates on a Development system before any updates are applied to Production systems. Consult your organization's policy on Windows server updates.
Server Type | Action Performed | Temporary User Impact During Restart | Next Step |
External MS SQL Database Server (if used) | Restart the external Microsoft SQL Server. | YSoft SafeQ Management Service will be unavailable as the database is inaccessible. | Restart YSoft SafeQ Management Servers |
YSoft SafeQ Management Server | Restart the Windows server. See "Management Server Restart Guidelines" | Restarting all Management Servers:
Restarting one Management Server at a time:
| Restart YSoft SafeQ Site Servers |
YSoft SafeQ Site Server | Restart the Windows server. See "Site Server Restart Guidelines" | Devices installed to a specific Site Server:
Devices installed to a load balancer:
| Test authentication, print, and scan functionality at devices. |
Management Server Restart Guidelines
If one Management Server is installed:
Restart the Management Server.
If multiple Management Servers are installed:
Restart one Management Server at a time.
In environments with 1000+ devices wait 30 minutes before restarting the next Management Server.
Wait until the Management Server dashboard is accessible before restarting the next Management Server.
Site Server Restart Guidelines
If the Site Server is not part of a Spooler Controller group:
Multiple Site Servers can be restarted.
If the Site Servers are in a Spooler Controller group (any size):
Only one member (server) of a Spooler Controller group can be restarted at a time. Once the server restarts and the Spooler Controller is visible online on Management Server (YSoft SafeQ management interface> Devices > Spooler Controller Groups), wait circa 5-10 minutes. If you wish, you may then proceed with the restart of the next Spooler Controller in the group.
If you restarted multiple members of a SPOC group in parallel, follow the section How to safely restart a Spooler Controller group with cache deletion on all members of a Spooler Controller group.
How to Safely Restart a Spooler Controller Group with Cache Deletion
Stop the YSoft SafeQ Spooler Controller service and YSoft SafeQ Spooler Controller Group Service service.
Stop the YSoft SafeQ Terminal Server service.
Stop all other YSoft services except those:
YSoft SafeQ Management Service service (if present)
YSoft Bundled PostgreSQL 9.4 service (if present)
YSoft Bundled Etcd service (if present)
Repeat previous steps 1-3 on all Site Servers in the Spooler Controller group.
Delete the cache folder <install_dir\SPOC\SpoolCache on all Site Servers in the group.
Start the YSoft SafeQ Spooler Controller service and verify that the YSoft SafeQ Spooler Controller Group Service service starts automatically within 1-2 minutes.
Start the YSoft SafeQ Terminal Server service.
Wait until the YSoft SafeQ Spooler Controller service starts and is online. Check that <install_dir\SPOC\logs\spoc_lifecycle.log last status is "ONLINE".
Start all the other YSoft services stopped in step 3.
Repeat the previous steps 6-9 on all Site Servers in the Spooler Controller group. Depending on the count of not-deleted jobs, wait 3-10 minutes between the start of each Site Server services.
Previously printed jobs may not be visible in the terminal job list for 15 to 30 minutes until spooler job recovery has completed.