Skip to content

Latest commit

 

History

History
105 lines (63 loc) · 3.37 KB

admin.rst

File metadata and controls

105 lines (63 loc) · 3.37 KB
Raw

Documentation for administrators

Configuring Centralized Crash Collection

In some scenarios, it's not desired to process crashes on affected machines. In this case, ABRT offers upload functionality that can upload problems caught by ABRT to remote machine via different protocols like scp, http or ftp.

Server side

To allow clients to upload problem directories to your server via scp follow these steps:

  1. Install abrt-addon-upload-watch:

    yum install abrt-addon-upload-watch

  2. Create abrt-upload user:

    useradd abrt-upload

  3. Allow abrt-upload user write access to /var/spool/abrt-upload:

    setfacl -m u:abrt-upload:-wx /var/spool/abrt-upload

  4. Set password for abrt-upload user or generate a pair of keys to be used instead of a password. To generate authentication keys run:

    su - abrt-upload # become abrt-upload user
ssh-keygen -f ~/.ssh/id_dsa -N '' # create new keypair with empty passphrase
ln -s ~/.ssh/id_dsa.pub ~/.ssh/authorized_keys # allow loging in with newly created keys

  1. In /etc/abrt/abrt.conf uncomment WatchCrashdumpArchiveDir = /var/spool/abrt-upload option.

  2. Enable abrt-upload-watch.service:

    systemctl start abrt-upload-watch.service
systemctl enable abrt-upload-watch.service

Server is now ready to accept reports from clients.

Client side

On the client this functionality is provided by libreport-plugin-reportuploader package which contains reporter-upload executable.

Complete the following steps on every client system which will use centralized crash reporting:

  1. Install libreport-plugin-reportuploader:

    yum install libreport-plugin-reportuploader

  2. Modify the /etc/libreport/plugins/upload.conf configuration file so that the reporter-upload plugin knows where to copy the saved crash reports in the following way:

    URL = scp://USERNAME:PASSWORD@SERVERNAME/var/spool/abrt-upload/

    If you've chosen to use authentication keys instead of passwords, copy id_dsa file created in previous step to /root/id_dsa. In this case your URL will look like this:

    URL = scp://USERNAME@SERVERNAME/var/spool/abrt-upload/

    If you're using passwords, make sure that /etc/libreport/plugins/upload.conf is only readable by root:

    chmod 600 /etc/libreport/plugins/upload.conf

  3. Allow automatic uploads:

    echo 'EVENT=notify reporter-upload' >> /etc/libreport/events.d/uploader_event.conf

  4. Observe logs on both machines and try to crash something. You can either use will_segfault from will_crash package or just crash the sleep binary with the following commands:

    sleep 100 &
kill SIGSEGV %1

    If everything is configured correctly, problem directory should be transfered to server machine and the server should process it.

Troubleshooting

If uploading doesn't work make sure it's possible to upload problem directories manually by running:

reporter-upload -vvv -d /var/spool/abrt/<PROBDIR>

Spacewalk

Spacewalk is able to collect and report crash statistic from clients using abrt. More information and configuration can be found on spacewalk wiki.