Use CLI commands

This article provides information on frequently used CLI commands for the Linux Player.

Command line maintenance tools 

The following command line tools are available:

• boxreset (requires admin password): resets the player; all content files and log files will be deleted. The player needs to be reinitialized.
• troubleshoot: collects all relevant logs and system information and packs it to a single file. The file should be attached to the support request with a detailed failure description. The file is stored on the device storage under /opt/Grassfish/cache/
• startPlayerCheck (requires admin password): starts a tool which frequently logs dynamic data to a file, such as processes and their RAM usage.

Process: gfOverseer

└───PID 963 (14080 kB RSS, 12596 kB SHR, t# 3, fd# 4)

Process: gfPlayer

└───PID 961 (285492 kB RSS, 146060 kB SHR, t# 30, fd# 106)

Process: gfInternetReceiver

└───PID 1325 (49064 kB RSS, 29060 kB SHR, t# 15, fd# 21)

Process: gfUpdater

└───PID 960 (21504 kB RSS, 17048 kB SHR, t# 9, fd# 12)

Process: gfScreenController

└───PID 1330 (24420 kB RSS, 19996 kB SHR, t# 4, fd# 7)

Process: pulseaudio

└───PID 1102 (11308 kB RSS, 8288 kB SHR, t# 4, fd# 31)  

The log file is stored on the device under /opt/grassfish/data/logs/gfHealth/

Log files and Linux tools

The log files for each GF tool are stored on the device under /opt/grassfish/data/logs/ 

To monitor the logs live, use the CLI command tail –f and the path to the log file.

Example

tail –f /opt/grassfish/data/logs/gfPlayer/20171128.log displays the live log of the player in the terminal.

Other useful Linux commands

Change the default audio output from HDMI stereo to analog stereo permanently. To find the output profiles, use the following command: pacmd list-cards | grep output\:

Modify the entry set-card-profile 0 output: in the default.pa file with: sudo nano /etc/pulse/default.pa.

Remote tool: SSH from Windows PC

A very handy tool for SSH is Mobaxterm which can be found at https://mobaxterm.mobatek.net/.

It provides you with a ssh CLI and enables you to browse files such as log files, screenshots etc. on the remote device and download them to your windows PC. Also, you can remotely open the device's file manager and other programs.