Anonymous reporting tool for Liguros Linux
emerge -av Liguros-Report
The reporting tool is intended to run with root privileges for access to key system files. Use the method most appropriate on your system
Just launching the program will show you a help menu:
Liguros anonymous data reporting tool usage: liguros-report -c, --config Specify path to config file -u, --update-config Interactively updates the config file -l, --list-config Lists the current configuration file's settings -j, --show-json Shows the JSON report -s, --send Sends the JSON report -d, --debug Enables additional debug output -v, --verbose Enables non-error output when sending -h, --help Display this help text -V, --version Prints the version and exits Output can be omitted by modifying the config file (default `/etc/liguros-report.conf`):
The --help option shows you the same output:
The --version option shows you the script and module version numbers; ideally they should match:
To see what data the report is generating use the show-json option:
You may get an error that no config file is found:
Warning! Could not open the configuration file at /etc/liguros-report.conf To generate a new configuration file use 'liguros-report --update-config'
You can follow these warning instructions and the program will ask you which sections you want to enable in your config file
You can send your report to the Elasticsearch database using the send option which can return a link to the data if successful in conjunction with --verbose:
'liguros-report --send [--verbose]'
your report can be seen at: https://es.host.liguros.org:9200/liguros-2018.10/report/C5DOC2IB4MpucymM_TFy
You can get HTTP debugging output for the send command with the
'liguros-report --debug --send'
The reporting tool is completely anonymous and the individual categories that are in the report can be turned off or on by editing the config file. The config file is located at /etc/liguros-report.conf by default, and will be autogenerated by the script if one is not present. All lines of the config file that are empty or start with # are ignored. The rest are read but may be ignored if they do not match any expected setting. You can manually change the settings from 'y' to 'n' to disable a particular category. Using the show-json option, you can confirm that this portion of the report is not being output, since the show-json option actually shows exactly what is reported to Elasticsearch.
Here is an example of all possible values in the config file
# To report kernel info including O.S. type, release and version kernel-info:y # Allows the reporter to search your /boot directory and list # any kernels it finds # (limited to kernel names that start with "kernel" or "vmlinuz") boot-dir-info:y # To report versions of key softwares on your system including # portage, ego, python, gcc, and glibc version-info:y # To report the contents of /var/lib/portage/world world-info:y # To report profiles information # the same as epro show-json profile-info:y # To report kit versions as reported by ego # extracted from ego kit show kit-info:y # To report all installed packages installed-pkgs:y # To report hardware info as is typical from lspci hardware-info:y
Options completion for GNU bash is available in
bash$ source share/bash-completion/liguros-report.bash
Options completion for zsh is available in
We are sorry to see you go!
You can uninstall the tool by running:
emerge -C Liguros-Report