Skip to content

Commit ed70aa0

Browse files
Sync docs from Discourse (#633)
Co-authored-by: GitHub Actions <41898282+github-actions[bot]@users.noreply.github.com>
1 parent 2165853 commit ed70aa0

File tree

2 files changed

+36
-2
lines changed

2 files changed

+36
-2
lines changed

docs/how-to/h-restore-backup.md

Lines changed: 24 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,10 +15,14 @@ To restore a backup that was made from the a *different* cluster, (i.e. cluster
1515
- Access to S3 storage
1616
- [Have configured settings for S3 storage](/t/9894)
1717
- [Have existing backups in your S3-storage](/t/9896)
18+
- Point-in-time recovery requires the following MySQL charm revisions:
19+
* 369+ for `arm64`
20+
* 368+ for `amd64`
1821

1922
## Summary
2023

2124
* [List backups](#list-backups)
25+
* [Point-in-time recovery](#point-in-time-recovery)
2226
* [Restore backup](#restore-backup)
2327

2428
---
@@ -38,11 +42,30 @@ This should show your available backups
3842
YYYY-MM-DDTHH:MM:SSZ | physical | finished
3943
```
4044

45+
## Point-in-time recovery
46+
47+
Point-in-time recovery (PITR) is a MySQL feature that enables restorations to the database state at specific points in time. The feature is enabled by default when there's a working relation with S3 storage.
48+
49+
4150
## Restore backup
4251

4352
To restore a backup from that list, run the `restore` command and pass the `backup-id` to restore:
4453
```shell
4554
juju run mysql/leader restore backup-id=YYYY-MM-DDTHH:MM:SSZ
4655
```
4756

48-
Your restore will then be in progress.
57+
Your restore will then be in progress.
58+
59+
However, if the user needs to restore to a specific point in time between different backups (e.g. to restore only specific transactions made between those backups), they can use the restore-to-time parameter to pass a timestamp related to the moment they want to restore.
60+
61+
```shell
62+
juju run mysql/leader restore restore-to-time="YYYY-MM-DD HH:MM:SS"
63+
```
64+
65+
Your restore will then be in progress.
66+
67+
It’s also possible to restore to the latest point from a specific timeline by passing the ID of a backup taken on that timeline and restore-to-time=latest when requesting a restore:
68+
69+
```shell
70+
juju run mysql/leader restore restore-to-time=latest
71+
```

docs/reference/r-releases.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@ For a given release, this table shows:
1616

1717
| Release | MySQL version | Juju version | [TLS encryption](/t/9898)* | [COS monitoring](/t/9900) | [Minor version upgrades](/t/11748) | [Cross-regional async replication](/t/14169) |
1818
|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
19+
| [366], [367] | 8.0.41 | `3.4.3+` | ![check] | ![check] | ![check] | ![check] |
1920
| [312], [313] | 8.0.39 | `3.4.3+` | ![check] | ![check] | ![check] | ![check] |
2021
| [240] | 8.0.36 | `3.4.3+` | ![check] | ![check] | ![check] | ![check] |
2122
| [196] | 8.0.34 | `3.1.6+` | | ![check] | ![check] | |
@@ -34,14 +35,22 @@ Several [revisions](https://juju.is/docs/sdk/revision) are released simultaneous
3435
> If you deploy a specific revision, **you must make sure it matches your base and architecture** via the tables below or with [`juju info`](https://juju.is/docs/juju/juju-info)
3536
3637

38+
### Release 366-367
39+
40+
| Revision | amd64 | arm64 | Ubuntu 22.04 LTS
41+
|:--------:|:-----:|:-----:|:-----:|
42+
|[366] |![check] | | ![check] |
43+
|[367] | | ![check]| ![check] |
44+
45+
[details=Older releases]
46+
3747
### Release 312-313
3848

3949
| Revision | amd64 | arm64 | Ubuntu 22.04 LTS
4050
|:--------:|:-----:|:-----:|:-----:|
4151
|[313] |![check] | | ![check] |
4252
|[312] | | ![check]| ![check] |
4353

44-
[details=Older releases]
4554

4655
### Release 240
4756

@@ -69,6 +78,8 @@ Several [revisions](https://juju.is/docs/sdk/revision) are released simultaneous
6978

7079
<!-- LINKS -->
7180

81+
[367]: https://github.com/canonical/mysql-operator/releases/tag/rev366
82+
[366]: https://github.com/canonical/mysql-operator/releases/tag/rev366
7283
[313]: https://github.com/canonical/mysql-operator/releases/tag/rev312
7384
[312]: https://github.com/canonical/mysql-operator/releases/tag/rev312
7485
[240]: https://github.com/canonical/mysql-operator/releases/tag/rev240

0 commit comments

Comments
 (0)