Configuring Terminal Failover

Terminal failover in YSoft SafeQ 6 can be achieved using Spooler Controller Groups. Once you add two servers into a Spooler Controller Group, you can start using terminal failover. Creating Spooler Controller Groups is described in Configuring Print Roaming.

When you create a Spooler Controller Group, you also need to choose how you want to achieve the terminal failover. YSoft SafeQ 6 supports two options: application-level failover and network-level failover. For network-level failover, you need a 3rd party network failover solution, which is not part of YSoft SafeQ 6 installation. This includes software like Windows NLB, NetScaler, or hardware load balancers like F5 BIG-IP.

Application-level failover

Application-level failover does not require any other 3rd party solutions and terminals are connecting directly to Site Servers, choosing a node from the Group automatically. When one server fails, the terminal will automatically reconnect to another healthy node.

images/download/attachments/160483083/Application-level_failover.png

Application-level failover configuration for each supported terminal:

Automatic configuration of failover servers

The list of IP addresses from which the terminals choose a server to connect to is, by default, the same as the list of IP addresses of the Site Servers in the Group.

Manual configuration of failover servers (optional)

failoverAddresses is applicable for YSoft Terminal Pro 4, Terminal Professional v3.5, and Terminal Ultralight. For Embedded Terminals, it is currently available for Ricoh (Java).

Do not use failoverAddresses in environments where enableEtcd property is set to Enabled. This might lead to misconfigured etcd on some nodes in certain failoverAddresses configurations.

If you need to use only a subset of IP addresses of the Site Servers in the Group, you can add the configuration property "failoverAddresses" into the <appSettings> section in the <SafeQ_dir>\SPOC\terminalserver\TerminalServer.exe.config file. The value should be a comma-separated list of IP addresses. The list shall include the IP address of the server on which it is configured. Then, terminals installed from the server with this configuration will use only the IP addresses listed in the configured value.

Example
<add key="failoverAddresses" value="IP_address_1,IP_address_2" />

Network-level failover

Network-level failover can be used in case YSoft SafeQ 6 does not support application-level failover for the terminal type you need or if you seek advanced features like protection against DDoS attacks.

images/download/attachments/160483083/Network-level_failover.png

Network-level failover is supported on the following terminal types:

  • YSoft SafeQ Embedded Terminal for Brother

  • YSoft SafeQ Embedded Terminal for Epson

  • YSoft SafeQ Embedded Terminal for Fuji Xerox

  • YSoft SafeQ Embedded Terminal for Fuji Xerox XCP

  • YSoft SafeQ Embedded Terminal for HP

  • YSoft SafeQ Embedded Terminal for Konica Minolta

  • YSoft SafeQ Embedded Terminal for Lexmark

  • YSoft SafeQ Embedded Terminal for OKI

  • YSoft SafeQ Embedded Terminal for Ricoh

  • YSoft SafeQ Embedded Terminal for Sharp

  • YSoft SafeQ Embedded Terminal for Sharp-eSF

  • YSoft SafeQ Embedded Terminal for Sharp OSA5

  • YSoft SafeQ Embedded Terminal for Toshiba

  • YSoft SafeQ Embedded Terminal for Xerox

You need to use a third-party HW/SW failover/load balancer or Microsoft Windows Network Load Balancing Cluster (WNLB), see the following guides:

And then enable support for Terminal Failover in YSoft SafeQ 6: