Skip to content

Commit 2759690

Browse files
committed
PS-9383 Test and update Quickstart for 8.4
new file: docs/quickstart-apt.md new file: docs/quickstart-docker.md modified: docs/quickstart-overview.md modified: mkdocs-base.yml
1 parent 09b8749 commit 2759690

11 files changed

+1637
-28
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-26
Original file line numberDiff line numberDiff line change
@@ -1,46 +1,42 @@
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

6-
## Install Percona Server for MySQL
5+
To start with Percona Server for MySQL quickly, this Quickstart guide focuses on either using Docker, or installing with APT or YUM.
76

8-
You can install Percona Server for MySQL using different methods.
7+
You can explore alternative installation options in the [Install] section of the Percona Server for MySQL documentation.
98

10-
* [Use the Percona Repositories](installation.md)
11-
* [Use APT](apt-repo.md)
12-
* [Use YUM](yum-repo.md)
13-
* [Use binary tarballs](binary-tarball-install.md)
14-
* [Use Docker](docker.md)
159

16-
## For backups and restores
10+
## Purpose of the Quickstart
1711

18-
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.
12+
This document guides you through the initial setup process, including setting a root password in either APT or YUM, creating a database.
1913

20-
[Install Percona XtraBackup](https://docs.percona.com/percona-xtrabackup/innovation-release/installation.html)
14+
You can also do the following:
2115

22-
## For Monitoring and Management
16+
* [Download and install Percona Server for MySQL packages for your operating system](installation.md)
2317

24-
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.
18+
* 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.
2519

26-
[Install PMM and connect your MySQL instances to it](https://docs.percona.com/percona-monitoring-and-management/get-started/index.html).
2720

28-
## For high availability
21+
## Steps for first-time users
2922

30-
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.
23+
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.
3124

32-
[Percona XtraDB Cluster Quick start guide](https://docs.percona.com/percona-xtradb-cluster/8.0/quickstart-overview.html)
3325

34-
## Operators
26+
## Next steps
3527

36-
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.
28+
[Run and create database (container):material-arrow-right:](quickstart-docker.md){.md-button}
3729

38-
[Percona Operator for MySQL Documentation](https://docs.percona.com/percona-operator-for-mysql/ps/)
30+
[Install and create database (Ubuntu):material-arrow-right:](quickstart-apt.md){.md-button}
3931

40-
[Percona Operator for MySQL based on Percona XtraDB Cluster](https://docs.percona.com/percona-operator-for-mysql/pxc/)
32+
[Install and create database (Oracle Linux):material-arrow-right:](quickstart-yum.md){.md-button}
4133

42-
## Cloud-native database services
34+
[Choose your next steps:material-arrow-right:](quickstart-next-steps.md){.md-button}
4335

44-
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.
4536

46-
[Percona Everest](https://docs.percona.com/everest/index.html)
37+
38+
39+
40+
[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
41+
42+
[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

0 commit comments

Comments
 (0)