Mender RedPesk

Mender is an OTA system used to update a large number of devices. This documentation presents how to install and manage the client side on RedPesk OS, here the full documentation of mender client https://docs.mender.io/client-installation/overview.

Note: the examples are set for the community factory

Note: the factory part of mender/OTA can be found here: /docs/en/master/redpesk-factory/models-boards-management/01-overview-models-boards.html

redpesk-config of your factory on target

To communicate with the mender server of your factory, be sure the right redpesk-config rpm is installed on your target, if not you can find it there:

https://YOURSTACK/download/redpesk/redpesk-config/packages

For the community stack:

https://community-app.redpesk.bzh/download/redpesk/redpesk-config/packages

Install redpesk-config on target

# on target

# check redpesk-config rpm
rpm -qa redpesk-config

# install the right one
FACTORY_URL=https://community-app.redpesk.bzh
dnf install $FACTORY_URL/download/redpesk/redpesk-config/packages/redpesk-config-1.2.0-5.community.noarch.rpm

Install mender-redpesk

The mender-redpesk package contains the mender device identity, some inventory files, and a script mender-init.sh to help configure mender client.

Note: mender-connect is optionnal, it creates a websocket for bidirectionnal information with the mender server, especially indicating if the target is connected.

# on target (mender-connect is optionnal)
dnf install mender-redpesk mender-connect

Configure mender-client with mender-init.sh

Use mender-init.sh to configure your mender-client, especially for setting device type and private key. Indeed, for mender the identity of device is defined with the pair of an mac address and the device type, and the authentification is set with the key.

help of mender-init.sh

/usr/bin/mender-init.sh --help

help of /usr/bin/mender-init.sh

Syntax: mender-init.sh [OPTION]... -d DEVICETYPE -k PRIVATEKEY
options:
-h,--help          print this help
-f,--force         force mode (override files if exist)
-d,--device-type   mender device type
-k,--key           mender private key
-p,--path-key      mender private key file path
-nr,--norestart    do not restart mender-client mender-connect services
-ne,--noenable     do not enable mender-client mender-connect services

example

mender-init.sh --force -d mydevice_type -k "-----BEGIN RSA PRIVATE KEY-----
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
-----END RSA PRIVATE KEY-----"

journal

journalctl -u mender-client -f

Your target is now ready to download mender deployments.