[Gluster-devel] doc-patch!
Harshavardhana Ranganath
harsha at 80x25.org
Thu Jan 26 06:25:06 UTC 2006
gluster.texi patch with building with iso as texinfo document.
-------------- next part --------------
--- gluster.texi 2006-01-24 12:01:36.000000000 +0530
+++ /root/texi/gluster/gluster.texi 2006-01-25 15:50:55.000000000 +0530
@@ -13,7 +13,8 @@
@end direntry
@ifinfo
- at noident This file documents Gluster version @value{VERSION}
+ at noindent
+This file documents Gluster version @value{VERSION}
Gluster is a GNU/Linux Live distribution, used to run clustering
applications.
@@ -24,7 +25,8 @@ Copyright @copyright{} 2005 Z RESEARCH,
@include permissions.texi
@titlepage
- at title Gluster - GNU Clustering Meta Distribution version @value{VERSION}
+ at title Gluster - GNU Clustering Meta Distribution
+ at title Version @value{VERSION}
@subtitle Introduction , @value{UPDATED}
@author Harshavardhana @email{harsha@@80x25.org}
@@ -67,6 +69,8 @@ applications.
@c @noindent Copyright @copyright{} 2005 Gluster Core Team.
@menu
+Gluster Summary
+
* Overview:: What is gluster?.
* Arch:: Gluster Architecture.
* Extensions:: Gluster's Key Modularity.
@@ -76,6 +80,7 @@ applications.
* Build Process:: Gluster Distro Build.
* Portability:: Porting Gluster.
* Concept Index::
+
@end menu
@end ifinfo
@@ -84,26 +89,23 @@ applications.
Gluster is a GNU/Linux Live distribution, used to run clustering
applications.
Gluster is modular system, extended in Python.
-
Few of the applications Gluster [will] run are:
- at itemsize @bullet
+ at itemize @bullet
@item
GInstaller - GInstaller is an application used to replicate a
GNU/Linux installation on a cluster.
-
- at item
+ at item
Gluster-SSI/NUMA - SSI - Single System Image.
....fill more......
- at end itemsize
+ at end itemize
@cindex What is Gluster?
@node Arch, Extensions, Overview, Top
@chapter Gluster Architecture
Gluster Runtime has three stages of operation
-
- at itemsize @bullet
+ at itemize @bullet
@item
Stage 1 (Bootstrapping)
@@ -112,8 +114,7 @@ are loaded either from ISO, USB or Netwo
The only goal of this stage is to load the kernel and initrd and boot
the kernel.
-
- at item
+ at item
Stage 2 (Probe for Stage 3)
Gluster being modular, has all its features as extensions. These
@@ -122,13 +123,11 @@ be used from NFS mount etc.
The goal of Stage 2 is to probe for the location of Stage 3 (extensions)
and load the 'core' extension, which takes control thereof.
-
@item
Stage 3 (Applications and extensions)
Applications, like GInstaller, GlusterSSI are part of Stage-3.
-
- at end itemsize
+ at end itemize
@cindex Architecture
@@ -144,9 +143,12 @@ Gluster libraries, and an application lo
Format of an Extension
An extension to Gluster consist of two files -
-a) A specification file [filename.gex]
-b) A tarball [filename.tgz]
-
+ at itemize @bullet
+ at item
+ A specification file [filename.gex]
+ at item
+ A tarball [filename.tgz]
+ at end itemize
The .gex file has meta information about the extension, like, what kind
of extension this is (Application, simple package, tool, library), what it
does, who is the maintainer, what is the .tgz corresponding to this
@@ -161,13 +163,18 @@ script, anything which can be executed.
It is upto the `runme' script to do whatever it wants. Usually the things
it might want to do are -
-a)If the extension provides a package, the runme would copy the .so files
+ at itemize @bullet
+ at item
+If the extension provides a package, the runme would copy the .so files
to the system lib repository /usr/lib etc.
-b)Install other extension which it depends on.
-c)If the extension provides tools for Gluster, copy them to
+ at item
+Install other extension which it depends on.
+ at item
+If the extension provides tools for Gluster, copy them to
/usr/share/gluster/extensions/<name>/<name>
If another extension needs to use this tool, it should look for it
in /usr/share/gluster/extensions/<toolname>/<toolname>
+ at end itemize
So, the extensions `runme' decides the characteristic of an extension,
and it is totally in the `runme's hands what an extension does, or doesnt.
@@ -206,16 +213,23 @@ Client nodes in Gluster can boot
@cindex Boot Mechanism
- at node Build Process, Gluster License, Client Boot, Top
+ at node Build Process, Portability, Client Boot, Top
@chapter Build Process
-
-1. Overview - Gluster build process generates a bootable Guster ISO, using which you
+ at itemize @bullet
+ at item
+Overview - Gluster build process generates a bootable Guster ISO, using which you
boot the master node.
-2. Third party packages
-3. Native compile and Cross compile
-4. Stage 2 installs and Extension/Stage 3 installs
-5. Adding a new third party package
-6. Adding a new Extension
+ at item
+Third party packages
+ at item
+Native compile and Cross compile
+ at item
+Stage 2 installs and Extension/Stage 3 installs
+ at item
+Adding a new third party package
+ at item
+Adding a new Extension
+ at end itemize
@cindex Building Gluster
More information about the Gluster-devel
mailing list