filed the move-instance problem as a bug (team#40971)

howto/ganeti.md

@@ -2171,7 +2171,9 @@ possible through things like [zerofree](https://tracker.debian.org/pkg/zerofree)
 
 ### Mass migrating instances to a new cluster
 
-The [move-instance](https://docs.ganeti.org/docs/ganeti/3.0/html/move-instance.html) command can do this.
+The [move-instance](https://docs.ganeti.org/docs/ganeti/3.0/html/move-instance.html) command can do this, apparently. In practice,
+this procedure doesn't currently work, see the end of the section for
+details.
 
  1. create a new secret on the source cluster:
 
@@ -2260,6 +2262,8 @@ Currently fails with:
         raise errors.OpPrereqError("If network is given, no mode or link"
     ganeti.errors.OpPrereqError: ('If network is given, no mode or link is allowed to be passed', 'wrong_input')
 
+Reported as [bug 1696 upstream](https://github.com/ganeti/ganeti/issues/1696), blocked.
+
 ### Reboot procedures
 
 If you get this email in Nagios: