en-US/FileSystems.xml en-US/Release_Notes.xml en-US/Revision_History.xml
John J. McDonough
jjmcd at fedoraproject.org
Tue Oct 27 01:48:59 UTC 2009
en-US/FileSystems.xml | 75 ++++++++++++++++++++++++++++++++++++++++++---
en-US/Release_Notes.xml | 2 -
en-US/Revision_History.xml | 1
3 files changed, 73 insertions(+), 5 deletions(-)
New commits:
commit af64203364b9d5d0c738cbe5614cdbd4561751e4
Author: John J. McDonough <jjmcd at fedoraproject.org>
Date: Mon Oct 26 21:48:50 2009 -0400
Updates to Filesystems from wiki
diff --git a/en-US/FileSystems.xml b/en-US/FileSystems.xml
index 7861e41..9bc3307 100644
--- a/en-US/FileSystems.xml
+++ b/en-US/FileSystems.xml
@@ -3,9 +3,76 @@
]>
<section id="sect-Release_Notes-File_Systems">
- <title>File Systems</title>
- <remark>This beat is located here: <ulink type="http" url="https://fedoraproject.org/wiki/Docs/Beats/FileSystems">https://fedoraproject.org/wiki/Docs/Beats/FileSystems</ulink></remark>
-
-</section>
+ <title>File Systems</title>
+ <remark>This beat is located here: <ulink type="http" url="https://fedoraproject.org/wiki/Docs/Beats/FileSystems">https://fedoraproject.org/wiki/Docs/Beats/FileSystems</ulink></remark>
+
+ <section id="sect-Release_Notes-File_Systems-fusecompress">
+ <title>fusecompress</title>
+ <indexterm>
+ <primary>fusecompress</primary>
+ </indexterm>
+
+ <para>
+ <package>Fusecompress</package> is a compressing filesystem
+ mountable by unprivileged users. (Note: this may mean we don't
+ want this note in the system admin section). Fedora-11 had
+ fusecompress-1.99.19. Fedora-12 updates to
+ fusecompress-2.6. This fixes many very nasty bugs but changes
+ the on-disk format. Users with fusecompress filesystems will
+ need to migrate their data to the new format. Unless they
+ decompress before upgrading, they will need the
+ <package>fusecompress_offline1</package> package to do so.
+ </para>
+ <warning>
+ <title>You must convert your filesystem</title>
+ <para>
+ If a user doesn't read these release notes and realize they need
+ to upgrade the format, the first indication they'll have that
+ something is wrong will probably be when they try to read a text
+ file and it is binary:
+ <screen>
+$ less test.txt
+ "test.dump" may be a binary file. See it anyway?
+ </screen>
+ </para>
+ </warning>
+ <para>
+ The basic method of updating their system is documented in a
+ <filename>/usr/share/doc/fusecompress_offline1-%{version}/README.fedora</filename>
+ file in the fusecompress1 package. The fusecompress package has
+ a <filename>README.fedora</filename> that tells the user to
+ install <package>fusecompress_offline1</package> and read that
+ file. The upgrade instructions are repeated below:
+ </para>
+ <para>
+ <screen>
+Let's say that in Fedora 11 your old fusecompress rootDir (where the files are
+actually stored) is in ~/.fusestorage and you mount it on ~/storage. Now you've
+updated to Fedora 12 and need to get your fusecompress filesystems updated to
+the new on-disk format. Here's the basic steps::
+ # Make sure the old fusecompress filesystem is unmounted
+ fusermount -u ~/storage
+ # Move it to a new location
+ mv ~/.fusestorage ~/.fusestorage.old
+ # Create a new directory for our new format data
+ mkdir ~/.fusestorage
+ # Mount the new directory. It's now a new format fusecompress filesystem
+ fusecompress ~/.fusestorage ~/storage
+ # Decompress all the files in the old fusecompress data directory
+ fusecompress_offline1 ~/.fusestorage.old
+ # Move the files into the new format storage
+ mv .fusestorage.old/* ~/storage
+ # If you have any hidden files, remember to move them too
+ mv .fusestorage.old/.?* ~/storage
+
+Note that to use this exact procedure you need to have enough disk space to
+uncompress all of the files stored in ~/.fusestorage.old. If you don't have
+that much space, you'll have to run fusecompress_offline1 on portions of
+~/.fusestorage.old and move them to ~/storage where they'll be recompressed,
+freeing up the space for you to run fusecompress_offline1 on more files.
+ </screen>
+ </para>
+ </section>
+</section>
diff --git a/en-US/Release_Notes.xml b/en-US/Release_Notes.xml
index 2483666..f70ef05 100644
--- a/en-US/Release_Notes.xml
+++ b/en-US/Release_Notes.xml
@@ -42,7 +42,7 @@
<xi:include href="Samba.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
<!-- <xi:include href="SystemDaemons.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> -->
<!-- <xi:include href="ServerTools.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> -->
- <!-- <xi:include href="FileSystems.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> -->
+ <xi:include href="FileSystems.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
<!-- <xi:include href="Xorg.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> -->
<xi:include href="Clusters.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
</section>
diff --git a/en-US/Revision_History.xml b/en-US/Revision_History.xml
index 9bf32f6..0cf28e2 100644
--- a/en-US/Revision_History.xml
+++ b/en-US/Revision_History.xml
@@ -20,6 +20,7 @@
<member>Wiki updates to I18n</member>
<member>Wiki updates to Virtualization</member>
<member>Wiki updates to Web Servers</member>
+ <member>Wiki updates to File Systems</member>
</simplelist>
</revdescription>
</revision>
More information about the Fedora-docs-commits
mailing list