Introduction
The Radix Device Management Platform includes a Live Terminal command for a remote Android device in your fleet. It opens a fully featured, live terminal with an ADB (=Android Debug Bridge) shell connection. The live terminal allows you to remotely debug an issue with a device, run exec scripts remotely, or download a log of commands to the device.
Accessing the Live Terminal
There are three methods of accessing the Live Terminal:
- – Method One: Accessing the Live Terminal from the Device Dashboard
To access the Live Terminal:
1. Click on the Devices icon in the sidebar menu.
2. Click on the row of the device that you wish to access.
3. Click on Terminal in the Device Dashboard of that device.
The Live Terminal opens:
- – Method Two: From the device’s three-dot menu
1. Click on the device’s three-dot menu>Terminal:
- – Method Three: From the Bulk Actions button
1. Click on the device’s checkbox to activate the Bulk Actions button, and go to Bulk Actions>Terminal:
Note: You can only open a terminal for a single device at any one time.
Terminal Commands to View a Log File
Finding Your User ID
1. To see your user ID, use the following Android command:
whoami
Here is an example of running the "whoami" command:
The result is "u0_a86". The “u0” means User ID 0.
Viewing a list of log files currently on the device
1. To see the log files currently on the device, use the following ls command:
ls /data/user/0/com.viso.mdm/files/
2. If the device User ID is something other than “0”, replace “0” with that User ID number.
Here is an example of the execution of the above command:
We see that there are five *.log files currently on the device.
Collecting the log files
To download one of the log files:
1. Enter the following command at the command prompt:
^collectfile:/data/user/0/com.viso.mdm/files/debug_YYYYMMDD.0.log
where you give the date of the log file in the format YYYYMMDD.
2. As an example of the above command, we will download the file "debug_20250617.0.log".
We enter the command:
^collectfile:/data/user/0/com.viso.mdm/files/debug_20250617.0.log.
We are provided with a URL where we can download the log file:
4. When we open the URL in a new tab, we will be able to view the log file: