Od paczki do pierwszego uruchomienia.

1. Przygotuj środowisko

• Serwer Windows x64 i dostęp do konta administratora.
• Pusty lub nieistniejący katalog MAIA, np. C:\MAIA. Paczkę rozpakuj gdzie indziej.
• IP serwera MAIA, lokalizacja ServiceDesk Plus i okno na ewentualny restart SDP.
• PostgreSQL z pgvector i Python — dostępne w komponentach All-in-One.
• Dane licencji, konfiguracja SDP i dostęp do wybranego dostawcy/modelu AI.
• Miejsce na aplikację, wiedzę, indeksy, logi i backupy; zapotrzebowanie zależy od skali.

Domyślne porty: MAIA 3000, dołączony PostgreSQL 5433. Sprawdź kolizje i firewall. Automatyczna konfiguracja bezpośredniego dostępu do bazy SDP dotyczy PostgreSQL. Inne warianty uzgodnij z MAIA Plus: stanislaw.rogasik@maiaplus.eu.

2. Pobierz i rozpakuj All-in-One

Na stronie pobierania wybierz All-in-One Windows, jeśli został udostępniony. Porównaj SHA-256 dokładnie tego pliku.

Get-FileHash .\mwtsolutions-maia-all-in-one-windows-1.1.0.zip -Algorithm SHA256

1.1.0 to przykład — użyj pobranej wersji. Nie rozpakowuj do aktywnego katalogu MAIA ani jego current.

Otwórz katalog all-in-one. Powinien zawierać:

all-in-one/
  install-all-in-one.bat
  install-all-in-one.ps1
  update/                 — podpisana aplikacja MAIA
  prerequisites/          — PostgreSQL / Python
  sdp-integration/         — integracja i proxy SDP
  tools/                  — narzędzia instalatora

Zachowaj release-manifest.json i release-manifest.sig przy podpisanych komponentach.

3. Uruchom instalator

Uruchom install-all-in-one.bat i zaakceptuj podniesienie uprawnień UAC. Alternatywnie otwórz PowerShell jako administrator w katalogu all-in-one:

powershell -NoProfile -ExecutionPolicy Bypass -File .\install-all-in-one.ps1

Interfejs instalatora jest po angielsku. Dla nowego środowiska wybierz Full installation. Tryby app-only, infra-only, sdp-only i repair usług nie zastępują procedury aktualizacji bazy aplikacji.

1. Wskaż serwer i katalog

   Wybierz IP MAIA, lokalizację SDP i pusty katalog docelowy. Sprawdź wykryte usługi i ścieżki.

2. Wybierz runtime

   Standard wymaga AVX2. Bez AVX2, często w VM, wybierz Baseline. Stosuj ten sam wariant przy późniejszym maintenance.

3. Zainstaluj aplikację i komponenty

   Instalator weryfikuje podpis i używa MAIA-MAINTENANCE. Wybierz PostgreSQL + Python, jeden komponent lub pominięcie już przygotowanych zależności. Przejrzyj wyniki OK / FAIL / SKIP.

4. Potwierdź integrację SDP

   Lokalnie instalator przygotowuje proxy i backup zmienianych plików. Dla zdalnego SDP tworzy pakiet do uruchomienia na jego serwerze.

5. Sprawdź połączenie

   Przejrzyj wyniki testów i końcową instrukcję. Rozwiąż błędy połączenia przed konfiguracją.

.\install-all-in-one.ps1 -InfoOnly

4. ServiceDesk Plus na innym serwerze

Przenieś MAIA-SDP-REMOTE-BUNDLE na serwer SDP. Tam, jako administrator, uruchom skrypt z prawdziwym adresem MAIA. Przykład:

.\deploy-remote.ps1 -MaiaUrl "http://10.0.0.50:3000" -MaiaIp "10.0.0.50"

Zastąp przykładowy IP swoim adresem. Sprawdź routing i firewall.

Przejrzyj zmiany proxy i PostgreSQL, wykonaj wymagany restart SDP w oknie serwisowym, a następnie wróć do testu połączenia z MAIA.

5. Dokończ konfigurację w przeglądarce

Na serwerze MAIA otwórz:

http://127.0.0.1:3000/maiawebui/setup

Z danych końcowej instrukcji skonfiguruj bazę MAIA, administratora, licencję, SDP oraz dostawcę/model AI. Dodaj potrzebne źródła wiedzy. Poprawnie skonfigurowane proxy udostępnia WebUI pod https://adres-twojego-SDP/maiawebui/.

Nie wystawiaj niezakończonego kreatora publicznie. Dostęp ogranicz do administratorów i zaufanej sieci. Certyfikat HTTPS i klucz trzymaj w C:\MAIA\ssl, poza wymienianym current.

6. Sprawdź pierwsze uruchomienie

Get-Service MAIA
Invoke-RestMethod http://127.0.0.1:3000/api/v1/status

Oczekuj usługi Running i komunikatu API API v1 is operational. Przy innym porcie lub HTTPS użyj właściwego lokalnego adresu.

• Działają logowanie i licencja.
• MAIA otwiera się także przez docelowy adres SDP/proxy.
• Model i wybrane źródła danych przechodzą test.
• Prosty workflow działa na świadomie wybranych danych.
• Ustalono miejsce backupów i procedurę następnej aktualizacji.

Inne ścieżki instalacji

Dla osobnej paczki komponentów zobacz instrukcję instalacji PostgreSQL, pgvector i Python.

.\MAIA-MAINTENANCE-baseline.exe check --package .
.\MAIA-MAINTENANCE-baseline.exe install --package . --install-root "C:\MAIA"
.\MAIA-MAINTENANCE-baseline.exe install --package . --install-root "C:\MAIA" --confirm

chmod +x maia-maintenance-linux mwtsolutions-maia-linux
./maia-maintenance-linux check --package .
sudo ./maia-maintenance-linux install --package . --install-root /opt/maia
sudo ./maia-maintenance-linux install --package . --install-root /opt/maia --confirm
sudo useradd --system --home /opt/maia --shell /usr/sbin/nologin maia
sudo chown -R maia:maia /opt/maia

[Unit]
Description=MAIA Plus
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=maia
Group=maia
WorkingDirectory=/opt/maia
ExecStart=/opt/maia/current/mwtsolutions-maia-linux
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now maia.service
systemctl status maia.service --no-pager
curl --fail http://127.0.0.1:3000/api/v1/status