Must Gather information for CPM: how to collect relevant details for support.

Must Gather information for CPM: how to collect relevant details for support.


When opening a support ticket, please provide the following information.
Info
You can attach the collected files (preferably in a single archive) to the ticket or an email reply (up to 20MB).
For larger files, please ask the support team for FTP instructions

Basic Information

Basic information to be provided:
  1. Description of the issue
  2. A screenshot of an error (if an error is displayed).
  3. Is this a one time occurrence?
  4. If the problem is reproducible - what are the steps to reproduce?
  5.  What is the version of CPM Server and Agents (if applicable) used?

Server Logs

Always no matter what the issue is, please provide the CPM Server logs using the link at the top right of the screen:

    

UI or Download logs not working?

If you are unable to connect to the CPM GUI or download logs, please connect to the CPM Server over SSH (using "cpmuser" and your assigned key) and perform these commands:
  1. sudo su
  2. tar cvzf /tmp/cpm_logs.tar.gz /var/log/cpm
  3. cp /tmp/cpm_logs.tar.gz ~cpmuser
  4. chmod o+r ~cpmuser/cpm_logs.tar.gz
           
If stability/availability of the CPM Server is in question,
please provide the Apache and MySQL logs as well:
  1. sudo su
                              Apache Configuration:
  1. tar cvzf /tmp/apache2_conf.tar.gz /etc/apache2
  2. cp /tmp/apache2_conf.tar.gz ~cpmuser
  3. chmod o+r ~cpmuser/apache2_conf.tar.gz
          Apache Logs:
    1. tar cvzf /tmp/apache2_logs.tar.gz /var/log/apache2
    2. cp /tmp/apache2_logs.tar.gz ~cpmuser
    3. chmod o+r ~cpmuser/apache2_logs.tar.gz
              MySQL Logs:
      1. tar cvzf /tmp/mysql_logs.tar.gz /var/log/mysql
      2. cp /tmp/mysql_logs.tar.gz ~cpmuser
      3. chmod o+r ~cpmuser/mysql_logs.tar.gz

      VSS agent Logs

      If an VSS Agent is involved in the issue, please provide:
      a) Agent logs (located in the "logs" subfolder of the installation directory)
      b) System and Application Event Logs saved as CSV (must be saved using the local Event Viewer on the protected instance, not a remote one).
      c) System Information saved as NFO
      d) Open an elevated administrator command line. Please run the following commands and send us the resulting files.

      1. vssadmin list writers >writers.txt
      2. vssadmin list providers >prod.txt
      3. vssadmin list shadows >shadows.txt
      4. vssadmin list volumes >vol.txt
      5. vssadmin list shadowstorage >shadstorage.txt

       


      ADFS (IDP)

      If the issue is ADFS (IDP) related, please provide in addition to CPM Server logs:
      a) Output of the following PowerShell commands:
          1) Get-AdfsProperties
          2) Get-AdfsEndpoint
          3) Get-AdfsRelyingPartyTrust
          4) Get-AdfsCertificate
          5) Get-AdfsSslCertificate
      b) System, Application and ADFS Event Logs saved as CSV (must be saved using the local Event Viewer on the ADFS server).
      c) System Information saved as NFO

      UI logs

      For some tickets UI browser logs might be needed in order to find the root cause, if asked by support you can use below steps to collect UI log

      Chrome dev tools network logs:
      1. Ctrl+shift+I to open chrome developer tools.
      2. Go to the network tab.
      3. Do step B before doing Step D
      4. Refresh the browser tab (F5)
      5. Reproduce the issue
      6. Export the network logs to a HAR file:


      Worker logs

      Usually AWS S3 workers logs are copied to the N2WS, but in some cases the worker will not be able to copy the logs to the main server, is such case Support might ask to manually collect the logs
      Please see this KB on how to manually collect he logs: How to retrieve logs from a CPM AWS Worker instance

      Thanks for reading this guide,
      N2WS Support Team.

        • Related Articles

        • MustGather information: how to collect logging and relevant details for CPM support (OldUI)

          When opening a support ticket, please provide the following information: 1. Always, no matter what the issue is, please provide the full CPM Server logs using the link at the bottom of the screen If you are unable to connect to the CPM GUI, please ...

        • How to download N2WS logs and upload them to a support ticket

          Summary This article explains how to gather N2WS server logs and upload them to an existing support ticket or to our FTPS server so that our support team can troubleshoot your issue. Steps: On your N2WS console select the "?" at the top right hand ...

        • How to retrieve logs from a CPM AWS Worker instance

          Linux & AWS knowledge is required Please read the entire KB before starting. N2WS uses temporary EC2 worker instances for several operations (copy to S3, FLR, etc), In cases where a worker is failing before it could communicate with the main server, ...

        • Cleanup Log

          This feature was added to allow CPM users to better understand whether Cleanup process ran successfully. It can be found in the “General Settings” tab. The Cleanup Interval may be set to run every 1 to 24 hours. Last cleanup timestamp will show the ...

        • CLI guide and software download for CPM v4.0.0

          CLI v2.0 for CPM v4.0.0 and the user guide are available for download as attachments to this solution Previous version: CLI guide and software download for CPM v3.2.1x Next version: CLI guide and software download for CPM v4.1.0x