Page Comparison

The remote control feature allows administrators to troubleshoot devices that are enrolled with WSO2 IoT Server using the device management console. This feature is used to  You can create a remote session, remotely control, send adb shell commands, view the device logs, and remotely view and interact with the screen of an Android device.

...

...

Follow the steps given below to create a remote session between the device and WSO2 IoT Server:

1. Start WSO2 IoT Server's core profile, which corresponds to the WSO2 Connected Device Management Framework (WSO2 CDMF) profile.
   

   Localtabgroup
   Localtab active true title Linux/Mac/Solaris Code Block ./iot-server.sh Localtab title Windows Code Block iot-server.bat

2. Access the device management console.For access via secured HTTP: https://<IOTS_HTTPS_HOST>:9443/devicemgt/ 
For example: https://localhost:9443/devicemgt/

   For access via HTTP:  http://<IOTS_HTTP_HOST>:9763/devicemgt/ 

   For example: http://localhost:9763/devicemgt/
3. Sign in as an administrator. By default, the username is admin and the password is admin.
4. Click View under DevicesUnder DEVICES, click View.
   
   You are navigated to the page A page appears that lists out all the devices that are enrolled with WSO2 IoT Server because you have administrator privileges. If you do not have administrator privileges, you only the see the devices that you enrolled.
5. Click on the device you want to start the remote sessiontroubleshoot.
6. Click the Remote Session tab.
   
7. Click Connect to Device to start the a remote session with the device. 
   Once After the server connects to the device, you see the following screen given below:
   
8. You can now troubleshoot the device as described in the next sections. To stop the remote sharing session, click Close Session.

Send adb shell commands

Follow Android Debug Bridge (adb) is a command line tool that lets you communicate with an emulator or connected Android device. Follow the steps given below to troubleshoot the device using adb shell commands:

1. Set If you haven't already set up a remote session between your device and WSO2 IoT Server, set it up now.
2. Click Shell.
3. Write the shell command (see adb shell commands for the available commands) and press the Enter key Enter.
   For example, if you want to get the CPU and memory usage of the device, use the top adb command.
   Sample output:
   

...

View device logs

Logcat is a tool that displays messages from the device log in real time and keeps a history so you can view the old messages. Follow the steps given below to view the device logs.

1. Set If you haven't already set up a remote session between your device and WSO2 IoT Server, set it up now.
2. Click Logcat.

You can now see the log for the device. 

View the device screen

...

via the remote session

To troubleshoot a device, it can be helpful to view the device's screen so you can monitor how the device owner is using it and then take actions yourself, such as opening applications and configuring settings. To view the screen, take the following steps: 

1. If you haven't already set up a remote session, set it up now.
2. Click Screen Share > Start.
   
3. A message is sent to the device asking the device owner to share the screen with WSO2 IoT Server. The After the device owner needs to accept accepts this message.
   Once accepted, the administrator is able to , you can view the device's screen , monitor how the device owner users the device, and troubleshoot the deviceand start interacting with it using the mouse.
   
4. Click Stop to stop viewing the screen of the device.

...

View and interact with the device via the remote session

Viewing the screen of the device alone does not help you to solve the issue. You need to be able to carry out actions on the shared screen to successfully troubleshoot the device. Follow the steps given below to try it out:

1. Enable the Android System Service Applications. For more information see, 

   Insert excerpt
   Integrating the Android System Service Application Integrating the Android System Service Application

   .Install or reinstall the configured APK on the device and enroll the device with WSO2 IoT Server. Follow the steps from step 6 onwards

   nopanel true

2. Restart or start WSO2 IoT Server's core profile, which corresponds to the WSO2 Connected Device Management Framework (WSO2 CDMF) profile.
3. Access the device management console.For access via secured HTTP: https://<IOTS_HTTPS_HOST>:9443/devicemgt/ 
   For example: https://localhost:9443/devicemgt/

4. For access via HTTP:  http://<IOTS_HTTP_HOST>:9763/devicemgt/ 

   For example: http://localhost:9763/devicemgt/
5. Sign in as an administrator. By default, the username is admin and the password is admin.
6. Click View under DevicesUnder DEVICES, click View.
   
   You are navigated to a page that lists out all the devices that are enrolled with WSO2 IoT Server because you have administrator privileges. If you do not have administrator privileges, you only the see the devices that you enrolled.
7. Click on the device you want to start a remote session.
8. Click the the Remote Session tab. tab.
9. Click Connect to Device to start a remote session with the device. 
10. Click Screen Share > Start. 
    
11. Click on the applications you want to open or the configurations you want to enable using the mouse.
12. Click Stop to stop viewing the screen of the device.