old-www/HOWTO/Network-Install-HOWTO-5.html

288 lines
13 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
<TITLE>Network Install HOWTO: SuSE Client Install</TITLE>
<LINK HREF="Network-Install-HOWTO-6.html" REL=next>
<LINK HREF="Network-Install-HOWTO-4.html" REL=previous>
<LINK HREF="Network-Install-HOWTO.html#toc5" REL=contents>
</HEAD>
<BODY>
<A HREF="Network-Install-HOWTO-6.html">Next</A>
<A HREF="Network-Install-HOWTO-4.html">Previous</A>
<A HREF="Network-Install-HOWTO.html#toc5">Contents</A>
<HR>
<H2><A NAME="s5">5. SuSE Client Install</A></H2>
<P>
<!--
network install!suse client install
-->
You should have already decided by now using the
<A HREF="Network-Install-HOWTO-3.html#quickguide">Quick Guide</A> section
of this HOWTO whether you are going to install your machine using the automated
process or a manual process. The automated process under SuSE is known as
AutoYaST and in short provides you with a configuration file for the machine
that you are going to install so that you can perform unattended installs of
client machines.
<P>
<P>
<H2><A NAME="ss5.1">5.1 Create AutoYaST Config Files</A>
</H2>
<P>You only need to read/follow this section if you are intending to use an
automated install process, if you intend to do a manual installation over
your network then skip this section. Here we go through the process of creating
configuration files that the installer will read in order to create the
configuration of our client machine we are installing during an unattended
network installation.
<P>
<P>
<H3>YaST 2 Module Installation</H3>
<P>In order to start creating your config files you will need to install the
AutoYaST module for YaST2 on your SuSE machine. You will need three RPMs for
this, all of which are on your SuSE source media e.g. CDs. The three RPMs are:
<UL>
<LI>yast2-trans-autoinst</LI>
<LI>yast2-config-autoinst</LI>
<LI>yast2-module-autoinst</LI>
</UL>
<P>Check to see if you already have them installed with the command:
<PRE>
rpm -q {rpm package name}
</PRE>
<P>If these packages are not installed then install with the command:
<PRE>
rpm -Uvh {rpm package name}
</PRE>
<P>
<P>
<H3><A NAME="susebasicconfig"></A> Create A Basic Config File </H3>
<P>Once you have confirmed that you have the AutoYaST packages installed on your
system, you can now start to create configuration files. For most situations
the basic configuration described here will be sufficient to perform your
installations.
<P>Start the YaST2 Autoinstall configuration GUI with the command:
<PRE>
yast2 autoyast
</PRE>
<P>You will now be presented with a window that allows you to configure most of
your installation options as if you were installing a new machine or performing
an upgrade. You can proceed through the menu system configuring your options
for a particular system or set of similar systems that you wish to automatically
install. Alternatively, you can create class definitions which allows you to
save different parts of the configuration setup and then use different classes
for different sets of machines.
<P>The use of classes is particularly good when you have a set of systems that are
similar but that you would like installed in slightly different ways. For
example, you could create a class definition for the hardware setup of all your
client machines and create a separate class for the packages you want installed
on them, whether they are server machines, test machines, workstations, etc.
You can then choose which classes are used by which machines when they are
installed. In our example here, all the machines would use the same hardware
setup, but the workstation machines could install our workstation class of
packages, test machines the test class, etc.
<P>Once you have progressed through each configuration screen in the config setup
GUI from YaST2 you are ready to save out your configuration file to disk. <EM>NOTE: it is outside the boundaries of this document to take you through each
configuration option for installation, we are just concerned with the principles
of network installs here. Please consult your SuSE documentation or
the
<A HREF="http://www.suse.com">SuSE Website</A> for this information.</EM>
<P>When you save your configuration files they will be stored locally in two
different locations depending on what file you have created as follows:
<UL>
<LI>Machine configuration files are stored in <CODE>/var/lib/autoinstall/repository</CODE></LI>
<LI>Class definition files are stored in <CODE>/var/lib/autoinstall/classes</CODE></LI>
</UL>
<P>
<P>
<H3>Advanced Config File Setup</H3>
<P>Before attempting advanced configuration please make sure that you have first
created a valid basic configuration file as described
<A HREF="#susebasicconfig">above</A>.
It is perfectly possible to create your own configuration files from scratch
but it is far easier to use the tools provided to do the job for you!
<P>Once you have your configuration file saved, you can open it in your favourite
text editor. The file is in XML format so it is particularly easy to follow and
edit manually. You can use or modify any of the existing tags in your file,
just so long as the tags, options, and syntax you use are legal. A full guide
to the tags and their usage can be found in the AutoYaST manual, please see
<A HREF="Network-Install-HOWTO-10.html#AppendixA">Appendix A</A> of this guide for a reference.
<P>The best use of editing the configuration file manually is probably for adding
your own customised packages to the installation. Back in
the
<A HREF="Network-Install-HOWTO-4.html#susecustomrpm">SuSE Server Setup</A> section we describe how to
add your own customised packages to your install server. Here, we describe how
to access those packages using the configuration file so they can be
automatically installed with the rest of the system.
<P>You should be able to locate a <CODE>&lt;software&gt;</CODE> section in your basic
configuration file in your editor. You can use a sub-tag inside the software
section called the <CODE>&lt;extra_packages&gt;</CODE> tag which can be used as in
the following example:
<PRE>
&lt;software&gt;
&lt;extra_packages&gt;
&lt;package_location&gt;
custom
&lt;/package_location&gt;
&lt;packages config:type="list"&gt;
&lt;package&gt;{Your package name}&lt;/package&gt;
&lt;package&gt;{Another Package}&lt;/package&gt;
&lt;/packages&gt;
&lt;extra_packages&gt;
&lt;base&gt;Default&lt;base&gt;
&lt;software&gt;
</PRE>
<P>The package location is written as <CODE>custom</CODE> which describes the directory
under the <CODE>suse</CODE> directory of you install server where you have put your
custom packages, in our example this would be <CODE>/install/suse/custom</CODE>,
but you only need to write <CODE>custom</CODE> here.
<P>You can include as many <CODE>package</CODE> tags under the <CODE>packages</CODE>
section as you wish. Use one <CODE>package</CODE> tag for each custom package you
want to include in your config file and install on the client machine.
<P>The <CODE>base</CODE> tag at the bottom should be left as you configured it during
the basic configuration.
<P>Save your modified configuration file from your text editor and it will then be
ready to use in your installations as described below.
<P>
<P>
<H2><A NAME="ss5.2">5.2 Boot the Machine</A>
</H2>
<P>There are different situations during a network installation boot of one of your
client systems that might mean that you wish to boot in one of the ways below.
<EM>NOTE: you only need use one of the methods described for the particular
usage for which it has been described.</EM>
<P>
<P>
<H3>Manual Installation</H3>
<P>If you skipped over the section above about creating AutoYaST config files then
this is the way in which you should boot your client machines.
<OL>
<LI>Turn on your machine, ensure the CD drive is in the boot list of your
BIOS, insert the CD. You should be faced with the normal boot menu of the SuSE
installation program. As an alternative to booting from CD, you can boot from
floppy images, from the network, or using whichever method you would normally
use to boot the installation program.</LI>
<LI>Select the "Manual Installation" option from the boot menu</LI>
<LI>Your client should now boot the installation program and present you with
a new menu system for the installer</LI>
<LI>Load any network modules you will need in order to connect to your network</LI>
<LI>Load any other modules you might need for installation e.g. SCSI modules
if you are installing onto a SCSI type machine.</LI>
<LI>Select "Start Installation" from the menu</LI>
<LI>Choose the NFS option and fill in the IP addresses when prompted for.
These should all be familiar to you i.e. the IP address of your server, and
perhaps your client and nameserver as well if you have not selected to use DHCP.</LI>
<LI>The installation will now proceed to the configuration screens where you
can select the installation options you require for your client in the normal
way</LI>
<LI>Once you have configured all the installation options and selected to
start the installation process, instead of reading from the normal CD (or other)
media, the installation program will read all the information it needs from the
network.</LI>
<LI>Don't forget to remove the CD (or other media) from the drive otherwise
you could end up with a recursive installation process.</LI>
<LI>Go grab a cup of something while you wait for your shiny new installation
to finish, no changing of installation media needed.</LI>
</OL>
<P>
<P>
<H3>Automatic Installation</H3>
<P>If you followed the section above about creating AutoYaST config files then this
is the way in which you should boot your client machines.
<OL>
<LI>Copy your config file that you have already created as above from your
repository directory on your hard disk to your floppy disk as a file called
autoinst.xml. You can do this as follows:
<PRE>
Insert and mount a floppy disk
cp /var/lib/autoinstall/repository/Your-File /dev/fd0/autoinst.xml
Unmount the floppy disk
</PRE>
</LI>
<LI>Put your floppy disk with the config file in your client machine</LI>
<LI>Turn on your machine, ensure the CD drive is in the boot list of your
BIOS, insert the CD. You should be faced with the normal boot menu of the SuSE
installation program. As an alternative to booting from CD, you can boot from
floppy images, from the network, or using whichever method you would normally
use to boot the installation program.</LI>
<LI>At the boot menu leave the default line as Linux to do the standard boot,
but add the following parameters in order to read your configuration file from
the floppy disk:
<PRE>
linux autoyast=floppy
</PRE>
</LI>
<LI>Your client should now boot the installation program and it will try to
load appropriate modules and install the system with the information that you
have provided in the config file.</LI>
<LI>If you are prompted to input any information for any reason then do so
e.g. if the installer cannot connect to your network.</LI>
<LI>Once the installation is running then you can remove the CD and the floppy
disk and grab a cup of something while you wait for your shiny new installation
to finish, no changing of installation media needed.</LI>
</OL>
<P>
<P>
<H3>Further Boot Options</H3>
<P>This is an extension to the technique used to boot client machines for Automatic
Installations as described above. You should try this method if you have tried
and failed with the method above. This section should help you if you have had
network connection problems during boot, for example, if you do not have a DHCP
server on your network.
<P>You can create what we call an "<EM>info</EM>" file to hold information about
your clients network details. This can then be used more explicitly by the
install process to contact your network. This is a plain text file in which
you put certain keyword and value combinations that are recognised by the
installer.
<P>The list of keywords you can use is as follows:
<UL>
<LI>autoyast - the location of your configuration file</LI>
<LI>gateway - the gateway your client should use (if any)</LI>
<LI>insmod - any special kernel modules you need to be loaded</LI>
<LI>install - a full path to your server installation directory</LI>
<LI>ip - the address of your client machine. If this is blank then the
installer will try BOOTP/DHCP</LI>
<LI>nameserver - the nameserver address on your network</LI>
<LI>netdevice - the network adaptor you want to be used</LI>
<LI>netmask - your client's netmask</LI>
<LI>server - the hostname or IP address of the server you have set up i.e. the
machine you have your NFS exports from</LI>
<LI>serverdir - the directory on your server the installation should be taken
from</LI>
</UL>
<P>Using the above keywords in an example info file, you <EM>might</EM> end up with
something looking a little bit like this:
<PRE>
install: nfs://10.0.0.100/install/SuSE8.0
netdevice: eth0
server: 10.0.0.100
serverdir: /install/SuSE8.0
ip: 10.0.0.200
netmask: 255.0.0.0
gateway: 10.0.0.1
nameserver: 10.0.0.2
autoyast: floppy
</PRE>
<P>Substitute the IP addresses above for relevant ones for your particular network
and save this file with filename <CODE>info</CODE> in the root directory of your
floppy disk that contains your configuration file <CODE>autoinst.xml</CODE>
<P>
<P>
<P>
<P>
<HR>
<A HREF="Network-Install-HOWTO-6.html">Next</A>
<A HREF="Network-Install-HOWTO-4.html">Previous</A>
<A HREF="Network-Install-HOWTO.html#toc5">Contents</A>
</BODY>
</HTML>