Skip to content

Commit a0c3247

Browse files
committed
Merge branch 'master' into testing
2 parents 8a56afe + 96f61c5 commit a0c3247

1 file changed

Lines changed: 11 additions & 9 deletions

File tree

README.md

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,35 @@
11
# Proxmox Qdevice
22

3+
This repository is based on original [work by Bradley Leonard](https://github.com/bcleonard/proxmox-qdevice). Many thanks to his hard work!
4+
35
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.
46

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).
68

79
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).
810

911
Run this container on a device that is *NOT* a virtual instance on one of your proxmox servers.
1012

1113
## Wiki
1214

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.
1416

1517
## Requirements/Prerequisites
1618

1719
Please check the [wiki](https://github.com/bcleonard/proxmox-qdevice/wiki#pre-requisites) for the most up to date information.
1820

1921
## Install:
2022

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.
2224

2325
## Configuration:
2426

2527
Modify the docker-compose.yml file. Make sure to change:
2628

2729
* 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
3133
parent (the ethernet device to bind macvlan)
3234
ipv4_address
3335
subnet
@@ -40,7 +42,7 @@ You can either run the command:
4042

4143
`docker compose up -d`
4244

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.
4446

4547
## Tested as working on:
4648

@@ -51,7 +53,7 @@ or cut and past the docker-compose.yml into portainer.io as a stack and then dep
5153

5254
## Problems & Troubleshooting:
5355

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).
5557

5658
## Security Implications:
5759

@@ -62,7 +64,7 @@ This container installs and configures a sshd server that permits root logins.
6264

6365
Please note that all of the ways listed above to set the environment above should survive the recreation of the container.
6466

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:
6668

6769
```bash
6870
sudo docker exec -it proxmox-qdevice /bin/bash

0 commit comments

Comments
 (0)