-
Notifications
You must be signed in to change notification settings - Fork 28
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #321 from percona/pxb-3366
PXB-3366 Update installation documentation 8.0
- Loading branch information
Showing
8 changed files
with
511 additions
and
69 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,19 +1,64 @@ | ||
# Install Percona XtraBackup 8.0 using downloaded DEB packages | ||
# Install with DEB packages | ||
|
||
Download `DEB` packages of the desired series for your architecture from [Percona Product Downloads](https://www.percona.com/downloads). | ||
This guide walks you through installing Percona XtraBackup 8.0 using DEB packages on Ubuntu-based systems. | ||
{.power-number} | ||
|
||
The following example downloads *Percona XtraBackup* 8.0.26-18 release package for Ubuntu 20.04: | ||
1. Download the DEB package | ||
|
||
On the [Percona Software Downloads](https://www.percona.com/downloads) website, find the Percona XtraBackup 8.0 package for your system. | ||
|
||
For example, for Ubuntu 20.04, this command downloads the appropriate package: | ||
|
||
```{.bash data-prompt="$"} | ||
$ wget https://downloads.percona.com/downloads/Percona-XtraBackup-LATEST/Percona-XtraBackup-8.0.26-18/binary/debian/focal/x86_64/percona-xtrabackup-80_8.0.26-18-1.focal_amd64.deb | ||
``` | ||
|
||
2. Install the package | ||
|
||
Use the dpkg command to install the downloaded package. You need root privileges for this: | ||
|
||
```{.bash data-prompt="$"} | ||
$ sudo dpkg -i percona-xtrabackup-80_8.0.26-18-1.focal_amd64.deb | ||
``` | ||
|
||
## Common dependencies for Percona XtraBackup | ||
|
||
| Library Name | Description | | ||
|-----------------|----------------------------------------------------------------------------------------------------------| | ||
| libmysqlclient | A client library for MySQL, providing essential functions for connecting to and communicating with MySQL databases. | | ||
| libssl | A cryptographic library used for implementing SSL/TLS encryption, necessary for secure data transmission. | | ||
| libcurl | A library that enables data transfer via various protocols such as HTTP, FTP, and others, commonly used for handling web requests. | | ||
| libev | A high-performance event-loop library, often used in network applications for handling asynchronous events efficiently. | | ||
| libgcrypt | A general-purpose cryptographic library that provides encryption, decryption, and cryptographic hashing algorithms. | | ||
| zlib | A compression library used for data compression and decompression, supporting the popular DEFLATE compression algorithm. | | ||
|
||
## Identify and add missing dependencies | ||
|
||
If there are missing dependencies, dpkg shows error messages. Install any missing packages with the following command: | ||
|
||
```{.bash data-prompt="$"} | ||
$ wget https://downloads.percona.com/downloads/Percona-XtraBackup-LATEST/Percona-XtraBackup-8.0.26-18/binary/debian/focal/x86_64/percona-xtrabackup-80_8.0.26-18-1.focal_amd64.deb | ||
$ sudo apt-get install -f | ||
``` | ||
|
||
Install Percona XtraBackup by using `dpkg`. Run this command as root or use the sudo command: | ||
Retry the Percona XtraBackup installation. | ||
|
||
## Verify the installation | ||
|
||
The following command returns the version information. | ||
|
||
```{.bash data-prompt="$"} | ||
$ sudo dpkg -i percona-xtrabackup-80_8.0.26-18-1.focal_amd64.deb | ||
$ xtrabackup --version | ||
``` | ||
|
||
!!! warning | ||
## Troubleshoot the installation | ||
|
||
| Issue | Description | | ||
|-------------------------------|-----------------------------------------------------------------------------| | ||
| Permission denied | Ensure you're using sudo or have root access for installation commands. | | ||
| Repository issues | If packages are not found, check your yum repository configuration. | | ||
| Incompatible OS version | Double-check your OS version matches the package requirements. | | ||
| Conflicts with existing packages | Consider removing conflicting packages or use a separate environment. | | ||
If you encounter persistent issues, consult the Percona XtraBackup documentation or reach out to their support forums for assistance. | ||
When installing packages manually like this, resolve all the dependencies and install missing packages yourself. | ||
Remember, when installing packages manually, you're responsible for managing dependencies and potential conflicts. Always back up your data before making significant system changes. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,15 +1,28 @@ | ||
# Apt pinning the Percona XtraBackup 8.0 packages | ||
# Pin packages in Debian-based systems | ||
|
||
In some cases you might need to `pin` the selected packages to avoid the upgrades from the distribution repositories. | ||
You may need to keep a specific package at a certain version and prevent it from being automatically updated by your package manager. This action is called "pinning" a package. | ||
{.power-number} | ||
|
||
The pinning takes place in the `preference` file. To pin a package, set the `Pin-Priority` to higher numbers. | ||
1. Create a preference file, `00percona.pref`, in the `/etc/apt/preferences.d/` directory. | ||
|
||
Make a new file `/etc/apt/preferences.d/00percona.pref`. For example, add the following to the preference file: | ||
2. Set the Pinning priority | ||
|
||
``` | ||
Package: | ||
Pin: release o=Percona Development Team | ||
Pin-Priority: 1001 | ||
``` | ||
To pin a package, set the `Pin-Priority` to a higher number than the default priority of the packages. This setting makes the packages higher priority over the other sources. | ||
|
||
For example, add the following lines to the preference file: | ||
|
||
``` | ||
Package: <package_name> | ||
Pin: release o=Percona Development Team | ||
Pin-Priority: 1001 | ||
``` | ||
|
||
Replace the `<package_name>` with the package's name. | ||
|
||
3. Save the `00percona.pref` file. | ||
|
||
You can pin multiple packages by adding separate entries to the file. | ||
|
||
Remove the entry from the file if you no longer want to pin the package. | ||
|
||
For more information about the pinning, check the official [debian wiki](http://wiki.debian.org/AptPreferences). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.