Skip to main content
OCLC Support

Move EZproxy to a new server

The following is a set of general guidelines to follow when moving EZproxy to a new server. There are several variations of ways in which you might move an EZproxy server.

Review the following to develop your own blueprint of how you plan to move your server, and if you have any questions regarding the best sequence to follow for your migration, please contact OCLC support.

When this document refers to "changing the operating system," it refers to a change between Linux and/or Windows, and not to a change to a version level of the same operating system (e.g., Windows 2000 to Windows 2003).

EZproxy license

You can move your license from one server to another at any time, and the move may include upgrading the operating system and/or changing the operating system. During a move, you can use your existing license on the old server and the new server concurrently. To move your license from the old server to the new server, copy the file wskey.key from the old server to the new server.

Contact OCLC Support if you have questions or issues with moving your license.

Moving process

1. Copy the files

All of the files used by EZproxy are normally contained in a single directory that has a few subdirectories. The standard locations for these files are /usr/local/ezproxy for Linux, and C:\ezproxy for Windows.

When moving EZproxy to a new server, you should start by copying most if not all of the files from the existing server to the installation point on the new server. If you are changing operating systems in the move, you do not copy the binary file ezproxy or ezproxy.exe. If you are moving between operating systems, a safe way to move the files is to use an ASCII FTP file transfer.

2. Check config.txt

Once you have copied the files to the new server, you should check config.txt to look for lines that start with:

FirstPort (or just F)
Interface
LoginPort
LoginPortSSL
Name (or just N)
RunAs

Depending on the configuration of your new server, any or all of these statements may need to be altered to meet the needs of your new server. If you are unclear how these statements may need to be altered, contact OCLC support.

3. Reinstall EZproxy

Once you have copied the files to the new server, you should follow the installation steps for the operating system of the new server, even if you did not change platforms. Among other things, the installation instructions contains information on how to make EZproxy start automatically when your server is rebooted.

For more information, see Download EZproxy.

4. Verify file ownership

If you use EZproxy on Linux under a username other than root, you should verify that the ezproxy directory and all files contained within it are owned by the correct user.

5. Establish a temporary name for testing

If possible, have your DNS administrator set up a testing name for the new server. If you are using proxy by hostname, make sure that the wildcard entry is setup as well.

To configure EZproxy to use the temporary name, edit config.txt and look for a line that starts with either Name or just N. You will then either change this existing line, or if none exists, add a new line that looks similar to:

Name testproxy.yourlib.org

6.  CGI authentication

If you are using CGI authentication, you will likely want to disable this during testing. You can disable this by editing user.txt and commenting out the line that contains :cgi=.

7. Testing

You can now start your EZproxy server and test.

Important proxy by hostname detail

If you are changing your server's address in the move and if you are using proxy by hostname, make certain that you change both your main DNS entry (e.g., ezproxy.yourlib.org) and the wildcard DNS entry (e.g., *.ezproxy.yourlib.org). You should run the hostname verification script at Check DNS to verify that both entries have been changed successfully.

Move to production

Once you are ready to move to production, you will need to edit config.txt and set EZproxy to operate under the old server's name, then restart EZproxy.

You may need to have your DNS administrator point your EZproxy server DNS entry to point to the new server's IP address, or you may be shifting the new server to take over the IP address of the old server.