Main menu

i When installed, this shows the device path AB-Solution is installed on. Installs or re-installs AB-Solution.

cu Checks with ab-solution.info for newer script versions and updates to the latest version if so selected.

a Turns Ad-blocking off or on. If the option pixelserv-tls ps is installed, turning ad-blocking to off shuts down pixelserv-tls as well.
When a is off, the weekly blocking file update and the router stats is suspended.

l Turns Dnsmasq logging off or on. When off, router stats rs functions are suspended, as well as the daily log rotation. No ads count is shown in UI header.

rs Router stats can be set to compile weekly (option 1), half an hour before the blocking file updates. A current stats function (option 2) compiles the current stats, counting since last update day.

Option 3 sets the stats count parameters, top 10 for 10 clients is the default.
Option 4 filters local client names if they appear in the stats as hosts or domains.
Option 5 shows the IP address to client name resolution as they appear in the stats. Note that at the time the stats are compiled, the client name may no longer be available to use.
Two files are used to resolve IP addresses to local client names:

  • /etc/hosts.dnsmasq
  • /tmp/var/lib/misc/dnsmasq.leases

Weekly stats and current stats can be saved to file on the router or sent to your email address. Current stats can also be displayed directly in the SSH terminal.
Option 6 opens the email config editor. When sending stats via email for the first time or the new firmware notification fn is enabled, this function will be called automatically to set your credentials.

Note that entering the options shows explanatory text what it does.

When weekly stats is set to on, the selected option where to send the file is shown as well as the day and time the stats are compiled.
The time is tied to the update day and time, set in the b option.

cb can be used to direct blocked domain queries to a specific IP address. This is useful if you use a customized pixelserv-tls installation or use another service to respond to the blocked domains. Note that this option must be set to off if you plan to use the integrated ps option. This menu is hidden when ps is active.

ps installs and manages Entware and pixelserv-tls. When not installed, the menu option offers to install pixelserv-tls.
The install process is a step by step procedure where everything is explained what you need to do to make it work on your router.

When installed, the ps menu changes and allows to manage the installation.
Option 1 turns pixelserv-tls off or on. If turned off, the blocking file as well as the blacklist is converted to the standard blocking IP 0.0.0.0. If set to on the blocking IP is the IP as shown in the menu.
Option 2 turns logging to System Log on or off. This is shown in the menu with [to syslog].
Option 3 lets you set additional pixelserv-tls switches (other than logging).
Option 4 purges all auto-generated pixelserv certificates. Use this if a new version of pixelserv requires it.
Option 5 restarts pixelserv-tls, if you have reason to do so.

Option 6 shows this menu with info's about installed Entware packages and the option to update them.

Note that updating or upgrading Entware packages is for all installed packages, not just the ones AB-Solution installed.

Option 7 resets pixelserv-tls settings. This is helpful if you want to change the pixelserv-tls IP.

The ps menu is hidden when cb is active.

b sets the blocking file type. The blocking file is amalgamated from various hosts files. Six preset types are built in, a seventh type can be used to assemble your own hosts files. Small blocking files block less ads, larger types may block more than is wanted. Use the el option to whitelist or blacklist domains. When setting the blocking file type, the update day and time can be set as well. This also affects when the weekly stats are compiled as the stats function runs 30 minutes before the blocking file is updated. The blocking file updates once a week.
[AdsBeGone!] is the blocking file type, [Thu @ 10.00] shows the day and time the update runs.

 

u updates the blocking file manually. This is useful when the custom blocking file type is selected to test or run it for the first time when set.

el edits the white and blacklist. The whitelist is used to remove domains in the blocking file to let them pass. The blacklist adds domains separately from the blocking file to be blocked. When adding a domain to the list, a check is done whether the domain needs to be added. When removing domains from the whitelist, the domain is added back to the blocking file. Both lists only block the exact domain, wildcard (*) entries are not possible. Domains with and without the www part are treated separately, e.g, www.domain.com and domain.com need to be added separately.

f follwos the dnsmasq log file. When l is on, this allows to see the requests made to dnsmasq. Four options allow to filter what to show in real time.

Option 1 shows the unfiltered log file, all requests are shown.

Option 2 only shows requests for blocked domains in the blocking file and blacklist.

Option 3 filters by an entered term. This can be an IP address or part of a domain name.

Option 4 allows to see requests from a single client IP only, started by entering the domain name to trace. Detailed info is given when entering this option.

To exit when following the log file, enter CTRL-C, this opens a menu with options.

 

ac updates the ads counter manually. The ads count is updated automatically every day at 5:20 a.m. and every time the AB-Solution UI is started.

e exits the AB-Solution UI in a safe way. A full system check is done to make sure AB-Solution is in working order.

 

sm changes from the main menu to the sub menu screen.