Bug 75865

Summary:	comments on "backup-basics" in handbook
Product:	Documentation	Reporter:	Vick Khera <vivek>
Component:	Books & Articles	Assignee:	Tom Rhodes <trhodes>
Status:	Closed FIXED
Severity:	Affects Only Me
Priority:	Normal
Version:	Latest
Hardware:	Any
OS:	Any

Description Vick Khera 2005-01-05 20:00:53 UTC

	

I was following the notes in Section 16.11.8.2 After the Disaster of the
handbook at
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/backup-basics.html
to repartition a server running 5-STABLE.

I ran into problems with running restore since the root partition (and thus
the /tmp dir) has only a few hundred blocks free when you boot from the fixit
CD.  Restore will quickly fill up the space and the restore will fail.

Fix: 

set environment variable TMPDIR to some suitably large place or mount a
ramdisk for /tmp.  I'm not sure what the instructions to do the latter would
be, as I was lucky enough to have a suitable place to set TMPDIR to.

Please add some commentary on setting TMPDIR and/or mounting a reasonably
large /tmp via MFS to let restore succeed.
How-To-Repeat: 	

boot to fixit floppy and run 'restore' on a good sized partition.  the dump
file was about 200k blocks.

Comment 1 minimarmot 2008-07-01 03:16:39 UTC

I think the inline patch should take care of this -- the other
programs listed on the page do
not seem to document using /tmp or other places for intermediate files.

Note that I also reworeded a couple of sentences to avoid starting
sentences with
(lowercase) command names, as well.

If gmail mangles whitespace, the patch can also be found at
http://stuff.mit.edu/afs/sipb.mit.edu/user/kaduk/freebsd/patches/disks.diff.2008.07.01

-Ben Kaduk

--- chapter.sgml.0      2008-06-30 21:11:24.000000000 -0400
+++ chapter.sgml        2008-06-30 22:09:30.000000000 -0400
@@ -2380,12 +2380,19 @@
        <command>dump</command> and <command>restore</command>.  They
        operate on the drive as a collection of disk blocks, below the
        abstractions of files, links and directories that are created by
-       the file systems. <command>dump</command> backs up an entire
+       the file systems. Unlike other backup software,
+       <command>dump</command> backs up an entire
        file system on a device.  It is unable to backup only part of a
        file system or a directory tree that spans more than one
-       file system.  <command>dump</command> does not write files and
+       file system.  The <command>dump</command> command does not
write files and
        directories to tape, but rather writes the raw data blocks that
-       comprise files and directories.</para>
+       comprise files and directories.  When being used to extract
+       data, <command>restore</command> stores temporary files
+       in <filename>/tmp/</filename> by default &emdash; if you are
+       operating from a recovery disk with a small
+       <filename>/tmp</filename> directory, you may need to set the
+       <envar>TMPDIR</envar> environment variable to a directory
+       with more free space for the restore to be successful.</para>

       <note><para>If you use <command>dump</command> on your root
directory, you
         would not back up <filename>/home</filename>,

Comment 2 dfilter service freebsd_committer

2008-12-24 10:54:22 UTC

trhodes     2008-12-24 10:54:09 UTC

  FreeBSD doc repository

  Modified files:
    en_US.ISO8859-1/books/handbook/disks chapter.sgml 
  Log:
  Recommend setting TMPDIR to a larger file system in cases where /tmp
  is small and restore eats the space.
  
  PR:             75865
  Submitted by:   "Ben Kaduk" <minimarmot@gmail.com>
  
  Revision  Changes    Path
  1.289     +10 -3     doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml
_______________________________________________
cvs-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-all
To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"

Comment 3 Tom Rhodes freebsd_committer

2008-12-24 10:54:33 UTC

State Changed
From-To: open->closed

Patch applied to the handbook, thanks!

Comment 4 Tom Rhodes freebsd_committer

2008-12-24 10:54:33 UTC

Responsible Changed
From-To: freebsd-doc->trhodes

Over to me.