Changes

Jump to navigation Jump to search
1,229 bytes added ,  04:09, 26 July 2022
Line 1: Line 1: −
{{Languages|Smeserver-bandwidthd}}
+
{{Languages|bandwidthd}}
   −
== Fail2ban for SME Server ==
+
== Bandwidthd for SME Server ==
 
{{Level|Easy|The instructions on this page can be followed by a beginner.}}
 
{{Level|Easy|The instructions on this page can be followed by a beginner.}}
 
+
{{ #smeversion: smeserver-bandwidthd }}
 
=== Maintainer ===
 
=== Maintainer ===
 
[[User:Unnilennium|Jean-Philippe Pialasse]]<br/>
 
[[User:Unnilennium|Jean-Philippe Pialasse]]<br/>
Line 28: Line 28:       −
=== Installation ===
+
===Installation===
 
+
<tabs container><tab name="For SME 10">
{{Warning box | This is still in development and testing phase}}
+
yum install smeserver-bandwidthd --enablerepo=smecontribs
 
+
</tab><tab name="For SME 9.X, 8.X">
  yum install smeserver-bandwidthd --enablerepo=smedev,smecontribs
+
  yum install smeserver-bandwidthd --enablerepo=smecontribs
    
then  
 
then  
Line 41: Line 41:  
  signal-event post-update; signal-event reboot
 
  signal-event post-update; signal-event reboot
   −
===DB command===
+
and wait for your db to start collecting data (at least 3 minutes)
there is no panel yet you can manage the contrib by the db configuration, it is quite simple
+
</tab>
 +
</tabs>
 +
 
 +
===Configuration with db command===
 +
There is no server manager panel, you can easily configure the contrib with a db command (see examples below)
   −
  # config show bandwidthd
+
To display current settings
 +
  config show bandwidthd
 +
Which will show something like
 
  bandwidthd=service
 
  bandwidthd=service
 
     DbName=bandwidthd
 
     DbName=bandwidthd
Line 54: Line 60:       −
Available options are below:
+
Available settings showing the db key property and value are listed below:
 +
 
 +
ie in the first example subnet is a property and disabled is a value, note that a default property & value is not listed in the database entry, but is in effect.
 +
 
    
* 'subnet' : default is "disabled", you can put there a subnet that is not your LAN or WAN or authorized SME network
 
* 'subnet' : default is "disabled", you can put there a subnet that is not your LAN or WAN or authorized SME network
 
* 'device' : default is "any", you can put there an interface you want to monitor. '''You should consider to set one network interface. Any might cause to account twice some traffic for your LAN hosts.'''
 
* 'device' : default is "any", you can put there an interface you want to monitor. '''You should consider to set one network interface. Any might cause to account twice some traffic for your LAN hosts.'''
 
* 'skipInterval' : default is "0", An interval is 2.5 minutes, this is how many intervals to skip before doing a graphing run
 
* 'skipInterval' : default is "0", An interval is 2.5 minutes, this is how many intervals to skip before doing a graphing run
* 'grapCutofff' : default is "1024", Graph cutoff is how many k must be transferred by an ip before we bother to graph it  
+
* 'grapCutoff' : default is "1024", Graph cutoff is how many k must be transferred by an ip before we bother to graph it  
 
* 'promiscuous' : default is "false",  Put interface in promiscuous mode to score to traffic that may not be routing through the host machine.
 
* 'promiscuous' : default is "false",  Put interface in promiscuous mode to score to traffic that may not be routing through the host machine.
 
* 'output_cdf' : default is "false", Log data to cdf file htdocs/log.cdf (NB: 'graph'="true" will override this if at false and consider it at true).
 
* 'output_cdf' : default is "false", Log data to cdf file htdocs/log.cdf (NB: 'graph'="true" will override this if at false and consider it at true).
Line 82: Line 91:       −
After changing one of these settings, you need to apply it:
+
To change a setting use the following db command syntax
 +
db configuration setprop bandwidthd property value
 +
or in the special case only for the configuration db, this can be abbreviated to
 +
config setprop bandwidthd property value
 +
where property and value are obtained from the list of options above.
 +
 
 +
eg to change webaccess
 +
config setprop bandwidthd webaccess public
 +
eg to change login page name
 +
config setprop bandwidthd Name 'My Monitoring Login Page'
 +
 
 +
After changing any setting, you need to apply it:
 
  signal-event conf-bandwidthd
 
  signal-event conf-bandwidthd
    
===Access===
 
===Access===
   −
you can access it throught the server-manager, at the URL https://SERVER/bandwidthd or https://SERVER/"URL"  ( default is php, html if php deactivated), https://SERVER/bandwidthd-static (html version only),https://SERVER/bandwidthd-sql (php version only)
+
you can access it '''through the server-manager''' in the administration panel, and also at the URL https://SERVER/bandwidthd or https://SERVER/"URL"  ( default is php, html if php deactivated), https://SERVER/bandwidthd-static (html version only),https://SERVER/bandwidthd-sql (php version only)
   −
===Advanced Monitoring (experienced users)===
+
===SME9 Advanced Monitoring (experienced users)===
 
Using the sensors you can monitor multiple server or interface. However you need to configure a host for the mysql db to contact if monitoring multiple host or to run multiple instances of bandwithd if you want to monitor multiple interface ( but not all) or want to avoid multiple accounting while using any on local hosts.
 
Using the sensors you can monitor multiple server or interface. However you need to configure a host for the mysql db to contact if monitoring multiple host or to run multiple instances of bandwithd if you want to monitor multiple interface ( but not all) or want to avoid multiple accounting while using any on local hosts.
   Line 97: Line 117:  
then edit /etc/bandwidthd-adsl.conf : change sensor to "adsl" and dev to "ppp0" or your network interface you want to monitor.Adjust what you want, and I suggest you to put off to graph and falt to cdf
 
then edit /etc/bandwidthd-adsl.conf : change sensor to "adsl" and dev to "ppp0" or your network interface you want to monitor.Adjust what you want, and I suggest you to put off to graph and falt to cdf
 
  cp -a /etc/rc.d/init.d/bandwidthd /etc/rc.d/init.d/bandwidthd-adsl
 
  cp -a /etc/rc.d/init.d/bandwidthd /etc/rc.d/init.d/bandwidthd-adsl
  chckconfig --add bandwidthd-adsl
+
  chkconfig --add bandwidthd-adsl
 
  ln -s /etc/rc.d/init.d/bandwidthd-adsl /etc/rc.d/rc7.d/S85bandwidthd-adsl
 
  ln -s /etc/rc.d/init.d/bandwidthd-adsl /etc/rc.d/rc7.d/S85bandwidthd-adsl
 
  vim /etc/rc.d/init.d/bandwidthd-adsl
 
  vim /etc/rc.d/init.d/bandwidthd-adsl
Line 116: Line 136:  
Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla]
 
Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla]
 
and select the smeserver-bandwidthd component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-bandwidthd|title=this link}}.  
 
and select the smeserver-bandwidthd component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-bandwidthd|title=this link}}.  
 +
{{#bugzilla:columns=id,product,version,status,summary |sort=id|order=desc |component=smeserver-bandwidthd|noresultsmessage="No open bugs found."}}
 +
 +
===Changelog===
 +
Only released version in smecontrib are listed here.
 +
 +
{{ #smechangelog: smeserver-bandwidthd}}
 +
    
[[Category: Contrib]]
 
[[Category: Contrib]]
Super Admin, Wiki & Docs Team, Bureaucrats, Interface administrators, Administrators
3,250

edits

Navigation menu