From khera@kcilink.com  Wed Jan  5 20:00:20 2005
Return-Path: <khera@kcilink.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 459E516A4CE
	for <FreeBSD-gnats-submit@freebsd.org>; Wed,  5 Jan 2005 20:00:20 +0000 (GMT)
Received: from yertle.kcilink.com (yertle.kcilink.com [65.205.34.180])
	by mx1.FreeBSD.org (Postfix) with ESMTP id E396643D31
	for <FreeBSD-gnats-submit@freebsd.org>; Wed,  5 Jan 2005 20:00:19 +0000 (GMT)
	(envelope-from khera@kcilink.com)
Received: by yertle.kcilink.com (Postfix, from userid 100)
	id 3F0C9217B5; Wed,  5 Jan 2005 15:00:19 -0500 (EST)
Message-Id: <20050105200019.3F0C9217B5@yertle.kcilink.com>
Date: Wed,  5 Jan 2005 15:00:19 -0500 (EST)
From: Vivek Khera <vivek@khera.org>
Reply-To: Vivek Khera <vivek@khera.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: comments on "backup-basics" in handbook
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         75865
>Category:       docs
>Synopsis:       comments on "backup-basics" in handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Wed Jan 05 20:00:53 GMT 2005
>Closed-Date:    Wed Dec 24 10:55:22 UTC 2008
>Last-Modified:  Wed Dec 24 11:00:07 UTC 2008
>Originator:     Vivek Khera
>Release:        FreeBSD 4.10-STABLE i386
>Organization:
>Environment:
System: FreeBSD yertle.int.kciLink.com 4.10-STABLE FreeBSD 4.10-STABLE #12: Tue Jul 13 13:13:38 EDT 2004 khera@yertle.int.kciLink.com:/u/yertle2/usr.obj/u/sources/usr/src/sys/YERTLE i386


	
>Description:
	

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.

>How-To-Repeat:
	

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

>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.
>Release-Note:
>Audit-Trail:

From: "Ben Kaduk" <minimarmot@gmail.com>
To: bug-followup@freebsd.org
Cc:  
Subject: Re: docs/75865: comments on "backup-basics" in handbook
Date: Mon, 30 Jun 2008 22:16:39 -0400

 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>,
State-Changed-From-To: open->closed 
State-Changed-By: trhodes 
State-Changed-When: Wed Dec 24 10:54:33 UTC 2008 
State-Changed-Why:  
Patch applied to the handbook, thanks! 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Wed Dec 24 10:54:33 UTC 2008 
Responsible-Changed-Why:  
Over to me. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=75865 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/75865: commit references a PR
Date: Wed, 24 Dec 2008 10:54:22 +0000 (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"
 
>Unformatted:
