update docs according to the comments

docs/source/guides/admin-guides/manage_clusters/common/deployment/enable_kdump.rst

@@ -4,7 +4,7 @@ Enable Kdump Over Ethernet
 Overview
 --------
 
-kdump is an advanced crash dumping mechanism. When enabled, the system is booted from the context of another kernel. This second kernel reserves a small amount of memory, and its only purpose is to capture the core dump image in case the system crashes. Since being able to analyze the core dump helps significantly to determine the exact cause of the system failure.
+kdump is an advanced crash dumping mechanism. When enabled, the system is booted from the context of another kernel. This second kernel reserves a small amount of memory, and its only purpose is to capture the core dump image in case the system crashes. Being able to analyze the core dump helps significantly to determine the exact cause of the system failure.
 
 
 xCAT Interface
@@ -14,26 +14,26 @@ The pkglist, exclude and postinstall files location and name can be obtained by
 
     lsdef -t osimage <osimage name>
 
-The pkglist file
-----------------
+Here is an example: ::
 
-For RHEL6 and RHEL7, there are two rpm packages for kdump: ::
+    lsdef -t osimage rhels7.1-ppc64le-netboot-compute
+    Object name: rhels7.1-ppc64le-netboot-compute
+    exlist=/opt/xcat/share/xcat/netboot/rh/compute.rhels7.ppc64le.exlist
+    imagetype=linux
+    osarch=ppc64le
+    osdistroname=rhels7.1-ppc64le
+    osname=Linux
+    osvers=rhels7.1
+    otherpkgdir=/install/post/otherpkgs/rhels7.1/ppc64le
+    permission=755
+    pkgdir=/install/rhels7.1/ppc64le
+    pkglist=/opt/xcat/share/xcat/netboot/rh/compute.rhels7.ppc64le.pkglist
+    postinstall=/opt/xcat/share/xcat/netboot/rh/compute.rhels7.ppc64le.postinstall
+    profile=compute
+    provmethod=netboot
+    rootimgdir=/install/netboot/rhels7.1/ppc64le/compute
 
-    kexec-tools
-    crash
-
-For SLES11, there are 3 rpm packages for kdump: ::
-
-    kdump
-    kexec-tools
-    makedumpfile
-
-For SLES10, there are 4 rpm packages for kdump: ::
-
-    kernel-kdump
-    kexec-tools
-    kdump
-    makedumpfile
+In above example, pkglist file is /opt/xcat/share/xcat/netboot/rh/compute.rhels7.ppc64le.pkglist, exclude files is in /opt/xcat/share/xcat/netboot/rh/compute.rhels7.ppc64le.exlist, and postinstall file is /opt/xcat/share/xcat/netboot/rh/compute.rhels7.ppc64le.postinstall.
 
 Setup pkglist
 -------------
@@ -42,24 +42,58 @@ Before setting up kdump,the approprite rpms should be added to the pkglist file
 
     lsdef -t osimage <osimage name>
 
+Here is the rpm pckages list for kdump for different OS.
+
+* **[RHEL]** ::
+    
+    kexec-tools
+    crash
+
+* **[SLES11]** ::
+
+    kdump
+    kexec-tools
+    makedumpfile
+
+* **[SLES10]** ::
+
+    kernel-kdump
+    kexec-tools
+    kdump
+    makedumpfile
+
+* **[Ubuntu]** ::
+
+    <TODO>
+
 The exclude file
 ----------------
 
 The base diskless image excludes the /boot directory, but it is required for kdump. Update the exlist file and remove the entry for /boot. Then run the packimage or liteimg command to update your image with the changes.
 
+<TODO exclude files list>
+
 The postinstall file
 --------------------
 
-The kdump will create a new initrd which used in the dumping stage. The /tmp or /var/tmp directory will be used as the temporary directory. These 2 directory only are allocated 10M space by default. You need to enlarge it to 200M.
+The kdump will create a new initrd which used in the dumping stage. The /tmp or /var/tmp directory will be used as the temporary directory. These 2 directory only are allocated 10M space by default. You need to enlarge it to 200M. Modify the postinstall file to increase /tmp space.
 
-For RHELS6 or SLES10, modify the postinstall file to increase /tmp space: ::
+* **[RHELS]** ::
 
     tmpfs   /var/tmp    tmpfs   defaults,size=200m   0 2
 
-For SLES11, modify the postinstall file to increase /tmp/space: ::
+* **[SLES10]** ::
+ 
+    tmpfs   /var/tmp    tmpfs   defaults,size=200m   0 2
+
+* **[SLES11]** ::
 
     tmpfs   /tmp    tmpfs   defaults,size=200m       0 2
 
+* **[Ubuntu]** ::
+
+    <TODO>
+
 The dump attribute
 ------------------
 
@@ -89,8 +123,6 @@ Where <size> recommended value is 256. For more information about the size can r
     
     `<https://access.redhat.com/knowledge/docs/en-US/Red_Hat_Enterprise_Linux/6/html/Deployment_Guide/s2-kdump-configuration-cli.html>`_.  
     
-    `<http://www.novell.com/support/kb/doc.php?id=3374462>`_.  
-
 For system p machine, set the crashkernelsize attribute to this: ::
 
     chdef -t osimage <image name> crashkernelsize=<size>@32M
@@ -155,7 +187,7 @@ Once the system has returned from recovering the crash, you may wish to analyze
 
   2.Locate the kernel file for the crash server(the kernel is under /tftpboot/xcat/netboot/<OS name="">/<ARCH>/<profile>/kernel on management node).
 
-  3.One you have located a vmcore dump file and kernel file, call crash: ::
+  3.Once you have located a vmcore dump file and kernel file, call crash: ::
 
     crash <vmcore_dump_file> <kernel_file>
 

docs/source/guides/admin-guides/manage_clusters/common/deployment/install_new_kernel.rst

@@ -49,7 +49,7 @@ The "4.6.ppc64le" is replaced with "4-ppc64le": ::
 Run genimage/packimage to update the image with the new kernel. 
 Note: If downgrading the kernel, you may need to first remove the rootimg directory.
 
-Since the kernel version name is different from the kernel rpm package name, the -g flag MUST to be specified on the genimage command. :: 
+Since the kernel version name is different from the kernel rpm package name, the -k flag MUST to be specified on the genimage command. :: 
 
          genimage <imagename> -k 3.12.28-4-ppc64le 3.12.28-4.6
          packimage <imagename>