docs: Update the docs to reflect current progress
authorNikos Skalkotos <skalkoto@grnet.gr>
Thu, 6 Feb 2014 10:32:20 +0000 (12:32 +0200)
committerNikos Skalkotos <skalkoto@grnet.gr>
Thu, 6 Feb 2014 10:36:15 +0000 (12:36 +0200)
* Add links for downloading NetBSD and OpenBSD images
* Remove the reference to the partition extending limitation for OpenBSD

docs/advanced.rst
docs/index.rst
docs/usage.rst

index b5a52ac..bea220d 100644 (file)
@@ -31,7 +31,7 @@ Known Issues
 ------------
 
  * For Linux systems, having grub installed in the partition is fragile and
 ------------
 
  * For Linux systems, having grub installed in the partition is fragile and
-   things can go wrong when resizing the partitions, especially when shrinking.
+   things can go wrong if you shrink the partition.
  * More complicated partition schemes are not supported.
 
 diskdump image format (recommended)
  * More complicated partition schemes are not supported.
 
 diskdump image format (recommended)
@@ -44,18 +44,24 @@ This design decision has the following benefits:
 
  * Swap partitions are supported
  * The system may use multiple partitions:
 
  * Swap partitions are supported
  * The system may use multiple partitions:
-    * dedicated partitions for /boot, /home etc in Linux
-    * system and boot partition in Windows
+    * Dedicated partitions for /boot, /home etc. in Linux
+    * Separate system and boot partition in Windows
  * There are no restrictions on starting sectors of partitions
 
 Although diskdump is a lot more flexible than the older formats, there are
 still some rules to follow:
 
  * There are no restrictions on starting sectors of partitions
 
 Although diskdump is a lot more flexible than the older formats, there are
 still some rules to follow:
 
- * All devices in fstab should be specified by persistent names (UUID or LABEL)
- * LVMs are not supported
- * For Linux disks only ext{2,3,4} file systems are supported
- * For FreeBSD disks only UFS file systems are supported
- * For FreeBSD only GUID Partition Tables (GPT) are supported
+ * For Linux:
+   * All block devices in */etc/fstab* should be specified using persistent
+     names (UUID or LABEL)
+   * LVM partitions are not supported
+   * Only ext{2,3,4} file systems are supported
+ * For FreeBSD:
+   * GUID Partition Tables (GPT) should be used
+   * Only UFS2 file systems are supported
+   * Labels should be omitted in */etc/fstab* entries
+ * For {Open,Net}BSD:
+   * Only FFS file systems should be used
 
 Progress Monitoring Interface
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Progress Monitoring Interface
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -67,7 +73,7 @@ the *PROGRESS_MONITOR* variable under ``/etc/default/snf-image`` and
 program. In this section we will describe the format and the fields of the
 progress messages.
 
 program. In this section we will describe the format and the fields of the
 progress messages.
 
-The progress messages are json strings with standardized fields. All messages
+The progress messages are JSON strings with standardized fields. All messages
 have a **type** field whose value is a string and a **timestamp** field whose
 value is a floating point number referring to a time encoded as the number of
 seconds elapsed since the epoch. The rest of the field depend on the specific
 have a **type** field whose value is a string and a **timestamp** field whose
 value is a floating point number referring to a time encoded as the number of
 seconds elapsed since the epoch. The rest of the field depend on the specific
@@ -138,7 +144,7 @@ warning
 This messages are produced to display a warning. The actual warning message
 itself is present in the *messages* field:
 
 This messages are produced to display a warning. The actual warning message
 itself is present in the *messages* field:
 
-``{"subtype": "warning", "type": "image-helper", "messages": [" No swap partition defined"], "timestamp": 1379075807.71704}``
+``{"subtype": "warning", "type": "image-helper", "messages": ["No swap partition defined"], "timestamp": 1379075807.71704}``
 
 error
 -----
 
 error
 -----
index aa035b6..f738c33 100644 (file)
@@ -19,16 +19,15 @@ snf-image supports `KVM <http://www.linux-kvm.org/page/Main_Page>`_ and
 
 snf-image also supports Image customization via hooks. Hooks allow for:
 
 
 snf-image also supports Image customization via hooks. Hooks allow for:
 
- * changing the password of root or arbitrary users
- * injecting files at arbitrary locations inside the filesystem, e.g., SSH keys
+ * Changing the password of root or arbitrary users
+ * Injecting files into the file system, e.g., SSH keys
  * setting a custom hostname
  * re-creating SSH host keys to ensure the image uses unique keys
 
 snf-image is being used in large scale production environments with Ganeti to
 successfully deploy many major Linux distributions (Debian, Ubuntu/Kubuntu,
  * setting a custom hostname
  * re-creating SSH host keys to ensure the image uses unique keys
 
 snf-image is being used in large scale production environments with Ganeti to
 successfully deploy many major Linux distributions (Debian, Ubuntu/Kubuntu,
-CentOS, Fedora, OpenSUSE), Windows 2008 R2 & Windows Server 2012, as well as
-FreeBSD. Support for OpenBSD and NetBSD is also included with exception to
-extending partitions.
+CentOS, Fedora, OpenSUSE, Slackware, Arch Linux), Windows Server flavors
+(2008 R2, 2012, 20012 R2), as well as BSD systems (FreeBSD, OpenBSD, NetBSD).
 
 The snf-image Ganeti OS Definition is released under
 `GPLv2 <http://www.gnu.org/licenses/gpl-2.0.html>`_.
 
 The snf-image Ganeti OS Definition is released under
 `GPLv2 <http://www.gnu.org/licenses/gpl-2.0.html>`_.
index ab6681e..c73b820 100644 (file)
@@ -59,6 +59,14 @@ that have been tested with snf-image and provided here for testing purposes:
    [`diskdump <http://cdn.synnefo.org/freebsd-9.2-x86_64.diskdump>`_]
    [`md5sum <http://cdn.synnefo.org/freebsd-9.2-x86_64.diskdump.md5sum>`_]
    [`metadata <http://cdn.synnefo.org/freebsd-9.2-x86_64.diskdump.meta>`_]
    [`diskdump <http://cdn.synnefo.org/freebsd-9.2-x86_64.diskdump>`_]
    [`md5sum <http://cdn.synnefo.org/freebsd-9.2-x86_64.diskdump.md5sum>`_]
    [`metadata <http://cdn.synnefo.org/freebsd-9.2-x86_64.diskdump.meta>`_]
+ * OpenBSD 5.4
+   [`diskdump <http://cdn.synnefo.org/openbsd-5.4-x86_64.diskdump>`_]
+   [`md5sum <http://cdn.synnefo.org/openbsd-5.4-x86_64.diskdump.md5sum>`_]
+   [`metadata <http://cdn.synnefo.org/openbsd-5.4-x86_64.diskdump.meta>`_]
+ * NetBSD 6.1
+   [`diskdump <http://cdn.synnefo.org/netbsd-6.1-x86_64.diskdump>`_]
+   [`md5sum <http://cdn.synnefo.org/netbsd-6.1-x86_64.diskdump.md5sum>`_]
+   [`metadata <http://cdn.synnefo.org/netbsd-6.1-x86_64.diskdump.meta>`_]
 
 Sample Usage
 ^^^^^^^^^^^^
 
 Sample Usage
 ^^^^^^^^^^^^