Wdróż LIDER AHENK na Pardus i zarejestruj pierwszych klientów

Uwaga dotycząca wersji: Oficjalne instrukcje instalatora serwera LIDER AHENK podają obecnie nazwę Pardus 25.1, podczas gdy Pardus opublikował już wersję 25.2. Aby uzyskać udokumentowaną linię bazową, należy użyć kombinacji 25.1 opisanej przez projekt; przed wdrożeniem wersji 25.2 do produkcji należy potwierdzić jej zgodność z opiekunami lub zweryfikować ją w środowisku testowym. Podstawowa konfiguracja polega na zainstalowaniu serwera zarządzania Lider, a następnie zarejestrowaniu każdego punktu końcowego Pardus za pomocą agenta Ahenk.

LIDER AHENK to centralny system zarządzania. Lider zapewnia serwer i interfejs zarządzania; Ahenk jest uprzywilejowanym agentem na każdym zarządzanym komputerze. Protokół LDAP przechowuje dane katalogowe, a protokół XMPP obsługuje komunikację systemową.

1. Zaplanuj serwer i sieć

Przed instalacją zdecyduj, czy jest to wdrożenie pilotażowe, czy produkcyjne. Aktualna strona z oficjalnymi wymaganiami wymienia 4 rdzenie procesora, 8 GB pamięci i 50 GB miejsca na dysku dla instalacji, przy czym zasoby rosną wraz ze wzrostem liczby klientów. W przypadku środowiska programistycznego lub testowego wymienione są 2 rdzenie procesora, 4 GB pamięci i 20 GB miejsca na dysku. Potraktuj je jako punkty wyjścia; zwiększaj rozmiar wraz ze wzrostem liczby klientów.

Strona wymagań zawiera listę portów 8080, 22, 5222, 5280, 3306 i 389. Nie należy ich udostępniać publicznie. Ponieważ strona nie mapuje każdego portu na każdy przepływ wdrożenia, przed zmianą zapory należy potwierdzić reguły źródłowe i docelowe dla swojej topologii.

Instalator obsługuje serwer typu „wszystko w jednym” lub oddzielne hosty komponentów. W przypadku wdrożenia pilotażowego należy użyć jednego serwera; w przypadku większych wdrożeń należy zaplanować układ rozproszony. Należy ustawić stabilną nazwę hosta i adres, potwierdzić synchronizację DNS i czasu oraz użyć języka angielskiego dla systemu operacyjnego serwera, zgodnie z instrukcją instalatora.

2. Zainstaluj serwer i przygotuj stację roboczą instalatora

Najnowsza strona instalacji serwera określa serwer Pardus 25.1, a oficjalny katalog pobierania zawiera teraz również obraz serwera Pardus 25.2. Różnica w wersji ma znaczenie: strona nie potwierdza, że ​​proces instalacji został zweryfikowany w wersji 25.2. Użyj udokumentowanej wersji, aby uzyskać dokładną reprodukcję, lub przetestuj nowszą wersję na serwerze nieprodukcyjnym przed zarejestrowaniem rzeczywistych urządzeń.

Graficzny instalator działa na osobnej stacji roboczej Pardus GNOME lub Xfce i łączy się z serwerem docelowym przez SSH. Zainstaluj udokumentowane zależności systemowe i klienta SSH, a także pakiet środowiska wirtualnego Pythona:

sudo apt update
sudo apt install python3-paramiko python3-pyqt5 python3-pip python3-psutil python3-venv xterm git openssh-client

Aktualna strona instalatora również instruuje użytkowników, aby usunęli EXTERNALLY-MANAGEDznacznik Pythona i zainstalowali biblioteki Pythona globalnie za pomocą pip. Unikaj usuwania tego znacznika: chroni on zarządzane środowisko Pythona w systemie operacyjnym, a instrukcje wskazują ścieżkę do Pythona 3.11, mimo że informacje o wydaniu Pardus 25.2 wymieniają Pythona 3.13. Zamiast tego użyj odizolowanego środowiska wirtualnego, a następnie przetestuj instalator przed uruchomieniem produkcyjnym:

python3 -m venv --system-site-packages ~/.venvs/lider-installer
~/.venvs/lider-installer/bin/python -m pip install mysql-connector-python argon2-cffi
git clone https://github.com/Pardus-LiderAhenk/lider-ahenk-installer.git
cd lider-ahenk-installer
~/.venvs/lider-installer/bin/python src/app.py

Środowisko wirtualne izoluje biblioteki PyPI, jednocześnie udostępniając biblioteki GUI zainstalowane przez apt. Ta bezpieczniejsza konfiguracja nie jest udokumentowana w projekcie, dlatego należy ją zweryfikować w laboratorium. Zarówno stacja robocza, jak i serwer wymagają połączenia SSH; należy zweryfikować klucz hosta i użyć autoryzowanego konta administratora.

3. Skonfiguruj i uruchom instalator Lider

W oknie instalatora wprowadź dane dostępu do serwera docelowego. Wybierz opcję umieszczenia wszystkich komponentów na jednym serwerze w przypadku prostego pilota lub przypisz poszczególne komponenty do serwerów, jeśli masz zaplanowaną rozproszoną topologię. Przed kontynuowaniem skorzystaj z kontroli połączenia; jeśli się nie powiedzie, rozwiąż problemy z uprawnieniami SSH, routingiem, zaporą sieciową lub kontem, zamiast kontynuować z odgadniętymi ustawieniami.

Następnie wybierz repozytorium pakietów Lider. Dokumentacja projektu odróżnia główne repozytorium pakietów stabilnych od repozytorium testowego. Użyj stabilnego źródła do wdrożenia produkcyjnego. Jeśli Twoja organizacja wewnętrznie kopiuje pakiety, wprowadź adres kopii lustrzanej i odpowiadający mu plik klucza repozytorium, zamiast mieszać źródła publiczne i wewnętrzne.

Wprowadź nazwę domyślną bazy LDAP, hasło administratora systemu, nazwę użytkownika i hasło do interfejsu Lider oraz adres e-mail użytkownika interfejsu. Nazwa domyślna bazy to główna ścieżka nazewnictwa dla wpisów LDAP; skorzystaj z planu nazewnictwa swojej organizacji. Używaj osobnych, silnych haseł i przechowuj je w zatwierdzonym sejfie. Przed rozpoczęciem instalacji sprawdź hosty i repozytorium, co konfiguruje kilka usług i może zająć trochę czasu.

4. Otwórz konsolę i zarejestruj klientów Ahenk

Po zakończeniu instalacji serwera otwórz interfejs Lider, używając adresu serwera na porcie 8080, jak pokazano w instrukcji instalacji. Użyj schematu skonfigurowanego dla wdrożenia i utrzymuj konsolę w zaufanej sieci lub za zatwierdzoną bezpieczną warstwą dostępu. Zaloguj się na utworzone konto interfejsu.

Na punkcie końcowym Pardus najpierw sprawdź, czy repozytorium Ahenk jest już skonfigurowane. W podręczniku klienta projektu podano, że jest ono zdefiniowane na komputerach Pardus; jeśli pakiet jest dostępny, zainstaluj go i zarejestruj:

sudo apt update
apt-cache policy ahenk
sudo apt install ahenk
sudo ahenk-register

Jeśli nie pojawi się żaden kandydat na pakiet, postępuj zgodnie z konfiguracją repozytorium opisaną w oficjalnym podręczniku klienta. Zawiera on klucz podpisu repozytorium i stabilny kod źródłowy pakietu. Unikaj dodawania zduplikowanych wierszy kodu źródłowego; dodaj repozytorium raz i zweryfikuj klucz oraz adres źródłowy przed uruchomieniem apt update. W oknie monitu o rejestrację potwierdź działanie i wprowadź dane serwera Lider oraz dane rejestracyjne wymagane przez kreatora. W podręczniku napisano, że rejestracja kończy się po ponownym uruchomieniu komputera, więc zaplanuj rejestrację, gdy ponowne uruchomienie będzie możliwe.

Ahenk działa z wysokimi uprawnieniami. Najpierw zarejestruj grupę pilotażową i sprawdź zakres zasad; nie testuj usuwania oprogramowania, konta, USB, zapory sieciowej ani działań skryptów na każdym kliencie jednocześnie.

5. Sprawdź pilota przed skalowaniem

Po ponownym uruchomieniu punktu końcowego znajdź go w konsoli Lider i sprawdź, czy jego status lub inwentaryzacja są aktualne. Wyślij zadanie o niskim wpływie na środowisko i sprawdź jego wynik. Etykiety interfejsu różnią się w zależności od wersji Lider, dlatego skorzystaj z odpowiedniej instrukcji.

Jeśli klient się nie pojawi, najpierw sprawdź dostępność sieci i wynik rejestracji Ahenk. Upewnij się, że wymagane ścieżki zapory sieciowej serwera są otwarte tylko między docelowymi hostami, a także zweryfikuj wybrane repozytorium i nazwę bazową LDAP. Pomyślne zalogowanie się do sieci potwierdza, że ​​konsola jest dostępna, ale nie potwierdza, że ​​agent zarejestrował się lub ukończył zadanie. Rozszerz wdrożenie dopiero po wyświetleniu rekordu klienta i wyniku zadania, które nie powoduje zagrożenia.

Źródła: Instrukcja instalacji serwera Lider , Wymagania systemowe Lider , Instalacja klienta Ahenk , Informacje o wydaniu Pardus 25.2 oraz Specyfikacja języka Python dla środowisk zarządzanych zewnętrznie .