public inbox for gentoo-docs-it@lists.gentoo.org
 help / color / mirror / Atom feed
* [gentoo-docs-it] openrc-migration.xml : dubbi e revisione pre-commit
@ 2008-05-06 10:20 Marcello Magaldi
  2008-05-06 13:04 ` Andrea Menegolo
  0 siblings, 1 reply; 6+ messages in thread
From: Marcello Magaldi @ 2008-05-06 10:20 UTC (permalink / raw
  To: gentoo-docs-it

[-- Attachment #1: Type: text/plain, Size: 428 bytes --]

Ciao,
come mio solito prima di aprire il bug vi pubblico il mio lavoro su
openrc-migration.xml , vi allego anche un file di testo con un paio di
dubbi che ho avuto nella traduzione.
Mi scuso se ho tardato a finire il lavoro ma ho avuto problemi tecnici
(pc in riparazione) e esami in vista.

Saluti

Marcello Magaldi

PS vi allego anche l'originale inglese così potete confrontare con il
mio lavoro dove necessario

[-- Attachment #2: dubbi-openrc --]
[-- Type: application/octet-stream, Size: 123 bytes --]

causing the rc system to bloat over time. - dubbio su bloat over time
provide it with a fresh boot. - dubbio su fresh boot

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #3: openrc-migration.xml --]
[-- Type: text/xml; name=openrc-migration.xml, Size: 12407 bytes --]

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<!-- $Header: /var/www/viewcvs.gentoo.org/raw_cvs/gentoo/xml/htdocs/doc/en/openrc-migration.xml,v 1.10 2008/04/16 00:40:11 nightmorph Exp $ -->

<guide link="/doc/it/openrc-migration.xml">
<title>Guida alla Migrazione di Baselayout e OpenRC</title>

<author title="Autore">
  <mail link="cardoe"/>
</author>
<author title="Autore">
  <mail link="nightmorph"/>
</author>
<author title="Collaboratore">
  <mail link="uberlord"/>
</author>
<author title="Traduzione">
  <mail link="magowiz@gmail.com">Marcello Magaldi</mail>
</author>

<abstract>
Questa guida illustra come migrare da baselayout-1 a baselayout-2 e OpenRC.
</abstract>

<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>

<version>1.6</version>
<date>2008-04-15</date>

<chapter>
<title>Background</title>
<section>
<title>Cos'è baselayout?</title>
<body>

<p>
Baselayout fornisce un insieme base di file che sono necessari per far 
funzionare adeguatamente tutti i sistemi, come ad esempio <path>/etc/hosts</path>. 
Fornisce anche il layout base del filesystem usato da Gentoo (ad es. le 
directory <path>/etc</path>, <path>/var</path>,<path>/usr</path>, <path>/home</path>).
</p>

</body>
</section>
<section>
<title>Cos'è OpenRC?</title>
<body>

<p>
OpenRC è un sistema rc basato sulle dipendenze che funziona con qualsiasi init
fornito dal sistema, normalmente <path>/sbin/init</path> . Comunque, <e>non</e>
è un sostituto per <path>/sbin/init</path>. L'init di default usato da Gentoo
Linux è <c>sys-apps/sysvinit</c>, mentre Gentoo/FreeBSD utilizza l'init di 
FreeBSD fornito da <c>sys-freebsd/freebsd-sbin</c>.
</p>
</body>
</section>
<section>
<title>Perchè migrare?</title>
<body>

<p>
Inizialmente il sistema rc di Gentoo è stato compilato dentro baselayout 1 e 
scritto interamente in bash. Questo porta a molte limitazioni. Per esempio, 
certe chiamate di sistema hanno bisogno di essere accedute durante il boot e 
ciò ha richiesto l'aggiunta di chiamate basate su C. Ognuna di queste chiamate
era linkata staticamente, facendo in modo che il sistema rc 
causing the rc system to bloat over time.
</p>

<p>
Inoltre, siccome Gentoo si è espansa ad altre piattaforme come Gentoo/FreeBSD e
Gentoo Embedded, è diventato impossibile richiedere a un sistema rc basato su
bash. Questo ha portato allo sviluppo di baselayout 2, che è scritto in C e 
richiede unicamente una shell POSIX-compilant. Durante lo sviluppo di 
baselayout 2, è stato determinato che era più appropriato se baselayout avesse
fornito meramente i file base e il layout del filesystem per Gentoo e il sistema
rc fu spostato in un suo pacchetto. Sicchè abbiamo OpenRC.
</p>

<p>
OpenRC è sviluppato principalmente da <uri link="http://roy.marples.name/openrc">Roy
Marples</uri> e supporta tutte le correnti variazioni di Gentoo (es. Gentoo Linux,
Gentoo/FreeBSD, Gentoo Embedded, e Gentoo Vserver) e altre piattaforme come FreeBSD
e NetBSD.
</p>

</body>
</section>
</chapter>

<chapter>
<title>Migrazione a OpenRC</title>
<section>
<body>

<p>
La migrazione a OpenRC è piuttosto diretta; sarà introdotta come parte del 
proprio processo di aggiornamento dal tuo gestore dei pacchetti. Il passo più
importante attualmente avviene dopo l'installazione dei nuovi pacchetti
<c>>=sys-apps/baselayout-2</c> e <c>sys-apps/openrc</c>. E' <e>critico</e> che 
si esegua <c>dispatch-conf</c> e che si assicuri che il proprio <path>/etc</path>
è aggiornato prima di riavviare. <brite>Un fallimento nel farlo produrrà un 
sistema non più avviabile</brite> e richiederà l'uso del Gentoo LiveCD per 
effettuare i passaggi seguenti per riparare il proprio sistema.
</p>

<p>
Una volta finito di aggiornare i propri file di configurazione, ci sono alcune
cose da verificare prima di riavviare.
</p>
	
</body>
</section>

<section id="rc_conf">
<title>/etc/conf.d/rc</title>
<body>

<p>
Il file <path>/etc/conf.d/rc</path> è stato deprecato e tutte le impostazioni
in esso contenute avranno bisogno di essere trasferite alle impostazioni 
appropriate in <path>/etc/rc.conf</path>. Si prega di leggere interamente 
<path>/etc/rc.conf</path> e <path>/etc/conf.d/rc</path> e migrare le 
impostazioni. Una volta finito, cancellare <path>/etc/conf.d/rc</path>.
</p>

</body>
</section>
<section id="moduli">
<title>Moduli del Kernel</title>
<body>

<p>
Normalmente, quando si vuole che certi moduli del kernel siano caricati 
all'avvio, li si mette in <path>/etc/modules.autoload.d/kernel-2.6</path>insieme
ad ogni parametro che gli si vuole passare. Nel baselayout-2, questo file non è 
più utilizzato. Invece, i moduli caricati automaticamente e i loro parametri
sono situati in un file, <path>/etc/conf.d/modules</path>, qualsiasi sia la 
versione del kernel.
</p>

<p>
Un esempio di configurazione vecchio stile sarebbe:
</p>

<pre caption="/etc/modules.autoload.d/kernel-2.6">
ivtv
cx88_dvb video_br=2
</pre>

<p>
Convertire l'esempio precedente risulterà nel seguente:
</p>

<pre caption="/etc/conf.d/modules">
<comment># Moduli caricati automaticamente all'avvio</comment>
modules_2_6="ivtv cx88_dvb"
<comment># Parametri dei Moduli</comment>
module_cx88_dvb_args_2_6="video_br=2"
</pre>

<p>
Negli esempi precedenti, i moduli e i loro parametri saranno passati soltanto
ai kernel della serie 2.6.x. La nuova configurazione permette un controllo più
preciso sui moduli e sui parametri basato sulla versione del kernel.
</p>

<p>
Un esempio approfondito sarà:
</p>

<pre caption="esempio dettagliato di /etc/conf.d/modules">
<comment># Carica sempre ochi1394 e ieee1394, per qualsiasi versione di kernel</comment>
modules="ohci1394 ieee1394"
<comment># Carica tun e usbserial solo per i kernel della serie 2.6.x</comment>
modules_2_6="tun usbserial"
<comment># Carica cx88_dvb solo per i kernel 2.6.23</comment>
modules_2_6_23="cx88_dvb"
<comment># Carica ivtv solo per il kernel 2.6.23-gentoo-r5</comment>
modules_2_6_23_gentoo_r5="ivtv"

<comment># Solo per il kernel 2.6.23-gentoo-r5, passa come argomento video_br=2
# a cx88_dvb</comment>
module_cx88_dvb_args_2_6_23_gentoo_r5="video_br=2"
<comment># Per i kernel della serie 2.6.x passa sempre vendor e product</comment>
module_usbserial_args_2_6="vendor=0x1410 product=0x2110"
<comment># Passa sempre debug a ieee1394</comment>
module_ieee1394_args="debug" 
</pre>

<note>
Prego notare la differenza tra <b>module_</b> e <b>modules_</b>.
</note>

</body>
</section>
<section id="boot">
<title>Runlevel di Boot</title>
<body>

<p>
Il runlevel di <c>boot</c> esegue molti passi importanti per ogni macchina. Per
esempio, assicurarsi che il proprio filesystem root sia montato in lettura/scrittura,
che i propri filesystem siano controllati, che i propri mountpoint siano 
disponibili, e che lo pseudp-filesystem <path>/proc</path> sia avviato al boot.
</p>

<p>
Con OpenRC, i servizi di gestione del volume per i propri dispositivi a blocchi
non sono più avviati automaticamente al boot. Questo include lvm, raid, swap,
device-mapper (dm), dm-crypt, evms, e il like. Bisogna assicurarsi che 
l'initscript appropriato per questi servizi nel runlevel di <c>boot</c>, 
altrimenti sarà possibile che il proprio sistema non si avvii!
</p>

<p>
Sebbene l'ebuild di OpenRC proverà a fare questa migrazione, si dovrà
verificare che migri tutti i servizi di gestione di volume propriamente:
</p>

<pre caption="Mostrare tutti i servizi nel boot runlevel">
# <i>ls -l /etc/runlevels/boot/</i>
</pre>

<p>
Se non si vede root, procfs, mtab, swap  e fsck con il precedente comando, 
effettua le seguenti istruzioni per aggiungerli al <c>boot</c> runlevel:
</p>

<pre caption="Aggiungere servizi critici al boot runlevel">
# <i>rc-update add root boot</i>
# <i>rc-update add procfs boot</i>
# <i>rc-update add mtab boot</i>
# <i>rc-update add fsck boot</i>
# <i>rc-update add swap boot</i>
</pre>

<p>
Se si è a conoscenza di utilizzare mdraid e lvm ma non li si vede sopra, si 
dovranno eseguire le seguenti istruzioni per aggiungere gli initscripts al
<c>boot</c> runlevel:
</p>

<pre caption="Aggiungere raid e lvm al boot runlevel">
# <i>rc-update add raid boot</i>
# <i>rc-update add lvm boot</i>
</pre>

</body>
</section>
<section>
<title>Rete</title>
<body>

<p>
Siccome baselayout e OpenRC sono stati divisi in due pacchetti differenti,
il proprio initscript net.eth0 può scomparire durante il processo di 
aggiornamento. Per sostituire questo initscript prego eseguire i seguenti
comandi:
</p>

<pre caption="Riaggiungere lo script net.eth0 mancante">
# <i>cd /etc/init.d</i>
# <i>ln -s net.lo net.eth0</i>
</pre>

<p>
Se manca qualsiasi altro initscript di rete, seguire le istruzioni menzionate 
sopra per riaggiungerlo. Semplicemente si sostituisca <c>eth0</c> con il nome 
del proprio dispositivo di rete.
</p>

<p>
Inoltre, <path>/etc/conf.d/net</path> non utilizza più gli array stile bash per
la configurazione. Prego consultare <path>/usr/share/doc/openrc/net.example</path>
per le istruzioni di configurazione. La conversione dovrebbe essere relativamente
diretta, per esempio un assegnamento statico di IP cambierà in questo modo:
</p>

<pre caption="Vecchio stile di /etc/conf.d/net">
config_eth0=( "192.168.1.37 netmask 255.255.255.0 brd 192.168.1.255" )
routes_eth0=( "default via 192.168.1.100" )
</pre> 

<pre caption="Nuovo stile di /etc/conf.d/net">
config_eth0="192.168.1.37 netmask 255.255.255.0 brd 192.168.1.255"
routes_eth0="default via 192.168.1.100"
</pre>

</body>
</section>
<section>
<title>Orologio</title>
<body>

<p>
Le impostazioni dell'orologio sono state rinominate da <path>/etc/conf.d/clock</path>
al proprio strumento di impostazione di orologio nativo di sistema. Questo 
significa che in Linux sarà <path>/etc/conf.d/hwclock</path> e in FreeBSD sarà 
<path>/etc/conf.d/adjkerntz</path>. L'initscript in <path>/etc/init.d/</path>
è anch'esso stato rinominato conseguentemente, quindi assicurarsi che sia nel 
runlevel appropriato.
</p>

<p>
Inoltre, la variabile <c>TIMEZONE</c>  non è più in questo file. I suoi contenuti
sono invece nel file <path>/etc/timezone</path>.  Se non esiste, bisognerà 
certamente crearlo con il proprio timezone. Prego controllare entrambi questi file
per assicurarsi della loro correttezza.
</p>

<p>
Il valore appropriato per questo file è il path relativo al proprio timezone
a partire da <path>/usr/share/zoneinfo</path>. Per esempio, per quelli che 
vivono nella costa orientale degli Stati Uniti, il seguente sarà una corretta
impostazione:
</p>

<pre caption="/etc/timezone">
America/New_York
</pre>

</body>
</section>
<section>
<title>XSESSION</title>
<body>

<p>
La variabile XSESSION non si trova più in <path>/etc/rc.conf</path>. Il pacchetto
<c>x11-apps/xinit</c> ora fornisce <path>/etc/env.d/90xsession</path>, che può
essere usato per impostare la variabile XSESSION.
</p>

<p>
Questa variabile <b>NON</b> sarà migrata di default, quindi bisognerà modificare
<path>/etc/env.d/90xsession</path>.
</p>

<impo>
Bisogna eseguire <c>env-update</c> dopo aver creato un file in <path>/etc/env.d</path>,
e successivamente effettuare il logout e poi il login perchè abbia effetto.
</impo>

</body>
</section>
<section>
<title>EDITOR / PAGER</title>
<body>

<p>
La variabile EDITOR non si trova più in <path>/etc/rc.conf</path>.  Sia EDITOR
che PAGER sono impostati di default in /etc/profile.  Si dovrebbe cambiare ciò
se se ne ha bisogno nel proprio file <path>~/.bashrc</path> (o equivalente) o 
creare <path>/etc/env.d/99editor</path> e impostare l'impostazione di default
del sistema in esso.
</p>

<impo>
Bisogna eseguire <c>env-update</c> dopo aver creato un file in <path>/etc/env.d</path>,
e successivamente effettuare il logout e poi il login perchè abbia effetto. Se
si è impostato la variabile in <path>~/.bashrc</path>, si può rifare il source
del file con <c>source ~/.bashrc</c>.
</impo>

</body>
</section>
<section>
<title>Finalizzare</title>
<body>

<p>
Una volta terminato e aggiornato i propri file di configurazione e gli 
initscript, l'ultima cosa da fare è <b>reboot</b>. Questo è necessario perchè
le informazioni di stato del sistema non sono preservate durante 
l'aggiornamento, quindi bisognerà fornirle con un boot pulito.
provide it with a fresh
boot.
</p>

</body>
</section>
</chapter>
</guide>

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #4: openrc-migration-en.xml --]
[-- Type: text/xml; name=openrc-migration-en.xml, Size: 11388 bytes --]

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<!-- $Header: /var/www/viewcvs.gentoo.org/raw_cvs/gentoo/xml/htdocs/doc/en/openrc-migration.xml,v 1.10 2008/04/16 00:40:11 nightmorph Exp $ -->

<guide link="/doc/en/openrc-migration.xml">
<title>Baselayout and OpenRC Migration Guide</title>

<author title="Author">
  <mail link="cardoe"/>
</author>
<author title="Author">
  <mail link="nightmorph"/>
</author>
<author title="Contributor">
  <mail link="uberlord"/>
</author>

<abstract>
This guide shows you how to migrate from baselayout-1 to baselayout-2 and
OpenRC.
</abstract>

<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>

<version>1.6</version>
<date>2008-04-15</date>

<chapter>
<title>Background</title>
<section>
<title>What's baselayout?</title>
<body>

<p>
Baselayout provides a basic set of files that are necessary for all systems to
function properly, such as <path>/etc/hosts</path>. It also provides the basic
filesystem layout used by Gentoo (i.e. <path>/etc</path>, <path>/var</path>,
<path>/usr</path>, <path>/home</path> directories).
</p>

</body>
</section>
<section>
<title>What's OpenRC?</title>
<body>

<p>
OpenRC is a dependency-based rc system that works with whatever init is provided
by the system, normally <path>/sbin/init</path>. However, it is <e>not</e> a
replacement for <path>/sbin/init</path>. The default init used by Gentoo Linux
is <c>sys-apps/sysvinit</c>, while Gentoo/FreeBSD uses the FreeBSD init provided
by <c>sys-freebsd/freebsd-sbin</c>.
</p>
</body>
</section>
<section>
<title>So why migrate?</title>
<body>

<p>
Originally Gentoo's rc system was built into baselayout 1 and written entirely
in bash. This led to several limitations. For example, certain system calls need
to be accessed during boot and this required C-based callouts to be added. These
callouts were each statically linked, causing the rc system to bloat over time.
</p>

<p>
Additionally, as Gentoo expanded to other platforms like
Gentoo/FreeBSD and Gentoo Embedded, it became impossible to require a bash-based
rc system. This led to a development of baselayout 2, which is written in
C and only requires a POSIX-compliant shell. During the development of
baselayout 2, it was determined that it was a better fit if baselayout merely
provided the base files and filesystem layout for Gentoo and the rc system
was broken off into its own package. Thus we have OpenRC.
</p>

<p>
OpenRC is primarily developed by <uri link="http://roy.marples.name/openrc">Roy
Marples</uri> and supports all current Gentoo variations (i.e. Gentoo Linux,
Gentoo/FreeBSD, Gentoo Embedded, and Gentoo Vserver) and other platforms such as
FreeBSD and NetBSD.
</p>

</body>
</section>
</chapter>

<chapter>
<title>Migration to OpenRC</title>
<section>
<body>

<p>
Migration to OpenRC is fairly straightforward; it will be pulled in as part of
your regular upgrade process by your package manager. The most important step
actually comes after you install the new <c>>=sys-apps/baselayout-2</c> and
<c>sys-apps/openrc</c> packages. It is <e>critical</e> that you run
<c>dispatch-conf</c> and ensure your <path>/etc</path> is up to date before
rebooting. <brite>Failure to do so will result in an unbootable system</brite>
and will require the use of the Gentoo LiveCD to perform the steps below to
repair your system.
</p>

<p>
Once you've finished updating your config files, there are a few things to
verify prior to rebooting.
</p>
	
</body>
</section>

<section id="rc_conf">
<title>/etc/conf.d/rc</title>
<body>

<p>
<path>/etc/conf.d/rc</path> has been deprecated and any settings you have in
there will need to be migrated to the appropriate settings in
<path>/etc/rc.conf</path>. Please read through <path>/etc/rc.conf</path> and
<path>/etc/conf.d/rc</path> and migrate the settings. Once you are complete,
delete <path>/etc/conf.d/rc</path>.
</p>

</body>
</section>
<section id="modules">
<title>Kernel modules</title>
<body>

<p>
Normally, when you want certain kernel modules automatically loaded at boot, you
place them into <path>/etc/modules.autoload.d/kernel-2.6</path> along with any
parameters you wanted to pass to them. In baselayout-2, this file is not used
anymore. Instead, autoloaded modules and module parameters are placed in one
file, <path>/etc/conf.d/modules</path>, no matter the kernel version.
</p>

<p>
An example old style configuration would be:
</p>

<pre caption="/etc/modules.autoload.d/kernel-2.6">
ivtv
cx88_dvb video_br=2
</pre>

<p>
Converting the above example would result in the following:
</p>

<pre caption="/etc/conf.d/modules">
<comment># Modules autoloaded at boot</comment>
modules_2_6="ivtv cx88_dvb"
<comment># Module parameters</comment>
module_cx88_dvb_args_2_6="video_br=2"
</pre>

<p>
In the above examples, the modules and their parameters would only be passed
to 2.6.x series kernels. The new configuration allows for fine grained
control over the modules and parameters based on kernel version.
</p>

<p>
An in-depth example would be:
</p>

<pre caption="detailed example of /etc/conf.d/modules">
<comment># Always load ochi1394 and ieee1394, no matter the kernel version</comment>
modules="ohci1394 ieee1394"
<comment># Only load tun and usbserial for 2.6.x series kernels</comment>
modules_2_6="tun usbserial"
<comment># Only load cx88_dvb for 2.6.23 kernels</comment>
modules_2_6_23="cx88_dvb"
<comment># Only load ivtv for 2.6.23-gentoo-r5</comment>
modules_2_6_23_gentoo_r5="ivtv"

<comment># For 2.6.23-gentoo-r5, pass video_br=2 to cx88_dvb</comment>
module_cx88_dvb_args_2_6_23_gentoo_r5="video_br=2"
<comment># For 2.6.x series kernels, always pass vendor and product</comment>
module_usbserial_args_2_6="vendor=0x1410 product=0x2110"
<comment># Always pass debug to ieee1394</comment>
module_ieee1394_args="debug" 
</pre>

<note>
Please note the difference between <b>module_</b> and <b>modules_</b>.
</note>

</body>
</section>
<section id="boot">
<title>Boot runlevel</title>
<body>

<p>
The <c>boot</c> runlevel performs several important steps for every machine. For
example, making sure your root filesystem is mounted read/write, that your
filesystems are checked for errors, that your mountpoints are available, and
that the <path>/proc</path> pseudo-filesystem is started at boot.
</p>

<p>
With OpenRC, volume management services for your block storage devices are no
longer run automatically at boot. This includes lvm, raid, swap, device-mapper
(dm), dm-crypt, evms, and the like. You must ensure the appropriate initscript
for these services is in the <c>boot</c> runlevel, otherwise it's possible that
your system will not boot!
</p>

<p>
While the OpenRC ebuild will attempt to do this migration for you, you should
verify that it migrated all the volume management services properly:
</p>

<pre caption="Display all services in boot runlevel">
# <i>ls -l /etc/runlevels/boot/</i>
</pre>

<p>
If you don't see root, procfs, mtab, swap, and fsck in the above listing,
perform the following to add them to the <c>boot</c> runlevel:
</p>

<pre caption="Adding critical services to the boot runlevel">
# <i>rc-update add root boot</i>
# <i>rc-update add procfs boot</i>
# <i>rc-update add mtab boot</i>
# <i>rc-update add fsck boot</i>
# <i>rc-update add swap boot</i>
</pre>

<p>
If you know you use mdraid and lvm but do not see them above, you would run
the following to add initscripts to the <c>boot</c> runlevel:
</p>

<pre caption="Adding raid and lvm to the boot runlevel">
# <i>rc-update add raid boot</i>
# <i>rc-update add lvm boot</i>
</pre>

</body>
</section>
<section>
<title>Network</title>
<body>

<p>
Due to baselayout and OpenRC being broken into two different packages, your
net.eth0 initscript may disappear during the upgrade process. To replace this
initscript please perform the following:
</p>

<pre caption="Adding back missing net.eth0 script">
# <i>cd /etc/init.d</i>
# <i>ln -s net.lo net.eth0</i>
</pre>

<p>
If you are missing any other network initscripts, follow the instructions above
to re-add them. Simply replace <c>eth0</c> with the name of your network
device.
</p>

<p>
Also, <path>/etc/conf.d/net</path> no longer uses bash-style arrays for
configuration. Please review <path>/usr/share/doc/openrc/net.example</path> for
configuration instructions. Conversion should be relatively straight-forward,
for example a static IP assignment would change as follows:
</p>

<pre caption="Old /etc/conf.d/net style">
config_eth0=( "192.168.1.37 netmask 255.255.255.0 brd 192.168.1.255" )
routes_eth0=( "default via 192.168.1.100" )
</pre> 

<pre caption="New /etc/conf.d/net style">
config_eth0="192.168.1.37 netmask 255.255.255.0 brd 192.168.1.255"
routes_eth0="default via 192.168.1.100"
</pre>

</body>
</section>
<section>
<title>Clock</title>
<body>

<p>
Clock settings have been renamed from <path>/etc/conf.d/clock</path> to your
system's native tool for adjusting the clock. This means on Linux it will be
<path>/etc/conf.d/hwclock</path> and on FreeBSD it will be
<path>/etc/conf.d/adjkerntz</path>. The initscript in <path>/etc/init.d/</path>
has also been renamed accordingly, so make sure it's in the appropriate
runlevel.
</p>

<p>
Additionally, the <c>TIMEZONE</c> variable is no longer in this file. Its
contents are instead found in the <path>/etc/timezone</path> file. If it
doesn't exist, you will of course have to create it with your timezone. Please
review both of these files to ensure their correctness.
</p>

<p>
The proper value for this file is the path relative to your timezone from
<path>/usr/share/zoneinfo</path>. For example, for someone living on the east
coast of the United States, the following would be a correct setting:
</p>

<pre caption="/etc/timezone">
America/New_York
</pre>

</body>
</section>
<section>
<title>XSESSION</title>
<body>

<p>
The XSESSION variable is no longer found in <path>/etc/rc.conf</path>. The
<c>x11-apps/xinit</c> package now provides <path>/etc/env.d/90xsession</path>,
which can be used to set the XSESSION variable.
</p>

<p>
This variable will <b>NOT</b> be migrated for you by default, so you will need
to edit <path>/etc/env.d/90xsession</path>.
</p>

<impo>
You must run <c>env-update</c> after creating a file in <path>/etc/env.d</path>,
and then logout and login for it to take effect.
</impo>

</body>
</section>
<section>
<title>EDITOR / PAGER</title>
<body>

<p>
The EDITOR variable is no longer found in <path>/etc/rc.conf</path>.  Both
EDITOR and PAGER are set by default in /etc/profile.  You should change this as
needed in your <path>~/.bashrc</path> (or equivalent) file or create
<path>/etc/env.d/99editor</path> and set the system default there.
</p>

<impo>
You must run <c>env-update</c> after creating a file in <path>/etc/env.d</path>,
and then logout and login for it to take effect. If you set the variable in
<path>~/.bashrc</path>, you can re-source the file with <c>source
~/.bashrc</c>.
</impo>

</body>
</section>
<section>
<title>Finishing up</title>
<body>

<p>
Once you've finished updating your config files and initscripts, the last thing
to do is <b>reboot</b>. This is necessary because system state information is
not preserved during the upgrade, so you'll need to provide it with a fresh
boot.
</p>

</body>
</section>
</chapter>
</guide>

^ permalink raw reply	[flat|nested] 6+ messages in thread
end of thread, other threads:[~2008-05-07  9:27 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2008-05-06 10:20 [gentoo-docs-it] openrc-migration.xml : dubbi e revisione pre-commit Marcello Magaldi
2008-05-06 13:04 ` Andrea Menegolo
2008-05-06 14:36   ` Marcello Magaldi
2008-05-06 14:43   ` Marcello Magaldi
2008-05-06 15:39   ` Marcello Magaldi
2008-05-07  9:27     ` Marcello Magaldi

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox