Instalacja prerequisites

Co instaluje ta paczka?

Komponent	Przeznaczenie
PostgreSQL + pgvector	Dedykowana baza MAIA z obsługą wyszukiwania wektorowego. Usługa: `MAIA-Postgres`.
Python i biblioteki	Runtime i zależności wspieranych funkcji Python w MAIA.
Konfiguracja	Chroniony `prerequisites.env` z danymi połączenia bazy i ścieżkami Python.

Paczka nie instaluje aplikacji MAIA, nie konfiguruje dostawcy AI ani proxy SDP. Do pełnego nowego wdrożenia Windows wybierz All-in-One.

To nie jest aktualizator istniejącej bazy

Instalator kopiuje runtime i może tworzyć lub zmieniać role oraz hasła. Nie wykonuje migracji między głównymi wersjami PostgreSQL ani aktualizacji aplikacji. Jeżeli istnieje już MAIA-Postgres lub docelowy klaster, przed ponownym uruchomieniem skonsultuj się z DBA. Nie wskazuj katalogu bazy ServiceDesk Plus.

1. Przygotuj i sprawdź paczkę

Windows x64 i PowerShell jako administrator.
Nowy, dedykowany katalog, np. C:\MAIA-Prerequisites, poza current aplikacji.
Wolny port 5433 lub inny konsekwentnie stosowany port.
Nie instaluj ponownie już przygotowanej bazy lub Pythona bez sprawdzenia potrzeb.
Pobierz ZIP Windows prerequisites, manifest i podpis ze strony pobierania.

Porównaj opublikowane SHA-256 dokładnie tego pliku:

Get-FileHash .\mwtsolutions-maia-prerequisites-windows-1.1.0.zip -Algorithm SHA256

Rozpakuj poza katalogiem docelowym. Otwórz prerequisites; zachowaj manifest, podpis i wszystkie foldery runtime.

Sprawdzenie podpisanej paczki przez MAIA-MAINTENANCE

Sam ZIP prerequisites nie zawiera MAIA-MAINTENANCE. Użyj programu z odpowiadającej mu paczki aplikacji Windows lub All-in-One. Przykładowe ścieżki:

& "D:\MAIA-Releases\1.1.0\update\MAIA-MAINTENANCE.exe" check `
  --package "D:\MAIA-Releases\prerequisites-1.1.0\prerequisites"

To weryfikacja bez instalacji. Bez AVX2 wybierz maintenance baseline. Dostosuj ścieżki i wersję do swoich plików.

2. Wybierz komponenty i uruchom

Launcher uruchamia dołączony instalator PowerShell. Kliknij install-prerequisites.bat prawym przyciskiem i wybierz Uruchom jako administrator albo użyj poniższego polecenia z rozpakowanego katalogu prerequisites.

Uruchomienie polecenia wprowadza zmiany

Osobny instalator prerequisites nie ma preflight aktualizatora aplikacji ani potwierdzenia każdego etapu. Najpierw sprawdź katalog, usługę i port. Domyślnie instaluje oba komponenty do C:\MAIA-Prerequisites na porcie 5433.

PostgreSQL i Python

.\install-prerequisites.ps1 -Target "C:\MAIA-Prerequisites" `
  -Port 5433 -Components "postgres,python"

Tylko PostgreSQL

.\install-prerequisites.ps1 -Target "C:\MAIA-Prerequisites" `
  -Port 5433 -Components "postgres"

Tylko Python

.\install-prerequisites.ps1 -Target "C:\MAIA-Prerequisites" `
  -Components "python"

Używaj parametrów PowerShell: -Target, -Port, -Components. Batch tylko je przekazuje; nie polegaj na starszych przykładach z podwójnymi myślnikami.

Dla nowego klastra bez podanego hasła skrypt generuje je sam. Przy istniejącym klastrze bez zapisanych danych zapyta o hasło superużytkownika. Nie wpisuj haseł w wiersz poleceń ani nie umieszczaj ich na screenshotach i w publicznych logach.

Skrypt kopiuje wybrane runtime, inicjalizuje nowy klaster w razie potrzeby, rejestruje/uruchamia MAIA-Postgres, przygotowuje bazę pgvector i rozszerzenie vector oraz testuje wybrany Python. Sukces kończy się [SUCCESS] i zapisem prerequisites.env.

3. Chroń bazę i dane dostępowe

Nowy klaster domyślnie nasłuchuje na 127.0.0.1 i używa uwierzytelnienia hasłem. To lokalna baza MAIA, nie baza SDP. Zdalny dostęp wymaga świadomej konfiguracji DBA/firewalla — nie wystawiaj po prostu portu 5433 do Internetu.

Obecny skrypt nadaje roli pgvector podwyższone uprawnienia. Przed produkcją przejrzyj zakres z DBA. Rola odczytu SDP maia_ro służy do innego celu.

prerequisites.env zawiera hasło

Instalator próbuje ograniczyć dostęp do Administrators i SYSTEM. Sprawdź uprawnienia pliku. Odczytuj go tylko w chronionej sesji lokalnej przy konfiguracji MAIA. Nie wysyłaj go na hosting, zwykłym mailem ani nie zastępuj nim istniejącego .env aplikacji.

4. Sprawdź wybrane komponenty

Testuj tylko zainstalowane komponenty. Przykłady zakładają domyślny katalog i port.

PostgreSQL i pgvector

Get-Service MAIA-Postgres
& "C:\MAIA-Prerequisites\pgsql\bin\psql.exe" `
  -h 127.0.0.1 -p 5433 -U pgvector -d pgvector -W -c "SELECT 1;"
& "C:\MAIA-Prerequisites\pgsql\bin\psql.exe" `
  -h 127.0.0.1 -p 5433 -U pgvector -d pgvector -W `
  -c "SELECT extversion FROM pg_extension WHERE extname = 'vector';"

Oczekuj Running, poprawnego SELECT 1 i wersji rozszerzenia vector. -W pyta o hasło, zamiast umieszczać je w historii poleceń.

Python

& "C:\MAIA-Prerequisites\python\python.exe" --version
& "C:\MAIA-Prerequisites\python\python.exe" -m pip --version
& "C:\MAIA-Prerequisites\python\python.exe" -c "import sklearn, pandas, numpy, lightgbm, psycopg2; import pgvector.psycopg2; print('PYTHON_OK')"

Oczekuj wersji runtime i pip oraz PYTHON_OK. Przy błędzie zachowaj komunikat i sprawdź przyczynę przed kontynuacją. Nie nadpisuj działającego klastra ponowną instalacją w ramach diagnozy.

5. Przejdź do MAIA

Zainstaluj aplikację zgodnie z instrukcją i dokończ kreator WebUI. Dane bazy i ścieżkę Python z chronionego pliku wprowadź w obsługiwanej konfiguracji MAIA. Katalog bazy/runtime pozostaje poza wymienianym payloadem aplikacji.

Gdy MAIA już działa, użyj procedury aktualizacji; upgrade aplikacji nie wymaga ponownej instalacji prerequisites. Pomoc MAIA Plus: stanislaw.rogasik@maiaplus.eu.