Skip to main content
OCLC Support

MessagesFile

Learn how to use the MessagesFile config.txt directive to specify the name of an alternate file for logging text that is normally stored in the messages.txt file in EZproxy.

MessagesFile is a position-dependent directive that specifies the name of an alternate file for logging the text that is normally stored in the messages.txt file.

Unlike other configuration directives, MessagesFile is not placed in config.txt, but rather must appear as the very first line of the messages.txt file. This unusual placement insures that EZproxy can determine where to record diagnostics immediately upon startup.

OCLC suggests that you rename the messages.txt files to rotate daily so your information is retained in logs named with the date. This will make it easier to identify the location of the information by date.

Qualifiers 

Qualifier Description
filename Name of the file where messages normally intended for messages.txt should be stored.

Syntax

MessagesFile

Examples

Direct EZproxy to record text normally intended for messages.txt to /var/log/ezproxy. This directive must appear as the first line of the existing messages.txt file.

MessagesFile /var/log/ezproxy

Direct EZproxy to record text normally intended for messages.txt to a file of the form messages-yyyy-mm-dd.txt, with a new file created automatically every day. This directive must appear as the first line of the existing messages.txt file.

MessagesFile -strftime messages-%Y-%m-%d.txt

Related directives: 

The following directives interact with or control functions related to this directive:
Directive