Media Tools

Introduction

The system provides a number of simple tools to handle and maintain external media devices, SD-cards and USB memory sticks. External media can be used in the system for boot configuration along with logging. For more information on this see:

Overview

The media tools provided are quite limited in the uses that they provide. They aim to provide the possibility to perform the most basic type of operations directly on the device. For more extensive or advanced media operations it is recommended to use a PC.

The following functionality are provided by the system.

  • Formatting media: Currently only possible for externally connected devices. The only supported file-systems that can be formatted at this time are vfat and ext2.

  • Populate media: Used to provide a factory configuration and default external media file structure to the connected media.

  • Sync media: Used to sync configuration files and certificates between external and internal media.

Note: Only one external media is currently supported at a time.

Configuration

Media configuration tools are accessed from the admin execution context in the following manner:

example:/#> media
example:/media/#>

Syntax

format <external> <ext2|vfat>

Format the specified media with the selected file system.

Note: that any files present on the selected media will be removed. Make sure to backup any important files before formatting.

external
Format any external media connected to the device (SD-Card, USB). If both are present, the SD-Card will take precedence.
ext2
Format the target with ext2 file system.
vfat
Format the target with vfat file system.
populate <external>

Populates external media with factory config and directories for certificates.

external
Populate any connected external media.
sync [FROM]<internal|external> [TO]<internal|external>

Sync configuration and certificates between media.

Copies configuration and certificates FROM media if any to TO media. If no FROM media the currently used boot config is chosen.

FROM
The media to sync from, either internal or external.
TO
The media to act as the sync target, either internal or external.

Status Overview

Shows status and information on any connected external media device:

example:/#> show media
MEDIA        NAME         TYPE         SIZE         USED         USE%         
External     usb          ext2         3.7G         6.8M         0%

Examples

Enter the media context:

example:/#> media
example:/media/#>

Format

Format a connected external media with ext2:

example:/media/#> format

Warning: Formating this media will remove any files currently stored on it!
         Backup any data you want to keep before formating the media.

Do you still want to proceed (y/N)?y

Formatting: 100% | [============================================================]

Format successful!

Populate

Populate or newly formatted external media with a default setup:

example:/media/#> populate external

Sync

Sync our current internal configuration to our external media.

example:/media/#> sync internal external
Syncing may remove .cfg and certificate files from destination media.
Are you sure you want to continue (y/N)? y