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