Update to EZproxy 6.0 GA for Windows

These instructions cover how to update existing 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, as the license keys from previous versions of EZproxy will not work in EZproxy V6.0. 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 ezproxy -m 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.

  1. Rename your existing copy of ezproxy.exe to another name such as ezproxy- yyyymmdd.exe replacing yyyymmdd with the current year, month and day.

  2. Download ezproxy-windows.exe into your EZproxy directory.

  3. Open a "Command Prompt" window by going to Start | Run..., typing
    cmd
    in the Open: box, then clicking OK.

  4. Change your current directory to the directory where EZproxy is installed with commands such as:
    c:
    cd \ezproxy
  5. Rename ezproxy-windows.exe to ezproxy.exe with the command:
    rename ezproxy-windows.exe ezproxy.exe
  6. 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:
    ezproxy -m
  7. a. If EZproxy is currently running on your server from a command prompt, press CTRL/C to stop it.

    b. If EZproxy is currently running as a service, use the Administrator command prompt, and stop it with the command:
    ezproxy -sr

        You will see messages confirming that EZproxy has been stopped and is no longer installed as a service.

  8. 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:
    rename ezproxy.msg messages.txt
  9. Copy your full WSKey from the OCLC Developer Network WSKeys screen (obtained by following the instructions at How to Request a WSKey), and paste it into your command prompt window with the key command as follows:
    ezproxy -k 123456789101112
    substituting your complete key for 123456789101112.

    Note: In the Windows Command Prompt, the keyboard shortcut Control-V will not paste copied text into the command line. You must right-click to open a list of options and click paste to enter the copied text.

  10. a. If you run EZproxy directly from the command line, start it with the command:
    ezproxy
    b. If you run EZproxy as a service, start it with the command:
    ezproxy -si
        This command will cause EZproxy to automatically start when you reboot your server. See Configure EZproxy to Run as a Windows Service for more information.

This page last revised: March 10, 2015