mirror of
https://git.proxmox.com/git/pve-docs
synced 2025-06-16 12:33:30 +00:00
Use correct xref: syntax and add pvecm prefix
Signed-off-by: Stefan Reiter <s.reiter@proxmox.com>
This commit is contained in:
parent
986e82b5e6
commit
3254bfddb3
30
pvecm.adoc
30
pvecm.adoc
@ -150,7 +150,7 @@ Login via `ssh` to the node you want to add.
|
|||||||
----
|
----
|
||||||
|
|
||||||
For `IP-ADDRESS-CLUSTER` use the IP or hostname of an existing cluster node.
|
For `IP-ADDRESS-CLUSTER` use the IP or hostname of an existing cluster node.
|
||||||
An IP address is recommended (see <<corosync-addresses,Ring Address Types>>).
|
An IP address is recommended (see xref:pvecm_corosync_addresses[Ring Address Types]).
|
||||||
|
|
||||||
CAUTION: A new node cannot hold any VMs, because you would get
|
CAUTION: A new node cannot hold any VMs, because you would get
|
||||||
conflicts about identical VM IDs. Also, all existing configuration in
|
conflicts about identical VM IDs. Also, all existing configuration in
|
||||||
@ -212,7 +212,7 @@ Membership information
|
|||||||
4 1 hp4
|
4 1 hp4
|
||||||
----
|
----
|
||||||
|
|
||||||
[[adding-nodes-with-separated-cluster-network]]
|
[[pvecm_adding_nodes_with_separated_cluster_network]]
|
||||||
Adding Nodes With Separated Cluster Network
|
Adding Nodes With Separated Cluster Network
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
@ -428,7 +428,7 @@ part is done by corosync, an implementation of a high performance low overhead
|
|||||||
high availability development toolkit. It serves our decentralized
|
high availability development toolkit. It serves our decentralized
|
||||||
configuration file system (`pmxcfs`).
|
configuration file system (`pmxcfs`).
|
||||||
|
|
||||||
[[cluster-network-requirements]]
|
[[pvecm_cluster_network_requirements]]
|
||||||
Network Requirements
|
Network Requirements
|
||||||
~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~
|
||||||
This needs a reliable network with latencies under 2 milliseconds (LAN
|
This needs a reliable network with latencies under 2 milliseconds (LAN
|
||||||
@ -486,7 +486,7 @@ Setting Up A New Network
|
|||||||
|
|
||||||
First you have to setup a new network interface. It should be on a physical
|
First you have to setup a new network interface. It should be on a physical
|
||||||
separate network. Ensure that your network fulfills the
|
separate network. Ensure that your network fulfills the
|
||||||
<<cluster-network-requirements,cluster network requirements>>.
|
xref:pvecm_cluster_network_requirements[cluster network requirements].
|
||||||
|
|
||||||
Separate On Cluster Creation
|
Separate On Cluster Creation
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||||
@ -510,9 +510,9 @@ systemctl status corosync
|
|||||||
----
|
----
|
||||||
|
|
||||||
Afterwards, proceed as descripted in the section to
|
Afterwards, proceed as descripted in the section to
|
||||||
<<adding-nodes-with-separated-cluster-network,add nodes with a separated cluster network>>.
|
xref:pvecm_adding_nodes_with_separated_cluster_network[add nodes with a separated cluster network].
|
||||||
|
|
||||||
[[separate-cluster-net-after-creation]]
|
[[pvecm_separate_cluster_net_after_creation]]
|
||||||
Separate After Cluster Creation
|
Separate After Cluster Creation
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||||
|
|
||||||
@ -521,7 +521,7 @@ its communication to another network, without rebuilding the whole cluster.
|
|||||||
This change may lead to short durations of quorum loss in the cluster, as nodes
|
This change may lead to short durations of quorum loss in the cluster, as nodes
|
||||||
have to restart corosync and come up one after the other on the new network.
|
have to restart corosync and come up one after the other on the new network.
|
||||||
|
|
||||||
Check how to <<edit-corosync-conf,edit the corosync.conf file>> first.
|
Check how to xref:pvecm_edit_corosync_conf[edit the corosync.conf file] first.
|
||||||
The open it and you should see a file similar to:
|
The open it and you should see a file similar to:
|
||||||
|
|
||||||
----
|
----
|
||||||
@ -579,7 +579,7 @@ you do not see them already. Those *must* match the node name.
|
|||||||
Then replace the address from the 'ring0_addr' properties with the new
|
Then replace the address from the 'ring0_addr' properties with the new
|
||||||
addresses. You may use plain IP addresses or also hostnames here. If you use
|
addresses. You may use plain IP addresses or also hostnames here. If you use
|
||||||
hostnames ensure that they are resolvable from all nodes. (see also
|
hostnames ensure that they are resolvable from all nodes. (see also
|
||||||
<<corosync-addresses,Ring Address Types>>)
|
xref:pvecm_corosync_addresses[Ring Address Types])
|
||||||
|
|
||||||
In my example I want to switch my cluster communication to the 10.10.10.1/25
|
In my example I want to switch my cluster communication to the 10.10.10.1/25
|
||||||
network. So I replace all 'ring0_addr' respectively. I also set the bindnetaddr
|
network. So I replace all 'ring0_addr' respectively. I also set the bindnetaddr
|
||||||
@ -640,7 +640,7 @@ totem {
|
|||||||
----
|
----
|
||||||
|
|
||||||
Now after a final check whether all changed information is correct we save it
|
Now after a final check whether all changed information is correct we save it
|
||||||
and see again the <<edit-corosync-conf,edit corosync.conf file>> section to
|
and see again the xref:pvecm_edit_corosync_conf[edit corosync.conf file] section to
|
||||||
learn how to bring it in effect.
|
learn how to bring it in effect.
|
||||||
|
|
||||||
As our change cannot be enforced live from corosync we have to do an restart.
|
As our change cannot be enforced live from corosync we have to do an restart.
|
||||||
@ -661,7 +661,7 @@ systemctl status corosync
|
|||||||
If corosync runs again correct restart corosync also on all other nodes.
|
If corosync runs again correct restart corosync also on all other nodes.
|
||||||
They will then join the cluster membership one by one on the new network.
|
They will then join the cluster membership one by one on the new network.
|
||||||
|
|
||||||
[[corosync-addresses]]
|
[[pvecm_corosync_addresses]]
|
||||||
Corosync addresses
|
Corosync addresses
|
||||||
~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
@ -708,7 +708,7 @@ RRP On Cluster Creation
|
|||||||
The 'pvecm create' command provides the additional parameters 'bindnetX_addr',
|
The 'pvecm create' command provides the additional parameters 'bindnetX_addr',
|
||||||
'ringX_addr' and 'rrp_mode', can be used for RRP configuration.
|
'ringX_addr' and 'rrp_mode', can be used for RRP configuration.
|
||||||
|
|
||||||
NOTE: See the <<corosync-conf-glossary,glossary>> if you do not know what each parameter means.
|
NOTE: See the xref:pvecm_corosync_conf_glossary[glossary] if you do not know what each parameter means.
|
||||||
|
|
||||||
So if you have two networks, one on the 10.10.10.1/24 and the other on the
|
So if you have two networks, one on the 10.10.10.1/24 and the other on the
|
||||||
10.10.20.1/24 subnet you would execute:
|
10.10.20.1/24 subnet you would execute:
|
||||||
@ -723,7 +723,7 @@ RRP On Existing Clusters
|
|||||||
~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
You will take similar steps as described in
|
You will take similar steps as described in
|
||||||
<<separate-cluster-net-after-creation,separating the cluster network>> to
|
xref:pvecm_separate_cluster_net_after_creation[separating the cluster network] to
|
||||||
enable RRP on an already running cluster. The single difference is, that you
|
enable RRP on an already running cluster. The single difference is, that you
|
||||||
will add `ring1` and use it instead of `ring0`.
|
will add `ring1` and use it instead of `ring0`.
|
||||||
|
|
||||||
@ -781,7 +781,7 @@ nodelist {
|
|||||||
----
|
----
|
||||||
|
|
||||||
Bring it in effect like described in the
|
Bring it in effect like described in the
|
||||||
<<edit-corosync-conf,edit the corosync.conf file>> section.
|
xref:pvecm_edit_corosync_conf[edit the corosync.conf file] section.
|
||||||
|
|
||||||
This is a change which cannot take live in effect and needs at least a restart
|
This is a change which cannot take live in effect and needs at least a restart
|
||||||
of corosync. Recommended is a restart of the whole cluster.
|
of corosync. Recommended is a restart of the whole cluster.
|
||||||
@ -979,7 +979,7 @@ For node membership you should always use the `pvecm` tool provided by {pve}.
|
|||||||
You may have to edit the configuration file manually for other changes.
|
You may have to edit the configuration file manually for other changes.
|
||||||
Here are a few best practice tips for doing this.
|
Here are a few best practice tips for doing this.
|
||||||
|
|
||||||
[[edit-corosync-conf]]
|
[[pvecm_edit_corosync_conf]]
|
||||||
Edit corosync.conf
|
Edit corosync.conf
|
||||||
~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
@ -1075,7 +1075,7 @@ the same content to avoid split brains. If you are not sure what went wrong
|
|||||||
it's best to ask the Proxmox Community to help you.
|
it's best to ask the Proxmox Community to help you.
|
||||||
|
|
||||||
|
|
||||||
[[corosync-conf-glossary]]
|
[[pvecm_corosync_conf_glossary]]
|
||||||
Corosync Configuration Glossary
|
Corosync Configuration Glossary
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user