From f33d468ea48fba8b75aa3aa1492983bbccae46aa Mon Sep 17 00:00:00 2001 From: Pete Fotheringham Date: Thu, 4 Dec 2014 13:49:59 +0000 Subject: ssh-rsync write extension documentation --- ssh-rsync.write.help | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 ssh-rsync.write.help (limited to 'ssh-rsync.write.help') diff --git a/ssh-rsync.write.help b/ssh-rsync.write.help new file mode 100644 index 00000000..4ef666e8 --- /dev/null +++ b/ssh-rsync.write.help @@ -0,0 +1,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=` - 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) -- cgit v1.2.1 From 6c1cc0f3706d1019158b6a31735f416b974a1226 Mon Sep 17 00:00:00 2001 From: Sam Thursfield Date: Tue, 9 Dec 2014 17:49:36 +0000 Subject: deploy: Note that some of the extensions listed live in definitions.git The user should be aware of this because if they aren't building baserock:baserock/definitions or a repo forked from it, those extensions won't be available. Also fix some long lines that I seem to have failed to commit already. --- ssh-rsync.write.help | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'ssh-rsync.write.help') diff --git a/ssh-rsync.write.help b/ssh-rsync.write.help index 4ef666e8..d03508c0 100644 --- a/ssh-rsync.write.help +++ b/ssh-rsync.write.help @@ -23,8 +23,8 @@ help: | 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. + '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. -- cgit v1.2.1 From 8ca2082cdb2cf65b8ec9e1c392349208c0a00373 Mon Sep 17 00:00:00 2001 From: Pete Fotheringham Date: Wed, 4 Mar 2015 13:28:57 +0000 Subject: Add copyright headers to write.help and configure.help files --- ssh-rsync.write.help | 14 ++++++++++++++ 1 file changed, 14 insertions(+) (limited to 'ssh-rsync.write.help') diff --git a/ssh-rsync.write.help b/ssh-rsync.write.help index d03508c0..f3f79ed5 100644 --- a/ssh-rsync.write.help +++ b/ssh-rsync.write.help @@ -1,3 +1,17 @@ +# Copyright (C) 2014, 2015 Codethink Limited +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; version 2 of the License. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License along +# with this program; if not, see . + help: | Upgrade a Baserock system which is already deployed: -- cgit v1.2.1