← Back to branch summary

~ubuntu-branches/ubuntu/breezy/openafs/breezy

« back to all changes in this revision

Viewing changes to src/WINNT/doc/install/Documentation/en_US/html/CmdRef/auarf268.htm

  • Committer: Bazaar Package Importer
  • Author(s): Russ Allbery
  • Date: 2005-08-26 01:30:21 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20050826013021-f0cwayjrju8bbfxu
Tags: 1.4rc1-1
http://bugs.debian.org/322638
http://bugs.debian.org/249315
http://bugs.debian.org/324694
http://bugs.debian.org/120097
http://bugs.debian.org/323582
* New upstream version.
* Install pam_afs.krb.so on hppa.  I believe the new PAM module build
  process fixes the issue that was being worked around before.
* Improve the documentation and scripts for setting up new servers or a
  new cell.  afs-rootvol can now be run from a client configured to use
  dynroot.  afs-newcell generates the server CellServDB directly to work
  around oddities with bos addhost.  There are many other, more minor
  improvements as well.  Thanks to Faheem Mitha and Sergio Gelato for
  analysis and patches.  (Closes: #322638)
* Update the configuration transcript to reflect the current packages,
  messages, and instructions.  Thanks, Faheem Mitha.
* Fill in the server CellServDB with information about the local cell,
  if available in the client CellServDB, rather than always initializing
  it to contain just the name of the cell.
* Detect AFS caches on non-ext2/ext3 file systems and abort AFS client
  initialization.  (Closes: #249315)
* Provide a way of setting sysname in afs.conf.  (Closes: #324694)
* Don't create the unused /etc/openafs/AFSLog file.  (Closes: #120097)
* Redo how library object files are found for the PAM module build to
  avoid assuming C locale character set behavior.  (Closes: #323582)
* Remove the openafs-client warning against dynroot for the first system
  in a cell now that afs-rootvol can cope.  Provide some basic
  documentation of the CellAlias syntax in that message until we have a
  real man page.
* Suggest openafs-doc.
* Update standards version to 3.6.2 for the kernel module packages (no
  changes required).
* Translation updates.
  - Czech, thanks Martin Sin.
  - Vietnamese, thanks Clytie Siddall.
  - French, thanks Christian Perrier.

Show diffs side-by-side

added added

removed removed

Lines of Context:
src/WINNT/doc/install/Documentation/en_US/html/CmdRef/auarf268.htm
1
 
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
2
 
<HTML><HEAD>
3
 
<TITLE>Administration Reference</TITLE>
4
 
<!-- Begin Header Records  ========================================== -->
5
 
<!-- /tmp/idwt3190/auarf000.scr converted by idb2h R4.2 (359) ID      -->
6
 
<!-- Workbench Version (AIX) on 5 Nov 1999 at 13:58:29                -->
7
 
<META HTTP-EQUIV="updated" CONTENT="Fri, 05 Nov 1999 13:58:29">
8
 
<META HTTP-EQUIV="review" CONTENT="Sun, 05 Nov 2000 13:58:29">
9
 
<META HTTP-EQUIV="expires" CONTENT="Mon, 05 Nov 2001 13:58:29">
10
 
</HEAD><BODY>
11
 
<!-- (C) IBM Corporation 2000. All Rights Reserved    --> 
12
 
<BODY bgcolor="ffffff"> 
13
 
<!-- End Header Records  ============================================ -->
14
 
<A NAME="Top_Of_Page"></A>
15
 
<H1>Administration Reference</H1>
16
 
<HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf267.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf269.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P> 
17
 
<P>
18
 
<H2><A NAME="HDRVOS_MOVE" HREF="auarf002.htm#ToC_282">vos move</A></H2>
19
 
<A NAME="IDX5766"></A>
20
 
<A NAME="IDX5767"></A>
21
 
<A NAME="IDX5768"></A>
22
 
<A NAME="IDX5769"></A>
23
 
<A NAME="IDX5770"></A>
24
 
<A NAME="IDX5771"></A>
25
 
<A NAME="IDX5772"></A>
26
 
<A NAME="IDX5773"></A>
27
 
<A NAME="IDX5774"></A>
28
 
<P><STRONG>Purpose</STRONG>
29
 
<P>Moves a read/write volume to another site
30
 
<P><STRONG>Synopsis</STRONG>
31
 
<PRE><B>vos move -id</B> &lt;<VAR>volume&nbsp;name&nbsp;or&nbsp;ID</VAR>>  <B>-fromserver</B> &lt;<VAR>machine&nbsp;name&nbsp;on&nbsp;source</VAR>> 
32
 
         <B>-frompartition</B> &lt;<VAR>partition&nbsp;name&nbsp;on&nbsp;source</VAR>> 
33
 
         <B>-toserver</B> &lt;<VAR>machine&nbsp;name&nbsp;on&nbsp;destination</VAR>>  
34
 
         <B>-topartition</B> &lt;<VAR>partition&nbsp;name&nbsp;on&nbsp;destination</VAR>> 
35
 
         [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-noauth</B>]  [<B>-localauth</B>]  [<B>-verbose</B>]  [<B>-help</B>] 
36
 
    
37
 
<B>vos m -i</B> &lt;<VAR>volume&nbsp;name&nbsp;or&nbsp;ID</VAR>>  <B>-froms</B> &lt;<VAR>machine&nbsp;name&nbsp;on&nbsp;source</VAR>> 
38
 
      <B>-fromp</B> &lt;<VAR>partition&nbsp;name&nbsp;on&nbsp;source</VAR>>  <B>-tos</B> &lt;<VAR>machine&nbsp;name&nbsp;on&nbsp;destination</VAR>> 
39
 
      <B>-top</B> &lt;<VAR>partition&nbsp;name&nbsp;on&nbsp;destination</VAR>>  [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]  
40
 
      [<B>-n</B>]  [<B>-l</B>]  [<B>-v</B>]  [<B>-h</B>]
41
 
</PRE>
42
 
<P><STRONG>Description</STRONG>
43
 
<P>The <B>vos move</B> command moves the indicated read/write volume from
44
 
its current site (specified with the <B>-fromserver</B> and
45
 
<B>-frompartition</B> arguments) to the destination site (specified with
46
 
the <B>-toserver</B> and <B>-topartition</B> arguments). This
47
 
command automatically removes the backup copy from the current site, if it
48
 
exists. To create a new backup volume at the destination site, use the
49
 
<B>vos backup</B> command.
50
 
<P>This command works on read/write volumes only. To move a read-only
51
 
volume, use the <B>vos addsite</B> and <B>vos release</B> commands to
52
 
define a new read-only site and release the volume contents to it, and then
53
 
use the <B>vos remove</B> command to remove the previous read-only
54
 
volume&#39;s definition from the Volume Location Database (VLDB) and data
55
 
from the partition. To move a backup volume, use this command to move
56
 
its read/write source and then issue the <B>vos backup</B> command.
57
 
<P>Before executing this command, the <B>vos</B> command interpreter
58
 
initiates a check that the destination partition contains enough space to
59
 
house the volume being moved. If there is not enough space, the move
60
 
operation is not attempted and the following message appears&#58;
61
 
<PRE>   vos&#58; no space on target partition <VAR>dest_part</VAR> to move volume <VAR>volume</VAR>
62
 
   
63
 
</PRE>
64
 
<P><STRONG>Cautions</STRONG>
65
 
<P>Unless there is a compelling reason, do not interrupt a <B>vos move</B>
66
 
command in progress. Interrupting a move can result in one or more of
67
 
the following inconsistent states&#58;
68
 
<UL>
69
 
<P><LI>There are two versions of the volume, one at the source site and one at
70
 
the destination site. (If this happens, retain the version identified
71
 
by the VLDB and use the <B>vos zap</B> command to remove the other
72
 
version.)
73
 
<P><LI>The backup version of the volume is stranded at the old site. (If
74
 
this happens, use the <B>vos zap</B> command to remove it.)
75
 
<P><LI>The volume is off-line. (If this happens, run the <B>bos
76
 
salvage</B> command to bring it back on line.)
77
 
</UL>
78
 
<P>If the &lt;<B>Ctrl-c</B>> interrupt signal is pressed while a <B>vos
79
 
move</B> operation is executing, the following message warns of the
80
 
consequences and requests confirmation of the kill signal&#58;
81
 
<PRE>   SIGINT handler&#58; vos move operation in progress
82
 
   WARNING&#58; may leave AFS storage and metadata in indeterminate state
83
 
   enter second control-c to exit
84
 
   
85
 
</PRE>
86
 
<P>To confirm termination of the operation, press &lt;<B>Ctrl-c</B>> a
87
 
second time; press any other key to continue the operation.
88
 
<P><STRONG>Options</STRONG>
89
 
<DL>
90
 
<P><DT><B>-id
91
 
</B><DD>Specifies either the complete name or volume ID number of a read/write
92
 
volume.
93
 
<P><DT><B>-fromserver
94
 
</B><DD>Identifies the file server machine where the volume currently
95
 
resides. Provide the machine&#39;s IP address or its host name (either
96
 
fully qualified or using an unambiguous abbreviation). For details, see
97
 
the introductory reference page for the <B>vos</B> command suite.
98
 
<P><DT><B>-frompartition
99
 
</B><DD>Names the partition where the volume currently resides. Provide the
100
 
full partition name (for, example, <B>/vicepa</B>) or one of the
101
 
abbreviated forms described on the introductory <B>vos</B> reference
102
 
page.
103
 
<P><DT><B>-toserver
104
 
</B><DD>Identifies the file server machine to which to move the volume.
105
 
Provide the machine&#39;s IP address or its host name (either fully qualified
106
 
or using an unambiguous abbreviation). For details, see the
107
 
introductory reference page for the <B>vos</B> command suite.
108
 
<P><DT><B>-topartition
109
 
</B><DD>Names the partition to which to move the volume. Provide the full
110
 
partition name (for, example, <B>/vicepa</B>) or one of the abbreviated
111
 
forms described on the introductory <B>vos</B> reference page.
112
 
<P><DT><B>-cell
113
 
</B><DD>Names the cell in which to run the command. Do not combine this
114
 
argument with the <B>-localauth</B> flag. For more details, see the
115
 
introductory <B>vos</B> reference page.
116
 
<P><DT><B>-noauth
117
 
</B><DD>Assigns the unprivileged identity <B>anonymous</B> to the
118
 
issuer. Do not combine this flag with the <B>-localauth</B>
119
 
flag. For more details, see the introductory <B>vos</B> reference
120
 
page.
121
 
<P><DT><B>-localauth
122
 
</B><DD>Constructs a server ticket using a key from the local
123
 
<B>/usr/afs/etc/KeyFile</B> file. The <B>vos</B> command
124
 
interpreter presents it to the Volume Server and Volume Location Server during
125
 
mutual authentication. Do not combine this flag with the
126
 
<B>-cell</B> argument or <B>-noauth</B> flag. For more details,
127
 
see the introductory <B>vos</B> reference page.
128
 
<P><DT><B>-verbose
129
 
</B><DD>Produces on the standard output stream a detailed trace of the
130
 
command&#39;s execution. If this argument is omitted, only warnings
131
 
and error messages appear.
132
 
<P><DT><B>-help
133
 
</B><DD>Prints the online help for this command. All other valid options
134
 
are ignored.
135
 
</DL>
136
 
<P><STRONG>Examples</STRONG>
137
 
<P>The following example moves the volume <B>user.smith</B> from
138
 
the <B>/vicepb</B> partition on the file server machine
139
 
<B>fs3.abc.com</B> to the <B>/vicepg</B> partition on
140
 
the file server machine <B>fs7.abc.com</B>.
141
 
<PRE>   % <B>vos move -id user.smith -fromserver fs3.abc.com -frompartition b</B>  \
142
 
              <B>-toserver fs7.abc.com -topartition g</B>
143
 
   
144
 
</PRE>
145
 
<P><STRONG>Privilege Required</STRONG>
146
 
<P>The issuer must be listed in the <B>/usr/afs/etc/UserList</B> file on
147
 
the machines specified with the <B>-toserver</B> and
148
 
<B>-fromserver</B> arguments and on each database server machine.
149
 
If the <B>-localauth</B> flag is included, the issuer must instead be
150
 
logged on to a server machine as the local superuser <B>root</B>.
151
 
<P><STRONG>Related Information</STRONG>
152
 
<P><A HREF="auarf252.htm#HDRVOS_INTRO">vos</A>
153
 
<P><A HREF="auarf253.htm#HDRVOS_ADDSITE">vos addsite</A>
154
 
<P><A HREF="auarf255.htm#HDRVOS_BACKUP">vos backup</A>
155
 
<P><A HREF="auarf270.htm#HDRVOS_RELEASE">vos release</A>
156
 
<P><A HREF="auarf266.htm#HDRVOS_LISTVOL">vos listvol</A>
157
 
<P><A HREF="auarf271.htm#HDRVOS_REMOVE">vos remove</A>
158
 
<P>
159
 
<HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf267.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf269.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P> 
160
 
<!-- Begin Footer Records  ========================================== -->
161
 
<P><HR><B> 
162
 
<br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved 
163
 
</B> 
164
 
<!-- End Footer Records  ============================================ -->
165
 
<A NAME="Bot_Of_Page"></A>
166
 
</BODY></HTML>