Skip to main content
OCLC Support

Server status screen (/status)

The Server Status screen displays details about your EZproxy installation, configuration, current users, and maintenance options. This information can be useful in troubleshooting configuration problems and performing regular maintenance on EZproxy.

Initial information

Version and startup information

The first line of text on the page will look similar to this:

EZproxy 6.1.6 GA [SOURCE:6.0.8] [Windows] [2015-10-30T13:03:00Z] started at 2015-07-17 16:15:23

This information gives you the EZproxy version number currently running on your server, the last time the server was able to validate the license, and the last time EZproxy was started.


The Options line provides additional customization of the Server Status page. Select the option and click Update to enable it.

Option Description
Show "From" hostnames Updates From column of Sessions table with user's hostname instead of IP address.
Include extended information Shows additional processing directives associated with the database stanzas in config.txt, in the Databases table.
Enable Sorting Allows ascending or descending column sorting for the Sessions and Login ports tables.

Quick links

To jump to a section of the page, click the blue hyperlink.


This table shows any currently open EZproxy sessions. The information in your table will vary depending on options configured in config.txt. By default the table will contain the following columns:

Column name Description
Session A unique ID generated for every new session a user begins.
Username The username used to log in and begin a session.
From The IP address from which the user connected. Selecting the Show "From" hostnames option will change the IP address to the user's hostname.
Created The date and time that the session began.
Accessed The date and time the session was last accessed.
Location (optional) If the Location directive is configured, you will see the location associated with the session's IP address.


This table shows all the databases defined in your config.txt file. Configurations are grouped by index number, with an index for each stanza and the related directives for the given resource. New indices are created in config.txt with the addition of a new Title directive statement. Any directive statements that do not correspond to a Title statement will be added to the preceeding database stanza.

Column name Description
Index The number assigned to the database by EZproxy for processing. This is based on the stanza's position in config.txt.
Database This is taken from the Title line of a database stanza.
Hosts The number of unique hosts and domains configured and accessed with a particular database stanza. For example if you have a Database titled Research Database with separate host lines configured for the URLS and, if a user visits both of these URLs, your Databases table will show two Hosts for that Database.
Domains All of the Host, Domain, HJ, and DJ directives configured for a given stanza. If you see statements that are not related to the Database, check your config.txt file and add Title statements to separate the Domains of different resources.
URL The URL given in the URL directive statement of the database stanza. The hyperlinked URL contains the proxy prefix and the target URL, and clicking will take you to the proxied URL.

Login ports

This table provides information about the login ports you have configured for use with EZproxy.

Column name Description
Interface The interface that the given port should listen on for incoming requests.
SSL Y if the port is configured for SSL; N if the port is not configured for SSL.
Port A port number configured with the above settings for use with EZproxy.


This table shows details from the ezproxy.hst file.

Column name Description
SSL      Y if the host is configured for SSL; N if the host is not configured for SSL.
My Port The port number on your server used by EZproxy to access the host.
Database index The database stanza with which the host is associated.
JavaScript Enabled Y if the host follows an HJ or DJ line; N if the host follows an H or D line.
Host The hostname corresponding to the given characteristics and access information.
Created The date and time a user first attempted to access the host.
Accessed The date and time the host was last successfully accessed on the given port.
Counts The number of times the host was successfully accessed on the given port.
Referenced The date and time a user last attempted to access the host (this was not necessarily a successful attempt).
Counts The number of times users attempted to access the host (these are not necessarily successful attempts).

Host maintenance

This section allows you to perform routine maintenance on your EZproxy installation to ensure that it runs correctly and has sufficient hosts available to proxy resources. Host maintenance can be done at any time. Removing hosts does not modify the config.txt file. It only removes a host from the ezproxy.hst file. The next time a user attempts to access a resource, it will be added back to the ezproxy.hst.

Four options may appear depending on your EZproxy usage.

Option Description
No action Does nothing.
Remove # orphaned hosts that have !!! database indexes (requires EZproxy restart) Cleans up the host file by deleting hosts that are no longer in the config.txt file or may have changed hostnames. This will reduce the number of virtual hosts created on your EZproxy server. This may be necessary if you receive a MaxVirtual Hosts error.
Remove # hosts that have not been used in over 30 days (requires EZproxy restart) Cleans up the host file by deleting hosts that no user has attempted to access in the past 30 days. This will free up hosts that are no longer be used by a particular resource so they can be used to proxy other resources. This may be necessary if you receive a MaxVirtual Hosts error.
Reset accessed and referenced dates and counts of all hosts (no restart required) Resets the access and reference date counts to (never) and 0. Doing this on a regular basis can help EZproxy administrators to identify how often certain resources are used during a given period of time. Once this information is reset, it cannot be retrieved on this screen.
Compress port usage by reassigning high ports into any available gaps (no restart required) Reduces the range of port numbers being used to proxy resources by reassigning hosts at high port numbers to ports with lower port numbers. If ports are successfully reassigned, you will receive a confirmation message stating, # ports reassigned, after selecting this option and clicking process.


This section provides additional information about your EZproxy configuration, including limit settings, the peak value your server has experienced, and whether SSL has been enabled.

Limit Description
Peak Sessions active/limit: ###/### Shows the number of sessions active and the maximum number of sessions that can be active at one time. To increase the max active sessions, edit the MaxSessions directive in your config.txt file and increase the number of hosts (500 is the default).
Peak concurrent transfers active/limit: ###/### Shows the peak number of concurrent sessions that has occurred and the maximum number of transfers that can occur at the same time. To increase the max concurrent transfers, edit the MaxConcurrentTransfers directive in your config.txt and increase the number of hosts (200 is the default).
Peak virtual hosts/limit: ###/### Shows the peak number of virtual hosts that have been in use on your EZproxy server and the maximum number of virtual servers that may be in use. To increase the max virtual hosts, edit the MaxVirtualHosts directive in your config.txt file and increase the number of hosts (200 is the default).

Below the limit settings, you will see a message reporting whether SSL has been enabled for your EZproxy installation.


  • Was this article helpful?