Archiving Netvisor ONE Log Files Outside the Switch


Netvisor ONE enables you to periodically  archive the nvOSd log files to an external file server. As a network administrator, you can configure the following parameters to enable archiving of the log files:

  • server IP address and hostname
  • username and password
  • log archival interval (minimum interval is 30 minutes and the default value is 24 hours)
  • add log files to archive


Using the Secure Copy Protocol (SCP), Netvisor ONE archives the log files from the switch to the configured server at  specified intervals. The log files may be helpful during troubleshooting issues. Using the enable or disable parameter in the CLI command, you can start or stop the archival of log files. You can archive regular log files, a set pattern of log files, or a whole directory from one of the following paths. If you add files from other paths than those specified here, Netvisor displays an error.


  • ../var/nvOS/log/*
  • ../nvOS/log/*
  • ../var/log/*


Use the below CLI commands to configure the log archival parameters and schedule the archival interval. To add log files to the archival list, use the command,


CLI (network-admin@switch-1) > log-archival-schedule-files-add log-file log-file-string


log-file log-file-string

Specify a comma-separated list of log file names to add to the archive list.



To remove the log files or a list of log files from the archival list, use the command,


CLI (network-admin@switch-1) > log-archival-schedule-files-remove log-file log-file-string


To view the list of log files that you had scheduled to be archived, use the command,


CLI (network-admin@switch-1) > log-archival-schedule-files-show


To modify the archival schedule parameters for the log files, use the command,


CLI (network-admin@switch-1) > log-archival-schedule-modify


enable|disable

Specify to enable or disable the log archival schedule.

Specify one or many of the following options:


archive-server-username <string>

Specify the SCP username of log archival server.

archive-server <string>

Specify the  IP address or hostname of the log archival server.

archive-server-path <string>

Specify the SCP server path to archive the log files in.

archive-interval <30..4294967295>

Specify the  log archival interval in minutes. The range varies from 30 minutes to 4294967295 minutes with a default value of 1440 minutes (one day).

archive-server-password <string>

Enter the SCP server password.


For  example, if you had modified  the log-archival-schedule by specifying the archive-server-username as pn-user, archive-server as pn-server, and  archive-server-path as /home/pn-server/workspace/log_archival_tests, use the command,


CLI (network-admin@switch-1) > log-archival-schedule-modify archive-server-username pn-user archive-server pn-server archive-server-path /home/pn-server/workspace/log_archival_tests


To display the modified configuration, use the command,


CLI (network-admin@switch-1) > log-archival-schedule-show


switch:                  switch-1

archive-server-username: pn-user

archive-server:          pn-server

archive-server-path:     /home/pn-server/workspace/log_archival_tests

enable:                  no

archive-interval(m):     1440


Guidelines and Tips

 

  • When the log-archival-schedule  is enabled and if all files are removed from the archival  list,  the log-archival-schedule gets disabled.
  • If the systemd timer expires before the  previous log-archival process is finished, then the systemd waits for the process to complete before starting the new process.