RocketLogger Software Update

The instructions below do not apply when updating from RocketLogger version 1.x! Follow the upgrade instructions when updating from RocketLogger version 1.x to the latest version.

For updating to versions up to and including 1.1.6, see Software Installation (Version 1.x).

Occasionally, an update of the RocketLogger software is required for important bugfixes and to benefit from new features. There are two alternative procedures to install the latest software version:

• The recommended way is to deploy a fresh RocketLogger system. After flashing the latest system image, reinsert the data SD card and logging can continue with the calibration and measurement configuration preserved.
• If running a modified RocketLogger system and preserving its configuration is desired, follow the instructions on how to update the software on-device.

It is recommended to backup all relevant calibration and configuration files and all measurement data stored on the device prior to performing an update.

Update with RocketLogger System Flasher Image

Warning: This installation procedure will erase all on-device data! This includes:

• Operating system and all related configuration changes, including SSH and login configurations,
• When not using the recommended Data SD card, all RocketLogger configuration and measurement data.

If preserving the system configuration is desired or when not using the recommended SD card for RocketLogger data follow the instructions for an on-device software update.

This is the recommended system update procedure when running an unmodified RocketLogger that was set up using a RocketLogger system flasher image.

1. Power down the RocketLogger and remove the data SD card containing the RocketLogger configuration and measurement data.
2. Using a separate SD card (not the data SD card just removed from the logger!) follow the system installation instruction to flash the latest software version to the RocketLogger.
3. Instead of setting up a new data SD card, reinsert the data SD card removed in step 1. Now, logging can continue with the same configuration used before the RocketLogger software update.
4. Review the considerations of a new RocketLogger installation under finalize system installation.

On-Device Software Rebuild and Update

Consider updating using a RocketLogger system flasher image when satisfying the prerequisites, or preserving the system configuration is not required.

This procedure is recommend for installations with modified system configuration, such as SSH login reconfiguration or when not using a SD card for RocketLogger data.

The on-device update procedure consists of cloning the RocketLogger repository, building and installing the RocketLogger software, and deploying the updated RocketLogger web interface.

Clone the RocketLogger Repository

1. Log into the RocketLogger device to update via SSH, see also SSH configuration.
2. Clone the RocketLogger repository using: git clone https://github.com/ETHZ-TEC/RocketLogger.git

Build and Install the RocketLogger Software

For more details on building and installing the RocketLogger software refer to the README.md in the software/rocketlogger folder.

3. Change to the software/rocketlogger subfolder within the repository.
4. Build the software using the following command sequence:
   • meson setup --buildtype=release release - set up the release build configuration in release directory
   • meson compile -C release - build all required software components and configuration
5. Install the software with elevated privileges by issuing sudo meson install -C release

Deploy the RocketLogger Web Interface

For more details on installing the RocketLogger web interface refer to the README.md within the software/node_server folder.

6. Change to the software/node_server subfolder within the repository.
7. Deploy the updated web interface by running the install.sh script. During the installation process the script will ask for the user password to gain elevated permissions for installing system package dependencies.

Finalize On-Device Software Update

8. To apply system configuration related changes and conclude the software update reboot the RocketLogger.
   • Optionally, the cloned RockerLogger repository can be removed again.
9. Review the considerations of a new RocketLogger installation under finalize system installation.