This "how to" describes how and when it is necessary to restart SPOC or a SPOC group. It is strongly recommended to perform the restart with no load on the SPOC server (no new jobs, no printing/copying/scanning, ...) and running Dispatcher Paragon Management Server.
A SPOC group (near roaming) with only one SPOC server is not a supported configuration. A SPOC group has to have at least two SPOC servers.
When the enableEtcd option is enabled in the Management System Settings, a SPOC group must consist of at least three SPOC servers to ensure ETCD quorum. Alternatively, the group can include two SPOC servers, with a third server running only the extension SWC-155 (ETCD witness server).
To control services, run 'Services' on the Windows server (Start > Run > Services.msc > Enter).
What a SPOC cache is and how to delete it is described in How to Delete the Dispatcher Paragon Spooler Controller Cache.
SPOC Maintenance Scenarios:
When Creating a SPOC Group from Standalone SPOCs
After creating a new SPOC group using Dispatcher Paragon Management Interface, follow the steps below.
If the SPOC servers are newly installed, then:
Follow the steps described in the section How to Safely Restart a SPOC Group without Cache Deletion below ( In this case, it is not necessary to wait as described in step 8).
If SPOC servers are already in production and contain waiting and printed jobs, then:
Follow the steps described in the section How to Safely Restart a SPOC Group with Cache Deletion below.
When Adding a Standalone SPOC to an Existing SPOC Group
After adding standalone SPOC to an existing SPOC group using Dispatcher Paragon Management Interface, follow the steps below.
After adding a standalone SPOC to an existing SPOC group that already has two members:
Follow the steps described in the section How to Safely Restart a SPOC Group with Cache Deletion below, including the newly added SPOC.
After adding a standalone SPOC to an existing SPOC group that already has three or more members:
- Newly added SPOC:
- Stop following services:
Dispatcher Paragon Spooler Controller
Dispatcher Paragon Spooler Controller Group Service
Dispatcher Paragon Terminal Server - Stop all other Konica Minolta services except following:
Dispatcher Paragon Management Service (if present)
Dispatcher Paragon Bundled PostgreSQL <version> (if present) - Delete the folder <install_dir>\SPOC\SpoolCache .
- Stop following services:
- SPOCs that were original members of a SPOC group:
- Follow the steps described in the section How to Safely Restart a SPOC Group without Cache Deletion .
- Newly added SPOC:
- Start the Dispatcher Paragon Spooler Controller service.
- Wait for Dispatcher Paragon Spooler Controller Group Service to start automatically within two minutes.
- Start all the remaining Konica Minolta services configured with a startup type other than Manual.
- Wait until SPOC shows ONLINE status on Management interface or until <install_dir>\SPOC\logs\spoc_lifecycle.log shows last status "ONLINE".
- Wait until distributed layer has converged, meaning that spoc.log contains text "RescueCache| Rescue process for SPOC's cache finished.", this may take approximately 5 minutes.
- Newly added SPOC:
After adding SPOC (any SPOC group size)
- If
When Removing One SPOC from a SPOC Group
After removing SPOC from a SPOC group using Dispatcher Paragon Management Interface, follow these steps:
- SPOCs that remained in a SPOC group:
- Perform steps outlined in section How to safely restart a SPOC group with cache deletion.
- If
- Removed SPOC:
- Stop following services:
Dispatcher Paragon Spooler Controller
Dispatcher Paragon Spooler Controller Group Service
Dispatcher Paragon Terminal Server - Stop all other Konica Minolta services except following:
Dispatcher Paragon Management Service (if present)
Dispatcher Paragon Bundled PostgreSQL <version> (if present) - Start Dispatcher Paragon Spooler Controller service.
- Start all the remaining Konica Minolta services configured with a startup type other than Manual.
- Stop following services:
- SPOCs that remained in a SPOC group:
When Moving a SPOC from a SPOC Group to Another SPOC Group
When it is necessary to move a SPOC from a SPOC group to another SPOC group, do it in two steps.
- First, remove the SPOC from the SPOC group and make it a standalone SPOC (follow section "When Removing One SPOC from a SPOC Group").
Then add the standalone SPOC to the new SPOC group (follow section "When Adding a Standalone SPOC to an Existing SPOC Group").
Optionally, all this can be done in one step, but it requires following How to safely restart a SPOC group with cache deletion section for both SPOC groups.
When Changing the IP Address of Site Server
When the IP address of Site Server (SPOC) is changed as described in the section How to Change the IP Address of Dispatcher Paragon Site Server, then follow the steps described in the section How to safely restart SPOC group with cache deletion on all remaining members of Spooler Controller Group to properly reconnect the node with the changed IP address.
When Restarting the Server with the Installed SPOC
When a server restart is required due to, e.g., Windows updates, Windows failure, or a hardware configuration change, then restart the operating system. Windows shuts down all services, reboots, and then restarts them.
- The SPOC server that is not part of the SPOC group:
- You may restart multiple SPOC servers in parallel
- SPOC servers in a SPOC group (any size of SPOC group):
- Only one member (server) of a SPOC group can be restarted at a time. Once the server restarts and the SPOC is visible online on Management Server (Dispatcher Paragon management interface> Devices > Spooler Controller Groups), wait circa 5-10 minutes. If you wish, you may then proceed with the restart of the next SPOC server in the group.
- If you restarted multiple members of a SPOC group in parallel, follow the section How to safely restart a SPOC group with cache deletion on all members of a SPOC group.
SPOC Restart Procedures:
The following section describes the process for restarting a standalone SPOC and a SPOC group. To choose the right one, please check the use cases above. If you delete the cache during a restart, the cache recovery algorithm executes and the SPOC downloads all its jobs from Dispatcher Paragon Management Server and saves them to its cache and distributed layer if the SPOC is in the SPOC group. If you do not delete the cache during the restart, the cache rescue algorithm executes. The difference between the cache recovery and cache rescue algorithm is that in the cache rescue algorithm, the jobs are not downloaded from Dispatcher Paragon Management Server and stored in the cache and distributed layer again, but only the jobs' "statuses" are updated according to the newest time stamp (the time stamp on the SPOC vs. the time stamp on Dispatcher Paragon Management Server).
How to Safely Restart a SPOC Group with Cache Deletion
- Perform these steps on all SPOC group members:
- Stop following services:
Dispatcher Paragon Spooler Controller
Dispatcher Paragon Spooler Controller Group Service
Dispatcher Paragon Terminal Server - Stop all other Konica Minolta services except following:
Dispatcher Paragon Management Service (if present)
Dispatcher Paragon Bundled PostgreSQL <version> (if present) - Delete the folder <install_dir>\SPOC\SpoolCache .
- Stop following services:
- Perform these steps on one SPOC group member:
- Start the Dispatcher Paragon Spooler Controller service.
- Wait for Dispatcher Paragon Spooler Controller Group Service to start automatically within two minutes.
- Start all the remaining Konica Minolta services configured with a startup type other than Manual.
- Wait until SPOC shows ONLINE status on Management interface or until <install_dir>\SPOC\logs\spoc_lifecycle.log shows last status "ONLINE".
- Wait for the message "End of processing of GetNewJobsByUsersResponseMessage" to appear in the <install_dir>\SPOC\logs\spoc.log. This process may take 5 to 30 minutes, depending on the size of the environment and the volume of print jobs.
Repeat the step 2 on all SPOCs in the SPOC group, always one server at a time.
Previously printed jobs may not be visible in the terminal job list for until spooler job recovery has completed.
How to Safely Restart a SPOC Group without Cache Deletion
- Perform these steps on one SPOC group member:
- Stop following services:
Dispatcher Paragon Spooler Controller
Dispatcher Paragon Spooler Controller Group Service
Dispatcher Paragon Terminal Server - Stop all other Konica Minolta services except following:
Dispatcher Paragon Management Service (if present)
Dispatcher Paragon Bundled PostgreSQL <version> (if present) - Start the Dispatcher Paragon Spooler Controller service.
- Wait for Dispatcher Paragon Spooler Controller Group Service to start automatically within two minutes.
- Start all the remaining Konica Minolta services configured with a startup type other than Manual.
- Wait until SPOC shows ONLINE status on Management interface or until <install_dir>\SPOC\logs\spoc_lifecycle.log shows last status "ONLINE".
- Wait until distributed layer has converged, meaning that spoc.log contains text "RescueCache| Rescue process for SPOC's cache finished.", this may take approximately 5 minutes.
- Stop following services:
- Repeat the step 1 on all SPOCs in the SPOC group, always one server at a time.
Terminal Server procedures
How to ensure etcd cluster is working correctly
If
etcdctl.exe -
-endpoint
http://127.0.0.1:2377 cluster
-health
If the members are not healthy, follow the steps inmember 5f8cbaace2f3bf3b is healthy: got healthy result from http://10.0.5.219:2377
member dce1e734da5d583f is healthy: got healthy result from http://10.0.5.218:2377
member d177d434de7565cb is healthy: got healthy result from http://10.0.5.217:2377
cluster is healthy
etcdctl.exe -
-endpoint
http://127.0.0.1:2377
-u
root:password auth enable
auth: No root user available, please create one
etcdctl.exe -
-endpoint
http://127.0.0.1:2377 cluster
-health