Skip to content

Commit 116243a

Browse files
docs: remove versioned content (#124)
This removes content that is not relevant anymore for the updated documentation, and is part of the work in our transition spec to remove versioned content from our docs. That information will still live in the docs in the 3.6 branch, see #120 for more details.
1 parent db29503 commit 116243a

11 files changed

Lines changed: 15 additions & 36 deletions

File tree

rtd-docs/explanation/deploying-machines.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -47,9 +47,9 @@ Curtin supports preseed files, allowing administrators to influence how storage,
4747

4848
Between curtin preseeds and cloud-init user-data, you can tailor deployments to a very fine level of detail.
4949

50-
## Ephemeral OS deployments (MAAS 3.5+)
50+
## Ephemeral OS deployments
5151

52-
Since MAAS 3.5, you can choose to deploy an ephemeral OS instance:
52+
You can choose to deploy an ephemeral OS instance:
5353

5454
- The entire operating system runs from memory, with no disk installation.
5555
- This is useful for stateless workloads, temporary testing, or security-sensitive use cases.

rtd-docs/explanation/logging.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@
22

33
This page describes basic MAAS logging operations.
44

5-
## Logging updates in MAAS 3.5
5+
## Logging in MAAS
66

7-
In 3.5, the MAAS snap uses the [Pebble](https://github.com/canonical/pebble) service manager instead of `supervisord`. This means that the `systemd` component was renamed to `snap.maas.pebble.service`. It contains Pebble logs, as well as intercepted stdout of the services running under Pebble. The region and rack logs are cached there, as well (i.e., `regiond.log` and `rackd.log` are no more -- supervisord was redirecting the stdout of the respective services).
7+
The MAAS snap uses the [Pebble](https://github.com/canonical/pebble) service manager, with the systemd component being named `snap.maas.pebble.service`. It contains Pebble logs, as well as intercepted stdout of the services running under Pebble. The region and rack logs are cached there, as well.
88

9-
Here is a per-service breakdown how logging works in MAAS 3.5:
9+
Here is a per-service breakdown how logging works in MAAS:
1010

1111
### Pebble
1212

rtd-docs/explanation/machine-customization.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Before a machine is deployed, you can customise:
1313

1414
## Post-deployment detection
1515

16-
From MAAS 3.2 onward, you can modify a running machine outside MAAS (e.g. by swapping hardware or adjusting a VM definition). MAAS can then detect:
16+
You can modify a running machine outside MAAS (e.g. by swapping hardware or adjusting a VM definition). MAAS can then detect:
1717

1818
- Added or removed disks.
1919
- Added or removed NICs.

rtd-docs/how-to-guides/deploy-a-fips-kernel.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ The kernel FIPS kernel isn't directly integrated into MAAS. Instead, cloud-init
2121
## What you'll need
2222

2323
1. Valid Ubuntu Pro token (find yours at [Ubuntu Pro Dashboard](https://ubuntu.com/pro/dashboard)^^*^^).
24-
2. MAAS 3.2 or later with Ubuntu 22.04 LTS images.
24+
2. Ubuntu 22.04 LTS images.
2525
3. A host compatible with Ubuntu FIPS-compliant kernel.
2626
4. Internet connection.
2727

rtd-docs/how-to-guides/deploy-a-real-time-kernel.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ The RT kernel isn't directly integrated into MAAS. Instead, cloud-init is used t
2323
## What you'll need
2424

2525
1. Valid Ubuntu Pro token (find yours at [Ubuntu Pro Dashboard](https://ubuntu.com/pro/dashboard)^^*^^).
26-
2. MAAS 3.2 or later with Ubuntu 22.04 LTS images.
26+
2. Ubuntu 22.04 LTS images.
2727
3. A host compatible with Ubuntu RT kernel.
2828
4. Internet connection.
2929

rtd-docs/how-to-guides/deploy-dpus.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# Deploy DPUs
22

3-
A Data Processing Unit (DPU) is a specialized network interface card that offloads networking, storage, and security tasks from the CPU. MAAS 3.7 introduced BMC-based control for NVIDIA BlueField 3 DPUs, enabling them to be managed like standard machines in the MAAS infrastructure.
3+
A Data Processing Unit (DPU) is a specialized network interface card that offloads networking, storage, and security tasks from the CPU. MAAS supports BMC-based control for NVIDIA BlueField 3 DPUs, enabling them to be managed like standard machines in the MAAS infrastructure.
44

5-
This guide explains how to configure, add, commission, deploy, and release NVIDIA BlueField 3 DPUs in MAAS 3.7 and later.
5+
This guide explains how to configure, add, commission, deploy, and release NVIDIA BlueField 3 DPUs.
66

77
**Note**: BlueField 2 DPUs can still be added and controlled using the manual approach described in previous [documentation](https://discourse.maas.io/t/maas-and-dpus/6390). This guide focuses on the BMC-enabled workflow for BlueField 3 devices.
88

@@ -12,7 +12,6 @@ Before deploying a DPU in MAAS, ensure you have the following:
1212

1313
### Infrastructure Requirements
1414

15-
- **MAAS 3.7 or later** installed and configured
1615
- **NVIDIA BlueField 3 DPU** with BMC support
1716
- **Host machine** powered on (the DPU resides within this host)
1817
- **Network infrastructure** configured for PXE boot on the OOB management interface

rtd-docs/how-to-guides/deploy-vms-on-ibm-z.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Deploy VMs on IBM Z
22

3-
You can deploy virtual machines on the IBM Z series with MAAS version 3.0 or higher.
3+
You can deploy virtual machines on the IBM Z series with MAAS.
44

55
The IBM Z or LinuxONE system can host MAAS controllers and is able to deploy predefined logical partitions (LPARs) KVM host(s), and virtual machines, if the mainframe is set up properly for MAAS.
66

rtd-docs/how-to-guides/manage-machine-groups.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -385,8 +385,6 @@ maas $PROFILE machines read | jq -r '.[] | select(.description != null and .desc
385385

386386
Dynamic annotations are ephemeral, key–value metadata attached to machines. They only exist during allocation or deployment and are lost when the machine is released.
387387

388-
> **Note**: Dynamic annotations are not supported in MAAS 2.9 or earlier.
389-
390388
### Identify eligible machines
391389

392390
**CLI only**

rtd-docs/how-to-guides/sso.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Single Sign-On (SSO) allows users to log in to multiple applications with a single set of credentials. In MAAS, you can configure SSO using an external identity provider (IdP) that supports the OpenID Connect (OIDC) protocol.
44

5-
This guide explains how to configure SSO using an OIDC-compliant IdP in MAAS 3.8 and later versions.
5+
This guide explains how to configure SSO using an OIDC-compliant IdP in MAAS.
66

77
## Prerequisites
88

rtd-docs/how-to-guides/use-logging.md

Lines changed: 2 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,9 @@ MAAS logs help you find issues, spot configuration mistakes, and audit the use o
1010

1111
Each of these has a specific purpose, as described in this document.
1212

13-
## Checking logs in systemd (MAAS 3.5 and Newer)
13+
## Checking logs in systemd
1414

15-
Understanding what MAAS is doing under the hood is critical when troubleshooting unexpected behavior — whether a machine fails to deploy, a controller won’t respond, or an API call returns errors. Starting with version 3.5, MAAS uses `systemd` journal logs instead of log files written to disk. This change offers a more efficient and centralized way to inspect logs, in context, in real time.
15+
Understanding what MAAS is doing under the hood is critical when troubleshooting unexpected behavior — whether a machine fails to deploy, a controller won’t respond, or an API call returns errors. MAAS uses `systemd` to provide an efficient and centralized way to inspect logs, in context, in real time.
1616

1717
### Region controller logs
1818

@@ -46,16 +46,6 @@ To search for logs by machine name (hostname):
4646
journalctl -u snap.maas.pebble -t maas-machine --since "-15m" MAAS_MACHINE_HOSTNAME=ace-cougar
4747
```
4848

49-
## Checking logs before MAAS 3.5
50-
51-
Before version 3.5, MAAS saved logs in custom files. Here are some examples:
52-
53-
- Region Controller: `/var/snap/maas/common/log/regiond.log` or `/var/log/maas/regiond.log`
54-
55-
- Rack Controller: `/var/snap/maas/common/log/rackd.log` or `/var/log/maas/rackd.log`
56-
57-
- Proxy: `/var/snap/maas/common/log/proxy/access.log`
58-
5949
### Using the less command to read logs
6050

6151
```

0 commit comments

Comments
 (0)