How to collect trace logs and crash dumps from VDI Agent appliance?

0 users found this article helpful

Symptoms

How to collect trace logs and crash dumps from VDI Agent appliance?

Enabling Trace Logging

  1. Download attached LogLevelSwitcher tool on the Windows machine.

  2. Launch the tool and specify the version of Parallels Remote Application Server in the Version field;
  3. Set Module to Linux VDS Agent value;
  4. Set Log Level value to 6. Debug Traces value;
  5. Set Console Log Level value to 6. Debug Traces value;
  6. In the IP Address field specify VDI Appliance IP address;
  7. Specify user: root and its password (password is configured during initial VDI appliance configuration);

  8. Click Set. Once log level is changed, you will see the following pop-up;

  9. In Parallels Remote Application Server Console navigate to Farm > VDI Hosts > right-click the host > Enable logging > hit Apply.

    Note: if logging is already enabled, disable it, hit Apply, enable it and hit Apply again.

Log will be collected here: /var/opt/Parallels/log/VDSAgent.log.

Enabling crash dump collecting

To make appliance to collect crash dumps, the following should be done:

  1. Login to appliance directly or using ssh;

    Note: to login directly you should switch console by pressing ALT+F1.

  2. Execute the following command to enable crash dump collecting:

    ulimit -c unlimited
    
  3. Restart VDSAgent service executing the following command:

    service 2XVDSAgent restart 
    

    Note: to disable crash dump collecting, the following command should be executed:

    ulimit -c 0
    service 2XVDSAgent restart 
    

Next time the crash of 2XVDSAgent occurs, dump will be collected here: /var/opt/Parallels/cwd/core.

Collecting files from Linux Appliance:

To get the logs, dumps and VDI database (/var/opt/Parallels/cwd/VDIAgentDatabase.db) from Linux Appliance download WinSCP tool and do the following:

  1. Extract the files and launch WinSCP.exe.
  2. In the Session pane specify Linux Appliance IP address, username and password and click Login.

Note: we recommend copying the whole "/var/opt/Parallels" folder to ensure that all required files are collected.

Was this article helpful?

Tell us how we can improve it.