May 27, 2026, 9:48 AM

2026-05-27 07:48:02 +00:00
parent 2d40028939
commit 405d42209c
28 changed files with 0 additions and 0 deletions
@@ -0,0 +1,135 @@
+# 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.