B AutoYaST FAQ - Frequently Asked Questions #
- 1. How do I invoke an AutoYaST installation?
On all SUSE Linux Enterprise Server versions, the automatic installation gets invoked by adding
autoyast=<PATH_TO_PROFILE>
to the kernel parameter list. So for example addingautoyast=http://MYSERVER/MYCONFIG.xml
will start an automatic installation where the profile with the AutoYaST configuration gets fetched from the Web servermyserver
. See Section 6.3, “Invoking the Auto-Installation Process” for more information.
- 2. What is an AutoYaST profile?
A profile is the AutoYaST configuration file. The content of the AutoYaST profile determines how the system will be configured and which packages will get installed. This includes partitioning, network setup, and software sources, to name but a few. Almost everything that can be configured with YaST in a running system can also be configured in an AutoYaST profile. The profile format is an ASCII XML file.
- 3. How do I create an AutoYaST profile?
The easiest way to create an AutoYaST profile is to use an existing SUSE Linux Enterprise Server system as a template. On an already installed system, start › › . Now select › from the menu. Choose the system components you want to include in the profile. Alternatively, create a profile containing the complete system configuration by running
sudo yast clone_system
from the command line.Both methods will create the file
/root/autoinst.xml
. The version created on the command line can be used to set up an identical clone of the system on which the profile was created. However, usually you will want to adjust the file to make it possible to install several machines that are very similar, but not identical. This can be done by adjusting the profile using your favorite text/XML editor.
- 4. How can I check the syntax of a created AutoYaST profile?
The most efficient way to check your created AutoYaST profile is by using
jing
orxmllint
.See Section 3.3, “Creating/Editing a Control File Manually” for details.
- 5. What is smallest AutoYaST profile that makes sense?
If a section has not been defined in the AutoYaST profile the settings of the general YaST installation proposal will be used. However, you need to specify at least the
root
password to be able to log in to the machine after the installation.<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE profile> <profile xmlns="http://www.suse.com/1.0/yast2ns" xmlns:config="http://www.suse.com/1.0/configns"> <users config:type="list"> <user> <encrypted config:type="boolean">false</encrypted> <user_password>linux</user_password> <username>root</username> </user> </users> </profile>
- 6. How do I do an automatic installation with autodetection of my sound card?
Use the following
sound
section in your profile:<sound> <autoinstall config:type="boolean">true</autoinstall> <configure_detected config:type="boolean">true</configure_detected> </sound>
- 7. I want to install from DVD only. Where do I put the AutoYaST profile?
Put the profile in the root of the DVD. Refer to it with
file:///PROFILE.xml
.
- 8. How can I test a merging process on the command line?
To merge two profiles,
a.xml
withbase.xml
, run the following command:/usr/bin/xsltproc --novalid --param replace "'false'" \ --param dontmerge1 "'package'" --param with "'a.xml'" --output out.xml \ /usr/share/autoinstall/xslt/merge.xslt base.xml
This requires sections in both profiles to be in alphabetical order (<software>, for example, needs to be listed after <add-on>). If you have created the profile with YaST, profiles are automatically sorted correctly.
The
dontmerge1
parameter is optional and an example of what to do when you use thedont_merge
element in your profile. See Section 5.4, “Merging of Rules and Classes” for more information.
- 9. May I call Zypper from scripts?
Zypper can only be called from AutoYaST init scripts, because during the post-script phase, YaST still has an exclusive lock on the RPM database.
If you really need to use other script types (for example a post-script) you will need to break the lock at your own risk:
<post-scripts config:type="list"> <script> <filename>yast_clone.sh</filename> <interpreter>shell</interpreter> <location/> <feedback config:type="boolean">false</feedback> <source><![CDATA[#!/bin/sh mv /var/run/zypp.pid /var/run/zypp.sav zypper in foo mv /var/run/zypp.sav /var/run/zypp.pid ]]></source> </script> </post-scripts>
- 10. Is the order of sections in an AutoYaST profile important?
Actually the order is not important. The order of sections in the profile has no influence on the AutoYaST workflow. However, if you want to merge different profiles, sections need to be in alphabetical order.
- 11.
linuxrc blocks the installation with
File not signed
. I need to manually interact. Linuxrc found some unsigned file (like a driver update). To use an unsigned file, you can suppress that message by passing
insecure=1
to the linuxrc parameter list (together with theautoyast=...
parameter).
- 12. I want to install from DVD/USB/HD but fetch the XML file from the network.
You need to pass
ifcfg
to linuxrc. This is required to set up the network, otherwise AutoYaST cannot download the profile from remote. See Section C.3, “Advanced Network Setup” for more information.
- 13.
Is the installation on an NFS root (
/
) possible? Yes, but it is a little bit “tricky”. You will need to set up the environment (DHCP, TFTP, etc.) very carefully. The AutoYaST profile needs to look like the following:
<?xml version="1.0"?> <!DOCTYPE profile> <profile xmlns="http://www.suse.com/1.0/yast2ns" xmlns:config="http://www.suse.com/1.0/configns"> <partitioning config:type="list"> <drive> <device>/dev/nfs</device> <initialize config:type="boolean">false</initialize> <type config:type="symbol">CT_NFS</type> <partitions config:type="list"> <partition> <filesystem config:type="symbol">nfs</filesystem> <fstopt>nolock</fstopt> <device>10.10.1.53:/tmp/m4</device> <mount>/</mount> </partition> </partitions> <use>all</use> </drive> </partitioning> </profile>
- 14. Where can I ask questions which have not been answered here?
There is an AutoYaST mailing list where you can post your questions. Join us at http://lists.opensuse.org/opensuse-autoinstall/.