From 25a4adf9b4331a14c00b2dcb7abb9ed3a1955a20 Mon Sep 17 00:00:00 2001 From: tbaka Date: Fri, 28 Feb 2025 08:30:28 -0600 Subject: [PATCH 1/2] updates distro and instructions --- docs/marketplace-docs/guides/mysql/index.md | 54 ++++++++------------- 1 file changed, 21 insertions(+), 33 deletions(-) diff --git a/docs/marketplace-docs/guides/mysql/index.md b/docs/marketplace-docs/guides/mysql/index.md index 7a0f231e893..8ea68964f97 100644 --- a/docs/marketplace-docs/guides/mysql/index.md +++ b/docs/marketplace-docs/guides/mysql/index.md @@ -2,7 +2,7 @@ title: "Deploy MySQL/MariaDB through the Linode Marketplace" description: "This guide shows how to install and configure MySQL/MariaDB so you can run databases for anything from a CRM to WordPress by using the Linode One-Click Marketplace." published: 2020-03-13 -modified: 2022-03-08 +modified: 2025-02-28 keywords: ['database','mysql','rdbms','relational database','mariadb'] tags: ["database","cloud-manager","linode platform","mysql","marketplace","mariadb"] external_resources: @@ -15,7 +15,7 @@ contributors: ["Akamai"] license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' --- -MySQL is an open-source database management system that uses a relational database and SQL (Structured Query Language) to manage its data. In Debian 9, MySQL is replaced with MariaDB as the default database system. MariaDB is an open-source, multi-threaded relational database management system, backward compatible replacement for MySQL. It is maintained and developed by the MariaDB Foundation. +MySQL is an open-source database management system that uses a relational database and SQL (Structured Query Language) to manage its data. This Marketplace app can deploy MySQL or MariaDB. MariaDB is an open-source, multi-threaded relational database management system, backward compatible replacement for MySQL. It is maintained and developed by the MariaDB Foundation. ## Deploying a Marketplace App @@ -29,36 +29,37 @@ MySQL is an open-source database management system that uses a relational databa ## Configuration Options -- **Supported distributions:** Ubuntu 20.04 LTS -- **Recommended plan:** Depends on the size of your MySQL database and the amount of traffic you expect. +- **Supported distributions:** Ubuntu 24.04 LTS +- **Suggested plan:** All plan types and sizes can be used. We suggest using a [High Memory Compute Instance](https://www.linode.com/products/high-memory/) for larger databases in a production environment. ### MySQL/MariaDB Options - **MySQL or MariaDB** *(required)*: Select which database service you'd like to use. -- **MySQL Root Password** *(required)*: The root password for your MySQL database. -- **MySQL User** *(required)*: The user for your MySQLDB database. -- **MySQL User Password** *(required)*: The user password for your MySQL database. -- **Create Database** *(required)*: The database on your MySQL. -{{% content "marketplace-limited-user-fields-shortguide" %}} - -{{% content "marketplace-custom-domain-fields-shortguide" %}} +{{% content "marketplace-required-limited-user-fields-shortguide" %}} {{% content "marketplace-special-character-limitations-shortguide" %}} ## Getting Started after Deployment -### Access MySQL/MariaDB +### Obtain the Credentials + +Once the app is deployed, you need to obtain the credentials from the server. + +To obtain credentials: -After MySQL has finished installing, you will be able to access MySQL from the console via ssh with your Linode's IPv4 address: +1. Log in to your new Compute Instance using one of the methods below: -1. [SSH into your Linode](/docs/products/compute/compute-instances/guides/set-up-and-secure/#connect-to-the-instance) and [create a limited user account](/docs/products/compute/compute-instances/guides/set-up-and-secure/#add-a-limited-user-account). + - **Lish Console**: Log in to Cloud Manager, click the **Linodes** link in the left menu, and select the Compute Instance you just deployed. Click **Launch LISH Console**. Log in as the `root` user. To learn more, see [Using the Lish Console](/docs/products/compute/compute-instances/guides/lish/). + - **SSH**: Log in to your Compute Instance over SSH using the `root` user. To learn how, see [Connecting to a Remote Server Over SSH](/docs/guides/connect-to-server-over-ssh/). -1. Log out and log back in as your limited user account. +1. Run the following command to access the credentials file: -1. Update your server: + ```command + cat /home/$USERNAME/.credentials + ``` - sudo apt-get update && apt-get upgrade +This returns passwords that were automatically generated when the instance was deployed. Save them. Once saved, you can safely delete the file. ## Using MySQL/MariaDB @@ -68,11 +69,9 @@ The standard tool for interacting with MySQL is the `mysql` client which install 1. To log in to MySQL as the root user: - sudo mysql -u root -p + sudo mysql -u root -p -1. When prompted, enter the MySQL root password that you set when launching the Marketplace App. You'll then be presented with a welcome header and the MySQL prompt as shown below: - - MariaDB [(none)]> +1. When prompted, enter the MySQL root password that was provided in the `/home/$USERNAME/.credentials` file. You'll then be presented with a welcome header and the MySQL prompt. 1. To generate a list of commands for the MySQL prompt, enter `\h`. You'll then see: @@ -105,19 +104,9 @@ The standard tool for interacting with MySQL is the `mysql` client which install For server side help, type 'help contents' - MariaDB [(none)]> - -1. Grant access to the database that you created when launching the Marketplace App for **MySQL User**. In this example, the database is called `webdata`, the user `webuser`, and password of the user is `password`. Be sure to enter your own password. This should be different from the root password for MySQL: - - GRANT ALL ON webdata.* TO 'webuser' IDENTIFIED BY 'password'; - -1. To Exit MySQL/MariaDB type: - - exit - ### Create a Sample Table -1. Log back in as **MySQL User** that you set when launching the Marketplace App. In the following example the **MySQL User** is `webuser`. +1. Log back in as sudo user that you set when launching the Marketplace App. In the following example the sudo user is `webuser`. sudo mysql -u webuser -p @@ -140,7 +129,6 @@ The standard tool for interacting with MySQL is the `mysql` client which install | last_name | text | YES | | NULL | | +-------------+---------+------+-----+---------+----------------+ - 4. Then exit MySQL/MariaDB. exit From 3ac4a75f6c7ee44156b307ca4c288f367b087d64 Mon Sep 17 00:00:00 2001 From: Magda Sulik Date: Wed, 12 Mar 2025 14:45:19 +0100 Subject: [PATCH 2/2] editorial review --- docs/marketplace-docs/guides/mysql/index.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/marketplace-docs/guides/mysql/index.md b/docs/marketplace-docs/guides/mysql/index.md index 55879a266cc..f48cc479f57 100644 --- a/docs/marketplace-docs/guides/mysql/index.md +++ b/docs/marketplace-docs/guides/mysql/index.md @@ -17,7 +17,7 @@ marketplace_app_id: 607026 marketplace_app_name: "MySQL/MariaDB" --- -MySQL is an open-source database management system that uses a relational database and SQL (Structured Query Language) to manage its data. This Marketplace app can deploy MySQL or MariaDB. MariaDB is an open-source, multi-threaded relational database management system, backward compatible replacement for MySQL. It is maintained and developed by the MariaDB Foundation. +The MySQL/MariaDB Marketplace app can deploy MySQL or MariaDB. MySQL is an open-source database management system that uses a relational database and SQL (Structured Query Language) to manage its data. MariaDB is an open-source, multi-threaded relational database management system, backward compatible replacement for MySQL that's maintained and developed by the MariaDB Foundation. ## Deploying a Marketplace App @@ -26,7 +26,7 @@ MySQL is an open-source database management system that uses a relational databa {{% content "marketplace-verify-standard-shortguide" %}} {{< note >}} -**Estimated deployment time:** MySQL should be fully installed within 2-5 minutes after the Compute Instance has finished provisioning. +**Estimated deployment time:** The app should be fully installed within 2-5 minutes after the Compute Instance has finished provisioning. {{< /note >}} ## Configuration Options @@ -71,9 +71,9 @@ The standard tool for interacting with MySQL is the `mysql` client which install 1. To log in to MySQL as the root user: - sudo mysql -u root -p + sudo mysql -u root -p -1. When prompted, enter the MySQL root password that was provided in the `/home/$USERNAME/.credentials` file. You'll then be presented with a welcome header and the MySQL prompt. +1. When prompted, enter the MySQL root password that was provided in the `/home/$USERNAME/.credentials` file. You get a welcome header and the MySQL prompt. 1. To generate a list of commands for the MySQL prompt, enter `\h`. You'll then see: @@ -117,7 +117,7 @@ The standard tool for interacting with MySQL is the `mysql` client which install use webdata; create table customers (customer_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY, first_name TEXT, last_name TEXT); -3. To view the contents of the table that you created: +3. To view the contents of the table that you created, enter the command: describe customers; @@ -131,7 +131,7 @@ The standard tool for interacting with MySQL is the `mysql` client which install | last_name | text | YES | | NULL | | +-------------+---------+------+-----+---------+----------------+ -4. Then exit MySQL/MariaDB. +4. To exit MySQL/MariaDB, enter: exit