Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

PS-9383 [DOCS] - Test and update Quickstart for 8.4 #399

Open
wants to merge 1 commit into
base: 8.4
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added docs/_static/auth-plugin.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/_static/confirm-password.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/_static/mysql-authentication.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/_static/strong-password.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
578 changes: 578 additions & 0 deletions docs/quickstart-apt.md

Large diffs are not rendered by default.

412 changes: 412 additions & 0 deletions docs/quickstart-docker.md

Large diffs are not rendered by default.

65 changes: 65 additions & 0 deletions docs/quickstart-next-steps.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
# Next steps

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:

- Familiarize yourself with the different data types, such as integers, strings, dates, and booleans, and choose the right one for your data.

- Create and use indexes to optimize the performance of your queries and reduce the load on your database server.

- Combine data from multiple tables and sources using joins, subqueries, and unions.

- Use functions, procedures, triggers, and views to encapsulate the logic, automate the tasks, and create reusable components.

- Use transactions, locks, and isolation levels to ensure data integrity and consistency in concurrent operations.

- Use backup and restore tools to protect your data from loss or corruption.

- Use security features, such as users, roles, privileges, and encryption, to protect your data from unauthorized access or modification.

- Use debugging and testing tools like logs, error messages, breakpoints, and assertions to identify and fix errors in your code or queries.

- Use documentation and commenting tools, such as comments, diagrams, schemas, and manuals, to explain and document your code or queries.

These tasks will expand your knowledge and skills in using Percona Server for MySQL and become more confident and proficient in developing database applications.

Review the [Percona Server for MySQL documentation](index.md) for more information.

## Other Percona products

### For backups and restores

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.

[Install Percona XtraBackup](https://docs.percona.com/percona-xtrabackup/8.4/installation.html)

### For monitoring and management

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.

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

### For high availability

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.

[Percona XtraDB Cluster Quick Start guide](https://docs.percona.com/percona-xtradb-cluster/8.4/quickstart-overview.html)

### Advanced command-line tools

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.

[Percona Toolkit documentation](https://docs.percona.com/percona-toolkit/)

### Operators

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.

[Percona Operator for MySQL Documentation](https://docs.percona.com/percona-operator-for-mysql/ps/)

[Percona Operator for MySQL based on Percona XtraDB Cluster](https://docs.percona.com/percona-operator-for-mysql/pxc/)

### Cloud-native database services

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.

[Percona Everest](https://docs.percona.com/everest/index.html)
48 changes: 22 additions & 26 deletions docs/quickstart-overview.md
Original file line number Diff line number Diff line change
@@ -1,46 +1,42 @@
# Quickstart guide for Percona Server for MySQL
# Overview

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.
Percona Server for MySQL is trusted by thousands of enterprises to provide better performance and concurrency for their most demanding workloads.
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.

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

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

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

## For backups and restores
## Purpose of the Quickstart

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

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

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

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.
* 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.

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

## For high availability
## Steps for first-time users

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

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

## Operators
## Next steps

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

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

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

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

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.

[Percona Everest](https://docs.percona.com/everest/index.html)



[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

[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
Loading