|
Section 1 Section 2 Section 3 Section 4 Section 5 Section 6 Section 7 Section 8 Section 9 Section 10 Section 11 Section 12 Section 13 Section 14 Section 15 Section 16 Section 17 Section 18 Appendix A |
LISTSERVฎ Maestro has three levels of logging. In the Administrator User Interface, it is possible to choose the level of logging for each component. Click the radio button adjacent to the level of logging desired.
LISTSERV Maestro log files are located in two places. Log files having to do with specific LISTSERV Maestro components are kept in a directory configured like the example below: x:\Program Files\L-Soft\Application Server\XXX\log "x: is the drive where LISTSERV Maestro is installed and XXX is the component, either HUB, LUI, or TRK. Log files for third party components like Tomcat are kept in a directory configured like the example below: x:\Program Files\L-Soft\Application Server\logs "x: is the drive where Maestro is installed. The three main LISTSERV Maestro components all write their own log files. These files can be found in the logs subfolder of each components home folder inside of the Application Server installation folder. In some situations the 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 an administrator to download the log files from the server, directly in the Web browser. Before accessing the log files of a component, configure the component for remote log access first. To do so, edit the INI file of the component and add the following entry: RemoteAdminPassword=PASSWORD Replace PASSWORD with a password only known 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 components INI file; to lui.ini, hub.ini, and tracker.ini. For more information on editing INI files, see Section 14. 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. Once the component(s) have been configured for remote log access, access their log files from any Web browser on any computer that has HTTP access to the particular component. The only requirements for access are the "PASSWORD" configured in the INI file(s) and the day of the log file to access. 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. The current version and build number of all components can be queried remotely. This is done with a simple HTTP-request - a URL typed into the address field of any browser. The result of the query will be displayed in the browser.
|