This module is developed as part of YaST. See the development documentation.

Have a look to the AutoYaST Development Documentation if you would like to implement AutoYaST support for your YaST module.

To get the source code, clone the GitHub repository:

$ git clone https://github.com/yast/yast-autoinstallation.git

If you want to contribute into the project you can fork the repository and clone your fork.

There are several possibilities how test an updated code. It also depends on the fact in which stage of installation it comes into effect. First stage runs between the start from installation media to reboot (or kexec), then continues second stage.

Either use StartShell=1 option in Linuxrc, edit the installation system and run yast manually or use a DriverUpdate via Linuxrc.

There are two possible ways how to rerun this stage, just keep in mind that the system might be already configured and thus it might behave a bit differently:

cp /var/lib/YaST2/install.inf /etc/
touch /var/lib/YaST2/runme_at_boot
cp /var/adm/autoinstall/cache/installedSystem.xml \
  /var/lib/autoinstall/autoconf/autoconf.xml
reboot

or faster without rebooting but with possible side-effects:

yast ayast_setup setup filename=/var/adm/autoinstall/cache/installedSystem.xml

Beside unattended installation this module provide also ability to do unattended upgrade.

• Semi automatic mode
• Without autoyast profile on the boot command line it reads the profile from /root/autoupg.xml file
• When using the Online installation medium the AutoYaST XML profile can be empty

To test autoupgrade run upgrade with parameters autoupgrade=1 and profile e.g. autoyast=ftp://example.com/ay_upgrade.xml. Following example profiles used for testing online and full media.

Online on registered system:

<?xml version="1.0"?>
<!DOCTYPE profile>
<profile xmlns="http://www.suse.com/1.0/yast2ns" xmlns:config="http://www.suse.com/1.0/configns">
</profile>

Full on system without registration:

<?xml version="1.0"?>
<!DOCTYPE profile>
<profile xmlns="http://www.suse.com/1.0/yast2ns" xmlns:config="http://www.suse.com/1.0/configns">
  <upgrade>
    <stop_on_solver_conflict config:type="boolean">true</stop_on_solver_conflict>
  </upgrade>

  <software>
    <products config:type="list">
      <listentry>SLES</listentry>
    </products>
  </software>

  <add-on>
    <add_on_products config:type="list">
      <listentry>
        <name>Basesystem</name>
        <product>Basesystem</product>
        <product_dir>/Module-Basesystem</product_dir>
        <media_url>relurl://</media_url>
        <ask_on_error config:type="boolean">false</ask_on_error>
      </listentry>
    </add_on_products>
  </add-on>
</profile>

• {file:doc/profile_handling.md Profile Handling}
• {file:doc/profile_fetching.md Profile Fetching}
• {file:doc/validation.md Profile Validation}
• {file:doc/error_reporting.md Error Reporting}
• {file:doc/network_scenarios.md Network Scenarios}
• {file:doc/multipath.md Old Multipath Support}

If you have any question, feel free to ask at the development mailing list or at the #yast IRC channel on freenode.