[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
docs/updating.xml: 1.2 -> 1.3
以下のページの更新をしました。ツッコミをお願いします。
docs/updating.xml: 1.2 -> 1.3
> revision 1.3
> date: 2007/08/08 00:51:06; author: weinem; state: Exp; lines: +74 -46
> Better instructions, based on user-feedback from Clayton <ckoeni@gmail.com>
木曜日までに異議がなければ、 commit します。
以下、訳と原文それぞれの新旧の差分です。
--- docs/updating.xml.orig 2007-08-08 23:16:54.000000000 +0900
+++ docs/updating.xml 2007-08-08 23:16:54.000000000 +0900
@@ -6,10 +6,10 @@
<webpage id="ja-docs-updating">
<config param="desc" value="安定版 NetBSD リリースの更新" />
<config param="cvstag"
- value="$NetBSD: updating.xml,v 1.2 2007/06/09 18:11:04 dsieger Exp $" />
+ value="$NetBSD: updating.xml,v 1.3 2007/08/08 00:51:06 weinem Exp $" />
<!-- Based on english version: -->
- <!-- NetBSD: updating.xml,v 1.2 2007/06/09 18:11:04 dsieger Exp -->
- <config param="rcsdate" value="$Date: 2007/06/09 18:11:04 $" />
+ <!-- NetBSD: updating.xml,v 1.3 2007/08/08 00:51:06 weinem Exp -->
+ <config param="rcsdate" value="$Date: 2007/08/08 00:51:06 $" />
<head>
<!-- Copyright (c) 2003-2006
The NetBSD Foundation, Inc. ALL RIGHTS RESERVED. -->
@@ -21,7 +21,7 @@
<sect3 id="current">
<title>-current を追跡する</title>
<para>
- -current
+ NetBSD-current
の追跡方法についての資料は、
<ulink url="current/">この文書</ulink>をご覧ください。
</para>
@@ -31,7 +31,7 @@
<title>ソースを更新する</title>
<para>
安定版 (
- <ulink url="../releases/formal-3/">NetBSD 3.0</ulink>
+ <ulink url="../releases/formal-3/">NetBSD 3.1</ulink>
など) の NetBSD リリースを、本番環境として使っている場合、
そのリリース向けのセキュリティー上の修正を取り込むために、
時々ソースを更新のうえシステムまたはカーネルを再構築すべきです。
@@ -43,22 +43,24 @@
ssh</ulink>
を使っておこなうことができます。
たとえば、
- NetBSD 3.0 リリースのソースをチェックアウトするためには、
+ NetBSD 3.1 リリースのソースをチェックアウトするためには、
以下のようにします:
</para>
<programlisting>
$ cd /usr
-$ env CVS_RSH=ssh cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot co -r netbsd-3-0 -P src</programlisting>
+$ env CVS_RSH=ssh cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot co -r netbsd-3-1 -P src</programlisting>
- <note>
- 間違ってソースツリーを<emphasis>ダウングレード</emphasis>することのないよう、
- 適切な意図通りの枝タグを選ぶように気を付けてください。
- </note>
+ <note>
+ 間違ってソースツリーを<emphasis>ダウングレード</emphasis>することのないよう、
+ 適切な意図通りの枝タグを選ぶように気を付けてください。
+ </note>
- <para>既存のソースツリーを更新するには以下のようにします:</para>
+ <para>既存のソースツリーを更新するには以下のようにします:</para>
- <programlisting>$ cd /usr/src
-$ env CVS_RSH=ssh cvs update -dP</programlisting>
+<programlisting>
+$ cd /usr/src
+$ env CVS_RSH=ssh
+$ cvs update -dP</programlisting>
</sect3>
@@ -68,23 +70,22 @@
新しいカーネルを構築する方法は、
<ulink url="kernel/#how_to_build_a_kernel">この文書
</ulink>
- で説明している方法とほぼ同じですが、
- <code>build.sh</code>
- スクリプトの書式が違うことにご注意ください。
- <code>build.sh</code>
- は、
- NetBSD 1.6 の後で、大幅に変わっています。(NetBSD > 1.6 または
- -current を使っているのでなければ、
- カーネルの構築に
- <code>build.sh</code>
- は
- <emphasis>使えません</emphasis>。)
+ で説明している方法とほぼ同じです。
</para>
+
+<para>カーネルを構築する手順は、以下の通りです。</para>
+<programlisting>
+$ cd /usr/src
+$ ./build.sh -O ../obj -T ../tools kernel=<KERNEL>
+</programlisting>
+
+
</sect3>
<sect3 id="userland">
- <title>ユーザーランドを更新する</title>
- <para>かならず
+ <title>ユーザーランドをあらたに構築する</title>
+ <para>
+ かならず
<code>build.sh -h</code>
の説明を見て、詳細は
<emphasis>UPDATING</emphasis>
@@ -94,18 +95,37 @@
<filename>/etc/mk.conf</filename>
で指定できるオプションが<emphasis>たくさん</emphasis>あるので、
これは重要なことです。
- 結局は、単一のコマンドに要約されます:
- <code>build.sh distribution</code> (NetBSD 1.6 の場合は
- <code>build.sh -d</code>)
</para>
- <para>
- これは、ユーザーランド
- <emphasis>すべて</emphasis>
- を更新することになるのに注意してください。
- </para>
+<para>ユーザーランドを構築するには、以下のようにします。</para>
+<programlisting>
+$ ./build.sh -U distribution</programlisting>
+
</sect3>
+<sect3 id="installing">
+ <title>構築したカーネルとユーザーランドをインストールする</title>
+
+<para>構築した新しいカーネルをインストールし、(新しいカーネルが動作することを確認するため)
+リブートし、新しいユーザーランドをインストールすることが、
+安定版 NetBSD の更新手順の最後の作業です。以下のようにします。</para>
+<programlisting>
+$ cd /usr/src
+$ su
+# mv /netbsd /netbsd.old
+# mv /usr/src/sys/arch/<ARCH>/compile/<KERNEL>/netbsd /
+# shutdown -r now
+...
+$ cd /usr/src
+$ su
+# ./build.sh -O ../obj -T ../tools -U install=/ </programlisting>
+
+<para>新しいカーネル "netbsd" がうまくブートしなかった場合は、
+"netbsd.old" カーネルをブートして、以前の状態に戻すことができます。</para>
+
+</sect3>
+
+
<sect3 id="parts">
<title>ソースツリーの一部だけを更新する</title>
<para>
@@ -115,9 +135,9 @@
一例としては以下のようになります:
</para>
- <programlisting>
+<programlisting>
$ cd src
-$ env CVS_RSH=ssh cvs update -d -P -r netbsd-3-0 gnu/dist/sendmail/sendmail
+$ env CVS_RSH=ssh cvs update -d -P -r netbsd-3-1 gnu/dist/sendmail/sendmail
$ cd gnu/usr.sbin/sendmail
$ make USETOOLS=no cleandir dependall
$ su
@@ -126,7 +146,7 @@
</sect3>
<sect3 id="summary">
- <title>簡潔なまとめ</title>
+ <title>更新手順の簡潔なまとめ</title>
<itemizedlist>
<listitem>
<para>ソースの更新:</para>
@@ -136,24 +156,29 @@
</listitem>
<listitem>
- <para>カーネルの再構築:</para>
+ <para>カーネルとユーザーランドの再構築:</para>
<programlisting>
$ cd /usr/src
-$ ./build.sh kernel=<KERNEL>
+$ ./build.sh -O ../obj -T ../tools kernel=<KERNEL>
+$ ./build.sh -U distribution</programlisting>
+</listitem>
+
+<listitem>
+<para>Installing the new kernel and userland:</para>
+<programlisting>
$ su
# mv /netbsd /netbsd.old
-# mv /usr/src/sys/arch/<ARCH>/compile/<KERNEL>/netbsd /</programlisting>
- </listitem>
- <listitem>
- <para>ユーザーランドの更新:</para>
- <programlisting>
+# mv /usr/src/sys/arch/<ARCH>/compile/<KERNEL>/netbsd /
+# shutdown -r now
+...
$ cd /usr/src
-$ ./build.sh -h
$ su
-# ./build.sh <optional arguments> distribution</programlisting>
- </listitem>
- </itemizedlist>
- </sect3>
+# ./build.sh -O ../obj -T ../tools -U install=/ </programlisting>
+</listitem>
+
+</itemizedlist>
+
+</sect3>
</sect2>
</sect1>
Index: docs/updating.xml
===================================================================
RCS file: /cvsroot/htdocs/docs/updating.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- docs/updating.xml 9 Jun 2007 18:11:04 -0000 1.2
+++ docs/updating.xml 8 Aug 2007 00:51:06 -0000 1.3
@@ -6,8 +6,8 @@
<webpage id="docs-updating">
<config param="desc" value="Updating a stable NetBSD release" />
<config param="cvstag"
- value="$NetBSD: updating.xml,v 1.2 2007/06/09 18:11:04 dsieger Exp $" />
- <config param="rcsdate" value="$Date: 2007/06/09 18:11:04 $" />
+ value="$NetBSD: updating.xml,v 1.3 2007/08/08 00:51:06 weinem Exp $" />
+ <config param="rcsdate" value="$Date: 2007/08/08 00:51:06 $" />
<head>
<!-- Copyright (c) 2003-2006
The NetBSD Foundation, Inc. ALL RIGHTS RESERVED. -->
@@ -21,7 +21,7 @@
<para>
See
<ulink url="current/">this document</ulink>
- for our documentation on how to track -current.
+ for our documentation on how to track NetBSD-current.
</para>
</sect3>
@@ -29,7 +29,7 @@
<title>Updating the sources</title>
<para>
If you are running a stable NetBSD release (such as
- <ulink url="../releases/formal-3/">NetBSD 3.0</ulink>),
+ <ulink url="../releases/formal-3/">NetBSD 3.1</ulink>),
in a production environment, you should occasionally
update your sources and rebuild the system or the kernel,
in order to incorporate any security fixes that have been
@@ -42,22 +42,24 @@
<ulink url="current/#using-anoncvs-over-ssh">anoncvs over
ssh</ulink>
by specifying the correct branch tag. For example, to
- checkout the sources for the NetBSD 3.0 release, you
+ checkout the sources for the NetBSD 3.1 release, you
could use:
</para>
<programlisting>
$ cd /usr
-$ env CVS_RSH=ssh cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot co -r netbsd-3-0 -P src</programlisting>
+$ env CVS_RSH=ssh cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot co -r netbsd-3-1 -P src</programlisting>
- <note>
- Be sure to take care in selecting the correct and desired branch tag so
- you don't accidently <emphasis>downgrade</emphasis> your source tree.
- </note>
+ <note>
+ Be sure to take care in selecting the correct and desired branch tag so
+ you don't accidently <emphasis>downgrade</emphasis> your source tree.
+ </note>
- <para>To update an existing source tree:</para>
+ <para>To update an existing source tree, do:</para>
- <programlisting>$ cd /usr/src
-$ env CVS_RSH=ssh cvs update -dP</programlisting>
+<programlisting>
+$ cd /usr/src
+$ env CVS_RSH=ssh
+$ cvs update -dP</programlisting>
</sect3>
@@ -67,37 +69,58 @@
Building a new kernel pretty much follows the steps
as described in
<ulink url="kernel/#how_to_build_a_kernel">this
- document</ulink>,
- but please note the differences in the syntax of the
- <code>build.sh</code> script. <code>build.sh</code>
- has changed significantly after NetBSD 1.6. (If you are not using
- NetBSD > 1.6 or -current, you can
- <emphasis>not</emphasis> use
- <code>build.sh</code>
- to build the new kernel!)
+ document</ulink>.
</para>
+
+<para>The steps to build the kernel are:</para>
+<programlisting>
+$ cd /usr/src
+$ ./build.sh -O ../obj -T ../tools kernel=<KERNEL>
+</programlisting>
+
+
</sect3>
<sect3 id="userland">
- <title>Updating the userland</title>
+ <title>Building a new userland</title>
<para>
Please always refer to <code>build.sh -h</code> and the
files <emphasis>UPDATING</emphasis> and
- <emphasis>BUILDING</emphasis> for details -- it's worth
+ <emphasis>BUILDING</emphasis> for details - it's worth
it, there are <emphasis>many</emphasis> options that can
be set on the command line or in
- <filename>/etc/mk.conf</filename> . In the end, it all
- boils down to a single command: <code>build.sh
- distribution</code> (or <code>build.sh -d</code> on NetBSD
- 1.6).
+ <filename>/etc/mk.conf</filename>.
</para>
- <para>
- Note that this will update the
- <emphasis>entire</emphasis> userland!
- </para>
+<para>The build the userland, do:</para>
+<programlisting>
+$ ./build.sh -U distribution</programlisting>
+
</sect3>
+<sect3 id="installing">
+ <title>Installing the kernel and userland</title>
+
+<para>Installing the new kernel, rebooting (to ensure that the new kernel
+works) and installing the new userland are the final steps of the updating
+procedure:</para>
+<programlisting>
+$ cd /usr/src
+$ su
+# mv /netbsd /netbsd.old
+# mv /usr/src/sys/arch/<ARCH>/compile/<KERNEL>/netbsd /
+# shutdown -r now
+...
+$ cd /usr/src
+$ su
+# ./build.sh -O ../obj -T ../tools -U install=/ </programlisting>
+
+<para>If the new kernel "netbsd" does not boot successfully, you can
+fall back on booting the "netbsd.old" kernel.</para>
+
+</sect3>
+
+
<sect3 id="parts">
<title>Updating only parts of the source tree</title>
<para>
@@ -107,9 +130,9 @@
advisory. An example is given below:
</para>
- <programlisting>
+<programlisting>
$ cd src
-$ env CVS_RSH=ssh cvs update -d -P -r netbsd-3-0 gnu/dist/sendmail/sendmail
+$ env CVS_RSH=ssh cvs update -d -P -r netbsd-3-1 gnu/dist/sendmail/sendmail
$ cd gnu/usr.sbin/sendmail
$ make USETOOLS=no cleandir dependall
$ su
@@ -118,7 +141,7 @@
</sect3>
<sect3 id="summary">
- <title>Terse summary</title>
+ <title>Terse summary of the updating procedure</title>
<itemizedlist>
<listitem>
<para>Update the sources:</para>
@@ -128,24 +151,29 @@
</listitem>
<listitem>
- <para>Build a new kernel:</para>
+ <para>Building the new kernel and userland:</para>
<programlisting>
$ cd /usr/src
-$ ./build.sh kernel=<KERNEL>
+$ ./build.sh -O ../obj -T ../tools kernel=<KERNEL>
+$ ./build.sh -U distribution</programlisting>
+</listitem>
+
+<listitem>
+<para>Installing the new kernel and userland:</para>
+<programlisting>
$ su
# mv /netbsd /netbsd.old
-# mv /usr/src/sys/arch/<ARCH>/compile/<KERNEL>/netbsd /</programlisting>
- </listitem>
- <listitem>
- <para>Update the userland:</para>
- <programlisting>
+# mv /usr/src/sys/arch/<ARCH>/compile/<KERNEL>/netbsd /
+# shutdown -r now
+...
$ cd /usr/src
-$ ./build.sh -h
$ su
-# ./build.sh <optional arguments> distribution</programlisting>
- </listitem>
- </itemizedlist>
- </sect3>
+# ./build.sh -O ../obj -T ../tools -U install=/ </programlisting>
+</listitem>
+
+</itemizedlist>
+
+</sect3>
</sect2>
</sect1>