Configure high availability
High availability configuration requirements
An EZproxy High Availability configuration requires the following components:
- Two or more EZproxy servers that have separate DNS hostnames and IP addresses (e.g. ezp1.yourlib.org at 184.108.40.206 and ezp2.yourlib.org at 220.127.116.11). These are called the peer hostnames.
- A single DNS hostname that is different from the peer hostnames and is setup using multiple DNS Address (A) records so that it resolves to all of the IP addresses of all of the peer servers (e.g. shared.yourlib.org at 18.104.22.168 and 22.214.171.124). This is called the shared hostname.
- The peer hostnames and the shared hostname must all be different up to the first period, then must all be identical from the first period to the end (e.g. ezp1.yourlib.org, ezp2.yourlib.org, and shared.yourlib.org start with the differing ezp1, ezp2, and shared, but all end identically in .yourlib.org).
- All EZproxy servers must be configured to accept their initial connections on the same port.
Configure HAName and HAPeer
The config.txt file for all servers requires a single HAName statement containing just the shared name and an HAPeer statement containing the main http URL for each of the peer servers.
HAName shared.yourlib.org HAPeer http://ezp1.yourlib.org HAPeer http://ezp2.yourlib.org
The file for each server should be identical except for their Name statement and Interface statements (if any).
Tips for configuring the HAPeer directive
- The URL for each HAPeer directive must exactly match the http URL that appears in that server's messages.txt file at startup. For example:
Server http URL http://ezp1.yourlib.org
- The URL for the HAPeer directive cannot be specified using https.
- If a port appears as part of the URL in messages.txt, it must be included in the HAPeer directive as well.
See the IncludeFile directive for information on how to allow the config.txt files to be identical on all peer servers while including their site-specific information from a separate file.
Starting point URLs
Once everything is configured, set up your Starting point URLs to use the shared hostname. Based on the prior example, a starting point URL might look like:
If you are using SSL on these servers, each server must have its own separate SSL certificate. SSL certificates are purchased under the specific server names (e.g. ezp1.yourlib.org and exp2.yourlib.org), not under the shared name.