Login

1. Go to https://<device IP address>:8083/web. On OS versions lower than 4.2 the address has to contain the particular tab, e.g https:// <device IP address> :8083/web/logs/ for logs tab.

2. Login as manager (default login is manager and password oCfpB112g5bZpOcywAp7)
   

   

3. Use web interface to interact with the device. When no activity is done for longer than 30 minutes you will be automatically logout.

Dashboard - System information

This is the default page you will be after successful login. It is accessible by Dashboard option in the left menu.

It contains some useful system metrics such as uptime, system load, cpu, ram and disk usage. For automatic refresh you should change refresh interval from 5 to 60 seconds.

Logout

1. Click in the right top corner near your login name on arrow down symbol. A popup menu will show up.
   

   

2. Click on the Log out option.

Change Password

1. Click in the right top corner near your login name on arrow down symbol. A popup menu will show up.
   

   

2. Click on the Change password option.

3. Fill in fields (your current password with which you have signed in to Current password field and new password twice to the other fields).
   

   

4. Press Save changes button.

Installing application

1. Login to the web interface and go to the Applications page.
   

2. Press Install application button .
   

3. Select an application package (in tar.gz format). The name of the application package is parsed during installation, the part before first dash ("-") is used as a name of an application, whatever is after it until the .tar.gz is used as a version of the application. The application version is optional. If there is no dash in the installation package name, the application will be installed without specified version. For example: application with package name demoapp-1.2.tar.gz will be installed as application with name demoapp and version 1.2.

4. Select whether automatically start installed application after system boot by Auto start switch. Application with active auto start will be started immediately after the installation.
   

   

5. Click Submit button to start application upload and install. You will be informed about upload status by progress bar.

Uninstalling application

1. Login to the management web and go to Applications page.

2. Check applications which you want to uninstall on the left side of applications table (on picture bellow the orange-1.2 app is chosen for uninstall).
   

   

3. Press Uninstall application button in top right corner and confirm uninstallation by clicking on the Uninstall button.
   

   

4. You will be informed about app uninstallation.

Configuring Application

You may see installed and running (status RUNNING) applications after logging in to the web interface and going to Applications page.

It is possible to control installed applications using icons on the right side (see picture above):

• Stop (rectangle icon) running application.

• Start (play button/arrow right) stopped application.

• Restart (circle) running application (shadowed arrows in circle is disabled because application is stopped so it can't be restarted).

Rest of the icons may be used to access more detailed info about each application:

• Edit and details (wrench icon) - see sections Setting autostart and Configuring application parameter below for more info.

• Show logs (stack icon) - display logs filtered for this application, see section Logs below for more info.

Setting application autostart

In the Applications page click wrench icon for a specific application. You will get to Application details page where you may enable autostart (or disable it when it is enabled), start, stop and restart the application.

Configuring application parameters

1. Login to the web interface and go to the Applications page.
   

   

2. Click on wrench picture in row of application you want to configure to get into Application details page.

3. At the bottom of the page see configuration table. Table describes configuration of the application with keys on the left, values in the middle and descriptions on the right.
   

   

4. Configure displayed parameters.

5. Press the Save changes button.

System

Operating system update

1. Login to the web interface and go to the System page. You may see current OS version there.
   
   

2. Press Update operating system button.

3. Select operating system package from your file system (.tar.gz file) and click Submit button.
   

   

4. Operating system will be uploaded, updated and device will automatically reboot. You will be informed about upload process by progress bar.

5. After the restart login to web interface again and check on Dashboard tab actual OS version.

Controlling system services

You may see supported and running (status RUNNING) services after logging in to the web interface and going to System services page.

It is possible to control these services using icons on the right side (see picture above):

• Stop (rectangle icon) running service.

• Start (play button/arrow right) stopped service.

• Restart (circle) running service (shadowed arrows in circle is disabled because service is stopped so it can't be restarted).

• Set autostart (switch in the middle), services with autostart will be started automatically after system boot.

Rest of the icons may be used to access more detailed info about each service:

• Service details (info icon) - see section System service details below for more info.

• Show logs (stack icon) - display logs filtered for this service, see section Logs below for more info.

System service details

When you login to the web, go to System services tab and then click 'info' icon for a specific service you will get to a detail page of the given service where you may enable autostart (or disable it when it is enabled), start, stop and restart the service.

You can see logs of given service by using 'Show logs' button. This action will redirect you to prefilled Logs page.

Viewing and downloading logs

1. Login to the web interface and go to the Logs page.

2. Select whether you want to see logs for all units (default), OS unit, some application unit or custom filter.
   

   

3. Insert dates and times to filter by (from date and time are required).

4. Choose output formatting (JSON or text).

5. For simple viewing press View, for download of logs in the specified format press Download and for viewing with real time addition of new logs press Auto refresh.

6. After logs are displayed you may turn on/off wrapping long lines using Wrap lines switch above displayed logs (default position of this switch is persisted in a cookie in your browser).
   

   

Changing log level

1. Login to the web interface and go to the Configuration page and further to Logs tab.
   

   

2. Select log level from the Log level dropdown menu (all messages with more verbose log level than the selected level will not be saved into log, order of verbosity is ERROR, WARNING, INFO, DEBUG).

3. Press Save changes button.

Enabling logs persistency

By default logs are not persistent - they are not saved on the flash storage and they disappear after device reboot.

Logs persistency could be enabled for predefined time, during this time logs are saved on the flash storage.

1. Login to the web interface and go to the Configuration page and further to Logs tab.
   

   

2. Click on the Log persistency switch to display more settings.
   

   

3. Select period for which will be persistence of logs enabled by selecting from the Persistence logging period drowdown menu.

4. Press Save changes button.

After saving changes or when persistence is already enabled you will see information about how long is persistency running and remaining time until persistency will be automatically turned off:

Networking

1. Login to the web interface and go to the Configuration page and further to Network tab.
   

   

2. In field next to Test connection you may insert an IP address and press Test button to test whether the device can ping the IP address successfully.

3. In the form bellow it you may configure networking (DHCP on/off, static IP address, ...).

4. Press Save changes button after setting all the values.

Time

1. Login to the web interface and go to the Configuration page.

2. Press Time horizontal tab.
   

   

3. Configure timezone and NTP servers (you may use '+' and 'x' buttons to add or remove NTP servers to maximum number of 7 servers).

4. Press Save changes button.

Connection to YSoft Infrastructure Service (IMS)

1. Login to the web interface and go to the Configuration page and further to Infrastructure Server (IMS) tab.
   

   

2. Enter IMS address in format protocol://<IMS address>:port. It is possible to enter more addresses by pressing the '+' button on the right side of Infrastructure servers field and inserting new addresses into new fields which will appear (these fields could be removed by pressing the 'x' button on the right side).

3. Ensure that the Enabled checkbox is on (on the picture above it is on).

4. With filled in fields you may test connection to the filled in servers by pressing blue Test button on the right side of each Infrastructure server field. It will test network connection to that server not specifically connection to IMS.

5. You can specify period in which the device will be sending heartbeats to the IMS, default Synchronization period is 4 seconds.

6. Press the Save changes button.

SD card setup

1. Insert SD card into your device's SD card slot. Correct insertion produces an audible click.
   
   

2. Login to the web interface and go to the Configuration page and further to SD card tab.

   SD card status informs whether card is not inserted , present or mounted. All applications using the card are listed here when the card is mounted.

   

3. Press the Format SD Card button.

   Warning

   Formatting SD Card will erase all of its contents!

   

4. Go to the Dashboard page. You can see the sdcard storage in right bottom section. The size and usage of SD cards are only shown if there is running application that uses the card.
   

   

SNMP

1. Login to the web interface and go to the System services tab.
   

   

2. Proceed to detail of snmpd service (by clicking on info icon).
   

   

3. Configure SNMP parameters.

4. Press Save changes button.

5. Go to System services tab and start/stop snmpd service. Also you may want to enable autostart for the snmpd service to be automatically started after boot.