[doc] Improve/reorg HA documentation and cover upgrades.
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
MAAS |
Invalid
|
High
|
Spencer Seidel |
Bug Description
While the HA documentation provides some good information on how to setup HA, it is not very clear on how to configure the primary region controller and manage it long term. The docs should be updated to include:
1. Clarify that Postgresql
1. How to install/configure the first (or primary) region controller
A sample outline should be:
0. Include a diagram of HA.
1. Configuring postgresql
- Clarify that postgresql HA is not covered here.
- Required changes for max_connections.
- Reguired changes to allow connections from other regions.
2. Install/configure primary region
- Install initial region(or region/rack)
- Configure MAAS to point to DB
- Running migrations
- Initial configuration commands.
3. Install/configure extra region controllers
- Install maas-region-api
- Configure MAAS to point to DB
- Initial configuration commands
4. Rack Controller HA
- Describe communication between rack/region
- Describe configuration options (e.g. let rack to automatically discover region endpoints or manually specifying them).
- Multiple rack controllers for HA
- Explain DHCP ha with multiple in the same VLAN
- Explain how machines communicate with rack when MAAS managed DHCP
- Explain how machines communicate with rack when NOT MAAS managed DHCP.
5. Upgrading a MAAS in HA mode (running migrations, etc).
Changed in maas: | |
milestone: | none → 2.5.0 |
importance: | Undecided → High |
status: | New → Triaged |
description: | updated |
Changed in maas: | |
assignee: | nobody → Spencer Seidel (jsseidel) |
tags: | added: customer track |
description: | updated |
summary: |
- [doc] Improve HA documentation for long term maintenance + [doc] Improve/reorg HA documentation and cover upgrades. |
tags: | added: docs |
tags: | removed: customer |
Changed in maas: | |
milestone: | 2.5.0 → 2.5.x |
This bug has not seen any activity in the last 6 months, so it is being automatically closed.
If you are still experiencing this issue, please feel free to re-open.
MAAS Team