Paweł Domański
136 lines
5.3 KiB
Markdown
136 lines
5.3 KiB
Markdown
# Kompletna Dokumentacja: Instalacja i Konfiguracja MariaDB na Red Hat Enterprise Linux (RHEL)
|
|
|
|
## Cel
|
|
Ta dokumentacja opisuje krok po kroku proces instalacji i konfiguracji serwera MariaDB na systemie RHEL. Konfiguracja jest specjalnie dostosowana do migracji istniejącej bazy danych MySQL, na podstawie dostarczonych parametrów, aby zapewnić maksymalną kompatybilność.
|
|
|
|
## Wymagania wstępne
|
|
- System operacyjny Red Hat Enterprise Linux (lub jego pochodna, np. CentOS, Rocky Linux).
|
|
- Dostęp do konta z uprawnieniami `sudo`.
|
|
- Dostęp do internetu na serwerze docelowym.
|
|
|
|
---
|
|
|
|
### Krok 1: Przygotowanie Systemu
|
|
Zawsze dobrą praktyką jest rozpoczęcie od aktualizacji pakietów systemowych do najnowszych wersji.
|
|
|
|
```bash
|
|
sudo dnf update -y
|
|
```
|
|
|
|
---
|
|
|
|
### Krok 2: Wybór i Konfiguracja Repozytorium MariaDB
|
|
|
|
System Red Hat domyślnie zawiera w swoich repozytoriach pakiety MariaDB. Masz dwie główne ścieżki instalacji:
|
|
|
|
#### Opcja 1: Użycie repozytorium Red Hat (Metoda alternatywna)
|
|
Możesz zainstalować wersję MariaDB dostarczaną bezpośrednio przez Red Hat. Jest to podejście prostsze, ale zazwyczaj daje dostęp do nieco starszej, choć bardzo stabilnej wersji.
|
|
|
|
- Aby zainstalować domyślną wersję z RHEL (np. 10.5 w RHEL 9):
|
|
```bash
|
|
sudo dnf install mariadb-server
|
|
```
|
|
- Jeśli używasz nowszej wersji RHEL (9.4+) i chcesz zainstalować nowszy "strumień" (np. 10.11):
|
|
```bash
|
|
sudo dnf module install mariadb:10.11/server
|
|
```
|
|
Jeśli wybierzesz tę opcję, możesz przejść od razu do **Kroku 4**, ale pamiętaj, aby zainstalować także klienta (`MariaDB-client` lub `mariadb`).
|
|
|
|
#### Opcja 2: Użycie oficjalnego repozytorium MariaDB (Metoda zalecana)
|
|
Ta metoda jest zalecana w tej dokumentacji, ponieważ gwarantuje dostęp do najnowszych stabilnych wersji, które często oferują lepszą wydajność, nowe funkcje i dłuższy okres wsparcia. Jest to najlepsza praktyka, szczególnie w kontekście migracji.
|
|
|
|
Aby skonfigurować oficjalne repozytorium MariaDB, wykonaj poniższą komendę. Skrypt automatycznie wykryje Twój system i doda odpowiednie źródła pakietów.
|
|
|
|
```bash
|
|
curl -sS https://downloads.mariadb.com/MariaDB/mariadb_repo_setup | sudo bash
|
|
```
|
|
Po wykonaniu tej komendy, kontynuuj z **Krokiem 3**.
|
|
|
|
---
|
|
|
|
### Krok 3: Instalacja MariaDB
|
|
Po dodaniu repozytorium, zainstaluj pakiety serwera i klienta MariaDB.
|
|
|
|
```bash
|
|
sudo dnf install MariaDB-server MariaDB-client -y
|
|
```
|
|
|
|
---
|
|
|
|
### Krok 4: Zastosowanie Niestandardowej Konfiguracji dla Migracji
|
|
To kluczowy krok, aby zapewnić zgodność z Twoim starym serwerem. Utworzyłem plik `z-custom-migration.cnf`, który zawiera ustawienia ze źródłowej bazy danych.
|
|
|
|
1. **Przenieś plik konfiguracyjny**
|
|
Musisz przenieść plik `inbox/Projects/z-custom-migration.cnf` z Twojego lokalnego komputera na serwer docelowy. Możesz użyć `scp`, `rsync` lub innej metody transferu plików.
|
|
|
|
*Przykład użycia `scp` (z Twojego lokalnego komputera):*
|
|
```bash
|
|
scp "inbox/Projects/z-custom-migration.cnf" uzytkownik@adres-serwera:/tmp/z-custom-migration.cnf
|
|
```
|
|
|
|
2. **Skopiuj plik do folderu konfiguracyjnego MariaDB**
|
|
Na serwerze docelowym, skopiuj plik do folderu `/etc/my.cnf.d/`. MariaDB automatycznie wczyta wszystkie pliki `.cnf` z tego katalogu.
|
|
|
|
```bash
|
|
sudo mv /tmp/z-custom-migration.cnf /etc/my.cnf.d/z-custom-migration.cnf
|
|
```
|
|
|
|
**Ważne:** Nazwa pliku zaczyna się od `z-`, aby zapewnić, że zostanie on wczytany jako jeden z ostatnich, co pozwoli mu nadpisać ewentualne domyślne ustawienia.
|
|
|
|
---
|
|
|
|
### Krok 5: Uruchomienie i Zabezpieczenie MariaDB
|
|
Po zakończeniu konfiguracji, uruchom usługę MariaDB i włącz ją, aby startowała automatycznie z systemem.
|
|
|
|
1. **Start i włączenie usługi:**
|
|
```bash
|
|
sudo systemctl start mariadb
|
|
sudo systemctl enable mariadb
|
|
```
|
|
|
|
2. **Zabezpieczenie instalacji:**
|
|
Uruchom skrypt `mariadb-secure-installation`, który pomoże Ci ustawić hasło `root`, usunąć anonimowych użytkowników i zabezpieczyć bazę danych.
|
|
|
|
```bash
|
|
sudo mariadb-secure-installation
|
|
```
|
|
Postępuj zgodnie z instrukcjami na ekranie.
|
|
|
|
---
|
|
|
|
### Krok 6: Weryfikacja Konfiguracji
|
|
Na koniec sprawdź, czy usługa działa poprawnie i czy niestandardowe ustawienia zostały załadowane.
|
|
|
|
1. **Sprawdź status usługi:**
|
|
```bash
|
|
sudo systemctl status mariadb
|
|
```
|
|
Powinieneś zobaczyć status `active (running)`.
|
|
|
|
2. **Zaloguj się do MariaDB i zweryfikuj zmienne:**
|
|
Zaloguj się jako `root` (używając hasła ustawionego w poprzednim kroku).
|
|
|
|
```bash
|
|
sudo mariadb -u root -p
|
|
```
|
|
|
|
Po zalogowaniu, sprawdź kilka kluczowych zmiennych, aby upewnić się, że Twoja konfiguracja została wczytana:
|
|
```sql
|
|
SHOW VARIABLES LIKE 'character_set_server';
|
|
SHOW VARIABLES LIKE 'collation_server';
|
|
SHOW VARIABLES LIKE 'max_allowed_packet';
|
|
```
|
|
|
|
Wyniki powinny być zgodne z tym, co ustawiliśmy w pliku `z-custom-migration.cnf`:
|
|
- `character_set_server`: `latin1`
|
|
- `collation_server`: `latin1_swedish_ci`
|
|
- `max_allowed_packet`: `67108864` (co odpowiada `64M`)
|
|
|
|
---
|
|
|
|
## Następne Kroki
|
|
Twój serwer MariaDB jest teraz zainstalowany, skonfigurowany i gotowy na migrację. Następne kroki będą obejmować:
|
|
1. Utworzenie odpowiednich baz danych i użytkowników.
|
|
2. Wykonanie zrzutu (dump) danych ze starego serwera.
|
|
3. Zaimportowanie danych na nowy serwer MariaDB.
|