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).
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.
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:
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=.
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.