Revision 80de0e3f man/gnt-instance.sgml
| b/man/gnt-instance.sgml | ||
|---|---|---|
| 798 | 798 |
<command>failover</command> |
| 799 | 799 |
<arg>-f</arg> |
| 800 | 800 |
<arg>--ignore-consistency</arg> |
| 801 |
<sbr> |
|
| 802 |
<group choice="opt"> |
|
| 803 |
<arg>--instance</arg> |
|
| 804 |
<arg>--primary</arg> |
|
| 805 |
<arg>--secondary</arg> |
|
| 806 |
</group> |
|
| 807 |
<sbr> |
|
| 808 |
<arg choice="req" rep="repeat"><replaceable>name</replaceable></arg> |
|
| 801 |
<arg choice="req"><replaceable>instance</replaceable></arg> |
|
| 809 | 802 |
</cmdsynopsis> |
| 810 | 803 |
|
| 811 | 804 |
<para> |
| 812 |
Failover will fail the selected instances to their secondary
|
|
| 805 |
Failover will fail the instance over its secondary
|
|
| 813 | 806 |
node. This works only for instances having a remote raid |
| 814 | 807 |
disk layout. |
| 815 | 808 |
</para> |
| 816 | 809 |
|
| 817 | 810 |
<para> |
| 818 |
The selection of which instances to failover is done via the |
|
| 819 |
following options: |
|
| 820 |
<variablelist> |
|
| 821 |
<varlistentry> |
|
| 822 |
<term><option>--instance</option></term> |
|
| 823 |
<listitem> |
|
| 824 |
<simpara>will select the instances given as arguments |
|
| 825 |
(at least one argument required); this is the default |
|
| 826 |
selection</simpara> |
|
| 827 |
</listitem> |
|
| 828 |
</varlistentry> |
|
| 829 |
<varlistentry> |
|
| 830 |
<term><option>--primary</option></term> |
|
| 831 |
<listitem> |
|
| 832 |
<simpara>will select all instances whose primary node |
|
| 833 |
is in the list of nodes passed as arguments (at least |
|
| 834 |
one node required)</simpara> |
|
| 835 |
</listitem> |
|
| 836 |
</varlistentry> |
|
| 837 |
<varlistentry> |
|
| 838 |
<term><option>--secondary</option></term> |
|
| 839 |
<listitem> |
|
| 840 |
<simpara>will select all instances whose secondary |
|
| 841 |
node is in the list of nodes passed as arguments (at |
|
| 842 |
least one node required)</simpara> |
|
| 843 |
</listitem> |
|
| 844 |
</varlistentry> |
|
| 845 |
</variablelist> |
|
| 846 |
</para> |
|
| 847 |
|
|
| 848 |
<para> |
|
| 849 | 811 |
Normally the failover will check the consistency of the |
| 850 |
disks before failing over an instance. If you are trying to
|
|
| 812 |
disks before failing over the instance. If you are trying to
|
|
| 851 | 813 |
migrate instances off a dead node, this will fail. Use the |
| 852 | 814 |
<option>--ignore-consistency</option> option for this |
| 853 | 815 |
purpose. Note that this option can be dangerous as errors in |
| ... | ... | |
| 860 | 822 |
Example: |
| 861 | 823 |
<screen> |
| 862 | 824 |
# gnt-instance failover instance1.example.com |
| 863 |
# gnt-instance failover --primary node4.example.com |
|
| 864 | 825 |
</screen> |
| 865 | 826 |
</para> |
| 866 | 827 |
</refsect3> |
Also available in: Unified diff