Skip to content

Commit

Permalink
KB crawler nightly commit
Browse files Browse the repository at this point in the history
  • Loading branch information
KB Crawler committed Jan 29, 2025
1 parent dac4c1c commit 6c2bf35
Show file tree
Hide file tree
Showing 59 changed files with 2,983 additions and 568 deletions.
779 changes: 366 additions & 413 deletions archive/+changes/index.html

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
<?xml version="1.0" encoding="utf-8"?>
<rss xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title>MariaDB Knowledge Base Comments for: Building MariaDB on Windows</title><link>https://mariadb.com/kb/en/Building_MariaDB_on_Windows/+comments/feed/</link><description></description><atom:link href="https://mariadb.com/kb/en/Building_MariaDB_on_Windows/+comments/feed/" rel="self"></atom:link><language>en-us</language><lastBuildDate>Tue, 28 Jan 2025 01:02:20 +0000</lastBuildDate></channel></rss>
<rss xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title>MariaDB Knowledge Base Comments for: Building MariaDB on Windows</title><link>https://mariadb.com/kb/en/Building_MariaDB_on_Windows/+comments/feed/</link><description></description><atom:link href="https://mariadb.com/kb/en/Building_MariaDB_on_Windows/+comments/feed/" rel="self"></atom:link><language>en-us</language><lastBuildDate>Wed, 29 Jan 2025 01:02:27 +0000</lastBuildDate></channel></rss>
2 changes: 1 addition & 1 deletion archive/en/Building_MariaDB_on_Windows/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -279,7 +279,7 @@
<dt>Modified</dt>
<dd>

<span class="datetime" title="2025-01-23 17:30">4 days, 7 hours ago</span></dd>
<span class="datetime" title="2025-01-23 17:30">5 days, 7 hours ago</span></dd>

<dt>Type</dt>
<dd>article</dd>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
<?xml version="1.0" encoding="utf-8"?>
<rss xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title>MariaDB Knowledge Base Comments for: Changes and Improvements in MariaDB 11.8</title><link>https://mariadb.com/kb/en/changes-improvements-in-mariadb-11-8/+comments/feed/</link><description></description><atom:link href="https://mariadb.com/kb/en/changes-improvements-in-mariadb-11-8/+comments/feed/" rel="self"></atom:link><language>en-us</language><lastBuildDate>Tue, 28 Jan 2025 01:02:41 +0000</lastBuildDate></channel></rss>
<rss xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title>MariaDB Knowledge Base Comments for: Changes and Improvements in MariaDB 11.8</title><link>https://mariadb.com/kb/en/changes-improvements-in-mariadb-11-8/+comments/feed/</link><description></description><atom:link href="https://mariadb.com/kb/en/changes-improvements-in-mariadb-11-8/+comments/feed/" rel="self"></atom:link><language>en-us</language><lastBuildDate>Wed, 29 Jan 2025 01:02:42 +0000</lastBuildDate></channel></rss>
2 changes: 1 addition & 1 deletion archive/en/changes-improvements-in-mariadb-11-8/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -271,7 +271,7 @@
<dt>Modified</dt>
<dd>

<span class="datetime" title="2025-01-27 11:19">13 hours, 42 minutes ago</span></dd>
<span class="datetime" title="2025-01-27 11:19">1 day, 13 hours ago</span></dd>

<dt>Type</dt>
<dd>article</dd>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
<?xml version="1.0" encoding="utf-8"?>
<rss xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title>MariaDB Knowledge Base Comments for: Container Backup and Restoration</title><link>https://mariadb.com/kb/en/container-backup-and-restoration/+comments/feed/</link><description></description><atom:link href="https://mariadb.com/kb/en/container-backup-and-restoration/+comments/feed/" rel="self"></atom:link><language>en-us</language><lastBuildDate>Tue, 28 Jan 2025 01:02:55 +0000</lastBuildDate></channel></rss>
<rss xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title>MariaDB Knowledge Base Comments for: Container Backup and Restoration</title><link>https://mariadb.com/kb/en/container-backup-and-restoration/+comments/feed/</link><description></description><atom:link href="https://mariadb.com/kb/en/container-backup-and-restoration/+comments/feed/" rel="self"></atom:link><language>en-us</language><lastBuildDate>Wed, 29 Jan 2025 01:02:53 +0000</lastBuildDate></channel></rss>
42 changes: 28 additions & 14 deletions archive/en/container-backup-and-restoration/+source/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -323,7 +323,7 @@ <h1>Container Backup and Restoration - Source</h1>
<div class="revision_info">
<dl class="table">
<dt>Revision</dt>
<dd><a href="/kb/en/container-backup-and-restoration/+r/145983/">145983</a></dd>
<dd><a href="/kb/en/container-backup-and-restoration/+r/146096/">146096</a></dd>
<dt>User</dt>
<dd>
<span class="user" id="user-13052">
Expand All @@ -332,7 +332,7 @@ <h1>Container Backup and Restoration - Source</h1>
<dt>Date</dt>
<dd>

<span class="datetime" title="2025-01-27 11:40">2025-01-27 11:40</span></dd>
<span class="datetime" title="2025-01-28 21:07">2025-01-28 21:07</span></dd>
</dl>
</div>

Expand All @@ -355,7 +355,7 @@ <h1>Container Backup and Restoration - Source</h1>
-v mariadb_data:/var/lib/mysql \
-v mariadb_backup:/backup \
mariadb \
sh -c &#34;chown -R mysql:mysql /var/lib/mysql /backup&#34;
chown -R mysql:mysql /var/lib/mysql /backup
$ docker run -d --name mariadb \
-v mariadb_data:/var/lib/mysql \
-v mariadb_backup:/backup \
Expand All @@ -367,15 +367,17 @@ <h1>Container Backup and Restoration - Source</h1>
[[mariadb-dump]] is in the Docker Official Image and can be used as follows:

&lt;&lt;code&gt;&gt;
$ docker exec mariadb sh -c &#39;mariadb-dump --all-databases -u root -p&#34;$MARIADB_ROOT_PASSWORD&#34; &gt; backup/db.sql&#39;
$ docker exec mariadb \
sh -c &#39;mariadb-dump --all-databases -u root -p&#34;$MARIADB_ROOT_PASSWORD&#34; &gt; backup/db.sql&#39;
&lt;&lt;/code&gt;&gt;

=== Restoring Data from Dump Files

For restoring data, you can use the following `docker exec` command:

&lt;&lt;code&gt;&gt;
$ docker exec mariadb sh -c &#39;mariadb -u root -p&#34;$MARIADB_ROOT_PASSWORD&#34; &lt; backup/db.sql&#39;
$ docker exec mariadb \
sh -c &#39;mariadb -u root -p&#34;$MARIADB_ROOT_PASSWORD&#34; &lt; backup/db.sql&#39;
&lt;&lt;/code&gt;&gt;

== Physical Backups
Expand All @@ -384,7 +386,7 @@ <h1>Container Backup and Restoration - Source</h1>

=== Backup

MariaDB Backup can create a backup as follows:
Mariabackup can create a backup as follows:

To perform a backup using [[mariabackup|Mariabackup]], a second container is started that shares the original container&#39;s data directory. An additional volume for the backup needs to be included in the second backup instance. Authentication against the MariaDB database instance is required to successfully complete the backup. In the example below, a `mysql@localhost` user is used with the MariaDB server&#39;s Unix socket shared with the backup container.

Expand All @@ -397,7 +399,7 @@ <h1>Container Backup and Restoration - Source</h1>
-v mariadb_data:/var/lib/mysql \
-v mariadb_backup:/backup \
mariadb \
sh -c &#34;chown -R mysql:mysql /var/lib/mysql /backup&#34;
chown -R mysql:mysql /var/lib/mysql /backup
$ docker run -d --name mariadb \
-v mariadb_data:/var/lib/mysql \
-v mariadb_backup:/backup \
Expand All @@ -410,17 +412,17 @@ <h1>Container Backup and Restoration - Source</h1>
Mariabackup will run as the `mysql` user in the container, so the permissions on `/backup` will need to ensure that it can be written to by this user:

&lt;&lt;code&gt;&gt;
$ docker exec mariadb sh -c &#39;mariadb-backup --backup --target-dir=backup --user=mysql&#39;
$ docker exec --user mysql mariadb &#39;mariadb-backup --backup --target-dir=backup
&lt;&lt;/code&gt;&gt;

=== Restore

These steps restore the backup made with Mariabackup.

At some point before doing the restore, the backup needs to be prepared. Perform the prepare like this:
At some point before doing the restore, the backup needs to be prepared. The prepare must be done with the same MariaDB version that performed the backup. Perform the prepare like this:

&lt;&lt;code&gt;&gt;
$ docker run --rm -it \
$ docker run --rm \
--name mariadb-restore \
-v mariadb_backup:/backup \
&lt;mariadb-image&gt; \
Expand All @@ -430,23 +432,35 @@ <h1>Container Backup and Restoration - Source</h1>
Now that the image is prepared, start the container with both the data and the backup volumes and restore the backup. The data directory must be empty to perform this action:

&lt;&lt;code&gt;&gt;
$ docker run --rm -it \
$ docker volume create mariadb_restore
$ docker run --rm \
-v mariadb_restore:/var/lib/mysql \
--name mariadb-restore-change-permissions \
&lt;mariadb-image&gt; \
chown mysql: /var/lib/mysql
$ docker run --rm \
--name mariadb-restore \
-v /my/new/datadir:/var/lib/mysql \
-v mariadb_restore:/var/lib/mysql \
-v mariadb_backup:/backup \
--user mysql \
&lt;mariadb-image&gt; \
mariadb-backup --copy-back --target-dir=backup
&lt;&lt;/code&gt;&gt;

With `/my/new/datadir` containing the restored backup, start normally as this is an initialized data directory:
With `mariadb_restore` volume containing the restored backup, start normally as this is an initialized data directory. At this point a later version of `&lt;mariadb-image&gt;` container can be used:

&lt;&lt;code&gt;&gt;
$ docker run -d --name mariadb \
-v /my/new/datadir:/var/lib/mysql \
-v mariadb_restore:/var/lib/mysql \
-e MARIADB_AUTO_UPGRADE=1 \
-e MARIADB_ROOT_PASSWORD=&#39;MariaDB11!&#39; \
&lt;mariadb-image&gt;
&lt;&lt;/code&gt;&gt;

On the environment variables here:
* [[mariadb-server-docker-official-image-environment-variables#mariadb_auto_upgrade-mariadb_disable_upgrade_backup|MARIADB_AUTO_UPGRADE]] here in addition to upgrading the system tables ensures there is a [[using-healthcheck-sh/|healthcheck user]].
* `MARIADB_ROOT_PASSWORD` is a convenience if any scripts, like logical backup above, use the environment variable. This environment variable is not strictly required.

For further information on Mariabackup, see [[mariabackup-overview|Mariabackup Overview]].</textarea>


Expand Down
42 changes: 28 additions & 14 deletions archive/en/container-backup-and-restoration/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -287,7 +287,7 @@
<dt>Modified</dt>
<dd>

<span class="datetime" title="2025-01-27 11:40">13 hours, 22 minutes ago</span></dd>
<span class="datetime" title="2025-01-28 21:07">3 hours, 55 minutes ago</span></dd>

<dt>Type</dt>
<dd>article</dd>
Expand Down Expand Up @@ -428,22 +428,24 @@ <h2 class="anchored_heading" id="logicial-backups">Logicial Backups</h2>
-v mariadb_data:/var/lib/mysql \
-v mariadb_backup:/backup \
mariadb \
sh -c &#34;chown -R mysql:mysql /var/lib/mysql /backup&#34;
chown -R mysql:mysql /var/lib/mysql /backup
$ docker run -d --name mariadb \
-v mariadb_data:/var/lib/mysql \
-v mariadb_backup:/backup \
-e MARIADB_ROOT_PASSWORD='MariaDB11!' \
&lt;mariadb-image&gt;
</pre><h3 class="anchored_heading" id="backup">Backup</h3>
<p><a href="/kb/en/mariadb-dump/">mariadb-dump</a> is in the Docker Official Image and can be used as follows:</p>
<pre class="fixed">$ docker exec mariadb sh -c 'mariadb-dump --all-databases -u root -p&#34;$MARIADB_ROOT_PASSWORD&#34; &gt; backup/db.sql'
<pre class="fixed">$ docker exec mariadb \
sh -c 'mariadb-dump --all-databases -u root -p&#34;$MARIADB_ROOT_PASSWORD&#34; &gt; backup/db.sql'
</pre><h3 class="anchored_heading" id="restoring-data-from-dump-files">Restoring Data from Dump Files</h3>
<p>For restoring data, you can use the following `docker exec` command:</p>
<pre class="fixed">$ docker exec mariadb sh -c 'mariadb -u root -p&#34;$MARIADB_ROOT_PASSWORD&#34; &lt; backup/db.sql'
<pre class="fixed">$ docker exec mariadb \
sh -c 'mariadb -u root -p&#34;$MARIADB_ROOT_PASSWORD&#34; &lt; backup/db.sql'
</pre><h2 class="anchored_heading" id="physical-backups">Physical Backups</h2>
<p><a href="/kb/en/mariadb-backup/">mariadb-backup</a> is in the Docker Official Image.</p>
<h3 class="anchored_heading" id="backup">Backup</h3>
<p>MariaDB Backup can create a backup as follows:</p>
<p>Mariabackup can create a backup as follows:</p>
<p>To perform a backup using <a href="/kb/en/mariabackup/">Mariabackup</a>, a second container is started that shares the original container's data directory. An additional volume for the backup needs to be included in the second backup instance. Authentication against the MariaDB database instance is required to successfully complete the backup. In the example below, a `mysql@localhost` user is used with the MariaDB server's Unix socket shared with the backup container.</p>
<p>Note: Privileges listed here are for 10.5+. For an exact list, see <a href="/kb/en/mariabackup-overview/#authentication-and-privileges">Mariabackup: Authentication and Privileges</a>.</p>
<pre class="fixed">$ docker volume create mariadb_data
Expand All @@ -452,7 +454,7 @@ <h3 class="anchored_heading" id="backup">Backup</h3>
-v mariadb_data:/var/lib/mysql \
-v mariadb_backup:/backup \
mariadb \
sh -c &#34;chown -R mysql:mysql /var/lib/mysql /backup&#34;
chown -R mysql:mysql /var/lib/mysql /backup
$ docker run -d --name mariadb \
-v mariadb_data:/var/lib/mysql \
-v mariadb_backup:/backup \
Expand All @@ -461,28 +463,40 @@ <h3 class="anchored_heading" id="backup">Backup</h3>
-e MARIADB_MYSQL_LOCALHOST_GRANTS='RELOAD, PROCESS, LOCK TABLES, BINLOG MONITOR' \
&lt;mariadb-image&gt;
</pre><p>Mariabackup will run as the `mysql` user in the container, so the permissions on `/backup` will need to ensure that it can be written to by this user:</p>
<pre class="fixed">$ docker exec mariadb sh -c 'mariadb-backup --backup --target-dir=backup --user=mysql'
<pre class="fixed">$ docker exec --user mysql mariadb 'mariadb-backup --backup --target-dir=backup
</pre><h3 class="anchored_heading" id="restore">Restore</h3>
<p>These steps restore the backup made with Mariabackup.</p>
<p>At some point before doing the restore, the backup needs to be prepared. Perform the prepare like this:</p>
<pre class="fixed">$ docker run --rm -it \
<p>At some point before doing the restore, the backup needs to be prepared. The prepare must be done with the same MariaDB version that performed the backup. Perform the prepare like this:</p>
<pre class="fixed">$ docker run --rm \
--name mariadb-restore \
-v mariadb_backup:/backup \
&lt;mariadb-image&gt; \
mariadb-backup --prepare --target-dir=backup
</pre><p>Now that the image is prepared, start the container with both the data and the backup volumes and restore the backup. The data directory must be empty to perform this action:</p>
<pre class="fixed">$ docker run --rm -it \
<pre class="fixed">$ docker volume create mariadb_restore
$ docker run --rm \
-v mariadb_restore:/var/lib/mysql \
--name mariadb-restore-change-permissions \
&lt;mariadb-image&gt; \
chown mysql: /var/lib/mysql
$ docker run --rm \
--name mariadb-restore \
-v /my/new/datadir:/var/lib/mysql \
-v mariadb_restore:/var/lib/mysql \
-v mariadb_backup:/backup \
--user mysql \
&lt;mariadb-image&gt; \
mariadb-backup --copy-back --target-dir=backup
</pre><p>With `/my/new/datadir` containing the restored backup, start normally as this is an initialized data directory:</p>
</pre><p>With `mariadb_restore` volume containing the restored backup, start normally as this is an initialized data directory. At this point a later version of `&lt;mariadb-image&gt;` container can be used:</p>
<pre class="fixed">$ docker run -d --name mariadb \
-v /my/new/datadir:/var/lib/mysql \
-v mariadb_restore:/var/lib/mysql \
-e MARIADB_AUTO_UPGRADE=1 \
-e MARIADB_ROOT_PASSWORD='MariaDB11!' \
&lt;mariadb-image&gt;
</pre><p>For further information on Mariabackup, see <a href="/kb/en/mariabackup-overview/">Mariabackup Overview</a>.</p>
</pre><p>On the environment variables here:</p>
<ul start="1"><li><a href="/kb/en/mariadb-server-docker-official-image-environment-variables/#mariadb_auto_upgrade-mariadb_disable_upgrade_backup">MARIADB_AUTO_UPGRADE</a> here in addition to upgrading the system tables ensures there is a <a href="/kb/en/using-healthcheck-sh/">healthcheck user</a>.
</li><li>`MARIADB_ROOT_PASSWORD` is a convenience if any scripts, like logical backup above, use the environment variable. This environment variable is not strictly required.
</li></ul>
<p>For further information on Mariabackup, see <a href="/kb/en/mariabackup-overview/">Mariabackup Overview</a>.</p>

</div>

Expand Down
2 changes: 1 addition & 1 deletion archive/en/e1045/+comments/feed/index.html
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
<?xml version="1.0" encoding="utf-8"?>
<rss xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title>MariaDB Knowledge Base Comments for: Error 1045: Access denied for user (using password)</title><link>https://mariadb.com/kb/en/e1045/+comments/feed/</link><description></description><atom:link href="https://mariadb.com/kb/en/e1045/+comments/feed/" rel="self"></atom:link><language>en-us</language><lastBuildDate>Mon, 27 Jan 2025 05:52:03 +0000</lastBuildDate></channel></rss>
<rss xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title>MariaDB Knowledge Base Comments for: Error 1045: Access denied for user (using password)</title><link>https://mariadb.com/kb/en/e1045/+comments/feed/</link><description></description><atom:link href="https://mariadb.com/kb/en/e1045/+comments/feed/" rel="self"></atom:link><language>en-us</language><lastBuildDate>Wed, 29 Jan 2025 01:02:10 +0000</lastBuildDate></channel></rss>
6 changes: 3 additions & 3 deletions archive/en/e1045/+comments/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@
Comments - Error 1045: Access denied for user (using password)
" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://mariadb.com/kb/en/e1045/+comments" />
<meta property="og:url" content="https://mariadb.com/kb/en/e1045/+comments/" />
<meta property="og:image" content="http://mariadb.comaskmonty-logo.png" />
<meta property="og:site_name" content="MariaDB KnowledgeBase" />
<meta property="fb:admins" content="514852603" />
Expand Down Expand Up @@ -76,7 +76,7 @@
</li>

<li>
<a href="/kb/user/login?next=/kb/en/e1045/+comments"> Login</a>
<a href="/kb/user/login?next=/kb/en/e1045/+comments/"> Login</a>
</li>

</ul>
Expand Down Expand Up @@ -121,7 +121,7 @@


<li>
<a href="/kb/user/login?next=/kb/en/e1045/+comments" rel="nofollow">Login</a>
<a href="/kb/user/login?next=/kb/en/e1045/+comments/" rel="nofollow">Login</a>
</li>


Expand Down
2 changes: 1 addition & 1 deletion archive/en/e1045/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -291,7 +291,7 @@
<dt>Modified</dt>
<dd>

<span class="datetime" title="2025-01-22 15:46">4 days, 10 hours ago</span></dd>
<span class="datetime" title="2025-01-22 15:46">6 days, 9 hours ago</span></dd>

<dt>Type</dt>
<dd>article</dd>
Expand Down
2 changes: 1 addition & 1 deletion archive/en/generated-columns/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -287,7 +287,7 @@
<dt>Modified</dt>
<dd>

<span class="datetime" title="2025-01-27 11:22">13 hours, 39 minutes ago</span></dd>
<span class="datetime" title="2025-01-27 11:22">1 day, 13 hours ago</span></dd>

<dt>Type</dt>
<dd>article</dd>
Expand Down
2 changes: 1 addition & 1 deletion archive/en/getting-the-mariadb-source-code/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -271,7 +271,7 @@
<dt>Modified</dt>
<dd>

<span class="datetime" title="2025-01-27 20:14">4 hours, 48 minutes ago</span></dd>
<span class="datetime" title="2025-01-27 20:14">1 day, 4 hours ago</span></dd>

<dt>Type</dt>
<dd>article</dd>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
<?xml version="1.0" encoding="utf-8"?>
<rss xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title>MariaDB Knowledge Base Comments for: hash_join_cardinality optimizer_switch Flag</title><link>https://mariadb.com/kb/en/hash_join_cardinality-optimizer_switch-flag/+comments/feed/</link><description></description><atom:link href="https://mariadb.com/kb/en/hash_join_cardinality-optimizer_switch-flag/+comments/feed/" rel="self"></atom:link><language>en-us</language><lastBuildDate>Tue, 28 Jan 2025 01:02:38 +0000</lastBuildDate></channel></rss>
<rss xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title>MariaDB Knowledge Base Comments for: hash_join_cardinality optimizer_switch Flag</title><link>https://mariadb.com/kb/en/hash_join_cardinality-optimizer_switch-flag/+comments/feed/</link><description></description><atom:link href="https://mariadb.com/kb/en/hash_join_cardinality-optimizer_switch-flag/+comments/feed/" rel="self"></atom:link><language>en-us</language><lastBuildDate>Wed, 29 Jan 2025 01:02:39 +0000</lastBuildDate></channel></rss>
Loading

0 comments on commit 6c2bf35

Please sign in to comment.