RELEASE NOTES

  • Release: 004
  • Tag: 004
  • Date: May 28, 2018
  • Summary: Feature and bugfix update for pvr

Get started

Simply (g)unzip and put pvr into a directory in PATH and off you go.

Download PVR

Known Issues:

  • None

Build PVR

See the README.md in top of pvr source project for more info...

Register Account

To get started register with pantahub:

$ pvr register --user="yournick" --pass="yourpass" --email="your@email.tld" https://api.pantahub.com/auth
2017/06/19 11:08:43 Registration Response: {
  "id": "5947949b85188a000c143c2e",
  "type": "USER",
  "email": "your@email.tld",
  "nick": "youruser",
  "prn": "prn:::accounts:/5947949b85188a000c143c2e",
  "password": "yourpassword",
  "time-created": "2017-06-19T09:08:43.767224118Z",
  "time-modified": "2017-06-19T09:08:43.767224118Z"
}

User 'youruser' registered. Follow email instructions sent to 'your@email.tld' before you can log in.

Clone an example repo:

In this example we clone our example rpi3 alpine based system. You can use username: examples and password: examples to retrieve this:

pvr clone https://api.pantahub.com/trails/59f1b5c67612b8000fbf9e81 rpi3-alpine-mini

$ ls
0base.cpio.xz  alpine-mini.json  alpine-mini.squashfs  firmware.squashfs  kernel.img  lxc-alpine.config  modules.squashfs  pantavisor.json

Scan for pantavisor devices on local network

Since 004 release pvr scan supports finding devices that announce themselves on mdns for easy discovery and claiming.

$ pvr scan
Scanning ...
        ID: 5b0cf52979b74d0009a7175e (unclaimed)
        Host: linux.local.
        IPv4: [192.168.178.97]
        IPv6: [2a02:2028:708:3d01:602:a2ff:feb3:d4e8]
        Port: 22
        Claim Cmd: pvr claim -c brightly-immense-bat https://api.pantahub.com:443/devices/5b0cf52979b74d0009a7175e

        ID: 5b0aa4363c6f7200095b2566 (owned)
        Host: linux.local.
        IPv4: [192.168.178.97]
        IPv6: [2a02:2028:733:ee01:602:a2ff:feb3:d4e8]
        Port: 22
        Pantahub WWW: https://www.pantahub.com/u/_/devices/5b0aa4363c6f7200095b2566
        PVR Clone: https://api.pantahub.com:443/trails/5b0aa4363c6f7200095b2566

Claiming: How to become owner of a device discovered through pvr scan

For an unclaimed device you simply would copy paste the "Claim Cmd:" in the output above to make that device owned by you:

$ pvr claim -c brightly-immense-bat https://api.pantahub.com:443/devices/5b0cf52979b74d0009a7175e
# no output expected means: success

Devices you are owner from will initially sync their state with your account storage etc. and once done will show up on your device list in pantahub and you will have permissions to roll updates, change configuration or delete it.

Claiming: devices that do not have mdns support might have telnet support enabled

  1. Flash your Pantavisor device (see PV release)
  2. Boot up, telnet into your device and tail -f /tmp/pantavisor.log -> there you will see both device id as well as challenge getting logged
  3. Claim device with pvr: ``` $ pvr claim -c YOURCHALLENGECHALLENGE https://api.pantahub.com/devices/YOURDEVICEID *** Login (/type [R] to register) @ https://api.pantahub.com/auth (realm=pantahub services) *** Username: ...

# Deploy a the "example repo" from above to your device:

$ cd myrepo $ pvr post https://api.pantahub.com/trails/YOURDEVICECID ...


Enjoy!