1 |
jkt 05/10/06 16:42:48 |
2 |
|
3 |
Modified: xml/htdocs/doc/en vserver-howto.xml |
4 |
Log: |
5 |
#108259, "Update vserver howto to reflect latest changes" by hollow |
6 |
|
7 |
Revision Changes Path |
8 |
1.3 +66 -129 xml/htdocs/doc/en/vserver-howto.xml |
9 |
|
10 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/vserver-howto.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
11 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/vserver-howto.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo |
12 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/vserver-howto.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo |
13 |
|
14 |
Index: vserver-howto.xml |
15 |
=================================================================== |
16 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/vserver-howto.xml,v |
17 |
retrieving revision 1.2 |
18 |
retrieving revision 1.3 |
19 |
diff -u -r1.2 -r1.3 |
20 |
--- vserver-howto.xml 8 Aug 2005 11:08:24 -0000 1.2 |
21 |
+++ vserver-howto.xml 6 Oct 2005 16:42:48 -0000 1.3 |
22 |
@@ -1,5 +1,5 @@ |
23 |
<?xml version='1.0' encoding="UTF-8"?> |
24 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/vserver-howto.xml,v 1.2 2005/08/08 11:08:24 neysx Exp $ --> |
25 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/vserver-howto.xml,v 1.3 2005/10/06 16:42:48 jkt Exp $ --> |
26 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
27 |
|
28 |
<guide link="/doc/en/vserver-howto.xml"> |
29 |
@@ -21,8 +21,8 @@ |
30 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
31 |
<license/> |
32 |
|
33 |
-<version>1.0</version> |
34 |
-<date>2005-06-17</date> |
35 |
+<version>1.1</version> |
36 |
+<date>2005-10-06</date> |
37 |
|
38 |
<chapter> |
39 |
<title>Introduction</title> |
40 |
@@ -83,7 +83,7 @@ |
41 |
</chapter> |
42 |
|
43 |
<chapter> |
44 |
-<title>Creating a VServer template</title> |
45 |
+<title>Host configuration</title> |
46 |
<section> |
47 |
<title>Install a VServer kernel</title> |
48 |
<body> |
49 |
@@ -102,13 +102,12 @@ |
50 |
# <i>make menuconfig</i> |
51 |
|
52 |
Linux VServer ---> |
53 |
-<comment>(Required by current utils)</comment> |
54 |
- [*] Enable Legacy Kernel API |
55 |
+ [ ] Enable Legacy Kernel API |
56 |
<comment>(Do not set!)</comment> |
57 |
[ ] Disable Legacy Networking Kernel API |
58 |
<comment>(Highly recommended)</comment> |
59 |
[*] Enable Proc Security |
60 |
- [ ] Enable Hard CPU Limits |
61 |
+ [*] Enable Hard CPU Limits |
62 |
Persistent Inode Context Tagging (UID24/GID24) ---> |
63 |
[ ] Tag NFSD User Auth and Files |
64 |
[ ] Compile Debugging Code |
65 |
@@ -124,7 +123,7 @@ |
66 |
# <i>make</i> |
67 |
<comment>(Installing)</comment> |
68 |
# <i>make modules_install</i> |
69 |
-# <i>cp arch/i386/boot/bzImage /boot/kernel-<KERNELVERSION>-vs<VSERVERVERSION></i> |
70 |
+# <i>cp arch/i386/boot/bzImage /boot/kernel-<KERNELVERSION>-vserver-<VSERVERVERSION></i> |
71 |
<comment>(Edit bootloader config file as required and)</comment> |
72 |
# <i>reboot</i> |
73 |
</pre> |
74 |
@@ -140,23 +139,25 @@ |
75 |
contains all necessary programs and many usefull features. |
76 |
</p> |
77 |
|
78 |
+<note> |
79 |
+The tools and features used in this HowTo require |
80 |
+<c>>=sys-apps/util-vserver-0.30.208-r3</c>. You may have to keyword it first. |
81 |
+</note> |
82 |
+ |
83 |
<pre caption="Install vserver utils"> |
84 |
# <i>emerge util-vserver</i> |
85 |
</pre> |
86 |
|
87 |
<p> |
88 |
-If you use Proc Security you have to "unhide" certain files in your |
89 |
-<path>/proc</path> directory in order to make them available in virtual |
90 |
-servers. There is a script called <c>vprocunhide</c> in |
91 |
-<path>/usr/lib/util-vserver</path> which unhides files specified in |
92 |
-<path>/usr/lib/util-vserver/defaults/vprocunhide-files</path>. The util-vserver |
93 |
-ebuild installed a init-script which uses the <c>vprocunhide</c> command. Add |
94 |
-it to your runlevel: |
95 |
+You have to run the <c>vprocunhide</c> command after every reboot in order to |
96 |
+setup <path>/proc</path> permissions correctly for vserver use. An init script has |
97 |
+been installed by util-vserver. To use it you should add it to a |
98 |
+runlevel: |
99 |
</p> |
100 |
|
101 |
-<pre caption="vprocunhide init script"> |
102 |
-# <i>rc-update add vprocunhide default</i> |
103 |
-# <i>/etc/init.d/vprocunhide start</i> |
104 |
+<pre caption="vserver init script"> |
105 |
+# <i>rc-update add vservers default</i> |
106 |
+# <i>/etc/init.d/vservers start</i> |
107 |
</pre> |
108 |
|
109 |
<p> |
110 |
@@ -171,27 +172,19 @@ |
111 |
|
112 |
</body> |
113 |
</section> |
114 |
+</chapter> |
115 |
+ |
116 |
+<chapter> |
117 |
+<title>Creating a guest template</title> |
118 |
<section> |
119 |
-<title>Basic Skeleton configuration</title> |
120 |
+<title>Install a vserver stage3</title> |
121 |
<body> |
122 |
|
123 |
<p> |
124 |
-You have to create some configuration files and directories to get your virtual |
125 |
-server up and running. We use the skeleton build mode from the util-vserver |
126 |
-package to setup our basic configuration. |
127 |
-</p> |
128 |
- |
129 |
-<p> |
130 |
-The util-vserver package uses <path>/vservers</path> to store all virtual |
131 |
-servers by default. You can put your servers somewhere else by specifying |
132 |
-<c>--rootdir=/path/to/vserver/root</c> to the build command below. |
133 |
-</p> |
134 |
- |
135 |
-<p> |
136 |
-There is a new baselayout-vserver ebuild in portage which supports the plain |
137 |
-init-style, i.e.; you don't have to use the gentoo init style anymore. The |
138 |
-plain init-style uses <c>init</c> and <path>/etc/inittab</path> to manage |
139 |
-runlevels and init scripts (considered more stable and is the default now). |
140 |
+We will use <c>vserver-new</c> to create the initial guest. You have to download |
141 |
+a vserver prepared stage3 from |
142 |
+<uri>http://dev.gentoo.org/~hollow/vserver/stages</uri> and the script will |
143 |
+guide you through the creation process. |
144 |
</p> |
145 |
|
146 |
<p> |
147 |
@@ -201,118 +194,63 @@ |
148 |
equivalent to the last two parts of the virtual servers IP). |
149 |
</p> |
150 |
|
151 |
-<pre caption="Basic configuration"> |
152 |
-# <i>vserver gentoo build -m skeleton \</i> |
153 |
+<pre caption="Start stage3 installation"> |
154 |
+# <i>vserver-new gentoo-template \</i> |
155 |
<i>--hostname gentoo \</i> |
156 |
- <i>--initstyle plain \</i> |
157 |
- <i>--context 1253</i> |
158 |
- <i>--interface gentoo=eth0:192.168.1.253/24</i> |
159 |
+ <i>--context 1253 \</i> |
160 |
+ <i>--interface eth0:192.168.1.253/24 \</i> |
161 |
+ <i>stage3 /path/to/stage3-tarball.tar.bz2</i> |
162 |
</pre> |
163 |
|
164 |
-<impo> |
165 |
-Per default the virtual server is allowed to set the hostname itself. Be sure |
166 |
-to change <path>/etc/conf.d/hostname</path> in your virtual server later to |
167 |
-match the hostname above. |
168 |
-</impo> |
169 |
- |
170 |
-</body> |
171 |
-</section> |
172 |
-<section> |
173 |
-<title>Installing Gentoo installation files</title> |
174 |
-<body> |
175 |
- |
176 |
-<p> |
177 |
-We are creating a Gentoo template which we can copy later to get multiple |
178 |
-virtual servers easily. The vserver build-script created some basic directories |
179 |
-in <path>/vservers/gentoo</path> which are installed by a stage anyway, so we |
180 |
-remove them first. |
181 |
-</p> |
182 |
- |
183 |
-<pre caption="Remove skeleton files"> |
184 |
-# <i>rm -rf /vservers/gentoo/*</i> |
185 |
-</pre> |
186 |
- |
187 |
-<p> |
188 |
-You have to install a regular Gentoo system now. You can follow most of the |
189 |
-Gentoo Handbook with some limitations and additions: |
190 |
-</p> |
191 |
- |
192 |
-<ul> |
193 |
- <li>Replace <path>/mnt/gentoo</path> with <path>/vservers/gentoo</path></li> |
194 |
- <li> |
195 |
- Choose the <path>vserver/x86</path> profile in <uri |
196 |
- link="/doc/en/handbook/handbook-x86.xml?part=1&chap=6#doc_chap1_sect6">chapter |
197 |
- 6.a</uri> |
198 |
- </li> |
199 |
- <li> |
200 |
- Use the vserver stages available <uri |
201 |
- link="http://dev.gentoo.org/~hollow/vserver/stages/">here</uri>. |
202 |
- </li> |
203 |
-</ul> |
204 |
- |
205 |
-<p> |
206 |
-Now, follow the Gentoo Handbook from <uri |
207 |
-link="/doc/en/handbook/handbook-x86.xml?part=1&chap=5#doc_chap2"> chapter |
208 |
-5.b</uri> to chapter 7.a and <uri |
209 |
-link="/doc/en/handbook/handbook-x86.xml?part=1&chap=8#doc_chap3"> chapter |
210 |
-8.c</uri> to chapter 9.c |
211 |
-</p> |
212 |
- |
213 |
|
214 |
|
215 |
|
216 |
-- |
217 |
gentoo-doc-cvs@g.o mailing list |