How to collect trace logs and crash dumps from VDI Agent appliance?
Enabling Trace Logging
Download attached LogLevelSwitcher tool on the Windows machine.
- Launch the tool and specify the version of Parallels Remote Application Server in the Version field;
- Set Module to Linux VDS Agent value;
- Set Log Level value to 6. Debug Traces value;
- Set Console Log Level value to 6. Debug Traces value;
- In the IP Address field specify VDI Appliance IP address;
Specify user: root and its password (password is configured during initial VDI appliance configuration);
Click Set. Once log level is changed, you will see the following pop-up;
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:
Login to appliance directly or using ssh;
Note: to login directly you should switch console by pressing ALT+F1.
Execute the following command to enable crash dump collecting:
ulimit -c unlimited
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:
- Extract the files and launch WinSCP.exe.
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.