Initial evbarm upgrade instructions - need work

distrib/notes/evbarm/upgrade

@@ -1,3 +1,74 @@
-.\"	$NetBSD: upgrade,v 1.2 2009/04/23 01:56:49 snj Exp $
+.\"	$NetBSD: upgrade,v 1.3 2020/07/18 17:40:14 nia Exp $
+.\"
+.\" Copyright (c) 2020 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
 .
-.so ../common/upgrade
+.Pp
+The easiest way to upgrade to
+.Nx
+\*M
+\*V
+is by using the sysutils/sysupgrade package from pkgsrc.
+.Pp
+First, edit
+.Pa /usr/pkg/etc/sysupgrade.conf .
+Make sure RELEASEDIR and KERNEL are correct:
+.Bd -literal
+RELEASEDIR="https://cdn.netbsd.org/pub/NetBSD/NetBSD-\*V/evbarm-aarch64/"
+.Ed
+or
+.Bd -literal
+RELEASEDIR="https://cdn.netbsd.org/pub/NetBSD/NetBSD-\*V/evbarm-earmv7hf/"
+.Ed
+or
+.Bd -literal
+RELEASEDIR="https://cdn.netbsd.org/pub/NetBSD/NetBSD-\*V/evbarm-earmv6hf/"
+.Ed
+.Pp
+Make sure
+.Pa /boot
+is mounted, and copy the new board-specific
+.Pa *.dts
+file into place, and
+.Pa bootaa64.efi
+if applicable.
+.Pp
+Finally:
+.Bd -literal
+# sysupgrade fetch
+# sysupgrade kernel netbsd-GENERIC (or netbsd-GENERIC64)
+# sysupgrade modules
+# reboot
+# sysupgrade sets
+# reboot
+# sysupgrade postinstall
+.Ed
+.Pp
+This is the most careful possible path.
+It is also possible to:
+.Bd -literal
+# sysupgrade auto
+# reboot
+.Ed