The three main LISTSERV Maestro components all write their own log files. These files can be found in the logs subfolder of each component’s home folder inside of the Application Server installation folder. In some situations, the Maestro administrator may not have access to these folders, but still needs to access the log files. To solve this, LISTSERV Maestro offers remote log file access. The remote access allows the Maestro administrator to download the log files from the server through a web browser.

Replace PASSWORD with a password known only to authorized administrators. For security reasons, do not use the normal admin password from the Administration Hub. Because this password will later be used as a parameter in a URL, use only URL-safe characters in the password (alphanumeric characters).

Remember; add this entry to each component’s INI file; to lui.ini, hub.ini and tracker.ini. For information on how to edit INI files, see Section 20 Editing LISTSERV Maestro INI Files. If the entry is not added to one of the INI files, then it will not be possible to access the log files of that component, but it will still be possible to access logs of the other components where the entry has been added. To disable remote log access, simply remove the entry from the INI file(s) or comment it out. Whenever this entry is changed, the change will be effective immediately – The component will not have to restart.

To download a Maestro User Interface log file, access the following URL:http://HOST:PORT/lui/downloadLog?pw=PASSWORD&day=DATE

•

To download an Administration Hub log file, access the following URL:http://HOST:PORT/hub/downloadLog?pw=PASSWORD&day=DATE

•

To download a Maestro Tracker log file, access the following URL:http://HOST:PORT/trk/downloadLog?pw=PASSWORD&day=DATE

Replace HOST with the host name of the server running the component to be accessed, PORT with the HTTP port on that server (:PORT can be left out if the HTTP-port is 80), PASSWORD with the password configured in the INI file, and DATE with the date of the day of the log file to download. The date is formatted as YYYYMMDD, where YYYY is the year with 4 digits, MM is the month with 2 digits and DD is the day of the month with 2 digits.

Notes: The keywords are not case sensitive, meaning that you could also type True,Yearly or TRUE,MONTHLY.

If any other value than true is specified, then the change log is deactivated. Therefore, you can temporarily deactivate the change log either by commenting out the ChangeLog line, or by changing the value true to something else, for example:

ip_address– Appears only if the new member was added because of an active join by an actual user; in which case, the user’s IP-address is logged. If the new member was added by the LISTSERV Maestro data admin, then no IP-address is logged.

ip_address– Appears only if the member was deleted because of an active un-register by the actual user; in which case, the user’s IP-address is logged. If the member was deleted by the LISTSERV Maestro data admin, then no IP-address is logged.

ip_address – Appears only if the member’s address was changed because of an active change by the actual user; in which case, the user’s IP-address is logged. If the member’s address was changed by the LISTSERV Maestro data admin, then no IP-address is logged.

ip_address – Appears only if the new subscriber was added because of an active subscribe by an actual user; in which case, the user’s IP-address is logged. If the new subscriber was added by the LISTSERV Maestro data admin, then no IP-address is logged.

ip_address– Appears only if the subscriber was deleted because of an active unsubscribe by the actual user, in which case the user’s IP-address is logged. If the member was deleted by the LISTSERV Maestro data admin, then no IP-address is logged.

Notes: If the list is a hosted LISTSERV list and the user unsubscribed from the list by sending an “unsubscribe” email to LISTSERV, then the address “0.0.0.0” is logged, since the real IP-address of the user it not known in this context.