Troubleshooting

Support package

Subscription customers can generate a support package by executing the command grommunio-support and send the created support package to grommunio’s support for analysis to support@grommunio.com.

The archive generated is made available under the web root of grommunio admin archive, which is why it is stongly recommended to remove the generated support archive as soon as it has been transmitted to grommunioi support. The support archive can be removed by accessing the console and executing the command rm -f /usr/share/grommunio-admin-web/grommunio-support.txz.

The information collected by grommunio-support contains:

  • Crash relevant information (Coredumps)

  • Disk layout (incl. LVM layout and SMART and Software-RAID)

  • Configuration dump (incl. /etc and more specific information e.g. from webserver)

  • High-availability information

  • Memory-related information

  • Network configuration

  • Process-relevant information

  • Sysconfig information

Important

The support package might contain sensitive information. If this is a concern to you, it is recommended to prune specific private data from the generated archive bedore sending it to grommunio support. Support data is used only for diagnostic purposesi and is considered confidential information.

Note

The support is solely available on the appliances provided by grommunio. On SUSE-based distributions it can also be made available by repository installation via the “grommunio-setup” package, which has a dependency on the package “supportutils”.

Installation logs

The setup wizard of the grommunio Appliance saves its log to /var/log/grommunio-setup.log. If, for example, the wizard fails the certificate generation, the reasons should be visible in that file.

System logs

The grommunio Appliance inherits system logging settings from systemd. Refer to the systemd-journald(8) manpage for details. To display logs, use the journalctl(8) command from a root login shell prompt:

journalctl -u gromox-http -n 1000
journalctl -f

Useful options that can independently be combined are:

  • -f for follow mode

  • -n to show that many of the most recent lines

  • -u to limit the display to one particular service unit

Some logs are emitted to files rather than journald. These include:

URI Prefix

Process

Files

/dav

nginx

/var/log/nginx/grommunio-web-access.log, /var/log/nginx/grommunio-web-error.log

/dav

php-fpm

/var/log/grommunio-dav/grommunio-dav-php.log

/Microsoft-Server-ActiveSync

nginx

/var/log/nginx/grommunio-web-access.log, /var/log/nginx/grommunio-web-error.log

/Microsoft-Server-ActiveSync

php-fpm

/var/log/grommunio-sync/grommunio-sync-fpm.log

/web

nginx

/var/log/nginx/grommunio-web-access.log, /var/log/nginx/grommunio-web-error.log

/web

php-fpm

/var/log/gromox

Coredumps

The grommunio Appliance inherits the coredump defaults from systemd. The sysctl variable for the core pattern is set to:

kernel.core_pattern = |/usr/lib/systemd/systemd-coredump %P %u %g %s %t %c %e

systemd-coredump stores dumps in /var/lib/systemd/coredump. Refer to the systemd-coredump(8) and coredump.conf(5) manpages for details. Dumps are normally LZ4-compressed and need to be decompressed before they can be used with gdb; for this, you will need to install the lz4 program (zypper in lz4).