Skip to page content

Worldwide (English) Change

Update to EZproxy 5.0c GA [Athens] for Windows

These instructions cover how to update existing installations to new versions of EZproxy. These instructions are valid to update from any version of EZproxy to this release. This process will preserve all existing configuration files.

  1. Before you can update to an Athens-enabled version of EZproxy for Windows, you must have installed the Athens Windows Agent. If the Athens Windows Agent is not already installed, refer to Installing the Athens Windows Agent for information on how to download and install the Agent.
  2. Rename your existing copy of ezproxy.exe to another name such as ezproxy-yyyymmdd.exe replacing yyyymmdd with the current year, month and day.
  3. Download ezproxy-athens-win32.exe into your EZproxy directory.
  4. Open a "Command Prompt" window by going to Start | Run..., typing
    cmd
    in the Open: box, then clicking OK.
  5. Change your current directory to the directory where EZproxy is installed with commands such as:
    c:
    cd \ezproxy
  6. Rename ezproxy-athens-win32.exe to ezproxy.exe with the command:
    rename ezproxy-athens-win32.exe ezproxy.exe
  7. Create any new files required for the updated release with the command:
    ezproxy -m

    If you receive an error similar to "This application has failed to start because athens_agent.dll was not found," you may have skipped the first step of these instructions describing how to install the Athens Windows Agent. If you did skip this step, perform it at this time and then retry the "ezproxy -m" command.

  8. If EZproxy is currently running on your server from a command prompt, press CTRL/C to stop it.

    If EZproxy is currently running as a service, stop it with the command:

    net stop ezproxy
  9. If you run EZproxy directly from the command line, start it with the command:
    ezproxy

    If you run EZproxy as a service, start it with the command:

    net start ezproxy

EZproxy can automatically restart when you reboot your server. See Configure EZproxy to Run as a Windows Service for more information.