Getting Started

Version added 10-Aug-2018| Modified 17-Oct-2018

Perform the following steps to get started with the Beanviser. 

Install Beanviser

No installation is required; simply unpack the downloaded file to a desired location. For download instructions, see Downloading the Beanviser Package.

Launch Beanviser

The following table details to steps to launch the Beanviser on different operating systems:

Operating System To Launch...

Linux

  1. Open a terminal on Linux, and go to the directory that contains the extracted Beanviser package.

  2. Type beanviser.sh and press Enter on the terminal to launch Beanviser.

macOS

  1. Open a terminal on the macOS, and go to the directory that contains the extracted Beanviser package.

  2. Type beanviser.sh and press Enter on the terminal to launch Beanviser.

Windows

On windows, you can use file explorer or command prompt.

 

Using file explorer:

  1. Open a file explorer on Windows, and go to the directory that contains the extracted Beanviser package.

  2. Double-click beanviser.cmd to launch Beanviser.

 

Using command prompt:

  1. Open a command prompt on Windows, and go to the directory that contains the extracted Beanviser package.

  2. Type beanviser.cmd and press Enter on the command prompt to launch Beanviser.

 

Connect to Device

You must first add the target device on Beanviser and then connect to that device as follows:

 

  1. Click the Configuration button (...) to get a list of available devices.

    Beanviser OSE - Configuration Button.png

    As the emulator is a basic device for testing, Beanviser has the emulator in its device list by default. In case you accidentally delete the emulator from the list, follow the steps given below to add the emulator again.
    If you already have the targets added by using IDE or ares-setup-device, Beanviser will show you the added targets automatically. 

     

  2. To add a new device, click the + button and provide the details of the target device:

      webOS Device Emulator
    Name Any name Any name
    Host <IP address of the device> 127.0.0.1
    Port 22 6622
    Username root root

     

  3. To connect to a target device, select it from the device list and click the Connect button.

    Beanviser OSE - Getting Started - Connect Device.png

     

[Troubleshooting] When connecting to a device, if the "dev mode" feature is not enabled on the device, you will get the following error:

Error Installing the perf service ...
luna-send command failed (Unknown method "install" for category "/dev/")

Resolution: Enable the "dev mode" feature as follows:

  1. Connect to device using an SSH client (like Putty).

  2. Enable the "dev mode" feature by calling the setDevMode method using the luna-send command.

  3. Restart the device.

View Performance Metrics

Each feature of the Beanviser is provided as a "feature tab" as indicated by (A) in the below image.

To get the required metrics:

  1. Click one of the feature tabs (A).
    Beanviser OSE - View Performance Metrics - Tabs.png 

  2. Click Start from the operation tabs (B) to start gathering the data. 

  3. You can view the data in two modes (C):

    • Live Monitoring (default): Shows reports for the last one hour that the Beanviser is running.

    • History Data: Shows metrics older than one hour from the current timestamp. In case of log files, it shows logs older than 10000 logs. 

  4. Click Stop to pause or suspend this operation. You can also perform the following operations:

    • Clear - Clears existing visualization charts from the tab. This option is enabled only when measuring is stopped and if there is a chart to be cleared.

    • Save - Saves the measurement data in your computer. To save the data, you must first STOP measuring. The data is saved in the [Beanviser_installation_path]/logs directory. The log file name specifies the timestamp and the log type.

    • Import - Imports a saved log file from your computer and displays the log. This feature is enabled only when Beanviser is not connected to a target (webOS device or emulator).

Except as noted, this content is licensed under Creative Commons Attribution 4.0 and sample code is licensed under Apache License 2.0.