summaryrefslogtreecommitdiff
path: root/ssh-rsync.write.help
blob: d03508c000fb842db008a38e349242c006e6632a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
help: |

    Upgrade a Baserock system which is already deployed:
    - as a KVM/LibVirt, OpenStack or vbox-ssh  virtual machine;
    - on a Jetson board.

    Copies a binary delta over to the target system and arranges for it
    to be bootable.

    The recommended way to use this extension is by calling `morph upgrade`.
    Using `morph deploy --upgrade` is deprecated.

    The upgrade will fail if:
    - no VM is deployed and running at `location`;
    - the target system is not a Baserock system;
    - the target's filesystem and its layout are not compatible with that
      created by `morph deploy`."

    See also the 'Upgrading a Baserock installation' section of the 'Using
    Baserock` page at wiki.baserock.org
    http://wiki.baserock.org/devel-with/#index8h2

    Parameters:

    * location: the 'user@hostname' string that will be used by ssh and rsync.
      'user' will always be `root` and `hostname` the hostname or address of
      the system being upgraded.

    * VERSION_LABEL=label - **(MANDATORY)** should contain only alpha-numeric
      characters and the '-' (hyphen) character.

    * AUTOSTART=<VALUE>` - boolean. If it is set, the VM will be started when
      it has been deployed.

    (See `morph help deploy` for details of how to pass parameters to write
    extensions)