Recovery mode

From SpinetiX Support Wiki

Jump to: navigation, search
"Info"
Recovery mode is a low-level functionality state which is automatically triggered in case of corrupted file-system or hardware problems.
Recovery mode is also referred to as Diagnostic mode or accessing the Recovery Console.

Introduction

The player may boot into Recovery mode by itself in case it encounters a serious problem (for instance a corrupted file-system or a hardware problem) or due to the network watchdog (when using a USB cellular modem).

SpinetiX Support might ask you to manually boot the player into Recovery mode for flashing the player firmware in order to solve certain issues. If it's not the case, then before contacting SpinetiX Support, please follow the steps detailed under "What to do when the HMP is in Recovery mode" section.

While in Recovery mode, the player displays the text "Recovery System" on the screen (with or without the SpinetiX splash-screen) instead of the user content, and the (SYS) LED blinks very fast as following:


Note Notes:
  • Recovery mode and Safe mode are two different operating modes of the player, even though in both cases, the user content is not rendered. However the LED activity and what is displayed on the screen are different. Also the reason why the player is entering into this mode is different than with the Safe mode (where is related to the content).
  • After one hour of inactivity while in Recovery mode, the player will automatically try to reboot into normal operating mode.

What to do when the player is in Recovery mode

Before contacting the SpinetiX Support, please follow these steps:

  1. If a USB cellular modem is used, ensure that the 3G/4G connection is active.
  2. Unplug the power supply cable of the player for at least 10 minutes.
  3. Power on the player and wait (few minutes) for it to boot.
  4. If the player enters again into Recovery mode, access the Recovery console.
    • Note that the Recovery Console cannot be accessed via the 3G connection, therefore you need to use the Ethernet connection instead.
  5. Take screen captures out of the "Main" and "Diagnostics" pages.
  6. On the Diagnostics page, generate and download a system report under the "Main system" section.
    • If that is not available, then generate a recovery report (which can be found at the beginning of the page).
  7. Send the screen captures and the report together with your inquiry (this will speed up the diagnostic process).

How to boot the player into Recovery mode

Note Note:
Write down the IP address of the player before manually booting it into Recovery mode.

DiVA, HMP350, and HMP300

If you can reach Control Center:

  1. Open the Operations > Maintenance page.
  2. Click the “Start Recovery Mode” button.

Otherwise, use the player's blue button to force a reboot into Recovery mode:

  1. Unplug the power supply cable.
  2. Press and hold the blue button.
  3. Plug in the power supply cable.
  4. Release the blue button after around 20 seconds when the SYS LED starts rapidly flashing red.

HMP200, HMP130, and HMP100

If you can reach Control Center:

  1. Open the "Maintenance" page under Administration menu.
  2. Select the Advanced tab.
  3. Click the “Restart Now” button under the “Diagnostic Mode Restart” section.

Otherwise, use the HMP blue button to reboot into Recovery mode - settings differ between devices.

Network access in Recovery mode

While in Recovery mode, the HMP / DiVA players are using the same IP address as in normal mode (except for some HMP100 devices as detailed below), therefore the Recovery Console can be accessed using the normal addresses.

For HMP players:

http://spx-hmp-{serial_number_of_the_hmp}.local./
http://{IP_of_the_HMP}/
http://[fe80::21d:50ff:feXX:XXXX]/  (where XXXXXX are the last six digits of the serial number of your unit)

For DIVA players:

http://diva-{serial_number_of_the_hmp}.local./
http://{IP_of_DiVA}/
http://[fe80::21d:50ff:feXX:XXXX]/  (where XXXXXX are the last six digits of the serial number of your unit)


Note Notes:
  • While in Recovery mode, the player uses the same admin password, as in normal mode; if that was forgotten, then you must perform a reset to factory default settings using the player blue button to restore the default credentials (admin / admin).
  • If the player is configured to use a static IP address, it keeps that while in Recovery mode as well, thus accessing the Recovery Console though the first two methods above might be problematic. In such cases, you can simply do a reset to factory default settings using the player blue button to clear that static IP address. Or use the IPv6 address.

HMP100 exception

The HMP100 devices with serial number starting with 001d50001000 can be accessed in the same manner as above!

The HMP100 devices with serial number below 001d50001000 (e.g., from 001d5000001 to 001d5000fff) can only be accessed using the IPv4 address (http://[IP_of_the_HMP]/), where the IP could be as following:

  • If you have manually configured a static IP address, then the HMP is using that IP address.
  • If the HMP was configured to use DHCP (which is the default configuration), then the IP address of the HMP100 is the first available IP address from the following list: 192.168.1.11, 192.168.1.12, ..., 192.168.1.29.
    • To access the recovery console of the HMP100 in this case, you need to change your PC network configuration to be in the same range as the HMP (i.e. set your computer IP to 192.168.1.10 and the gateway to 255.255.0.0).

Recovery Console

The Recovery Console contains three pages, Main, Diagnostics, and Reboot, which are accessible using the three buttons on top of each page.

Main page

Main page

This page has the following sections:

  • Install new firmware
    Shows information about the factory-installed firmware present on the device and allows flushing the player firmware - either with a firmware image package file uploaded by the user (the latest one is recommended) or with the factory-installed firmware image .
  • Previous install
    Shows whether a firmware install has been performed since last reboot of the player.
  • Reboot
  • System Data
    Lists a brief description of the HMP system data (e.g., serial number, MAC address, IP address, internal storage size etc.)

Diagnostics page

Diagnostics page

This page has the following sections: (note that some of these sections might not appear under some conditions)

  • Recovery report
    From here you can get the recovery report - a basic report, useful in case the System report (see below) is not available.
  • System date and time
    Allows setting the date & time of the unit.
  • Temperature
    Lists the internal temperature of the player. This does not apply for HMP130 and HMP100 devices.
  • Flash memory contents
    Lists the verification results of the kernel image on the flash memory;
  • Internal storage
    Lists the verification results of the internal storage partitions;
  • Main system:
    • Kernel
      Lists the verification results of the kernel image in the root filesystem;
    • System / Base firmware
      Lists the system firmware installed on the HMP;
    • System report
      From here you can get the system report - in case this section is not available, get the Recovery report instead (see above).
    • System configuration
      Allows running configuration commands on the player.
  • Reboot

Recovery report

The "Recovery report" (previously called "Safe report") is a report that provides the basic information about the file system of your device.

To generate this report, press (one time) the "Get recovery report" button and wait for it to be generated by the player. When the report is ready, you will be prompted to save a file called safereport-[HMP serial number].tar.gz.

System report

The "System Report" has more information than the Recovery report and therefore it's better to generate this one. However, depending on the type of problem the player is having, this report might not be available all the time.

To generate this report, scroll down to the "System report" (under "Main system" section), then press (one time) the "Get system report" button and wait for it to be generated by the player. When the report is ready, you will be prompted to save a file called spxreport-[player serial number].tar.gz.

Configuration changes

Note
This section does not apply for firmware versions lower than 2.2.1.
  1. Boot the player into Recovery mode.
  2. Open the Recovery console in a browser.
  3. Open the Diagnostics page.
  4. Go to the "System configuration" / "Change configuration" / "Add configuration change" section
    • The name of the section is different depending on the hardware revision of your player.
  5. Type configuration_command into the text box.
  6. Click the "Set change" button.
  7. Reboot the player into normal mode from the Main page to apply the configuration change(s).


Note Notes:
  • On older hardware revisions only one configuration change can be entered per reboot. The applicable section is named "Change configuration" in this case.
  • One newer hardware revisions multiple configuration changes can be entered before rebooting (they will be executed in the order listed). The applicable section is named "Add configuration change" in this case.

Configuration commands

The following commands can be used (at step 5 above):

  • format = format the content partition.
    • Formatting the content partition without installing new firmware can be useful if you are certain that the firmware itself is not corrupted.
    • While booting in normal mode the content partition will be reformatted.
  • reset = reset to factory defaults
  • dhcp = configure the network for DHCP
  • static=<parameters> = configure the network for static IP address (where <parameters> is in the format ipaddr;mask;brd;[[gw];dns1;dns2;dns3]).
    • the 'brd' field is always ignored and can be left blank.
    • Example: static=192.168.1.10;255.255.255.0;;10.5.25.4;10.5.27.8

Reboot page

This page allows rebooting the HMP into normal mode (default) or into recovery mode (if "Force recovery mode" checkbox is enabled).

The content of this page is also included at the bottom of the other two pages.

Install the firmware in Recovery mode

The process of installing the player firmware from the Recovery Console works as follow:

  1. The internal storage is formatted, so the existing firmware files (including the configuration settings) and the user content are completely removed.
  2. The selected firmware version is installed from scratch.

Installing the player firmware is necessary in case of firmware corruption, but can also be used when wanting to downgrade the firmware or when the firmware update would take too long.

  • A firmware corruption can occur when the update process is interrupted or when there is a physical corruption of the internal storage, in which case the player is going to enter into Recovery mode by itself.
  • For the other cases, see how to manually boot the HMP into Recovery mode.


Note Note: Before reinstalling the player firmware, you might want to generate a configuration backup and make sure you have a copy of the content.

Reverting to factory default firmware

The factory default firmware is permanently stored on the player, regardless of the current installed firmware. If needed, the player can be reverted to the factory default firmware, by following these steps:

  1. Boot the HMP into Recovery mode.
  2. On the "Main" page, under "Install new firmware" section, check if the factory installed system firmware is present.
  3. If so, click on the "Install Factory Image" button.


Note Notes:
  • The device is restored to the same state as when it left the factory - this could mean that the firmware is not the latest one, therefore you might need to update to / install the latest one afterwards.
  • In case the factory firmware got corrupted, then use the installation procedure based on PKG files, as detailed below.
  • To restore the factory default settings without reinstalling firmware, see the Reset to factory default settings page.
  • This functionality is not available on the HMP100 with serial number below 001d500000d7.

Installing a specific firmware

You can install a specific firmware version (the latest one recommended) using the corresponding PKG file that can be downloaded from SpinetiX server.

Procedure

To install a specific firmware version, follow these steps:

  1. Download the relevant PKG file (e.g., fw-spinetix-hmp350-***.pkg, prod-fs-spinetix.hmp200-***.pkg etc.) onto your PC.
  2. Boot the HMP into Recovery mode.
  3. On the first page of the Recovery Console ("Main" page), click on the "Browse" button (next to the "Firmware image package:" field).
    • The "Browse" button might be translated into your language by the browser.
  4. Select the PKG file that you have downloaded from SpinetiX site from your PC.
  5. Click on the "Upload and install this image" button.
  6. Wait for the installation process to complete.
  7. (Optional) If you need to set a static IP or to avoid loosing the one previously set, follow the procedure below.
  8. Reboot the player into normal operating mode.

Avoid resetting the static IP

If you need the player to use a specific IP address after a firmware installation from the Recovery Console, follow the procedure below:

  1. Do not reboot at the end of the installation process.
  2. Open the "Diagnostics" page.
  3. Go to the "System configuration" / "Change configuration" / "Add configuration change" section.
    • The name of the section is different depending on the hardware revision of your player.
  4. Set the IP configuration and click on the "Set change" button.
  5. Reboot the device.

Error messages concerning firmware

  • "tar: gzip: Cannot write: Broken pipe"
    The PKG file is corrupted. Download the file again after clearing your browser's cache.
  • "Could not recover firmware image package file"
    If you receive this error when trying to update from a PKG file, attempt to install the factory default firmware.
    If you receive this error when installing the factory firmware, then contact SpinetiX Support.
This page was last modified on 17 August 2017, at 13:07.