[d-i] revisione di boot-usb-files.xml

[Luca Monducci]

Ciao a tutti,

questa è la traduzione di una sezione del nuovo manuale d'installazione
per Debian da revisionare.

Grazie,
Luca


###  boot-usb-files.xml  ###
<!-- retain these comments for translator revision tracking -->
<!-- original version: 25496 -->

 <sect1 condition="bootable-usb" id="boot-usb-files">
 <!-- <title>Preparing Files for USB Memory Stick Booting</title> -->
 <title>Preparare i file per l'avvio da penne USB</title>

<para>

<!-- For preparing the USB stick you will need a system where GNU/Linux is
already running and where USB is supported. You should ensure that the
usb-storage kernel module is loaded (<userinput>modprobe
usb-storage</userinput>) and try to find out which SCSI device the USB
stick has been mapped to (in this example
<filename>/dev/sda</filename> is used). To write to your stick, you
will probably have to turn off its write protection switch. -->

Per preparare la penna USB è necessario un sistema GNU/Linux con supporto
USB già funzionante. Si deve controllare che il modulo del kernel usb-storage
sia caricato (<userinput>modprobe usb-storage</userinput>) e si deve scoprire
su quale device SCSI è stata mappata la penna USB (in questo esempio è usato
<filename>/dev/sda</filename>). Probabilmente per scrivere sulla penna è
necessario disattivare la protezione dalla scrittura.

</para><para>

<!-- Note, that the USB stick should be at least 128 MB in size (smaller
setups are possible if you follow <xref linkend="usb-copy-flexible"/>). -->

Notare che la penna USB deve essere da almeno 128&nbsp;MB (è possibile fare
anche installazioni più piccole seguendo <xref linkend="usb-copy-flexible"/>).

</para>

  <sect2 id="usb-copy-easy">
  <!--<title>Copying the files &mdash; the easy way</title> -->
  <title>Copia dei file &mdash; il modo semplice</title>

<para arch="i386">

<!-- There is an all-in-one file <filename>hd-media/boot.img.gz</filename>
which contains all the installer files (including the kernel) as well
as <command>SYSLINUX</command> and its configuration file. You only
have to extract it directly to your USB stick: -->

C'è un file all-in-one <filename>hd-media/boot.img.gz</filename> che
contiene non solo tutti i file dell'installatore (kernel compreso) ma
anche <command>SYSLINUX</command> e il suo file di configurazione. È
sufficiente estrarlo direttamente sulla penna USB:

<informalexample><screen>
# zcat boot.img.gz &gt; /dev/<replaceable>sda</replaceable>
</screen></informalexample>

<!-- Of course this will destroy anything already on the device, so take
care that you use the correct device name for your USB stick. -->

Ovviamente questo comando distrugge qualunque cosa sia presente sul device,
quindi fare attenzione a usare il nome di device della penna USB.

</para><para arch="powerpc">

<!-- There is an all-in-one file <filename>hd-media/boot.img.gz</filename>
which contains all the installer files (including the kernel) as well
as <command>yaboot</command> and its configuration file. Create a
partition of type "Apple_Bootstrap" on your USB stick using
<command>mac-fdisk</command>'s <userinput>C</userinput> command and
extract the image directly to that: -->

C'è un file all-in-one <filename>hd-media/boot.img.gz</filename> che
contiene non solo tutti i file dell'installatore (kernel compreso) ma
anche <command>yaboot</command> e il suo file di configurazione. Creare
una partizione di tipo "Apple_Bootstrap" sulla penna USB usando il comando
<userinput>C</userinput> di <command>mac-fdisk</command> ed estrarre
l'immagine direttamente sulla penna USB:

<informalexample><screen>
# zcat boot.img.gz &gt; /dev/<replaceable>sda2</replaceable>
</screen></informalexample>

<!-- Of course this will destroy anything already on the device, so take
care that you use the correct device name for your USB stick. -->

Ovviamente questo comando distrugge qualunque cosa sia presente sul device,
quindi fare attenzione a usare il nome di device della penna USB.

</para><para>

<!-- After that, mount the USB memory stick (<userinput>mount
<replaceable arch="i386">/dev/sda</replaceable>
<replaceable arch="powerpc">/dev/sda2</replaceable>
/mnt</userinput>), which will now have
<phrase arch="i386">a FAT filesystem</phrase>
<phrase arch="powerpc">an HFS filesystem</phrase>
on it, and copy a Debian netinst or businesscard ISO image to it.
Please note that the file name must end in <filename>.iso</filename>.
Unmount the stick (<userinput>umount /mnt</userinput>) and you are done. -->

Poi montare la penna USB (<userinput>mount
<replaceable arch="i386">/dev/sda</replaceable>
<replaceable arch="powerpc">/dev/sda2</replaceable>
/mnt</userinput>), che adesso avrà
<phrase arch="i386">un filesystem FAT,</phrase>
<phrase arch="powerpc">un filesystem HFS,</phrase>
e copiarci l'immagine ISO netinst o businesscard Debian. Si noti che il nome
del file deve avere estensione <filename>.iso</filename>. Infine smontare la
penna (<userinput>umount /mnt</userinput>).

</para>
  </sect2>

  <sect2 id="usb-copy-flexible">
  <!-- <title>Copying the files &mdash; the flexible way</title> -->
  <title>Copia dei file &mdash; il modo flessibile</title>

<para>

<!-- If you like more flexibility or just want to know what's going on, you
should use the following method to put the files on your stick. -->

Se si preferisce avere più flessibilità o semplicemente si vuole capire
cosa si sta facendo si deve usare questo metodo per scrivere i file sulla
penna.

</para>

&usb-setup-i386.xml;
&usb-setup-powerpc.xml;

   <sect3>
   <!-- <title>Adding an ISO image</title> -->
   <title>Aggiungere una immagine ISO</title>

<para>

<!-- Now you should put any Debian ISO image (businesscard, netinst or even
a full one) onto your stick (if it fits). The file name of such an
image must end in <filename>.iso</filename>. -->

Adesso si deve copiare una qualsiasi immagine ISO (businesscard, netinst o
persino una completa se c'entra) sulla propria penna. Il nome del file
immagine deve avere estensione <filename>.iso</filename>.

</para><para>

<!-- If you want to install over the network, without using an ISO image,
you will of course skip the previous step. Moreover you will have to
use the initial ramdisk from the <filename>netboot</filename>
directory instead of the one from <filename>hd-media</filename>,
because <filename>hd-media/initrd.gz</filename> does not have network
support. -->

Se si vuole installare usando la rete, senza usare una immagine ISO, si deve
saltare il passo precedente ma è necessario usare il ramdisk iniziale nella
directory <filename>netboot</filename> al posto di quello in
<filename>hd-media</filename> perché in <filename>hd-media/initrd.gz</filename>
non c'è il supporto per la rete.

</para><para>

<!-- When you are done, unmount the USB memory stick (<userinput>umount
/mnt</userinput>) and activate its write protection switch. -->

Conclusa la copia dei file, smontare la penna USB (<userinput>umount
/mnt</userinput>) e attivare la protezione dalla scrittura.

</para>
   </sect3>

   <!-- TODO: doesn't this section belong later? -->
   <sect3 arch="i386">
   <!-- <title>Booting the USB stick</title> -->
   <title>Avvio dalla penna USB</title>

<warning><para>

<!-- If your system refuses to boot from the memory stick, the stick may
contain an invalid master boot record (MBR). To fix this, use the
<command>install-mbr</command> command from the package
<classname>mbr</classname>: -->

Se il proprio sistema rifiuta di partire dalla penna, la penna potrebbe
contenere un MBR (master boot record) non valido. Per risolvere questo
problema usare il comando <command>install-mbr</command> contenuto nel
pacchetto <classname>mbr</classname>:

<informalexample><screen>
# install-mbr /dev/<replaceable>sda</replaceable>
</screen></informalexample>

</para></warning>
   </sect3>
  </sect2>
 </sect1>


###  usb-setup/i386.xml  ###
<!-- retain these comments for translator revision tracking -->
<!-- original version: 24663 -->

   <sect3 arch="i386">
   <!-- <title>USB stick partitioning on &arch-title;</title> -->
   <title>Partizionamento della penna USB su &arch-title;</title>

<para>

<!-- We will show how to setup the memory stick to use the first partition,
instead of the entire device. -->

Verrà spiegato come impostare la penna per usare solo la prima partizione
anziché l'intero dispositivo.

</para><note><para>

<!-- Since most USB sticks come pre-configured with a single FAT16
partition, you probably won't have to repartition or reformat the
stick.  If you have to do that anyway, use <command>cfdisk</command>
or any other partitioning tool for creating a FAT16 partition and then
create the filesystem using: -->

Poiché la maggior parte delle penne USB viene venduta con una singola
partizione FAT16 già configurata, probabilmente non è necessario
ripartizionare o riformattare la penna. Se la si vuole ripartizionare
ugualmente usare <command>cfdisk</command> o un qualsiasi altro programma
di partizionamento per creare una partizione FAT16 e poi crearci un
filesystem usando:

<informalexample><screen>
# mkdosfs /dev/<replaceable>sda1</replaceable>
</screen></informalexample>

<!-- Take care that you use the correct device name for your USB stick. The
<command>mkdosfs</command> command is contained in the
<classname>dosfstools</classname> Debian package. -->

Fare attenzione a usare il nome di device della penna USB. Il
comando <command>mkdosfs</command> è contenuto nel pacchetto Debian
<classname>dosfstools</classname>.

</para></note><para>

<!-- In order to start the kernel after booting from the USB stick, we will
put a boot loader on the stick. Although any boot loader
(e.g. <command>LILO</command>) should work, it's convenient to use
<command>SYSLINUX</command>, since it uses a FAT16 partition and can
be reconfigured by just editing a text file. Any operating system
which supports the FAT file system can be used to make changes to the
configuration of the boot loader. -->

Per far partire il kernel dopo aver avviato da un penna USB è necessario
mettere un bootloader sulla penna. Nonostante il fatto che qualsiasi
bootloader (p.e. <command>LILO</command>) dovrebbe funzionare è più
comodo usare <command>SYSLINUX</command> dato che utilizza una partizione
FAT16 e può essere riconfigurato semplicemente modificando un file di
testo. Qualsiasi sistema operativo con supporto per il filesystem FAT può
essere usato per fare delle modifiche alla configurazione del bootloader.

</para><para>

<!-- To put <command>SYSLINUX</command> on the FAT16 partition on your USB
stick, install the <classname>syslinux</classname> and
<classname>mtools</classname> packages on your system, and do: -->

Per collocare <command>SYSLINUX</command> sulla partizione FAT16 della
penna USB installare i pacchetti <classname>syslinux</classname> e
<classname>mtools</classname> ed eseguire:

<informalexample><screen>
# syslinux /dev/<replaceable>sda1</replaceable>
</screen></informalexample>

<!-- Again, take care that you use the correct device name. The partition
must not be mounted when starting <command>SYSLINUX</command>. This
procedure writes a boot sector to the partition and creates the file
<filename>ldlinux.sys</filename> which contains the boot loader code. -->

Di nuovo fare attenzione a usare il nome corretto del device. La partizione
non deve essere montata quando si avvia <command>SYSLINUX</command>, la
procedura scrive il settore di avvio sulla partizione e crea il file
<filename>ldlinux.sys</filename> che contiene il codice del bootloader.

</para><para>

<!-- Mount the partition (<userinput>mount /dev/sda1 /mnt</userinput>) and
copy the following files from the Debian archives to the stick: -->

Montare la partizione (<userinput>mount /dev/sda1 /mnt</userinput>) e
copiare i seguenti file dall'archivio Debian sulla penna:

<itemizedlist>
<listitem><para>

<!-- <filename>vmlinuz</filename> (kernel binary) -->

<filename>vmlinuz</filename> (kernel)

</para></listitem>
<listitem><para>

<!-- <filename>initrd.gz</filename> (initial ramdisk image) -->

<filename>initrd.gz</filename> (immagine del ramdisk iniziale)

</para></listitem>
<listitem><para>

<!-- <filename>syslinux.cfg</filename> (SYSLINUX configuration file) -->

<filename>syslinux.cfg</filename> (file di configurazione di SYSLINUX)

</para></listitem>
<listitem><para>

<!-- Optional kernel modules -->

Moduli del kernel opzionali

</para></listitem>
</itemizedlist>

<!-- If you want to rename the files, please note that
<command>SYSLINUX</command> can only process DOS (8.3) file names. -->

Se si vuole rinominare questi file ricordarsi che <command>SYSLINUX</command>
può gestire solo nomi di file in formato DOS (8.3).

</para><para>

<!-- The <filename>syslinux.cfg</filename> configuration file should
contain the following two lines: -->

Il file di configurazione <filename>syslinux.cfg</filename> deve contenere
le seguenti righe:

<informalexample><screen>
default vmlinuz
append initrd=initrd.gz ramdisk_size=12000 root=/dev/rd/0 init=/linuxrc rw
</screen></informalexample>

<!-- Please note that the <userinput>ramdisk_size</userinput> parameter
may need to be increased, depending on the image you are booting.
If the boot fails, you can try adding <userinput>devfs=mount,dall</userinput>
to the <quote>append</quote> line. -->

Notare che potrebbe essere necessario aumentare il valore del parametro
<userinput>ramdisk_size</userinput> a seconda dell'immagine che si vuole
avviare. Se non si riesce ad avviare provare aggiungendo
<userinput>devfs=mount,dall</userinput> alla riga <quote>append</quote>.

</para>
   </sect3>


###  usb-setup/powerpc.xml  ###
<!-- retain these comments for translator revision tracking -->
<!-- original version: 24663 -->

   <sect3 arch="powerpc">
   <!-- <title>USB stick partitioning on &arch-title;</title> -->
   <title>Partizionamento della penna USB su &arch-title;</title>

<para>

<!-- Most USB sticks do not come pre-configured in such a way that Open
Firmware can boot from them, so you will need to repartition the stick.
On Mac systems, run <userinput>mac-fdisk /dev/sda</userinput>,
initialise a new partition map using the <userinput>i</userinput>
command, and create a new partition of type Apple_Bootstrap using the
<userinput>C</userinput> command. (Note that the first "partition" will
always be the partition map itself.) Then type -->

La maggior parte delle penne USB viene venduta con una configurazione da cui
Open Firmware non può avviare la macchina e quindi è necessario ripartizionare
la penna. Sui sistemi Mac, usando <userinput>mac-fdisk /dev/sda</userinput>,
si deve inizializzare una nuova mappa delle partizioni usando il comando
<userinput>i</userinput> e poi creare una nuova partizione di tipo
Apple_Bootstrap con il comando <userinput>C</userinput> (notare che la prima
partizione è la mappa delle partizioni stessa). Poi eseguire

<informalexample><screen>
$ hformat /dev/<replaceable>sda2</replaceable>
</screen></informalexample>

<!-- Take care that you use the correct device name for your USB stick. The
<command>hformat</command> command is contained in the
<classname>hfsutils</classname> Debian package. -->

Fare attenzione a usare il nome di device della penna USB. Il
comando <command>hformat</command> è contenuto nel pacchetto Debian
<classname>hfsutils</classname>.

</para><para>

<!-- In order to start the kernel after booting from the USB stick, we will
put a boot loader on the stick. The <command>yaboot</command> boot
loader can be installed on an HFS filesystem and can be reconfigured by
just editing a text file. Any operating system which supports the HFS
file system can be used to make changes to the configuration of the boot
loader. -->

Per far partire il kernel dopo aver fatto l'avvio da una penna USB è necessario
mettere un bootloader sulla penna. Su un filesystem HFS è possibile installare
il bootloader <command>yaboot</command> che può essere riconfigurato con la
semplice modifica di un file di testo. Qualsiasi sistema operativo con
supporto per il filesystem HFS può essere usato per fare delle modifiche alla
configurazione del bootloader.

</para><para>

<!-- The normal <command>ybin</command> tool that comes with
<command>yaboot</command> does not yet understand USB storage devices,
so you will have to install <command>yaboot</command> by hand using the
<classname>hfsutils</classname> tools. Type -->

La normale versione del programma <command>ybin</command> contiene una
versione di <command>yaboot</command> che non riconosce i dispositivi di
memorizzazione USB, quindi è necessario installare manualmente
<command>yaboot</command> usando le <classname>hfsutils</classname>. Eseguire

<informalexample><screen>
$ hmount /dev/sda2
$ hcopy -r /usr/lib/yaboot/yaboot :
$ hattrib -c UNIX -t tbxi :yaboot
$ hattrib -b :
$ humount
</screen></informalexample>

<!-- Again, take care that you use the correct device name. The partition
must not be otherwise mounted during this procedure. This procedure
writes the boot loader to the partition, and uses the HFS utilities to
mark it in such a way that Open Firmware will boot it. Having done this,
the rest of the USB stick may be prepared using the normal Unix
utilities. -->

Di nuovo fare attenzione a usare il nome corretto del device. La partizione
non deve essere montata durante questa procedura dato che scrive il
bootloader sulla partizione e usa le utilità per HFS per effettuare le
impostazioni necessarie per l'avvio da Open Firmware. Completata questa fase,
il resto della preparazione della penna USB può essere completata usando le
comuni utilità Unix.

</para><para>

<!-- Mount the partition (<userinput>mount /dev/sda2 /mnt</userinput>) and
copy the following files from the Debian archives to the stick: -->

Montare la partizione (<userinput>mount /dev/sda2 /mnt</userinput>) e
copiare i seguenti file dall'archivio Debian sulla penna:

<itemizedlist>
<listitem><para>

<!-- <filename>vmlinux</filename> (kernel binary) -->

<filename>vmlinuz</filename> (kernel)

</para></listitem>
<listitem><para>

<!-- <filename>initrd.gz</filename> (initial ramdisk image) -->

<filename>initrd.gz</filename> (immagine del ramdisk iniziale)

</para></listitem>
<listitem><para>

<!-- <filename>yaboot.conf</filename> (yaboot configuration file) -->

<filename>yaboot.conf</filename> (file di configurazione di yaboot)

</para></listitem>
<listitem><para>

<!-- <filename>boot.msg</filename> (optional boot message) -->

<filename>boot.msg</filename> (messaggio opzionale di avvio)

</para></listitem>
<listitem><para>

<!-- Optional kernel modules -->

Moduli del kernel opzionali

</para></listitem>
</itemizedlist>

</para><para>

<!-- The <filename>yaboot.conf</filename> configuration file should
contain the following lines: -->

Il file di configurazione <filename>yaboot.conf</filename> deve contenere
le seguenti righe:

<informalexample><screen>
default=install
root=/dev/ram

message=/boot.msg

image=/vmlinux
        label=install
        initrd=/initrd.gz
        initrd-size=10000
        append="devfs=mount,dall --"
        read-only
</screen></informalexample>

<!-- Please note that the <userinput>initrd-size</userinput> parameter
may need to be increased, depending on the image you are booting. -->

Notare che potrebbe essere necessario aumentare il valore del parametro
<userinput>ramdisk_size</userinput> a seconda dell'immagine che si vuole
avviare.

</para>
   </sect3>