SonarG 4.1

jSonar Support Resources

jSonar Support may ask you to provide logs using the sonarg-collect-info utility. This utility collects all the necessary logs and creates an encrypted tarball that can be loaded to your FTP account on ftp.jsonar.com.

To run the utility, enter the following command in the CLI (requires admin password):

sudo sonarg-collect-info

You can also generate a non-encrypted version of the file (to be encrypted later) by running the following command:

sudo sonarg-collect-info --no-encrypt

After examining it, you can encrypt the file separately by running the following command:

sudo sonarg-encrypt <file>

You can use this last utility (sonarg-encrypt) to encrypt any file to be shared privately with jSonar Support, as it uses a SonarG public key.

Additionally, any report (existing or added through a new pipeline) can be dispatched via email to support by selecting the Session type in the scheduler. The system will produce a CSV with the results, encrypt it and send it to the email you provide.

Elevated Access for jSonar Support

To provide comprehensive support for your SonarG system, jSonar Support may require elevated access to the files, directories, logs, paths, running processes and services described in the sections below.

Configuration Files and Directories

Below is a list of directories and files that need to be editable via /usr/bin/{vimdiff,vi,view}

(** indicates all items contained within the directory, i.e. files and sub-directories)

/etc/cron.daily/sonarfinder
/etc/cron.daily/sonarg
/etc/cron.d/sonar-mapr-gateway
/etc/default/sonardispatcher
/etc/default/sonarendpoint
/etc/default/sonares
/etc/ld.so.conf.d
/etc/ld.so.conf.d/intel_daal.conf
/etc/ld.so.conf.d/intel_mkl.conf
/etc/ld.so.conf.d/intel_tbb.conf
/etc/ld.so.conf.d/sonarw.conf
/etc/logrotate.d/sonardispatcher
/etc/logrotate.d/sonares
/etc/logrotate.d/sonarfinder
/etc/logrotate.d/sonarforwarder
/etc/logrotate.d/sonark
/etc/logrotate.d/sonarwebgateway
/etc/sonar/**
/etc/sysconfig/sonard
/etc/sysconfig/sonarjproxyd
/etc/rsyslog.d/sonargateway.conf
/etc/rsyslog.d/sonar/gateway/**
/opt/bin/sonarfinder-setup
/opt/lib/sonarfinder-upgrade.py
/opt/sonarfinder/sonarFinder/**
/usr/bin/sonar-splunk/config.json
/usr/lib/sonarw/default/**
/usr/lib/sonargd/**
/usr/lib/sonarw/hadr_install_defaults.sh
Binaries

Running processes of the following binaries need to be observable by /bin/{iostat,strace},/sbin/{iotop,lsof}, and /bin/gdb.

(** indicates all items contained within the directory, i.e. files and sub-directories)

/usr/bin/flow-convert
/usr/bin/sonarconfigd
/usr/bin/sonard
/usr/bin/sonarg-auto-complete
/usr/bin/sonarg-azure
/usr/bin/sonarg-collect-info
/usr/bin/sonargdm
/usr/bin/sonarg-encrypt
/usr/bin/sonar-mapr-gateway-sync
/usr/bin/sonarremote.sh
/usr/bin/sonar-splunk/**
/usr/bin/sonarsql
/usr/bin/sonarsql-setup
/usr/share/sonarkibana/bin/**
/usr/bin/sql2pipeline
/usr/bin/tar
/usr/lib/sonar/**
/usr/lib/sonarw/**
/var/lib/sonarw/**
Log Files

Below is a list of log files that need to be viewable via /usr/bin/{vimdiff,vi,view,tail}

(* indicates wildcard; ** indicates all items contained within the directory, i.e. files and sub-directories)

/var/lib/sonarw/log/*
/opt/sonarfinder/sonarFinder/*.log
/opt/sonarfinder/sonarFinder/logs/*
/var/log/sonargd/*log*
/var/log/sonar/*
/var/log/sonarsql/sonarsql.log*
$SONAR_HOME/logs/** ## $SONAR_HOME is a configuration variable for sonarw
Services

Below is a list of services that need to be enabled/disabled/started/restarted/stopped by /bin/systemctl

/usr/lib/systemd/system/gateway-aws@.service
/usr/lib/systemd/system/gateway-azure@.service
/usr/lib/systemd/system/gateway-gcp@.service
/usr/lib/systemd/system/gateway-mongodb@.service
/usr/lib/systemd/system/gateway-splunk@.service
/usr/lib/systemd/system/gdmhandler.service
/usr/lib/systemd/system/gdmhandler.timer
/usr/lib/systemd/system/jproxyforwarder.service
/usr/lib/systemd/system/jproxytimer.timer
/usr/lib/systemd/system/sonaractions.service
/usr/lib/systemd/system/sonarconfigd.service
/usr/lib/systemd/system/sonarconnections.service
/usr/lib/systemd/system/sonardispatcher.service
/usr/lib/systemd/system/sonard.service
/usr/lib/systemd/system/sonarendpoint.service
/usr/lib/systemd/system/sonares.service
/usr/lib/systemd/system/sonarfinder.service
/usr/lib/systemd/system/sonarg-azure-eventhub.service
/usr/lib/systemd/system/sonarg-azure.service
/usr/lib/systemd/system/sonargd.service
/usr/lib/systemd/system/sonarjproxyd.service
/usr/lib/systemd/system/sonarkibana.service
/usr/lib/systemd/system/sonarremotebackup.service
/usr/lib/systemd/system/sonarremotebackup.timer
/usr/lib/systemd/system/sonarremote.service
/usr/lib/systemd/system/sonarremote.timer
/usr/lib/systemd/system/sonar-splunk.service
/usr/lib/systemd/system/sonarsql.service
/usr/lib/systemd/system/sonarwebgateway.service
/usr/lib/systemd/system/sonarwebgateway.timer
/usr/lib/systemd/system/zookeeper.service