some formatting and syntax fixes on existing guides, and adding new OpenSUSE Deployment Guide

_includes/autoinstall_done.md

@@ -0,0 +1,62 @@
+          #set system_name = $getVar('system_name','')
+          #set profile_name = $getVar('profile_name','')
+          #if $system_name != ''
+              #set object_type = 'system'
+              #set object_name = $system_name
+          #else if $profile_name != ''
+              #set object_type = 'profile'
+              #set object_name = $profile_name
+          #else
+              #set object_type = ''
+              #set object_name = ''
+          #end if
+          #set breed = $getVar('breed','')
+          #set os_version = $getVar('os_version','')
+          #set srv = $getVar('http_server','')
+          #set autoinstall = $getVar('autoinstall','')
+          #set run_install_triggers = $getVar('run_install_triggers','')
+          #set pxe_just_once = $getVar('pxe_just_once','')
+          #set nopxe = ""
+          #set save_autoinstall = ""
+          #set runpost = ""
+          #if $system_name != ''
+              ## PXE JUST ONCE
+              #if $pxe_just_once
+                  #if $breed == 'redhat'
+                      #set nopxe = "\ncurl \"http://%s/cblr/svc/op/nopxe/system/%s\" -o /dev/null" % (srv, system_name)
+                  #else if $breed == 'vmware' and $os_version == 'esx4'
+                      #set nopxe = "\ncurl \"http://%s/cblr/svc/op/nopxe/system/%s\" -o /dev/null" % (srv, system_name)
+                  #else
+                      #set nopxe = "\nwget \"http://%s/cblr/svc/op/nopxe/system/%s\" -O /dev/null" % (srv, system_name)
+                  #end if
+              #end if
+          #end if
+          #if $object_type != ''
+              ## SAVE AUTO INSTALLATION
+              #if $autoinstall != ''
+                  #if $breed == 'redhat'
+                      #set save_autoinstall = "\ncurl \"http://%s/cblr/svc/op/autoinstall/%s/%s\" -o /root/cobbler.ks" % (srv, object_type, object_name)
+                  #else if $breed == 'suse'
+                      #set save_autoinstall = "\ncurl \"http://%s/cblr/svc/op/autoinstall/%s/%s\" -o /root/cobbler.xml" % (srv, object_type, object_name)
+                  #else if $breed == 'vmware' and $os_version == 'esx4'
+                      #set save_autoinstall = "\ncurl \"http://%s/cblr/svc/op/autoinstall/%s/%s\" -o /root/cobbler.ks" % (srv, object_type, object_name)
+                  #else if $breed == 'vmware'
+                      #set save_autoinstall = "\nwget \"http://%s/cblr/svc/op/autoinstall/%s/%s\" -O /var/log/cobbler.ks" % (srv, object_type, object_name)
+                  #else if $breed == 'debian' or $breed == 'ubuntu'
+                      #set save_autoinstall = "\nwget \"http://%s/cblr/svc/op/autoinstall/%s/%s\" -O /var/log/cobbler.seed" % (srv, object_type, object_name)
+                  #end if
+              #end if
+              ## RUN POST TRIGGER
+              #if $run_install_triggers
+                  #if $breed == 'redhat' or $breed == 'suse'
+                      #set runpost = "\ncurl \"http://%s/cblr/svc/op/trig/mode/post/%s/%s\" -o /dev/null" % (srv, object_type, object_name)
+                  #else if $breed == 'vmware' and $os_version == 'esx4'
+                      #set runpost = "\ncurl \"http://%s/cblr/svc/op/trig/mode/post/%s/%s\" -o /dev/null" % (srv, object_type, object_name)
+                  #else
+                      #set runpost = "\nwget \"http://%s/cblr/svc/op/trig/mode/post/%s/%s\" -O /dev/null" % (srv, object_type, object_name)
+                  #end if
+              #end if
+          #end if
+          #echo $nopxe
+          #echo $save_autoinstall
+          #echo $runpost

_includes/autoinstall_start.md

@@ -0,0 +1,27 @@
+          #set system_name = $getVar('system_name','')
+          #set profile_name = $getVar('profile_name','')
+          #if $system_name != ''
+              #set object_type = 'system'
+              #set object_name = $system_name
+          #else if $profile_name != ''
+              #set object_type = 'profile'
+              #set object_name = $profile_name
+          #else
+              #set object_type = ''
+              #set object_name = ''
+          #end if
+          #set breed = $getVar('breed','')
+          #set srv = $getVar('http_server','')
+          #set run_install_triggers = $getVar('run_install_triggers','')
+          #set runpre = ""
+          #if $object_type != ''
+              ## RUN PRE TRIGGER
+              #if $run_install_triggers
+                  #if $breed == 'redhat' or $breed == 'suse'
+                      #set runpre = "\ncurl \"http://%s/cblr/svc/op/trig/mode/pre/%s/%s\" -o /dev/null" % (srv, object_type, object_name)
+                  #else
+                      #set runpre = "\nwget \"http://%s/cblr/svc/op/trig/mode/pre/%s/%s\" -O /dev/null" % (srv, object_type, object_name)
+                  #end if
+              #end if
+          #end if
+          #echo $runpre

_includes/example-preseed-excerpt.txt.md

@@ -0,0 +1,42 @@
+          ### Apt setup
+          # Choose, if you want to scan additional installation media
+          # (default: false).
+          d-i apt-setup/cdrom/set-first boolean false
+          # You can choose to install non-free firmware.
+          #d-i apt-setup/non-free-firmware boolean true
+          # You can choose to install non-free and contrib software.
+          #d-i apt-setup/non-free boolean true
+          #d-i apt-setup/contrib boolean true
+          # Uncomment the following line, if you don't want to have the sources.list
+          # entry for a DVD/BD installation image active in the installed system
+          # (entries for netinst or CD images will be disabled anyway, regardless of
+          # this setting).
+          #d-i apt-setup/disable-cdrom-entries boolean true
+          # Uncomment this if you don't want to use a network mirror.
+          #d-i apt-setup/use_mirror boolean false
+          # Select which update services to use; define the mirrors to be used.
+          # Values shown below are the normal defaults.
+          #d-i apt-setup/services-select multiselect security, updates
+          #d-i apt-setup/security_host string security.debian.org
+
+          # Additional repositories, local[0-9] available
+          #d-i apt-setup/local0/repository string \
+          #       http://local.server/debian stable main
+          #d-i apt-setup/local0/comment string local server
+          # Enable deb-src lines
+          #d-i apt-setup/local0/source boolean true
+          # URL to the public key of the local repository; you must provide a key or
+          # apt will complain about the unauthenticated repository and so the
+          # sources.list line will be left commented out.
+          #d-i apt-setup/local0/key string http://local.server/key
+          # or one can provide it in-line by base64 encoding the contents of the
+          # key file (with `base64 -w0`) and specifying it thus:
+          #d-i apt-setup/local0/key string base64://LS0tLS1CRUdJTiBQR1AgUFVCTElDIEtFWSBCTE9DSy0tLS0tCi4uLgo=
+          # The content of the key file is checked to see if it appears to be ASCII-armoured.
+          # If so it will be saved with an ".asc" extension, otherwise it gets a '.gpg' extension.
+          # "keybox database" format is currently not supported. (see generators/60local in apt-setup's source)
+
+          # By default the installer requires that repositories be authenticated
+          # using a known gpg key. This setting can be used to disable that
+          # authentication. Warning: Insecure, not recommended.
+          #d-i debian-installer/allow_unauthenticated boolean true

_includes/suse-15.6-autoyast.xml.md

@@ -0,0 +1,121 @@
+          <?xml version="1.0"?>
+          <!DOCTYPE profile>
+          <profile xmlns="http://www.suse.com/1.0/yast2ns" xmlns:config="http://www.suse.com/1.0/configns">
+            <deploy_image>
+              <image_installation config:type="boolean">false</image_installation>
+            </deploy_image>
+            ## without the next 6 lines autoyast will ask for confirmation bevore installation
+            <general>
+              <mode>
+                <confirm config:type="boolean">false</confirm>
+                <final_reboot config:type="boolean">true</final_reboot>
+              </mode>
+            </general>
+            $SNIPPET('addons.xml')
+            $SNIPPET('hosts.xml')
+            <ntp-client>
+              <ntp_policy>auto</ntp_policy>
+              <ntp_servers config:type="list">
+                <ntp_server>
+                  <address>us.pool.ntp.org</address>
+                  <iburst config:type="boolean">false</iburst>
+                  <offline config:type="boolean">false</offline>
+                </ntp_server>
+                <ntp_server>
+                  <address>2.opensuse.pool.ntp.org</address>
+                  <iburst config:type="boolean">false</iburst>
+                  <offline config:type="boolean">false</offline>
+                </ntp_server>
+              </ntp_servers>
+              <ntp_sync>15</ntp_sync>
+            </ntp-client>
+            $SNIPPET('kdump.xml')
+            <keyboard>
+              <keymap>us</keymap>
+            </keyboard>
+            <language>
+              <language>en_US</language>
+              <languages></languages>
+            </language>
+            <timezone>
+              <hwclock>UTC</hwclock>
+              <timezone>EST5EDT</timezone>
+            </timezone>
+            <software>
+              <packages config:type="list">
+                <package>chrony</package>
+                <package>sudo</package>
+                <package>openssh</package>
+              </packages>
+            </software>
+            <services-manager>
+              <services>
+                <enable config:type="list">
+                  <service>sshd</service>
+                </enable>
+              </services>
+            </services-manager>
+            <login_settings/>
+            $SNIPPET('suse-15.4-networking.xml')
+            <users config:type="list">
+              <user>
+                <encrypted config:type="boolean">true</encrypted>
+                <fullname>root</fullname>
+                <gid>0</gid>
+                <home>/root</home>
+                <password_settings>
+                  <expire></expire>
+                  <flag></flag>
+                  <inact></inact>
+                  <max></max>
+                  <min></min>
+                  <warn></warn>
+                </password_settings>
+                <shell>/bin/bash</shell>
+                <uid>0</uid>
+                  <user_password>$default_password_crypted</user_password>
+                <username>root</username>
+              </user>
+              <user>
+                <encrypted config:type="boolean">true</encrypted>
+                <username>suse</username>
+                <user_password>$default_password_crypted</user_password>
+              </user>
+            </users>
+            <scripts>
+              ## we have to include the pre-scripts tag to get autoinstall_start included
+              <pre-scripts config:type="list">
+                #set global $wrappedscript = 'autoinstall_start'
+                $SNIPPET('suse-15.4_scriptwrapper.xml')
+                  ## SuSE has an annoying habit on ppc64 of changing the system
+                  ## boot order after installation. This makes it non-trivial to
+                  ## automatically re-install future OS.
+                  #set global $wrappedscript = 'save_boot_device'
+                  $SNIPPET('suse-15.4_scriptwrapper.xml')
+              </pre-scripts>
+              <post-scripts config:type="list">
+                  ##
+                  ## This plugin wrapper provides the flexibility to call pure shell
+                  ## snippets which can be used directly on autoinst file and with
+                  ## wrapper on SuSE.
+                  ##
+                  ## To use it
+                  ## - exchange name_of_pure_shell_snippet with the name of this shell snippet
+                  ## - and remove the '##' in front of the line with suse-15.4_scriptwrapper.xml
+                  ##
+                  #set global $wrappedscript = 'name_of_pure_shell_snippet'
+                  ## $SNIPPET('suse-15.4_scriptwrapper.xml')
+
+                  ## SuSE has an annoying habit on ppc64 of changing the system
+                  ## boot order after installation. This makes it non-trivial to
+                  ## automatically re-install future OS.
+                  #set global $wrappedscript = 'restore_boot_device'
+                  $SNIPPET('suse-15.4_scriptwrapper.xml')
+              </post-scripts>
+              ## we have to include the init-scripts tag to get autoinstall_done included
+              <init-scripts config:type="list">
+                #set global $wrappedscript = 'autoinstall_done'
+                $SNIPPET('suse-15.4_scriptwrapper.xml')
+              </init-scripts>
+            </scripts>
+          </profile>