These instructions cover how to update existing Linux installations to EZproxy 6.0. These instructions are valid to update from any version of EZproxy to this release. This process will preserve all existing configuration files.
Before getting started
EZproxy 6.0 requires users to obtain a WSKey to run the software. Before downloading EZproxy, please request your WSKey. To request and obtain a Key, please see How to Request a WSKey.
If you are updating from a version of EZproxy 5.0 or earlier, please be aware that the ezproxy.cfg, ezproxy.msg, and ezproxy.usr files have been renamed to config.txt, messages.txt, and user.txt in EZproxy 5.1 or later. When you perform the
step, you will be asked to allow EZproxy to rename ezproxy.cfg and ezproxy.usr to their new names. For more information on this change, including information on how to continue to use the historic names if necessary, see EZproxy 5.1 New Filenames.
- Change your current directory to the directory where EZproxy is installed with a command such as:
- Download ezproxy-linux.bin into the directory where EZproxy is installed. If you download this file on different system and use FTP to move it to your EZproxy server, be sure to perform this transfer using binary.
- Use the following command to stop the old version of EZproxy:
- Rename your existing copy of the program file ezproxy to another name such as ezproxy. yyyymmdd replacing yyyymmdd with the current year, month and day using a command such as:
mv ezproxy ezproxy.yyyymmdd
- Rename the program and make it executable with the commands:
mv ezproxy-linux.bin ezproxy
chmod 755 ezproxy
- During this step, if you are updating from EZproxy 5.0 or earlier, you will be asked to allow ezproxy.cfg to be renamed to config.txt and to allow ezproxy.usr to be renamed to user.txt. See EZproxy 5.1 New Filenames for more information.
Create any new files required for the updated release with the command:
If you receive any errors during this step, please contact OCLC support.
- This step is optional. If you are updating from a EZproxy 5.0 or earlier, you can choose to rename your existing ezproxy.msg to messages.txt, or you can leave the existing file alone and EZproxy will create a new messages.txt file.
If you would like to rename the existing file, issue the command:
mv ezproxy.msg messages.txt
- Enter your WSKey (obtained by following the instructions at How to Request a WSKey), using the command:
substituting your WSKey for 123456789101112
./ezproxy -k 123456789101112
- Start EZproxy with the command: