This section describes how to recover/renew one CML cluster node (not the 1st installed node).

If the slave node is not operational for a longer period of time, you can use the procedure from CML - Printer settings in case of one CML node failure to sustain the printing functionality.

Step 1 - restore hardware after the server failure (optional)

Restore hardware required for YSoft SafeQ server.

WARNING: Make sure that the server has the same IP address as it had before the failure.

WARNING: In case time period between node failure and node restoration exceeds number of days specified by remove-jobs-from-sq system property, then prefix value in cluster_server.ip_address column for node being restored with deleted_ prefix. Example: IP address before failure was: 10.20.30.40, then before starting restoration procedure IP address should be changed to: deleted_10.20.30.40

Step 2 - restore software after the server failure

1

Install one of the supported operating systems for YSoft SafeQ server

2

Install one of the supported databases (or select the embedded database during installation of YSoft SafeQ in the next step)

Database type MUST be the same as before the failure.

Step 3 - install CML slave node

1	Run ysf-sq5-install.exe to start the YSoft SafeQ Setup Wizard. Select I want to customize my SafeQ installation.
2	Enter the master node (1st node) IP address and click the Retrieve node list button.
3	Select the node you want to restore and continue by clicking the Next> button. In case time period between node failure and node restoration is longer than number of days specified by remove-jobs-from-sq system property, then select Add new node instead of Replace node, otherwise select Replace node.
4	Select the same database type as on the Master node and continue with the installation process.
5	Enter original Local GUID of failed node. The original GUID can be taken from any ORS server connected to the CML cluster (<SafeQORS_DIR>\conf\modules\ors.conf => parameter serverGUIDx where x is the number of failed CML node you are currently restoring). In case you do not have any ORS installed kindly insert random GUID (e.g. ckeuvnmxcviw) Also set HTTP and HTTPS port for SafeQ web interface and press Install button.
6	This step is required for External PG–SQL / MS SQL database At specific point the installation is paused and pop-up window is displayed. Follow the on-screen instructions to proceed further. Database Backup article describes one of the ways how the backup can be made. Restore database article describes how to restore the database.
7	Wait for installation to finish.
8	In case you were using any specific configuration (such as clustering via MSCS or WNLB with one shared IP address; different port HTTPS; non-default certificates), kindly follow the part of documentation that describes your custom settings and set them up again.
9	Restore folder with scanning scripts (if scan to script functionality is used)

Step 4 - recovery scenario for node on environment with ETCD

If master node is on environment with etcd, continue with this scenario Recovery scenario on environment with ETCD

Step 5 - verification of the functionality

1

Verification of services:
Open Services (e.g. Start => Run => services.msc) and start (unless already running) the following services in any order:

YSoft SafeQ CML
YSoft SafeQ CML DBS
YSoft SafeQ Terminal Server
YSoft SafeQ LDAP Replicator Service
YSoft SafeQ Web Interface

All services must start without any errors. The first start of the services may take several minutes.

images/download/attachments/21955754/services.jpg

2

Log in to the web interface (YSoft SafeQ Web interface => System => System information) of the master node.

Verify that all servers are showing status ONLINE (the node you are connected to may show status LOCAL)
Verify that synchronization between the nodes in the cluster is functional. See table DBsync database & system pools (non-local servers only). Values in column Database pool priority must not be growing constantly. They shall be changing and they shall be often around 0.

images/download/attachments/21955754/dbpoolip.jpg

3

Test authentication/print/copy/scan. All functions must be working. Also accounting must return the correct data.