Configuring NE Log Collection
Use this procedure to configure network element log collection.
The PSM server can retrieve NE logs on a collection schedule as well as on demand. To retrieve logs, PSM logs in to the NE or router and transfers the specified log file from the NE or router to the PSM server machine using FTP. PSM then parses and stores the logs into its database and makes the logs available for the user to query. Once the logs are in the database, the retrieved log file is no longer needed and is removed automatically. For information on how to view NE logs, see the proNX Service Manager User Guide.
- Log in to the PSM server machine and open the
/var/local/ems9001/conf/override-common.propertiesfile contains many settings that affect the behavior of the PSM server. Only those attributes explicitly described in this guide should be changed. Changing any other attributes may have unintended consequences and must only be performed under the guidance of Juniper Networks Support.
- Configure log collection parameters.
PSM logs in to the network element or router and transfers the specified log files to the PSM server machine using FTP.
7800for BTI7800 Series network elements and
junosfor supported Juniper Networks routers.
To set the FTP username, set
<username>is the username of the FTP user configured on the PSM server machine. If you leave this blank, the default FTP user is used. The default FTP user is set up as part of PSM server software installation.
To set the FTP password, set
<password>is the FTP password for the specified username. If you leave this blank, the default FTP password is used.
To set the destination file path where the log file is to be transferred, set
<filepath>is the absolute path of the directory where you want to place the log file. If you leave this blank, the log files are placed in
To specify the log file(s) that you want to retrieve, set
<files>is a comma-separated list of log files you want to retrieve. If you leave this blank, the
system.logfile is retrieved for BTI7800 Series network elements and the
messagesfile is retrieved for supported Juniper Networks routers.
To specify the FTP timeout value, set
<timeout>is the number of milliseconds to wait for FTP to complete. If the timeout expires, PSM assumes the FTP has failed.
To specify the (source) directory on supported Juniper Networks routers, set
<directory>is the directory where the log files are stored on the router.
- If you want PSM to collect logs automatically,
set the collection schedule by changing the
For information on how to set this value, see Example: Scheduling Using Quartz CronTrigger Format.
Different network elements might support different strategies for log rotation. Log rotation refers to closing and saving the current log file and creating a new log file for subsequent logs. In order to minimize the risk of PSM missing a log file, ensure that the log rotation frequency on the network element or router aligns with the log collection frequency on PSM.
- Save and close the
- Track changes to the
/var/local/ems9001/conf/override-common.propertiesfile with Git by committing this update to the Git repository.
[user ~]# cd /var/local/ems9001/conf [user conf]# git commit -m "Configured log collection. By email@example.com." override-common.properties
This update can now be seen in the Git log. For more information on Git, see Using Git to Track override-common.properties.
- To activate changes made to the
override-common.propertiesfile, restart the PSM server.
The restart command successfully completes when the 'Ems-' processes all change to 'running' state. Type <ctrl> c to exit the Linux watch command window.