Admin-bwm: Difference between revisions

From Tomato64
(Created page with "<span id="bandwidth-monitoring"></span> = Bandwidth Monitoring = The Bandwidth Monitoring menu contains settings for Bandwidth Monitoring features. This menu contains sections including Bandwidth Monitoring, Backup (of monitoring statistics in rstats format) and Restore. <span id="bandwidth-monitoring-1"></span> == Bandwidth Monitoring == [https://wiki.freshtomato.org/lib/exe/detail.php?id=bandwidth_monitoring&media=cfd1bdbc52340668d45a53409a426089.png File:/cfd1bdb...")
 
m (Text replacement - "FreshTomato" to "Tomato64")
Line 26: Line 26:
** JFFS partitions are managed in the ''Administration''/'''[[jffs|JFFS]]''' menu.  
** JFFS partitions are managed in the ''Administration''/'''[[jffs|JFFS]]''' menu.  
** Storage space available depends on your router hardware and the build installed.
** Storage space available depends on your router hardware and the build installed.
** FreshTomato and any JFFS2 partitions share storage space on the same chip.  
** Tomato64 and any JFFS2 partitions share storage space on the same chip.  
** The larger the build, the less space left for JFFS2 partitions.  
** The larger the build, the less space left for JFFS2 partitions.  
** The upgrade process rewrites the whole flash chip, so data on JFFS is destroyed.
** The upgrade process rewrites the whole flash chip, so data on JFFS is destroyed.
** To avoid this, FreshTomato stops you from upgrading firmware until JFFS is disabled.
** To avoid this, Tomato64 stops you from upgrading firmware until JFFS is disabled.
** You must back up the data on JFFS storage before a firmware upgrade.
** You must back up the data on JFFS storage before a firmware upgrade.


* CIFS1 - This makes FreshTomato write bandwidth logs to the first external CIFS network share.  
* CIFS1 - This makes Tomato64 write bandwidth logs to the first external CIFS network share.  
** CIFS Client connections to CIFS shares are configured in the '''[[admin-cifs|CIFS Client]]''' menu.
** CIFS Client connections to CIFS shares are configured in the '''[[admin-cifs|CIFS Client]]''' menu.


<pre>  *
<pre>  *
* CIFS2 - This will let FreshTomato write bandwidth statistics to the second external CIFS share.
* CIFS2 - This will let Tomato64 write bandwidth statistics to the second external CIFS share.
   * CIFS network shares are configured in the //Administration///**[[:admin-cifs|CIFS Client]]** menu.
   * CIFS network shares are configured in the //Administration///**[[:admin-cifs|CIFS Client]]** menu.
</pre>
</pre>
Line 46: Line 46:
'''Save Frequency:''' This specifies how often Bandwidth Monitoring saves logs. (Default: TBD). The more often data is saved, the less likely it will be lost due to adverse events like power outages or crashes.
'''Save Frequency:''' This specifies how often Bandwidth Monitoring saves logs. (Default: TBD). The more often data is saved, the less likely it will be lost due to adverse events like power outages or crashes.


'''Save on Shutdown:''' Checking this makes FreshTomato save bandwidth logs immediately if it receives a shutdown signal. This prevents data loss.
'''Save on Shutdown:''' Checking this makes Tomato64 save bandwidth logs immediately if it receives a shutdown signal. This prevents data loss.


'''Create New File:''' Checking this erases your current log file and creates a new one. This is useful when you switch storage media/locations (such as moving from RAM to CIFS). FreshTomato must create a new file in order for logs to be saved properly.
'''Create New File:''' Checking this erases your current log file and creates a new one. This is useful when you switch storage media/locations (such as moving from RAM to CIFS). Tomato64 must create a new file in order for logs to be saved properly.


'''Create Backups:''' Enabling this makes FreshTomato create backup logs. The backups are put in the same folder as the original files, and given a .bak file ending. (Default: Disabled).
'''Create Backups:''' Enabling this makes Tomato64 create backup logs. The backups are put in the same folder as the original files, and given a .bak file ending. (Default: Disabled).


'''First Day of the Month:''' This value sets the first day of the month for bandwidth logs. For example, if you enter 3, FreshTomato makes the third day of each month the first day it records bandwidth monitoring. (Default: 1). This is useful with certain ISPs which log/bill for bandwidth starting on a day other than the first of the month.
'''First Day of the Month:''' This value sets the first day of the month for bandwidth logs. For example, if you enter 3, Tomato64 makes the third day of each month the first day it records bandwidth monitoring. (Default: 1). This is useful with certain ISPs which log/bill for bandwidth starting on a day other than the first of the month.


'''Excluded Interfaces:''' Here, you specify the device name of any interfaces whose bandwidth you don't want to be monitored/logged. If you list more than one, the names must be separated by commas.
'''Excluded Interfaces:''' Here, you specify the device name of any interfaces whose bandwidth you don't want to be monitored/logged. If you list more than one, the names must be separated by commas.
Line 62: Line 62:


<br />
<br />
Here you can back up the bandwidth monitoring log file, naming it whatever you choose. FreshTomato creates a default filename, but clicking the cursor in the field lets you edit the log's filename. After you click Save, the new file name will take effect.
Here you can back up the bandwidth monitoring log file, naming it whatever you choose. Tomato64 creates a default filename, but clicking the cursor in the field lets you edit the log's filename. After you click Save, the new file name will take effect.


Backup files are are saved in the GNU .gz (gzip) format. This is an archive format, similar to .zip. It can be easily opened by programs in Windows, Linux, and MacOS.
Backup files are are saved in the GNU .gz (gzip) format. This is an archive format, similar to .zip. It can be easily opened by programs in Windows, Linux, and MacOS.
Line 80: Line 80:


<br />
<br />
The ''Browse…'' button lets you find existing Bandwidth Monitoring logs to restore to the location selected in the ''Save History Location'' menu. FreshTomato will expect to find a GNU .gz (gzip) archive file.
The ''Browse…'' button lets you find existing Bandwidth Monitoring logs to restore to the location selected in the ''Save History Location'' menu. Tomato64 will expect to find a GNU .gz (gzip) archive file.


If you Restore an existing Bandwidth Monitoring log to the same location it was originally stored, FreshTomato will continue to log bandwidth statistics to the same file, continuing where it left off.
If you Restore an existing Bandwidth Monitoring log to the same location it was originally stored, Tomato64 will continue to log bandwidth statistics to the same file, continuing where it left off.

Revision as of 17:43, 26 September 2023

Bandwidth Monitoring

The Bandwidth Monitoring menu contains settings for Bandwidth Monitoring features. This menu contains sections including Bandwidth Monitoring, Backup (of monitoring statistics in rstats format) and Restore.

Bandwidth Monitoring

cfd1bdbc52340668d45a53409a426089.png


Enable: Checking this turns on the Bandwidth Monitoring feature. (Default: Enabled).

Save History Location: From this menu, you choose where Bandwidth Monitoring history files are saved.

The options include:

  • RAM (Temporary) - This will save Bandwidth Monitoring history files to the router's RAM.
    • Since this is temporary storage, contents will disappear after a reboot or crash.
  • NVRAM - This will save Bandwidth Monitoring history to NVRAM.
    • NVRAM is permanent storage, but is often tiny on routers.
  • JFFS2 - This will save monitoring files to a portion of flash RAM formatted with JFS.
    • JFFS is a journalling, log-structured file system.
    • JFFS partitions are managed in the Administration/JFFS menu.
    • Storage space available depends on your router hardware and the build installed.
    • Tomato64 and any JFFS2 partitions share storage space on the same chip.
    • The larger the build, the less space left for JFFS2 partitions.
    • The upgrade process rewrites the whole flash chip, so data on JFFS is destroyed.
    • To avoid this, Tomato64 stops you from upgrading firmware until JFFS is disabled.
    • You must back up the data on JFFS storage before a firmware upgrade.
  • CIFS1 - This makes Tomato64 write bandwidth logs to the first external CIFS network share.
    • CIFS Client connections to CIFS shares are configured in the CIFS Client menu.
  *
* CIFS2 - This will let Tomato64 write bandwidth statistics to the second external CIFS share.
  * CIFS network shares are configured in the //Administration///**[[:admin-cifs|CIFS Client]]** menu.
  • Custom Path - This allows you to create a custom directory within the JFFS2 storage space.
    • This is useful when using JFFS2 for other storage tasks, so you can organize the storage into folders.

(Default: RAM).

Save Frequency: This specifies how often Bandwidth Monitoring saves logs. (Default: TBD). The more often data is saved, the less likely it will be lost due to adverse events like power outages or crashes.

Save on Shutdown: Checking this makes Tomato64 save bandwidth logs immediately if it receives a shutdown signal. This prevents data loss.

Create New File: Checking this erases your current log file and creates a new one. This is useful when you switch storage media/locations (such as moving from RAM to CIFS). Tomato64 must create a new file in order for logs to be saved properly.

Create Backups: Enabling this makes Tomato64 create backup logs. The backups are put in the same folder as the original files, and given a .bak file ending. (Default: Disabled).

First Day of the Month: This value sets the first day of the month for bandwidth logs. For example, if you enter 3, Tomato64 makes the third day of each month the first day it records bandwidth monitoring. (Default: 1). This is useful with certain ISPs which log/bill for bandwidth starting on a day other than the first of the month.

Excluded Interfaces: Here, you specify the device name of any interfaces whose bandwidth you don't want to be monitored/logged. If you list more than one, the names must be separated by commas.

Backup

1d93577512187e108da502690758ed50.png


Here you can back up the bandwidth monitoring log file, naming it whatever you choose. Tomato64 creates a default filename, but clicking the cursor in the field lets you edit the log's filename. After you click Save, the new file name will take effect.

Backup files are are saved in the GNU .gz (gzip) format. This is an archive format, similar to .zip. It can be easily opened by programs in Windows, Linux, and MacOS.

Backup: Clicking on the Backup button will download the log file to your browser. The browser will open a window prompting you to Open or Save the file. Generally, you click Save, and the browser prompts you to browse to the location to save the backup log.

Hovering your mouse over the blue "link" will make your browser display the full path of the backup file location in the browser's status area. It will also prompt you for where to store the existing Bandwidth Monitor backup file.




Restore

058a13734928e6c9e5f9903d262c2d71.png


The Browse… button lets you find existing Bandwidth Monitoring logs to restore to the location selected in the Save History Location menu. Tomato64 will expect to find a GNU .gz (gzip) archive file.

If you Restore an existing Bandwidth Monitoring log to the same location it was originally stored, Tomato64 will continue to log bandwidth statistics to the same file, continuing where it left off.