root / man / gnt-backup.sgml @ 017778ac
History | View | Annotate | Download (7.3 kB)
1 | dd4b1106 | Iustin Pop | <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [ |
---|---|---|---|
2 | dd4b1106 | Iustin Pop | |
3 | dd4b1106 | Iustin Pop | <!-- Fill in your name for FIRSTNAME and SURNAME. --> |
4 | dd4b1106 | Iustin Pop | <!-- Please adjust the date whenever revising the manpage. --> |
5 | dd4b1106 | Iustin Pop | <!ENTITY dhdate "<date>Jul 6, 2007</date>"> |
6 | dd4b1106 | Iustin Pop | <!-- SECTION should be 1-8, maybe w/ subsection other parameters are |
7 | dd4b1106 | Iustin Pop | allowed: see man(7), man(1). --> |
8 | dd4b1106 | Iustin Pop | <!ENTITY dhsection "<manvolnum>8</manvolnum>"> |
9 | dd4b1106 | Iustin Pop | <!ENTITY dhucpackage "<refentrytitle>gnt-backup</refentrytitle>"> |
10 | dd4b1106 | Iustin Pop | <!ENTITY dhpackage "gnt-backup"> |
11 | dd4b1106 | Iustin Pop | |
12 | dd4b1106 | Iustin Pop | <!ENTITY debian "<productname>Debian</productname>"> |
13 | dd4b1106 | Iustin Pop | <!ENTITY gnu "<acronym>GNU</acronym>"> |
14 | dd4b1106 | Iustin Pop | <!ENTITY gpl "&gnu; <acronym>GPL</acronym>"> |
15 | dd4b1106 | Iustin Pop | <!ENTITY footer SYSTEM "footer.sgml"> |
16 | dd4b1106 | Iustin Pop | ]> |
17 | dd4b1106 | Iustin Pop | |
18 | dd4b1106 | Iustin Pop | <refentry> |
19 | dd4b1106 | Iustin Pop | <refentryinfo> |
20 | dd4b1106 | Iustin Pop | <copyright> |
21 | dd4b1106 | Iustin Pop | <year>2007</year> |
22 | dd4b1106 | Iustin Pop | <holder>Google Inc.</holder> |
23 | dd4b1106 | Iustin Pop | </copyright> |
24 | dd4b1106 | Iustin Pop | &dhdate; |
25 | dd4b1106 | Iustin Pop | </refentryinfo> |
26 | dd4b1106 | Iustin Pop | <refmeta> |
27 | dd4b1106 | Iustin Pop | &dhucpackage; |
28 | dd4b1106 | Iustin Pop | |
29 | dd4b1106 | Iustin Pop | &dhsection; |
30 | dd4b1106 | Iustin Pop | <refmiscinfo>ganeti 1.2</refmiscinfo> |
31 | dd4b1106 | Iustin Pop | </refmeta> |
32 | dd4b1106 | Iustin Pop | <refnamediv> |
33 | dd4b1106 | Iustin Pop | <refname>&dhpackage;</refname> |
34 | dd4b1106 | Iustin Pop | |
35 | dd4b1106 | Iustin Pop | <refpurpose>ganeti instance import/export</refpurpose> |
36 | dd4b1106 | Iustin Pop | </refnamediv> |
37 | dd4b1106 | Iustin Pop | <refsynopsisdiv> |
38 | dd4b1106 | Iustin Pop | <cmdsynopsis> |
39 | dd4b1106 | Iustin Pop | <command>&dhpackage; </command> |
40 | dd4b1106 | Iustin Pop | |
41 | dd4b1106 | Iustin Pop | <arg choice="req">command</arg> |
42 | dd4b1106 | Iustin Pop | <arg>arguments...</arg> |
43 | dd4b1106 | Iustin Pop | </cmdsynopsis> |
44 | dd4b1106 | Iustin Pop | </refsynopsisdiv> |
45 | dd4b1106 | Iustin Pop | <refsect1> |
46 | dd4b1106 | Iustin Pop | <title>DESCRIPTION</title> |
47 | dd4b1106 | Iustin Pop | |
48 | dd4b1106 | Iustin Pop | <para> |
49 | dd4b1106 | Iustin Pop | The <command>&dhpackage;</command> is used for importing and exporting |
50 | dd4b1106 | Iustin Pop | instances and their configuration from a ganeti system. It is useful for |
51 | dd4b1106 | Iustin Pop | backing instances up and also to migrate them between clusters. |
52 | dd4b1106 | Iustin Pop | </para> |
53 | dd4b1106 | Iustin Pop | |
54 | dd4b1106 | Iustin Pop | </refsect1> |
55 | dd4b1106 | Iustin Pop | <refsect1> |
56 | dd4b1106 | Iustin Pop | <title>COMMANDS</title> |
57 | dd4b1106 | Iustin Pop | |
58 | dd4b1106 | Iustin Pop | <refsect2> |
59 | dd4b1106 | Iustin Pop | <title>EXPORT</title> |
60 | dd4b1106 | Iustin Pop | |
61 | dd4b1106 | Iustin Pop | <cmdsynopsis> |
62 | dd4b1106 | Iustin Pop | <command>export</command> |
63 | dd4b1106 | Iustin Pop | <arg choice="req">-n <replaceable>node</replaceable></arg> |
64 | dd4b1106 | Iustin Pop | <arg>--noshutdown</arg> |
65 | dd4b1106 | Iustin Pop | <arg choice="req"><replaceable>instance</replaceable></arg> |
66 | dd4b1106 | Iustin Pop | </cmdsynopsis> |
67 | dd4b1106 | Iustin Pop | |
68 | dd4b1106 | Iustin Pop | <para> |
69 | dd4b1106 | Iustin Pop | Exports an instance to the target node. All the instance |
70 | dd4b1106 | Iustin Pop | data and its configuration will be exported under the |
71 | dd4b1106 | Iustin Pop | /srv/ganeti/exports/instance directory on the target node. |
72 | dd4b1106 | Iustin Pop | </para> |
73 | dd4b1106 | Iustin Pop | |
74 | dd4b1106 | Iustin Pop | <para> |
75 | dd4b1106 | Iustin Pop | The <option>--noshutdown</option> option will create a |
76 | dd4b1106 | Iustin Pop | snapshot disk of the instance without shutting it down first. |
77 | dd4b1106 | Iustin Pop | While this is faster and involves no downtime, it cannot be |
78 | dd4b1106 | Iustin Pop | guaranteed that the instance data will be in a consistent state |
79 | dd4b1106 | Iustin Pop | in the exported dump. |
80 | dd4b1106 | Iustin Pop | </para> |
81 | dd4b1106 | Iustin Pop | |
82 | dd4b1106 | Iustin Pop | <para> |
83 | dd4b1106 | Iustin Pop | Example: |
84 | dd4b1106 | Iustin Pop | <screen> |
85 | 017778ac | Guido Trotter | # gnt-backup export -n node1.example.com instance3.example.com |
86 | dd4b1106 | Iustin Pop | </screen> |
87 | dd4b1106 | Iustin Pop | </para> |
88 | dd4b1106 | Iustin Pop | </refsect2> |
89 | dd4b1106 | Iustin Pop | |
90 | dd4b1106 | Iustin Pop | <refsect2> |
91 | dd4b1106 | Iustin Pop | <title>IMPORT</title> |
92 | dd4b1106 | Iustin Pop | <cmdsynopsis> |
93 | dd4b1106 | Iustin Pop | <command>import</command> |
94 | dd4b1106 | Iustin Pop | <arg choice="req">-n <replaceable>node</replaceable></arg> |
95 | dd4b1106 | Iustin Pop | <arg>-s <replaceable>disksize</replaceable></arg> |
96 | dd4b1106 | Iustin Pop | <arg>-o <replaceable>os-type</replaceable></arg> |
97 | dd4b1106 | Iustin Pop | <arg>-m <replaceable>memsize</replaceable></arg> |
98 | dd4b1106 | Iustin Pop | <arg>-b <replaceable>bridge</replaceable></arg> |
99 | dd4b1106 | Iustin Pop | <sbr> |
100 | dd4b1106 | Iustin Pop | <arg choice="req">-t<group> |
101 | dd4b1106 | Iustin Pop | <arg>diskless</arg> |
102 | dd4b1106 | Iustin Pop | <arg>plain</arg> |
103 | dd4b1106 | Iustin Pop | <arg>local_raid1</arg> |
104 | dd4b1106 | Iustin Pop | <arg>remote_raid1</arg> |
105 | dd4b1106 | Iustin Pop | </group> |
106 | dd4b1106 | Iustin Pop | </arg> |
107 | dd4b1106 | Iustin Pop | <arg choice="req">--src-node=<replaceable>source-node</replaceable></arg> |
108 | dd4b1106 | Iustin Pop | <arg choice="req">--src-dir=<replaceable>source-dir</replaceable></arg> |
109 | dd4b1106 | Iustin Pop | <arg choice="req"><replaceable>instance</replaceable></arg> |
110 | dd4b1106 | Iustin Pop | </cmdsynopsis> |
111 | dd4b1106 | Iustin Pop | <para> |
112 | dd4b1106 | Iustin Pop | Imports a new instance from an export residing on |
113 | dd4b1106 | Iustin Pop | <replaceable>source-node</replaceable> in |
114 | dd4b1106 | Iustin Pop | <replaceable>source-dir</replaceable>. |
115 | dd4b1106 | Iustin Pop | <replaceable>instance</replaceable> must be in DNS and |
116 | dd4b1106 | Iustin Pop | resolve to a IP in the same network as the nodes in the |
117 | dd4b1106 | Iustin Pop | cluster. |
118 | dd4b1106 | Iustin Pop | </para> |
119 | dd4b1106 | Iustin Pop | |
120 | dd4b1106 | Iustin Pop | <para> |
121 | dd4b1106 | Iustin Pop | The <option>-s</option> option specifies the disk size for |
122 | dd4b1106 | Iustin Pop | the instance, in gigibytes (defaults to 20 GiB). |
123 | dd4b1106 | Iustin Pop | </para> |
124 | dd4b1106 | Iustin Pop | |
125 | dd4b1106 | Iustin Pop | <para> |
126 | dd4b1106 | Iustin Pop | The <option>-o</option> options specifies the operating |
127 | dd4b1106 | Iustin Pop | system to be installed. The available operating systems can |
128 | dd4b1106 | Iustin Pop | be listed with <command>gnt-os list</command>. |
129 | dd4b1106 | Iustin Pop | </para> |
130 | dd4b1106 | Iustin Pop | |
131 | dd4b1106 | Iustin Pop | <para> |
132 | dd4b1106 | Iustin Pop | The <option>-m</option> option specifies the memory size for |
133 | dd4b1106 | Iustin Pop | the instance, in megibytes (defaults to 128 MiB). |
134 | dd4b1106 | Iustin Pop | </para> |
135 | dd4b1106 | Iustin Pop | |
136 | dd4b1106 | Iustin Pop | <para> |
137 | dd4b1106 | Iustin Pop | The <option>-b</option> option specifies the bridge to which the |
138 | dd4b1106 | Iustin Pop | instance will be connected. (defaults to the cluster-wide default |
139 | dd4b1106 | Iustin Pop | bridge specified at cluster intialization time). |
140 | dd4b1106 | Iustin Pop | </para> |
141 | dd4b1106 | Iustin Pop | |
142 | dd4b1106 | Iustin Pop | <para> |
143 | dd4b1106 | Iustin Pop | The <option>-t</option> options specifies the disk layout type for |
144 | dd4b1106 | Iustin Pop | the instance. The available choices are: |
145 | dd4b1106 | Iustin Pop | <variablelist> |
146 | dd4b1106 | Iustin Pop | <varlistentry> |
147 | dd4b1106 | Iustin Pop | <term>diskless</term> |
148 | dd4b1106 | Iustin Pop | <listitem> |
149 | dd4b1106 | Iustin Pop | <para> |
150 | dd4b1106 | Iustin Pop | This creates an instance with no disks. Its useful for |
151 | dd4b1106 | Iustin Pop | testing only (or other special cases). |
152 | dd4b1106 | Iustin Pop | </para> |
153 | dd4b1106 | Iustin Pop | </listitem> |
154 | dd4b1106 | Iustin Pop | </varlistentry> |
155 | dd4b1106 | Iustin Pop | <varlistentry> |
156 | dd4b1106 | Iustin Pop | <term>plain</term> |
157 | dd4b1106 | Iustin Pop | <listitem> |
158 | dd4b1106 | Iustin Pop | <para>Disk devices will be logical volumes.</para> |
159 | dd4b1106 | Iustin Pop | </listitem> |
160 | dd4b1106 | Iustin Pop | </varlistentry> |
161 | dd4b1106 | Iustin Pop | <varlistentry> |
162 | dd4b1106 | Iustin Pop | <term>local_raid1</term> |
163 | dd4b1106 | Iustin Pop | <listitem> |
164 | dd4b1106 | Iustin Pop | <para> |
165 | dd4b1106 | Iustin Pop | Disk devices will be md raid1 arrays over two local |
166 | dd4b1106 | Iustin Pop | logical volumes. |
167 | dd4b1106 | Iustin Pop | </para> |
168 | dd4b1106 | Iustin Pop | </listitem> |
169 | dd4b1106 | Iustin Pop | </varlistentry> |
170 | dd4b1106 | Iustin Pop | <varlistentry> |
171 | dd4b1106 | Iustin Pop | <term>remote_raid1</term> |
172 | dd4b1106 | Iustin Pop | <listitem> |
173 | dd4b1106 | Iustin Pop | <para> |
174 | dd4b1106 | Iustin Pop | Disk devices will be md raid1 arrays with one |
175 | dd4b1106 | Iustin Pop | component (so it's not actually raid1): a drbd device |
176 | dd4b1106 | Iustin Pop | between the instance's primary node and the node given |
177 | dd4b1106 | Iustin Pop | by the option <option>--secondary-node</option>. |
178 | dd4b1106 | Iustin Pop | </para> |
179 | dd4b1106 | Iustin Pop | </listitem> |
180 | dd4b1106 | Iustin Pop | </varlistentry> |
181 | dd4b1106 | Iustin Pop | </variablelist> |
182 | dd4b1106 | Iustin Pop | </para> |
183 | dd4b1106 | Iustin Pop | |
184 | dd4b1106 | Iustin Pop | <para> |
185 | dd4b1106 | Iustin Pop | The <option>--secondary-node</option> option is used with |
186 | dd4b1106 | Iustin Pop | the remote raid disk template type and specifies the remote |
187 | dd4b1106 | Iustin Pop | node. |
188 | dd4b1106 | Iustin Pop | </para> |
189 | dd4b1106 | Iustin Pop | |
190 | dd4b1106 | Iustin Pop | <para> |
191 | 017778ac | Guido Trotter | If you do not want gnt-backup to wait for the disk mirror |
192 | dd4b1106 | Iustin Pop | to be synced, use the <option>--no-wait-for-sync</option> |
193 | dd4b1106 | Iustin Pop | option. |
194 | dd4b1106 | Iustin Pop | </para> |
195 | dd4b1106 | Iustin Pop | |
196 | dd4b1106 | Iustin Pop | |
197 | dd4b1106 | Iustin Pop | <para> |
198 | dd4b1106 | Iustin Pop | Example: |
199 | dd4b1106 | Iustin Pop | <screen> |
200 | dd4b1106 | Iustin Pop | # gnt-backup import -t plain -s 30 -m 512 -n node1.example.com \ |
201 | dd4b1106 | Iustin Pop | > --src-node=node2.example.com \ |
202 | dd4b1106 | Iustin Pop | > --src-dir=/srv/ganeti/exports/instance3.example.com \ |
203 | dd4b1106 | Iustin Pop | > instance3.example.com |
204 | dd4b1106 | Iustin Pop | </screen> |
205 | dd4b1106 | Iustin Pop | </para> |
206 | dd4b1106 | Iustin Pop | |
207 | dd4b1106 | Iustin Pop | </refsect2> |
208 | dd4b1106 | Iustin Pop | |
209 | dd4b1106 | Iustin Pop | <refsect2> |
210 | dd4b1106 | Iustin Pop | <title>LIST</title> |
211 | dd4b1106 | Iustin Pop | |
212 | dd4b1106 | Iustin Pop | <cmdsynopsis> |
213 | dd4b1106 | Iustin Pop | <command>list</command> |
214 | dd4b1106 | Iustin Pop | <arg>--nodes=<replaceable>NODE-LIST</replaceable></arg> |
215 | dd4b1106 | Iustin Pop | </cmdsynopsis> |
216 | dd4b1106 | Iustin Pop | |
217 | dd4b1106 | Iustin Pop | <para> |
218 | dd4b1106 | Iustin Pop | Lists the exports currently available in the default directory in all |
219 | dd4b1106 | Iustin Pop | the nodes of the current cluster, or optionally only a subset of them |
220 | dd4b1106 | Iustin Pop | specified by the <option>--nodes</option> option. |
221 | dd4b1106 | Iustin Pop | </para> |
222 | dd4b1106 | Iustin Pop | |
223 | dd4b1106 | Iustin Pop | </refsect2> |
224 | dd4b1106 | Iustin Pop | |
225 | dd4b1106 | Iustin Pop | </refsect1> |
226 | dd4b1106 | Iustin Pop | |
227 | dd4b1106 | Iustin Pop | &footer; |
228 | dd4b1106 | Iustin Pop | |
229 | dd4b1106 | Iustin Pop | </refentry> |
230 | dd4b1106 | Iustin Pop | |
231 | dd4b1106 | Iustin Pop | <!-- Keep this comment at the end of the file |
232 | dd4b1106 | Iustin Pop | Local variables: |
233 | dd4b1106 | Iustin Pop | mode: sgml |
234 | dd4b1106 | Iustin Pop | sgml-omittag:t |
235 | dd4b1106 | Iustin Pop | sgml-shorttag:t |
236 | dd4b1106 | Iustin Pop | sgml-minimize-attributes:nil |
237 | dd4b1106 | Iustin Pop | sgml-always-quote-attributes:t |
238 | dd4b1106 | Iustin Pop | sgml-indent-step:2 |
239 | dd4b1106 | Iustin Pop | sgml-indent-data:t |
240 | dd4b1106 | Iustin Pop | sgml-parent-document:nil |
241 | dd4b1106 | Iustin Pop | sgml-default-dtd-file:nil |
242 | dd4b1106 | Iustin Pop | sgml-exposed-tags:nil |
243 | dd4b1106 | Iustin Pop | sgml-local-catalogs:nil |
244 | dd4b1106 | Iustin Pop | sgml-local-ecat-files:nil |
245 | dd4b1106 | Iustin Pop | End: |
246 | dd4b1106 | Iustin Pop | --> |