Recent changes to Installing_Stateful_Linux_Nodes

Installing_Stateful_Linux_Nodes modified by XiaoPeng Wang

XiaoPeng Wang — Mon, 27 Jul 2015 06:00:38 -0000

--- v83
+++ v84
@@ -672,9 +672,11 @@

 #### ** set the kernel options which will be persistent the installed system(Optional) **

-The attributes “linuximage.addkcmdline” and “bootparams.addkcmdline” are the interfaces for the user to specify some additional kernel options to be passed to kernel/installer for node deployment. There are some scenarios that users want to specify some kernel options persistent after installation, that is, the specified kernel options will be effective(can be found in /proc/cmdline) among normal system reboots after installation.  
-
-This can be finished by specifying the persistent kernel options with the prefix "R::", for example, to specify the redhat7 kernel option “net.ifnames=0” persistent:
+The attributes “linuximage.addkcmdline” and “bootparams.addkcmdline” are the interfaces for the user to specify some additional kernel options to be passed to kernel/installer for node deployment. 
+
+The added kernel parameters can be 'OS deployment Only' or 'Reboot Only'(Added to the grub2.conf). A specific prefix 'R::' is defined to identify that this parameter is 'Reboot Only'. Otherwise, it's 'OS deployment Only'. 
+
+For example, to specify the redhat7 kernel option “net.ifnames=0” to be persistent (Reboot Only), that means it does take effect even after reboot:

 ~~~~

@@ -682,7 +684,7 @@

 ~~~~

-**Note**: The persistent kernel options with prefix "R::" won't be passed to the kernel/installer for node deployment.
+**Note**: The persistent kernel options with prefix 'R::' won't be passed to the OS installer for node deployment. So that means if you want a parameter to be available for both 'OS deployment' and 'Reboot', you need to specify the parameter twice with and without 'R::' prefix.

 #### **\[SLES\] set the netwait kernel parameter (Optional)**

@@ -783,4 +785,3 @@
 ~~~~
  lsdef -t osimage <mycomputeimage> to check the osimage attributes. 
 ~~~~
-

Installing_Stateful_Linux_Nodes modified by yangsong

yangsong — Tue, 05 May 2015 09:26:06 -0000

--- v82
+++ v83
@@ -615,7 +615,10 @@

 ~~~~ 

-    's:c:<the absolute="" path="" of="" the="" additional="" preseed="" config="" script="">',  the additional preseed config script is a script to set the preseed values with "debconf-set". When "nodeset", the #XCA_PARTMAN_ADDITIONAL_CONFIG_SCRIPT# directive in /install/autoinst/<node>.pre will be replaced with the content of the script, an example: 
+    's:c:<the absolute="" path="" of="" the="" additional="" preseed="" config="" script="">',  the additional preseed config
+     script is a script to set the preseed values with "debconf-set". When "nodeset", the 
+    #XCA_PARTMAN_ADDITIONAL_CONFIG_SCRIPT# directive in /install/autoinst/<node>.pre will be replaced 
+    with the content of the script, an example: 

 ~~~~

Installing_Stateful_Linux_Nodes modified by yangsong

yangsong — Tue, 05 May 2015 09:23:21 -0000

--- v81
+++ v82
@@ -602,21 +602,26 @@
 ##### Additional preseed configuration file and additional preseed configuration script (For Ubuntu only)

 To support other specific partition methods such as RAID or LVM in Ubuntu, some additional preseed configuration entries should be specified, these entries can be specified in 2 ways:
+
     'c:<the absolute="" path="" of="" the="" additional="" preseed="" config="" file="">', the additional preseed config file
      contains the additional preseed entries in "d-i ..." syntax. When "nodeset", the     
     #XCA_PARTMAN_ADDITIONAL_CFG# directive in /install/autoinst/<node> will be replaced with 
     content of the config file, an example:

 ~~~~
+
 d-i partman-auto/method string raid
 d-i partman-md/confirm boolean true
+
 ~~~~ 

     's:c:<the absolute="" path="" of="" the="" additional="" preseed="" config="" script="">',  the additional preseed config script is a script to set the preseed values with "debconf-set". When "nodeset", the #XCA_PARTMAN_ADDITIONAL_CONFIG_SCRIPT# directive in /install/autoinst/<node>.pre will be replaced with the content of the script, an example: 

 ~~~~
+
 debconf-set partman-auto/method string raid
 debconf-set partman-md/confirm boolean true
+
 ~~~~ 

 If not specified, the default value will be used.

Installing_Stateful_Linux_Nodes modified by yangsong

yangsong — Tue, 05 May 2015 09:22:07 -0000

--- v80
+++ v81
@@ -602,7 +602,10 @@
 ##### Additional preseed configuration file and additional preseed configuration script (For Ubuntu only)

 To support other specific partition methods such as RAID or LVM in Ubuntu, some additional preseed configuration entries should be specified, these entries can be specified in 2 ways:
-    'c:<the absolute="" path="" of="" the="" additional="" preseed="" config="" file="">', the additional preseed config file contains the additional preseed entries in "d-i ..." syntax. When "nodeset", the #XCA_PARTMAN_ADDITIONAL_CFG# directive in /install/autoinst/<node> will be replaced with content of the config file, an example:
+    'c:<the absolute="" path="" of="" the="" additional="" preseed="" config="" file="">', the additional preseed config file
+     contains the additional preseed entries in "d-i ..." syntax. When "nodeset", the     
+    #XCA_PARTMAN_ADDITIONAL_CFG# directive in /install/autoinst/<node> will be replaced with 
+    content of the config file, an example:

 ~~~~
 d-i partman-auto/method string raid

Installing_Stateful_Linux_Nodes modified by yangsong

yangsong — Tue, 05 May 2015 09:19:46 -0000

--- v79
+++ v80
@@ -602,14 +602,14 @@
 ##### Additional preseed configuration file and additional preseed configuration script (For Ubuntu only)

 To support other specific partition methods such as RAID or LVM in Ubuntu, some additional preseed configuration entries should be specified, these entries can be specified in 2 ways:
-'c:<the absolute="" path="" of="" the="" additional="" preseed="" config="" file="">', the additional preseed config file contains the additional preseed entries in "d-i ..." syntax. When "nodeset", the #XCA_PARTMAN_ADDITIONAL_CFG# directive in /install/autoinst/<node> will be replaced with content of the config file, an example:
+    'c:<the absolute="" path="" of="" the="" additional="" preseed="" config="" file="">', the additional preseed config file contains the additional preseed entries in "d-i ..." syntax. When "nodeset", the #XCA_PARTMAN_ADDITIONAL_CFG# directive in /install/autoinst/<node> will be replaced with content of the config file, an example:

 ~~~~
 d-i partman-auto/method string raid
 d-i partman-md/confirm boolean true
 ~~~~ 

-'s:c:<the absolute="" path="" of="" the="" additional="" preseed="" config="" script="">',  the additional preseed config script is a script to set the preseed values with "debconf-set". When "nodeset", the #XCA_PARTMAN_ADDITIONAL_CONFIG_SCRIPT# directive in /install/autoinst/<node>.pre will be replaced with the content of the script, an example: 
+    's:c:<the absolute="" path="" of="" the="" additional="" preseed="" config="" script="">',  the additional preseed config script is a script to set the preseed values with "debconf-set". When "nodeset", the #XCA_PARTMAN_ADDITIONAL_CONFIG_SCRIPT# directive in /install/autoinst/<node>.pre will be replaced with the content of the script, an example: 

 ~~~~
 debconf-set partman-auto/method string raid

Installing_Stateful_Linux_Nodes modified by yangsong

yangsong — Tue, 05 May 2015 09:10:02 -0000

--- v78
+++ v79
@@ -602,14 +602,14 @@
 ##### Additional preseed configuration file and additional preseed configuration script (For Ubuntu only)

 To support other specific partition methods such as RAID or LVM in Ubuntu, some additional preseed configuration entries should be specified, these entries can be specified in 2 ways:
-"c:<the absolute="" path="" of="" the="" additional="" preseed="" config="" file="">", the additional preseed config file contains the additional preseed entries in "d-i ..." syntax. When "nodeset", the #XCA_PARTMAN_ADDITIONAL_CFG# directive in /install/autoinst/<node> will be replaced with content of the config file, an example:
+'c:<the absolute="" path="" of="" the="" additional="" preseed="" config="" file="">', the additional preseed config file contains the additional preseed entries in "d-i ..." syntax. When "nodeset", the #XCA_PARTMAN_ADDITIONAL_CFG# directive in /install/autoinst/<node> will be replaced with content of the config file, an example:

 ~~~~
 d-i partman-auto/method string raid
 d-i partman-md/confirm boolean true
 ~~~~ 

-"s:c:<the absolute="" path="" of="" the="" additional="" preseed="" config="" script="">",  the additional preseed config script is a script to set the preseed values with "debconf-set". When "nodeset", the #XCA_PARTMAN_ADDITIONAL_CONFIG_SCRIPT# directive in /install/autoinst/<node>.pre will be replaced with the content of the script, an example: 
+'s:c:<the absolute="" path="" of="" the="" additional="" preseed="" config="" script="">',  the additional preseed config script is a script to set the preseed values with "debconf-set". When "nodeset", the #XCA_PARTMAN_ADDITIONAL_CONFIG_SCRIPT# directive in /install/autoinst/<node>.pre will be replaced with the content of the script, an example: 

 ~~~~
 debconf-set partman-auto/method string raid

Installing_Stateful_Linux_Nodes modified by yangsong

yangsong — Tue, 05 May 2015 09:08:02 -0000

--- v77
+++ v78
@@ -615,17 +615,20 @@
 debconf-set partman-auto/method string raid
 debconf-set partman-md/confirm boolean true
 ~~~~ 
+
 If not specified, the default value will be used.

 ###### Associate additional preseed configuration file or additional preseed configuration script with osimage: 

 Associate additional preseed configuration file by:
+
 ~~~~  
          chdef -t osimage <osimagename> -p partitionfile='c:/install/custom/configfile'
          nodeset <nodename> osimage=<osimage>
 ~~~~  

 Associate additional preseed configuration script by:
+
 ~~~~  
          chdef -t osimage <osimagename> -p partitionfile='s:c:/install/custom/configscript'
          nodeset <nodename> osimage=<osimage>
@@ -654,7 +657,7 @@
 d-i network-console/password           password cluster
 d-i network-console/password-again     password cluster
 ~~~~
-** Note: For the entry "d-i preseed/early_command string anna-install network-console",if there is already a "preseed/early_command"  entry in /install/autoinst/<node>,  the value "anna-install network-console" should be appended to the existed "preseed/early_command"  entry carefully, otherwise, the former one will be overwritten. 
+** Note: For the entry "d-i preseed/early_command string anna-install network-console",if there is already a "preseed/early_command"  entry in /install/autoinst/<node>,  the value "anna-install network-console" should be appended to the existed "preseed/early_command"  entry carefully, otherwise, the former will be overwritten. 

 #### ** set the kernel options which will be persistent the installed system(Optional) **

Installing_Stateful_Linux_Nodes modified by yangsong

yangsong — Tue, 05 May 2015 09:03:54 -0000

--- v76
+++ v77
@@ -457,7 +457,7 @@

 For Redhat, when nodeset runs and generates the /install/autoinst file for a node, it will replace the #XCAT_PARTITION_START#...#XCAT_PARTITION_END# directives from your osimage template with the contents of your custom partitionfile. 

-For Ubuntu, When nodeset runs and generates the /install/autoinst file for a node, it will generate a script to write the partition configuration to /tmp/partitionfile, this script will replace the #XCA_PARTMAN_RECIPE_SCRIPT# directive in /install/autoinst/<node>.pre. 
+For Ubuntu, when nodeset runs and generates the /install/autoinst file for a node, it will generate a script to write the partition configuration to /tmp/partitionfile, this script will replace the #XCA_PARTMAN_RECIPE_SCRIPT# directive in /install/autoinst/<node>.pre. 

 ##### Partitioning definition script(for RedHat and Ubuntu)

@@ -541,10 +541,10 @@

 Note: the 's:' preceding the filename tells nodeset that this is a script. 
 For Redhat, when nodeset runs and generates the /install/autoinst file for a node, it will add the execution of the contents of this script to the %pre section of that file. The nodeset command will then replace the #XCAT_PARTITION_START#...#XCAT_PARTITION_END# directives from the osimage template file with "%include /tmp/partitionfile" to dynamically include the tmp definition file your script created. 
-For Ubuntu, when nodeset runs and generates the /install/autoinst file for a node, it will replace the "#XCA_PARTMAN_RECIPE_SCRIPT#" directive add the execution of the contents of this script to the /install/autoinst/<node>.pre, the /install/autoinst/<node>.pre script will be run in the preseed/early_command.
+For Ubuntu, when nodeset runs and generates the /install/autoinst file for a node, it will replace the "#XCA_PARTMAN_RECIPE_SCRIPT#" directive and add the execution of the contents of this script to the /install/autoinst/<node>.pre, the /install/autoinst/<node>.pre script will be run in the preseed/early_command.

 ##### Partitioning disk file(For Ubuntu only)
-The disk file contains the name of the disks to partition in traditional, non-devfs format, delimited with space “ ”, for example, 
+The disk file contains the name of the disks to partition in traditional, non-devfs format and delimited with space “ ”, for example, 

 ~~~~
 /dev/sda /dev/sdb 
@@ -560,7 +560,7 @@
 ~~~~  

 Note: the 'd:' preceding the filename tells nodeset that this is a partition disk file. 
-For Ubuntu, When nodeset runs and generates the /install/autoinst file for a node, it will generate a script to write the content of the partition disk file to /tmp/boot_disk, this script will replace the #XCA_PARTMAN_DISK_SCRIPT# directive in /install/autoinst/<node>.pre. 
+For Ubuntu, when nodeset runs and generates the /install/autoinst file for a node, it will generate a script to write the content of the partition disk file to /tmp/boot_disk, this context to run the script will replace the #XCA_PARTMAN_DISK_SCRIPT# directive in /install/autoinst/<node>.pre. 

 ##### Partitioning disk script(For Ubuntu only)
@@ -592,24 +592,24 @@
 ###### Associate partition disk script with osimage: 

 ~~~~  
-         chdef -t osimage <osimagename> -p partitionfile='s:d:/install/custom/partitiondisk'
+         chdef -t osimage <osimagename> -p partitionfile='s:d:/install/custom/partitiondiskscript'
          nodeset <nodename> osimage=<osimage>
 ~~~~  

 Note: the 's:' prefix tells nodeset that is a script, the 's:d:' preceding the filename tells nodeset that this is a script to generate the partition disk file. 
-For Ubuntu, When nodeset runs and generates the /install/autoinst file for a node, this script will replace the #XCA_PARTMAN_DISK_SCRIPT# directive in /install/autoinst/<node>.pre. 
+For Ubuntu, when nodeset runs and generates the /install/autoinst file for a node, this context to run the script will replace the #XCA_PARTMAN_DISK_SCRIPT# directive in /install/autoinst/<node>.pre. 

 ##### Additional preseed configuration file and additional preseed configuration script (For Ubuntu only)

-To support other specific partition methods such as RAID or LVM in Ubuntu, some additional preseed values should be specified, these values can be specified in 2 ways:
-"c:<the absolute="" path="" of="" the="" additional="" preseed="" config="" file="">" which contains the additional preseed entries in "d-i ..." form. When "nodeset", the #XCA_PARTMAN_ADDITIONAL_CFG# directive in /install/autoinst/<node> will be replaced with content of the config file, an example:
+To support other specific partition methods such as RAID or LVM in Ubuntu, some additional preseed configuration entries should be specified, these entries can be specified in 2 ways:
+"c:<the absolute="" path="" of="" the="" additional="" preseed="" config="" file="">", the additional preseed config file contains the additional preseed entries in "d-i ..." syntax. When "nodeset", the #XCA_PARTMAN_ADDITIONAL_CFG# directive in /install/autoinst/<node> will be replaced with content of the config file, an example:

 ~~~~
 d-i partman-auto/method string raid
 d-i partman-md/confirm boolean true
 ~~~~ 

-"s:c:<the absolute="" path="" of="" the="" additional="" pressed="" config="" script="">" which is a script to set the preseed values with "debconf-set". When "nodeset", the #XCA_PARTMAN_ADDITIONAL_CONFIG_SCRIPT# directive in /install/autoinst/<node>.pre will be replaced with the content of the script, an example: 
+"s:c:<the absolute="" path="" of="" the="" additional="" preseed="" config="" script="">",  the additional preseed config script is a script to set the preseed values with "debconf-set". When "nodeset", the #XCA_PARTMAN_ADDITIONAL_CONFIG_SCRIPT# directive in /install/autoinst/<node>.pre will be replaced with the content of the script, an example: 

 ~~~~
 debconf-set partman-auto/method string raid
@@ -654,6 +654,7 @@
 d-i network-console/password           password cluster
 d-i network-console/password-again     password cluster
 ~~~~
+** Note: For the entry "d-i preseed/early_command string anna-install network-console",if there is already a "preseed/early_command"  entry in /install/autoinst/<node>,  the value "anna-install network-console" should be appended to the existed "preseed/early_command"  entry carefully, otherwise, the former one will be overwritten. 

 #### ** set the kernel options which will be persistent the installed system(Optional) **

Installing_Stateful_Linux_Nodes modified by yangsong

yangsong — Tue, 05 May 2015 08:46:47 -0000

--- v75
+++ v76
@@ -444,8 +444,8 @@
     * Use yast2 autoyast in GUI or CLI mode to customize the installation options and create autoyast file
     * Use yast2 clone_system to create autoyast configuration file /root/autoinst.xml to clone an existing system

-*Ubuntu
-    *For detailed information see the files partman-auto-recipe.txt and partman-auto-raid-recipe.txt included in the debian-installer package. Both files are also available from the debian-installer source repository. Note that the supported functionality may change between releases.
+* Ubuntu
+    * For detailed information see the files partman-auto-recipe.txt and partman-auto-raid-recipe.txt included in the debian-installer package. Both files are also available from the debian-installer source repository. Note that the supported functionality may change between releases.

 ###### Associate partition file with osimage

Installing_Stateful_Linux_Nodes modified by yangsong

yangsong — Tue, 05 May 2015 08:45:29 -0000

--- v74
+++ v75
@@ -434,7 +434,7 @@

 ~~~~

-If none of these examples could be used in your cluster, you could refer to the [Kickstart documentation](http://fedoraproject.org/wiki/Anaconda/Kickstart#part_or_partition) or [Autoyast documentation](https://doc.opensuse.org/projects/autoyast/configuration.html#CreateProfile.Partitioning) to write your own partitions layout or [Preseed documentation](https://www.debian.org/releases/stable/i386/apbs04.html.en#preseed-partman). Meanwhile, RedHat and SuSE provides some tools that could help generate kickstart/autoyast templates, in which you could refer to the partition section for the partitions layout information:
+If none of these examples could be used in your cluster, you could refer to the [Kickstart documentation](http://fedoraproject.org/wiki/Anaconda/Kickstart#part_or_partition) or [Autoyast documentation](https://doc.opensuse.org/projects/autoyast/configuration.html#CreateProfile.Partitioning) or [Preseed documentation](https://www.debian.org/releases/stable/i386/apbs04.html.en#preseed-partman) to write your own partitions layout. Meanwhile, RedHat and SuSE provides some tools that could help generate kickstart/autoyast templates, in which you could refer to the partition section for the partitions layout information:

 * RedHat:
     * The file /root/anaconda-ks.cfg is a sample kickstart file created by RedHat installer during the installation process based on the options that you selected.