Link: Genesys: Memory Dumps

Capture Genesys Pulse Collector memory dumps

This information is useful when you need to:

  • Take a memory dump from a running Genesys Pulse Collector process.
  • Configure an operating system for automatically generating crash dumps when Genesys Pulse Collector crashes.

Take a Memory Dump of the Running Genesys Pulse Collector Process on Linux

  1. Open a Linux terminal.
  2. Confirm the GCore utility is installed from the gdb package by typing gcore in the terminal. If the GCore utility is not available, install it:
    1. Ubuntu: sudo apt-get install gdb
    2. RHEL, CentOS: sudo yum install gdb
  3. Determine the process ID of Genesys Pulse Collector using the following command: ps -ef | grep collector
  4. Change directories to the one to store the dump (for example: cd ~/memory_dumps).
  5. Run commands: gcore <PID> where <PID> is process ID
  6. You should get the file core.<PID>.
  7. If you need to submit this core dump file to Genesys:
    1. Compress it (XZ or BZip2 are strongly recommended, as long as they give better compression ratio):
      1. with XZ: xz -6 core.<PID>
      2. or with BZip2: bzip2 -9 core.<PID>
      3. or with GZip: gzip -9 core.<PID>
    2. Submit the file core.<PID>.xz  (or core.<PID>.bz2  or core.<PID>.gz) to the location specified by the Genesys Customer Care.

Tune a Linux Operating System to Generate a Core Dump for the Genesys Pulse Collector in the Case it has Crashed

  1. As superuser, edit the file /etc/abrt/abrt.conf , set parameter MaxCrashReportsSize to value 0.
  2. As superuser, edit file  /etc/abrt/abrt-action-save-package-data.conf , set parameter ProcessUnpackaged to value yes.
  3. Restart abrtd service: sudo service abrtd restart 
  4. Now Genesys Pulse Collector crash dumps will appear in the folder /var/spool/abrt or other folder, as configured in the /etc/abrt/abrt.conf .
  5. If you need to submit this core dump file to Genesys:
    1. Locate directory with necessary crash data (named like ccpp-YYYY-MM-DD-HH:MM:SS-PID ) in the folder  /var/spool/abrt  (or other directory, as configured in the  /etc/abrt/abrt.conf ). You are interested to provide Genesys with archive of the file called coredump located in that directory.
    2. Compress it (XZ or BZip2 are strongly recommended, as long as they give better compression ratio) – note that you must do that as superuser, because abrtd dump directory is typically not accessible to normal users:
      1. with XZ: sudo xz -c -6 /var/spool/abrt/ ccpp-YYYY-MM-DD-HH:MM:SS-PID/ coredump >coredump.<PID>.xz
      2. or with BZip2:  sudo bzip2 -c -9 /var/spool/abrt/ ccpp-YYYY-MM-DD-HH:MM:SS-PID/ coredump >coredump.<PID>.bz2
      3. or with GZip:  sudo gzip -c -9 /var/spool/abrt/ ccpp-YYYY-MM-DD-HH:MM:SS-PID/ coredump >coredump.<PID>.gz 
    3. Change ownership of the resulting archive file so that you can access it with your regular user: sudo chown your-user-name:your-default-group coredump.<PID>.<Archiever-Specific-Suffix>
    4. Submit resulting file  coredump.<PID>.xz  (or  coredump.<PID>.bz2  or  coredump.<PID>.gz ) to the location specified by the Genesys Technical Support.