Skip to content

Commit 56ce316

Browse files
authoredJan 30, 2025··
Merge pull request #399 from percona/ps-9383
PS-9383 [DOCS] - Test and update Quickstart for 8.4
2 parents 4fb4162 + cf37c42 commit 56ce316

11 files changed

+1638
-27
lines changed
 

‎docs/_static/auth-plugin.png

23 KB
Loading

‎docs/_static/confirm-password.png

55.7 KB
Loading

‎docs/_static/mysql-authentication.png

176 KB
Loading

‎docs/_static/strong-password.png

60.2 KB
Loading

‎docs/quickstart-apt.md

+578
Large diffs are not rendered by default.

‎docs/quickstart-docker.md

+412
Large diffs are not rendered by default.

‎docs/quickstart-next-steps.md

+65
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
# Next steps
2+
3+
After creating a database and running queries, you have taken the first steps to become a MySQL beginner developer. However, there is still more to learn and practice to improve your skills and knowledge. Some of the next steps you can take are learning and using the following:
4+
5+
- Familiarize yourself with the different data types, such as integers, strings, dates, and booleans, and choose the right one for your data.
6+
7+
- Create and use indexes to optimize the performance of your queries and reduce the load on your database server.
8+
9+
- Combine data from multiple tables and sources using joins, subqueries, and unions.
10+
11+
- Use functions, procedures, triggers, and views to encapsulate the logic, automate the tasks, and create reusable components.
12+
13+
- Use transactions, locks, and isolation levels to ensure data integrity and consistency in concurrent operations.
14+
15+
- Use backup and restore tools to protect your data from loss or corruption.
16+
17+
- Use security features, such as users, roles, privileges, and encryption, to protect your data from unauthorized access or modification.
18+
19+
- Use debugging and testing tools like logs, error messages, breakpoints, and assertions to identify and fix errors in your code or queries.
20+
21+
- Use documentation and commenting tools, such as comments, diagrams, schemas, and manuals, to explain and document your code or queries.
22+
23+
These tasks will expand your knowledge and skills in using Percona Server for MySQL and become more confident and proficient in developing database applications.
24+
25+
Review the [Percona Server for MySQL documentation](index.md) for more information.
26+
27+
## Other Percona products
28+
29+
### For backups and restores
30+
31+
Percona XtraBackup (PXB) is a 100% open source backup solution for all versions of Percona Server for MySQL and MySQL® that performs online non-blocking, tightly compressed, highly secure full backups on transactional systems. Maintain fully available applications during planned maintenance windows with Percona XtraBackup.
32+
33+
[Install Percona XtraBackup](https://docs.percona.com/percona-xtrabackup/8.4/installation.html)
34+
35+
### For monitoring and management
36+
37+
Percona Monitoring and Management (PMM )monitors and provides actionable performance data for MySQL variants, including Percona Server for MySQL, Percona XtraDB Cluster, Oracle MySQL Community Edition, Oracle MySQL Enterprise Edition, and MariaDB. PMM captures metrics and data for the InnoDB, XtraDB, and MyRocks storage engines, and has specialized dashboards for specific engine details.
38+
39+
[Install PMM and connect your MySQL instances to it](https://docs.percona.com/percona-monitoring-and-management/get-started/index.html).
40+
41+
### For high availability
42+
43+
Percona XtraDB Cluster (PXC) is a 100% open source, enterprise-grade, highly available clustering solution for MySQL multi-master setups based on Galera. PXC helps enterprises minimize unexpected downtime and data loss, reduce costs, and improve the performance and scalability of their database environments, supporting their critical business applications in the most demanding public, private, and hybrid cloud environments.
44+
45+
[Percona XtraDB Cluster Quick Start guide](https://docs.percona.com/percona-xtradb-cluster/8.4/quickstart-overview.html)
46+
47+
### Advanced command-line tools
48+
49+
Percona Toolkit is a collection of advanced command-line tools used by the Percona support staff to perform various MySQL, MongoDB, and system tasks that are complex or difficult to perform manually. These tools are ideal alternatives to “one-off” scripts because they are professionally developed, formally tested, and documented. Each tool is self-contained, so installation is quick and easy and does not install libraries.
50+
51+
[Percona Toolkit documentation](https://docs.percona.com/percona-toolkit/)
52+
53+
### Operators
54+
55+
Percona Operator for MySQL and Percona Operator for MySQL based on Percona XtraDB Cluster are tools designed to simplify the deployment, management, and scaling of MySQL and Percona XtraDB Cluster (PXC) instances in Kubernetes environments. These operators automate various database tasks such as backups, recovery, and updates, ensuring high availability and reliability. They provide robust features like automated failover, self-healing, and seamless scaling, which help maintain optimal database performance and reduce manual intervention. By leveraging Kubernetes' orchestration capabilities, these operators enhance the efficiency and resilience of MySQL and PXC deployments, making them well-suited for modern cloud-native applications.
56+
57+
[Percona Operator for MySQL Documentation](https://docs.percona.com/percona-operator-for-mysql/ps/)
58+
59+
[Percona Operator for MySQL based on Percona XtraDB Cluster](https://docs.percona.com/percona-operator-for-mysql/pxc/)
60+
61+
### Cloud-native database services
62+
63+
Percona Everest is an open-source cloud-native database platform that helps developers deploy code faster, scale deployments rapidly, and reduce database administration overhead while regaining control over their data, database configuration, and DBaaS costs.
64+
65+
[Percona Everest](https://docs.percona.com/everest/index.html)

‎docs/quickstart-overview.md

+22-25
Original file line numberDiff line numberDiff line change
@@ -1,48 +1,45 @@
1-
# Quickstart guide for Percona Server for MySQL
1+
# Overview
22

3-
Percona Server for MySQL is a freely available, fully compatible, enhanced, and open source drop-in replacement for any MySQL database. It provides superior and optimized performance, greater scalability and availability, enhanced backups, increased visibility, and instrumentation.
4-
Percona Server for MySQL is trusted by thousands of enterprises to provide better performance and concurrency for their most demanding workloads.
3+
Percona Server for MySQL is a freely available, fully compatible, enhanced, and open source drop-in replacement for any MySQL database and provides enterprise-grade features in security, availability, data management, visibility, instrumentation, and performance.
54

65
--8<--- "get-help-snip.md"
76

87
## Install Percona Server for MySQL
98

10-
You can install Percona Server for MySQL using different methods.
119

12-
* [Use the Percona Repositories](installation.md)
13-
* [Use APT](apt-repo.md)
14-
* [Use YUM](yum-repo.md)
15-
* [Use binary tarballs](binary-tarball-install.md)
16-
* [Use Docker](docker.md)
10+
You can explore alternative installation options in the [Install] section of the Percona Server for MySQL documentation.
1711

18-
## For backups and restores
1912

20-
Percona XtraBackup (PXB) is a 100% open source backup solution for all versions of Percona Server for MySQL and MySQL® that performs online non-blocking, tightly compressed, highly secure full backups on transactional systems. Maintain fully available applications during planned maintenance windows with Percona XtraBackup.
13+
## Purpose of the Quickstart
2114

22-
[Install Percona XtraBackup](https://docs.percona.com/percona-xtrabackup/innovation-release/installation.html)
15+
This document guides you through the initial setup process, including setting a root password in either APT or YUM, creating a database.
2316

24-
## For Monitoring and Management
17+
You can also do the following:
2518

26-
Percona Monitoring and Management (PMM )monitors and provides actionable performance data for MySQL variants, including Percona Server for MySQL, Percona XtraDB Cluster, Oracle MySQL Community Edition, Oracle MySQL Enterprise Edition, and MariaDB. PMM captures metrics and data for the InnoDB, XtraDB, and MyRocks storage engines, and has specialized dashboards for specific engine details.
19+
* [Download and install Percona Server for MySQL packages for your operating system](installation.md)
2720

28-
[Install PMM and connect your MySQL instances to it](https://docs.percona.com/percona-monitoring-and-management/get-started/index.html).
21+
* Work with [the Quickstart for the Percona Operator for MySQL based on the Percona Server for MySQL using Helm] or [the Quickstart for the Percona Operator for MySQL based on the Percona Server for MySQL using Minikube] to find out more about the Percona Operator.
2922

30-
## For high availability
3123

32-
Percona XtraDB Cluster (PXC) is a 100% open source, enterprise-grade, highly available clustering solution for MySQL multi-source setups based on Galera. PXC helps enterprises minimize unexpected downtime and data loss, reduce costs, and improve performance and scalability of your database environments supporting your critical business applications in the most demanding public, private, and hybrid cloud environments.
24+
## Steps for first-time users
3325

34-
[Percona XtraDB Cluster Quick start guide](https://docs.percona.com/percona-xtradb-cluster/8.0/quickstart-overview.html)
26+
The following guides walk you through the setup process and working with a database for a developer. Select the installation method that works best in your environment.
3527

36-
## Operators
3728

38-
Percona Operator for MySQL and Percona Operator for MySQL based on Percona XtraDB Cluster are tools designed to simplify the deployment, management, and scaling of MySQL and Percona XtraDB Cluster (PXC) instances in Kubernetes environments. These operators automate various database tasks such as backups, recovery, and updates, ensuring high availability and reliability. They provide robust features like automated failover, self-healing, and seamless scaling, which help maintain optimal database performance and reduce manual intervention. By leveraging Kubernetes' orchestration capabilities, these operators enhance the efficiency and resilience of MySQL and PXC deployments, making them well-suited for modern cloud-native applications.
29+
## Next steps
3930

40-
[Percona Operator for MySQL Documentation](https://docs.percona.com/percona-operator-for-mysql/ps/)
31+
[Run and create database (container):material-arrow-right:](quickstart-docker.md){.md-button}
4132

42-
[Percona Operator for MySQL based on Percona XtraDB Cluster](https://docs.percona.com/percona-operator-for-mysql/pxc/)
33+
[Install and create database (Ubuntu):material-arrow-right:](quickstart-apt.md){.md-button}
4334

44-
## Cloud-native database services
35+
[Install and create database (Oracle Linux):material-arrow-right:](quickstart-yum.md){.md-button}
4536

46-
Percona Everest is an open-source cloud-native database platform that helps developers deploy code faster, scale deployments rapidly, and reduce database administration overhead while regaining control over their data, database configuration, and DBaaS costs.
37+
[Choose your next steps:material-arrow-right:](quickstart-next-steps.md){.md-button}
4738

48-
[Percona Everest](https://docs.percona.com/everest/index.html)
39+
40+
41+
42+
43+
[the Quickstart for the Percona Operator for MySQL based on the Percona Server for MySQL using Helm]: https://docs.percona.com/percona-operator-for-mysql/ps/helm.html
44+
45+
[the Quickstart for the Percona Operator for MySQL based on the Percona Server for MySQL using Minikube]: https://docs.percona.com/percona-operator-for-mysql/ps/minikube.html

‎docs/quickstart-yum.md

+550
Large diffs are not rendered by default.

‎mkdocs-base.yml

+6-2
Original file line numberDiff line numberDiff line change
@@ -189,8 +189,12 @@ nav:
189189
- trigger-updates.md
190190
- udf-percona-toolkit.md
191191
- utility-user.md
192-
- Quickstart guide:
193-
- quickstart-overview.md
192+
- Quickstart:
193+
- Quickstart - Overview: quickstart-overview.md
194+
- Quickstart - Run and create database (containers): quickstart-docker.md
195+
- Quickstart - Install and create database (Ubuntu): quickstart-apt.md
196+
- Quickstart - Install and create database (Oracle Linux): quickstart-yum.md
197+
- Quickstart - Next steps: quickstart-next-steps.md
194198
- Install:
195199
- Install Percona Server for MySQL from repositories: installation.md
196200
- Before you start:

‎variables.yml

+5
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,11 @@ release: '8.4.3-3'
44
version: '8.4'
55
vers: '8.4' # we are going to use it instead of version
66
pkg: 'ps-84-lts'
7+
pro_release: '8.4.3-3'
8+
tag: '8.4.3'
9+
arm_tag: '8.4.3-aarch64'
10+
year_tag: '2024'
711
release_date: '2024-12-18'
812
title_date: '2024-12-18'
913

14+

0 commit comments

Comments
 (0)
Please sign in to comment.