[doc] Improve/reorg HA documentation and cover upgrades.

Bug #1803201 reported by Andres Rodriguez
18
This bug affects 2 people
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).

Tags: docs track
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
Revision history for this message
Adam Collard (adam-collard) wrote :

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

Changed in maas:
status: Triaged → Invalid
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Duplicates of this bug

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.