vos_move - Moves a read/write volume to another site

       Unless there is a compelling reason, do not interrupt a vosmove command in progress. Interrupting a move
       can result in one or more of the following inconsistent states:

       •   There  are  two  versions  of the volume, one at the source site and one at the destination site. (If
           this happens, retain the version identified by the VLDB and use the voszap  command  to  remove  the
           other version.)

       •   The  backup  version  of  the  volume  is stranded at the old site. (If this happens, use the voszap
           command to remove it.)

       •   The volume is off-line. (If this happens, run the bossalvage command to bring it back on line.)

       If the Ctrl-C interrupt signal is pressed while a vos move operation is executing, the following  message
       warns of the consequences and requests confirmation of the kill signal:

          SIGINT handler: vos move operation in progress
          WARNING: may leave AFS storage and metadata in indeterminate state
          enter second control-c to exit

       To  confirm termination of the operation, press Ctrl-C a second time; press any other key to continue the
       operation.

       Currently, the maximum quota for a volume is 2 terabytes (2^41 bytes). Note that this  only  affects  the
       volume's  quota;  a  volume may grow much larger if the volume quota is disabled. However, volumes over 2
       terabytes in size may be impractical to move, and may have their size incorrectly reported by some tools,
       such as fs_listquota(1).

       IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

       This  documentation  is covered by the IBM Public License Version 1.0.  It was converted from HTML to POD
       by software written by Chas Williams and Russ Allbery, based on  work  by  Alf  Wachsmann  and  Elizabeth
       Cassell.

OpenAFS                                            2025-03-21                                        VOS_MOVE(1)

       The vosmove command moves the indicated read/write volume from its current site (specified with the
       -fromserver and -frompartition arguments) to the destination site (specified with the -toserver and
       -topartition arguments). This command automatically removes the backup copy from the current site, if it
       exists. To create a new backup volume at the destination site, use the vosbackup command.

       This command works on read/write volumes only. To move a read-only volume, use the vosaddsite and vosrelease commands to define a new read-only site and release the volume contents to it, and then use the
       vosremove command to remove the previous read-only volume's definition from the Volume Location Database
       (VLDB) and data from the partition. To move a backup volume, use this command to move its read/write
       source and then issue the vosbackup command.

       Before executing this command, the vos command interpreter initiates a check that the destination
       partition contains enough space to house the volume being moved. If there is not enough space, the move
       operation is not attempted and the following message appears:

          vos: no space on target partition <dest_part> to move volume <volume>

       The following example moves the volume "user.smith" from the /vicepb partition on the file server machine
       "fs3.example.com" to the /vicepg partition on the file server machine "fs7.example.com".

          % vos move -id user.smith -fromserver fs3.example.com -frompartition b \
              -toserver fs7.example.com -topartition g

       vos_move - Moves a read/write volume to another site

-id <volumenameorID>
           Specifies either the complete name or volume ID number of a read/write volume.

       -fromserver <servername>
           Identifies the file server machine where the volume  currently  resides.  Provide  the  machine's  IP
           address  or its host name (either fully qualified or using an unambiguous abbreviation). For details,
           see vos(1).

       -frompartition <partitionname>
           Names the partition where the volume  currently  resides.  Provide  the  full  partition  name  (for,
           example, /vicepa) or one of the abbreviated forms described in vos(1).

       -toserver <servername>
           Identifies  the file server machine to which to move the volume.  Provide the machine's IP address or
           its host name (either fully qualified or using an unambiguous abbreviation). For details, see vos(1).

       -topartition <partitionname>
           Names the partition to which to move the volume. Provide  the  full  partition  name  (for,  example,
           /vicepa) or one of the abbreviated forms described in vos(1).

       -live
           Avoids  making  a  temporary  copy  of the volume during the move. This is useful if the partition is
           full, but the administrator needs to move volumes to a another partition or server to  free  up  disk
           space.  The caveat is that the volume is locked during the entire operation instead of the short time
           that is needed to make the temporary clone.

       -cell <cellname>
           Names the cell in which to run the command. Do not combine this argument with  the  -localauth  flag.
           For more details, see vos(1).

       -noauth
           Assigns  the  unprivileged  identity  "anonymous"  to  the  issuer. Do not combine this flag with the
           -localauth flag. For more details, see vos(1).

       -localauth
           Constructs a server ticket using a key from  the  local  /etc/openafs/server/KeyFile  file.  The  vos
           command  interpreter  presents  it  to  the  Volume  Server  and Volume Location Server during mutual
           authentication. Do not combine this flag with the -cell argument or -noauth flag. For  more  details,
           see vos(1).

       -verbose
           Produces  on the standard output stream a detailed trace of the command's execution. If this argument
           is omitted, only warnings and error messages appear.

       -encrypt
           Encrypts the command so that the operation's results are not transmitted across the network in  clear
           text. This option is available in OpenAFS versions 1.4.11 or later and 1.5.60 or later.

       -noresolve
           Shows  all  servers  as  IP  addresses  instead  of the DNS name. This is very useful when the server
           address is registered as 127.0.0.1 or when dealing with multi-homed servers. This option is available
           in OpenAFS versions 1.4.8 or later and 1.5.35 or later.

       -config <configurationdirectory>
           Set the location of the configuration directory to be used. This defaults to /etc/openafs, except  if
           -localauth is specified, in which case the default is /etc/openafs/server. This option allows the use
           of alternative configuration locations for testing purposes.

       -help
           Prints the online help for this command. All other valid options are ignored.

       The  issuer  must  be  listed in the /etc/openafs/server/UserList file on the machines specified with the
       -toserver and -fromserver arguments and on each database server  machine.   If  the  -localauth  flag  is
       included, the issuer must instead be logged on to a server machine as the local superuser "root".

vos(1), vos_addsite(1), vos_backup(1), vos_copy(1), vos_release(1), vos_listvol(1), vos_remove(1)

vosmove-id <volumenameorID>
           -fromserver <machinenameonsource>
           -frompartition <partitionnameonsource>
           -toserver <machinenameondestination>
           -topartition <partitionnameondestination>
           [-live] [-cell <cellname>] [-noauth] [-localauth]
           [-verbose] [-encrypt] [-noresolve]
           [-config <configdirectory>]
           [-help]

       vosm-i <volumenameorID>
           -froms <machinenameonsource>
           -fromp <partitionnameonsource>
           -tos <machinenameondestination>
           -top <partitionnameondestination>
           [-li] [-c <cellname>] [-noa]
           [-lo] [-v] [-e] [-nor]
           [-co <configdirectory>]
           [-h]