summaryrefslogtreecommitdiff
blob: 9e2476faae11872be8e432b5fdfcf4323407e1aa (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2010-10-21 23:56+0600\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(guide:link):5
msgid "/doc/en/openrc-migration.xml"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(title):6
msgid "Baselayout and OpenRC Migration Guide"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(author:title):8 ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(author:title):11
msgid "Author"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(mail:link):9
msgid "cardoe"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(mail:link):12
msgid "nightmorph"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(author:title):14
msgid "Contributor"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(mail:link):15
msgid "uberlord"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(abstract):18
msgid "This guide shows you how to migrate from baselayout-1 to baselayout-2 and OpenRC."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(version):27
msgid "2"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(date):28
msgid "2010-07-20"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(title):31
msgid "Background"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(title):33
msgid "What's baselayout?"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):36
msgid "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)."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(title):46
msgid "What's OpenRC?"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):49
msgid "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>."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(title):60
msgid "So why migrate?"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):63
msgid "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."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):70
msgid "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."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):80
msgid "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."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(title):92
msgid "Migration to OpenRC"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):96
msgid "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>&gt;=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."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):107
msgid "Once you've finished updating your config files, there are a few things to verify prior to rebooting."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(title):116
msgid "/etc/conf.d/rc"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):119
msgid "<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>."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(title):130
msgid "Kernel modules"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):133
msgid "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."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):141
msgid "An example old style configuration would be:"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre:caption):145
msgid "/etc/modules.autoload.d/kernel-2.6"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre):145
#, no-wrap
msgid "\nivtv\ncx88_dvb video_br=2\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):150
msgid "Converting the above example would result in the following:"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre:caption):154
msgid "/etc/conf.d/modules"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre):154
#, no-wrap
msgid "\n<comment># Modules autoloaded at boot</comment>\nmodules_2_6=\"ivtv cx88_dvb\"\n<comment># Module parameters</comment>\nmodule_cx88_dvb_args_2_6=\"video_br=2\"\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):161
msgid "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."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):167
msgid "An in-depth example would be:"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre:caption):171
msgid "detailed example of /etc/conf.d/modules"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre):171
#, no-wrap
msgid "\n<comment># Always load ochi1394 and ieee1394, no matter the kernel version</comment>\nmodules=\"ohci1394 ieee1394\"\n<comment># Only load tun and usbserial for 2.6.x series kernels</comment>\nmodules_2_6=\"tun usbserial\"\n<comment># Only load cx88_dvb for 2.6.23 kernels</comment>\nmodules_2_6_23=\"cx88_dvb\"\n<comment># Only load ivtv for 2.6.23-gentoo-r5</comment>\nmodules_2_6_23_gentoo_r5=\"ivtv\"\n\n<comment># For 2.6.23-gentoo-r5, pass video_br=2 to cx88_dvb</comment>\nmodule_cx88_dvb_args_2_6_23_gentoo_r5=\"video_br=2\"\n<comment># For 2.6.x series kernels, always pass vendor and product</comment>\nmodule_usbserial_args_2_6=\"vendor=0x1410 product=0x2110\"\n<comment># Always pass debug to ieee1394</comment>\nmodule_ieee1394_args=\"debug\" \n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(impo):189
msgid "The <b>module*</b> variables are not cumulative. The more version-specific variables will override the more general variables."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(note):194
msgid "Please note the difference between <b>module_</b> and <b>modules_</b>."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(title):201
msgid "Boot runlevel"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):204
msgid "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."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):211
msgid "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!"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):219
msgid "While the OpenRC ebuild will attempt to do this migration for you, you should verify that it migrated all the volume management services properly:"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre:caption):224
msgid "Display all services in boot runlevel"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre):224
#, no-wrap
msgid "\n# <i>ls -l /etc/runlevels/boot/</i>\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):228
msgid "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:"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre:caption):233
msgid "Adding critical services to the boot runlevel"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre):233
#, no-wrap
msgid "\n# <i>rc-update add root boot</i>\n# <i>rc-update add procfs boot</i>\n# <i>rc-update add mtab boot</i>\n# <i>rc-update add fsck boot</i>\n# <i>rc-update add swap boot</i>\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):241
msgid "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:"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre:caption):246
msgid "Adding mdraid and lvm to the boot runlevel"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre):246
#, no-wrap
msgid "\n# <i>rc-update add mdraid boot</i>\n# <i>rc-update add lvm boot</i>\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(title):254
msgid "Udev"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):257
msgid "OpenRC no longer starts <c>udev</c> by default, but it does need to be present in the <c>sysinit</c> runlevel to be started. The OpenRC ebuild should detect if <c>udev</c> was previously enabled and add it to the <c>sysinit</c> runlevel. However, to be safe, check if <c>udev</c> is present:"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre:caption):264
msgid "Verifying udev"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre):264
#, no-wrap
msgid "\n# <i>ls -l /etc/runlevels/sysinit</i>\nlrwxrwxrwx 1 root root 14 2009-01-29 08:00 /etc/runlevels/sysinit/udev -&gt; \\\n/etc/init.d/udev\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):270
msgid "If <c>udev</c> is not listed, add it to the correct runlevel:"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre:caption):274
msgid "Adding udev to the sysinit runlevel"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre):274
#, no-wrap
msgid "\n# <i>rc-update add udev sysinit</i>\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(title):281
msgid "Network"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):284
msgid "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:"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre:caption):290
msgid "Adding back missing net.eth0 script"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre):290
#, no-wrap
msgid "\n# <i>cd /etc/init.d</i>\n# <i>ln -s net.lo net.eth0</i>\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):295
msgid "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."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):301
msgid "Also, <path>/etc/conf.d/net</path> no longer uses bash-style arrays for configuration. Please review <path>/usr/share/doc/openrc-&lt;version&gt;/net.example</path> for configuration instructions. Conversion should be relatively straight-forward, for example a static IP assignment would change as follows:"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre:caption):309
msgid "Old /etc/conf.d/net style"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre):309
#, no-wrap
msgid "\nconfig_eth0=( \"192.168.1.37 netmask 255.255.255.0 brd 192.168.1.255\" )\nroutes_eth0=( \"default via 192.168.1.100\" )\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre:caption):314
msgid "New /etc/conf.d/net style"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre):314
#, no-wrap
msgid "\nconfig_eth0=\"192.168.1.37 netmask 255.255.255.0 brd 192.168.1.255\"\nroutes_eth0=\"default via 192.168.1.100\"\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(title):322
msgid "Clock"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):325
msgid "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>. Systems without a working real time clock (RTC) chip should use <path>/etc/init.d/swclock</path>, which sets the system time based on the mtime of a file which is created at system shutdown. The initscripts in <path>/etc/init.d/</path> have also been renamed accordingly, so make sure the appropriate script for your system has been added to the boot runlevel."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):337
msgid "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."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):344
msgid "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:"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre:caption):350
msgid "/etc/timezone"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre):350
#, no-wrap
msgid "\nAmerica/New_York\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(title):357
msgid "XSESSION"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):360
msgid "The XSESSION variable is no longer found in <path>/etc/rc.conf</path>. Instead, you can set the XSESSION variable per-user in <path>~/.bashrc</path> (or equivalent), or system-wide in <path>/etc/env.d/</path>."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):366
msgid "Here's an example of setting XSESSION for the whole system:"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre:caption):370
msgid "Setting XSESSION system-wide"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre):370
#, no-wrap
msgid "\n# <i>echo 'XSESSION=\"Xfce4\"' &gt; /etc/env.d/90xsession</i>\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(impo):374 ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(impo):394
msgid "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>."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(title):384
msgid "EDITOR and PAGER"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):387
msgid "The EDITOR variable is no longer found in <path>/etc/rc.conf</path>. Both EDITOR and PAGER are set by default in <path>/etc/profile</path>. 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."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(title):404
msgid "Boot log"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):407
msgid "Previously, you could log the boot process by using <c>app-admin/showconsole</c>. However, OpenRC now handles all logging internally, so there's no need for the hacks that <c>showconsole</c> employed. You can safely unmerge <c>showconsole</c>. To continue logging boot messages, just set the appropriate variable in <path>/etc/rc.conf</path>. Logs will appear in <path>/var/log/rc.log</path>."
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre:caption):416
msgid "Enabling boot logging in /etc/rc.conf"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(pre):416
#, no-wrap
msgid "\nrc_logger=\"YES\"\n"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(title):423
msgid "Finishing up"
msgstr ""

#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(p):426
msgid "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."
msgstr ""

#. Place here names of translator, one per line. Format should be NAME; ROLE; E-MAIL
#: ../../gentoo/xml/htdocs/doc/en//openrc-migration.xml(None):0
msgid "translator-credits"
msgstr ""