You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+11-9Lines changed: 11 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,33 +1,35 @@
1
1
# Proxmox Qdevice
2
2
3
+
This repository is based on original [work by Bradley Leonard](https://github.com/bcleonard/proxmox-qdevice). Many thanks to his hard work!
4
+
3
5
This repository will allow you build and deploy a docker container for use with a proxmox cluster as an external qdevice. Properly configured proxmox clusters require an odd number servers in the cluster. In the event that you have an even number of proxmox servers (like 2, such as I have), you need an another device to vote. Proxmox supports this by allow you to configure a qdevice for an external vote.
4
6
5
-
Normally running an even number of servers in a cluster isn't a problem, but I've had situations where I've booted both promox servers at the same time. In that case, the first server to come online doesn't have a quarum (1 of 2) so the images won't start. The 2nd server will (2 of 2). With an external qdevice thats already up, the first device to come up has quarom (2 of 3).
7
+
Normally running an even number of servers in a cluster isn't a problem, but I've had situations where I've booted both proxmox servers at the same time. In that case, the first server to come online doesn't have a quarum (1 of 2) so the images won't start. The 2nd server will (2 of 2). With an external qdevice thats already up, the first device to come up has quarom (2 of 3).
6
8
7
9
For more information on proxmmox clusters, external qdevices, and how to configure/use them, go [here](https://pve.proxmox.com/wiki/Cluster_Manager#_corosync_external_vote_support).
8
10
9
11
Run this container on a device that is *NOT* a virtual instance on one of your proxmox servers.
10
12
11
13
## Wiki
12
14
13
-
A wiki has been created [here](https://github.com/bcleonard/proxmox-qdevice/wiki) which contains all kinds of information.
15
+
Bradley's original wiki [can be found here](https://github.com/bcleonard/proxmox-qdevice/wiki) which contains all kinds of information on configuring this container.
14
16
15
17
## Requirements/Prerequisites
16
18
17
19
Please check the [wiki](https://github.com/bcleonard/proxmox-qdevice/wiki#pre-requisites) for the most up to date information.
18
20
19
21
## Install:
20
22
21
-
This repo is designed to run from either docker compose or a container manager, like Portainer.
23
+
This container is designed to run from either Docker Compose or a container manager, like Portainer.
22
24
23
25
## Configuration:
24
26
25
27
Modify the docker-compose.yml file. Make sure to change:
26
28
27
29
* Environment Variable NEW_ROOT_PASSWORD
28
-
*location of your corosync-data (so you can keep your configuration between restarts, etc.)
29
-
*hostname
30
-
*local network information
30
+
*Location of your corosync-data (so you can keep your configuration between restarts, etc.)
31
+
*Hostname
32
+
*Local network information
31
33
parent (the ethernet device to bind macvlan)
32
34
ipv4_address
33
35
subnet
@@ -40,7 +42,7 @@ You can either run the command:
40
42
41
43
`docker compose up -d`
42
44
43
-
or cut and past the docker-compose.yml into portainer.io as a stack and then deploy.
45
+
Or cut and paste the docker-compose.yml into portainer.io as a stack and then deploy.
44
46
45
47
## Tested as working on:
46
48
@@ -51,7 +53,7 @@ or cut and past the docker-compose.yml into portainer.io as a stack and then dep
51
53
52
54
## Problems & Troubleshooting:
53
55
54
-
* You can find the most up to date information on issues, known problems and troubleshooting by reviewing the [issues](https://github.com/bcleonard/proxmox-qdevice/issues) and what is [not supported](https://github.com/bcleonard/proxmox-qdevice/wiki#whats-not-supported).
56
+
* You can find the most up to date information on issues, known problems and troubleshooting by reviewing the [issues](https://github.com/unixerius/proxmox-qdevice/issues).
55
57
56
58
## Security Implications:
57
59
@@ -62,7 +64,7 @@ This container installs and configures a sshd server that permits root logins.
62
64
63
65
Please note that all of the ways listed above to set the environment above should survive the recreation of the container.
64
66
65
-
An alternative would be to **NOT SET** the password at all and change it after the container has started and is running. Please note that this method will not survive the recreation of the container. This means you have to change the passwor manually every time you upgrade and/or recreate the container. To change the password after the container has started, do the following:
67
+
An alternative would be to **NOT SET** the password at all and change it after the container has started and is running. Please note that this method will not survive the recreation of the container. This means you have to change the password manually every time you upgrade and/or recreate the container. To change the password after the container has started, do the following:
0 commit comments