Wersja 1.0.0-alpha.1najnowsza
Rozdział 2.7
Instalacja edycji Enterprise i stosowanie licencji
Co się zmienia po zainstalowaniu edycji Enterprise, jak wystąpić o licencję z konta Adverant, trzy sposoby jej importu wraz ze wszystkimi kodami odmowy oraz jak organizacja Harrow Port Authority przeniosła swój pilotaż w edycji Community do Enterprise w miejscu, bez utraty danych.
Ta strona została przetłumaczona przez AI z angielskiego oryginału. W razie jakichkolwiek niejasności wersją wiążącą jest strona w języku angielskim. Przeczytaj tę stronę po angielsku

Instalacja Enterprise składa się z dwóch połówek, które docierają różnymi drogami. Obrazy Enterprise są dostarczane z pakietem chart Enterprise, pobieranym za pomocą tokenu pobierania (pull token). Licencja ma postać podpisanego pliku z konta Adverant i należy ją zaimportować do działającej instalacji. Żadna połówka nie działa bez drugiej: obrazy bez licencji działają na poziomie podstawowym Community, a licencja bez obrazów Enterprise nie ma czego włączyć.
W Harrow Port Authority zrobiliśmy to w tej właśnie kolejności, sześć tygodni po pilotażu wersji Community opisanym w rozdziale 2.6, Instalacja wersji Community w środowisku Kubernetes. Aktualizacja do pakietu chart Enterprise zajęła jedno okno serwisowe; import licencji zajął dwie minuty. Niniejszy rozdział omawia obie połówki. Zaczyna się od czystej instalacji, a kończy na aktualizacji istniejącej instalacji Community w miejscu.
Różnice względem edycji Community
Dwie wartości oraz pakiet chart, który je odczytuje.
# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
enabled: trueWszystko inne w pliku wartości pozostaje dokładnie takie samo, a przede wszystkim nazwa instalacji oraz depozytariusze. Oba klucze muszą być zgodne – pakiet chart odrzuci edition: enterprise z enterprise.enabled: false lub odwrotnie.
Edycja musi być również zgodna z blokadą obrazów pakietu chart. Każda paczka chart zawiera blokadę dla jednej edycji, a blokada Enterprise obejmuje obrazy Community oraz kompilacje Enterprise. Jeśli wskażą Państwo plik wartości Enterprise dla pakietu chart Community, renderowanie zatrzyma się z błędem files/images.lock.json is the community lock; this install is edition enterprise. Zatem instalacja Enterprise wymaga pakietu chart Enterprise.
Pakiet chart oraz paczka Enterprise znajdują się na stronie Downloads na Państwa koncie Adverant, zgodnie z posiadaną licencją. Plik pakietu chart ma taką samą nazwę jak w wersji Community, nexus-1.0.0-alpha.1.tgz, należy więc przechowywać je w osobnych folderach. Proszę go zweryfikować dokładnie tak, jak opisano w rozdziale 2.4, Pobieranie i weryfikacja wydania, względem klucza wydania, którego odcisk palca został sprawdzony:
nexusctl verify enterprise/nexus-1.0.0-alpha.1.tgz
tar -xzf enterprise/nexus-1.0.0-alpha.1.tgz -C enterprise
jq -r '.version, .edition' enterprise/nexus/files/images.lock.json1.0.0-alpha.1
enterprise
Następnie proszę uruchomić pętlę weryfikacji podpisów z rozdziału 2.4, Pobieranie i weryfikacja wydania, dla pliku enterprise/nexus/files/images.lock.json. Obejmuje on zarówno obrazy Enterprise, jak i te współdzielone.
Token pobierania (pull token)
Obrazy Community są publiczne. Obrazy Enterprise wymagają tokenu pobierania ze strony Pull tokens and install commands na Państwa koncie, skonfigurowanego dla środowiska uruchomieniowego kontenerów na węzłach, jak pokazano w rozdziale 2.4, Pobieranie i weryfikacja wydania, w kroku 3. W przypadku k3s jest to wpis configs dla registry.adverant.ai w pliku /etc/rancher/k3s/registries.yaml na każdym węźle.
Proszę utworzyć jeden token na klaster i nadać mu datę ważności, którą łatwo zauważyć. Gdy token wygaśnie, działające pody będą kontynuować pracę, ale pod przeniesiony na węzeł, który nie ma jeszcze obrazu, nie będzie mógł go pobrać. My wpisaliśmy datę wygaśnięcia tokenu do tego samego kalendarza, w którym śledzimy certyfikaty.
Nowa instalacja edycji Enterprise
Jeśli instalują Państwo edycję Enterprise od podstaw, proszę postępować krok po kroku zgodnie z rozdziałem 2.6, Instalacja wersji Community w środowisku Kubernetes, z trzema różnicami:
Przed krokiem 6 proszę umieścić token pobierania na każdym węźle.
W kroku 4 proszę użyć wartości Enterprise (dwóch powyższych kluczy).
W kroku 6 proszę przeprowadzić instalację z pobranego pliku pakietu chart Enterprise:
helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45m
Wszystko po poleceniu instalacji wygląda tak samo jak w rozdziale 2.6, Instalacja wersji Community w środowisku Kubernetes, włącznie z zasadą dotyczącą --wait: proszę tego nie używać. Jeśli zamiast tego instalują Państwo za pomocą nexusctl, proszę dodać do polecenia --edition enterprise:
nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterpriseGdy wszystkie obciążenia będą gotowe, proszę przejść przez pierwsze uruchomienie opisane w rozdziale 2.12, Pierwsze uruchomienie. Licencja to jedna z sześciu rzeczy, które konsola wyświetla, zanim ktokolwiek się zaloguje. Dopóki nie zostanie zaimportowana, instalacja działa na poziomie podstawowym Community, a każdy obszar Enterprise jest wyszarzony i oznaczony kłódką.
Występowanie o licencję
Licencja od Adverant jest wystawiana dla tożsamości jednej instalacji – tej, którą magazyn kluczy wygenerował pod keys.installationName podczas instalacji. Konto musi więc wiedzieć, o którą instalację chodzi, zanim będzie mogło wystawić licencję.
- Proszę zalogować się na swoje konto Adverant pod adresem
https://account.adverant.ai. - W instalacji proszę otworzyć This installation, a następnie Licence. Wyświetli się jednorazowy kod oraz odcisk palca instalacji.
- Na swoim koncie proszę otworzyć Claim a deployment i wprowadzić kod. Następnie proszę porównać odcisk palca otrzymany przez konto z tym, który pokazuje instalacja, grupa po grupie; każda grupa musi się zgadzać.
- Proszę nacisnąć przycisk przypisania. Instalacja dołączy do sekcji Deployments na Państwa koncie, wraz z informacją o wersji i stanie licencji.
- Adverant wystawia licencję dla tej instalacji. Proszę pobrać plik ze swojego konta; jego nazwa pochodzi od identyfikatora licencji,
<licence-id>.json.
Kod przypisania działa jednorazowo i przez krótki czas. Jeśli wygaśnie, konto odrzuci go z błędem CLAIM_CODE_EXPIRED, a instalacja wyświetli nowy kod.
Istnieją dwie inne drogi, a rozdział 2.13, Licencje, szczegółowo omawia obie. Urządzenia zintegrowane (appliances) i zestawy brzegowe (edge kits) nie mają ekranu do wyświetlenia kodu, dlatego przypisuje się je za pomocą klucza przypisania wydrukowanego na pudełku, wpisywanego na stronie Enter a claim key lub odczytywanego z pliku zamówienia od producenta. Instalacja bez połączenia ze światem zewnętrznym korzysta z wymiany offline (Offline exchange): tworzy podpisany plik żądania licencji, który przenoszą Państwo na swoje konto, a z powrotem przenoszą Państwo plik licencji. Raz w roku w ten sam sposób instalacja tworzy podpisane zestawienie wykorzystania. Każdy plik w tej wymianie jest podpisany, więc plik zmodyfikowany po drodze zostaje odrzucony z kodem LICENCE_REQUEST_SIGNATURE_INVALID w przypadku żądania oraz USAGE_FILE_SIGNATURE_INVALID w przypadku pliku wykorzystania.
Co zawiera plik licencji
Licencja to dokument JSON w formacie nexus-licence/v1, podpisany dwukrotnie przez Adverant dwoma niezależnymi kluczami. Nie muszą go Państwo czytać, ale warto wiedzieć, co się w nim znajduje, gdy ktoś zapyta, co zostało kupione.
| Pole | Co określa |
|---|---|
licence_id |
Własny identyfikator licencji, zapisany małymi literami identyfikator UUID (uniwersalnie unikalny identyfikator) |
type |
alpha, evaluation lub commercial |
licensee |
Nazwę organizacji oraz identyfikator klienta Adverant |
scope |
Instalację, dla której została wystawiona, oraz wszelkie organizacje wskazane w nadaniu uprawnień |
edition |
enterprise |
grants |
Odblokowywane grupy funkcji, każda dla całej instalacji lub dla wskazanych organizacji |
add_ons oraz domain_packs |
Możliwości licencjonowane osobno; jedną z nich jest pakiet Logistics and maritime |
metric |
Sposób rozliczania licencji – named-seat, per-core lub per-environment – oraz liczbę |
term |
starts_on, ends_on oraz liczbę dni ostrzeżenia i okresu karencji |
matrix |
Wersję macierzy edycji, względem której została wystawiona |
signatures |
Dwa podpisy firmy Adverant |
Licencja ewaluacyjna trwa maksymalnie 30 dni, obejmuje najwyżej pięć nazwanych osób i nie ma okresu karencji. Licencja komercyjna wyświetla ostrzeżenie na 30 dni przed końcem, a następnie domyślnie daje 30 dni okresu karencji. To, co dzieje się na każdym stopniu tej drabiny, opisano w rozdziale 2.13, Licencje.
Podpisy obejmują dokument w takiej postaci, w jakiej utworzył go Adverant. Proszę przesłać go dokładnie tak, jak został otrzymany; proszę nie otwierać go w edytorze, który mógłby sformatować zawartość.
Importowanie licencji
Tylko administrator instalacji może zaimportować licencję: właściciel lub administrator całej organizacji będącej właścicielem instalacji, po zalogowaniu się do niej. Może to również zrobić pełny administrator platformy. Licencja nigdy nie jest wartością pakietu chart ani plikiem montowanym do poda. Trafia ona do usługi logowania, nexus-auth, która weryfikuje ją w trybie offline względem głównych certyfikatów zaufania wbudowanych w jej własny obraz i zapisuje ją w jednej transakcji. Można ją zaimportować na trzy sposoby, a wszystkie prowadzą do tego samego miejsca.
W konsoli
Podczas pierwszego uruchomienia proszę otworzyć Six things before anyone signs in, a następnie Licence. Strona Import the licence przyjmuje plik: można go upuścić na stronę lub wybrać z dysku. Strona weryfikuje go offline w samej instalacji, a następnie wyświetla listę otwieranych grup funkcji wraz z informacją, jak każda z nich jest chroniona i do kiedy obowiązuje. Grupy nieobjęte licencją pozostają na liście jako wyszarzone.
Później ten sam import jest dostępny pod przyciskiem Import a new licence na stronie licencji danej instalacji. Gdy licencja wygaśnie, strona ograniczonej licencji oferuje przycisk Import a renewed licence.
Za pomocą nexusctl
nexusctl licence import <licence-id>.jsonPolecenie nexusctl wysyła niezmieniony plik do ścieżki importu instalacji jako administrator instalacji i zwraca stan licencji lub kod odrzucenia z poniższej tabeli.
Przez API
Ścieżka importu jest częścią interfejsu programowania aplikacji (API) usługi logowania pod Państwa adresem hosts.auth. Treść żądania to dokument licencji, bajt po bajcie:
curl -sS -X POST https://auth.harrow.example/api/v1/installation/licence \
-H "authorization: Bearer <admin-token>" \
-H "content-type: application/json" \
--data-binary @<licence-id>.json<admin-token> to token dostępu zalogowanego administratora instalacji. Proszę użyć --data-binary, nigdy -d, ponieważ ten drugi usuwa znaki końca linii, zmieniając wysyłane bajty. Ścieżka nie przyjmuje żadnych parametrów zapytania (query string), a w treści nie może być niczego poza dokumentem; treść, która na najwyższym poziomie próbuje wskazać organizację lub osobę, zostaje odrzucona przed jakimkolwiek odczytem.
Prawidłowy import zwraca odpowiedź 201 Created. Po skróceniu treść wygląda następująco:
{
"licence": {
"licence_id": "<licence-id>",
"state": "licensed",
"edition": "enterprise",
"licensee": {"name": "Harrow Port Authority", "customer_id": "<customer-id>"},
"term": {"starts_on": "2026-12-01", "ends_on": "2027-11-30", "warn_days": 30, "grace_days": 30},
"groups": ["enterprise-base", "..."]
},
"organizations": 1,
"tenants_without_organisation": 0
}
organizations zlicza organizacje w instalacji, które mają teraz przypisaną licencję. tenants_without_organisation zlicza organizacje wymienione w licencji, których ta instalacja nie obejmuje.
Gdy import zostanie odrzucony
Odrzucony import niczego nie zmienia: żaden wiersz nie zostaje zapisany, a obowiązująca licencja, jeśli istnieje, pozostaje bez zmian. Dziennik audytu instalacji rejestruje każdą próbę, w tym również te odrzucone.
| Kod | Status | Co to oznacza | Co należy zrobić |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Brakuje jednego z dwóch podpisów Adverant lub nie przechodzi on weryfikacji; plik został zmodyfikowany po podpisaniu | Proszę poprosić Adverant o ponowne przesłanie pliku; proszę go nie edytować |
LICENCE_FORMAT_INVALID |
422 | Plik nie jest licencją, którą to wydanie potrafi odczytać | Proszę przesłać plik dokładnie w takiej postaci, w jakiej przekazał go Adverant |
LICENCE_ROOT_UNKNOWN |
422 | Plik jest podpisany kluczem, któremu ta instalacja nie ufa | Proszę poprosić o licencję podpisaną dla głównych certyfikatów zaufania tego wydania lub przeprowadzić aktualizację |
LICENCE_MATRIX_MISMATCH |
422 | Licencja została wystawiona względem macierzy edycji, której to wydanie nie odczytuje, lub nadaje uprawnienia do grupy nieznanej temu wydaniu | Proszę przeprowadzić aktualizację lub poprosić o licencję wystawioną dla tego wydania |
LICENCE_OTHER_INSTALLATION |
409 | Licencja została wystawiona dla innej instalacji | Proszę poprosić o licencję wystawioną dla tożsamości tej instalacji |
TRANSITION_NOT_PERMITTED |
409 | Licencja o tym identyfikatorze została już zaimportowana; każdą importuje się tylko raz | Jeśli warunki muszą ulec zmianie, proszę poprosić Adverant o nową licencję |
LICENCE_REVOKED |
403 | Adverant wycofał tę licencję | Proszę poprosić Adverant o nową licencję |
LICENCE_LOCKED |
403 | Okres obowiązywania licencji jeszcze się nie rozpoczął; do tego czasu obowiązuje poziom podstawowy Community | Proszę zaimportować ją ponownie w pierwszym dniu obowiązywania lub później |
RECORD_NOT_FOUND |
404 | Instalacja nie została jeszcze zadeklarowana, nie ma więc tożsamości, względem której można dokonać sprawdzenia | Proszę ukończyć krok pierwszego administratora (rozdział 2.12, Pierwsze uruchomienie), a następnie zaimportować licencję |
VALIDATION_FAILED |
400 | Treść żądania była nieczytelna, przekraczała 1 MiB lub przesłano parametry zapytania | Proszę przesłać plik jako całą treść żądania, bez parametrów zapytania |
Przy udanym imporcie może pojawić się jeszcze jeden kod, jako powiadomienie, a nie odrzucenie: LICENCE_CLOCK_BEHIND_FLOOR oznacza, że zegar instalacji wskazuje czas wcześniejszy niż najpóźniejszy czas, jaki już odnotowała, więc licencja jest odczytywana względem tego późniejszego czasu. Cofnięcie zegara nigdy nie przywraca wygasłej licencji. Tylko token resetowania czasu podpisany przez Adverant dla danej instalacji może obniżyć ten próg czasowy.
Przenoszenie edycji Community do Enterprise w miejscu
Tak właśnie postąpiliśmy w Harrow. Nic nie jest instalowane od nowa i nic nie jest migrowane: to ta sama instalacja, z tą samą tożsamością i tymi samymi danymi, ale z większą liczbą włączonych funkcji. Nazwa instalacji oraz depozytariusze pozostają dokładnie tacy sami; podczas aktualizacji hak depozytu (custody hook) sprawdza jedynie, czy magazyn kluczy jest już zainicjowany, i nie robi nic więcej.
Proszę umieścić token pobierania na każdym węźle i zrestartować tam środowisko uruchomieniowe kontenerów.
Proszę pobrać pakiet chart Enterprise z sekcji Downloads oraz zweryfikować go wraz z obrazami, jak opisano powyżej.
Proszę zmienić dwie wartości w istniejącym pliku wartości:
edition: enterpriseorazenterprise.enabled: true. Proszę nie zmieniać niczego innego.Proszę uruchomić sprawdzenie wstępne (preflight) z nowym plikiem.
nexusctl preflight --context harrow-prod --values harrow-values.yamlProszę zaktualizować wydanie do pakietu chart Enterprise, ponownie bez użycia
--wait.helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45mPodczas aktualizacji haki (hooks) uruchamiają się przed wdrożeniem nowych podów, a każda migracja stosuje tylko te pliki, których wcześniej nie zastosowała. Wygenerowane sekrety są odczytywane z instalacji i zachowywane. Helm kończy działanie komunikatem:
NAME: nexus NAMESPACE: nexus STATUS: deployed REVISION: 2Proszę zaczekać na obciążenia, dokładnie tak jak w rozdziale 2.6, Instalacja wersji Community w środowisku Kubernetes, w kroku 7.
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900sProszę zaimportować licencję jednym z trzech opisanych wyżej sposobów.
W konsoli proszę otworzyć This installation, następnie Licence, a potem Move to Enterprise. Strona odczytuje licencję i pokazuje, co zostanie pobrane i co się zmieni, zanim cokolwiek nastąpi. Zlicza również osoby i treści w organizacji, oznaczając je jako zachowane. Proszę nacisnąć Fetch and switch on. Każda część przed użyciem jest weryfikowana względem klucza wydania Adverant, a grupy funkcji włączają się jedna po drugiej.
Nasze okno serwisowe wynosiło godzinę; sama praca zajęła około dwudziestu minut, z czego większość stanowiło oczekiwanie na schemat podczas działania haków. Uczestnicy pilotażu zalogowali się następnego ranka do tej samej przestrzeni roboczej, w której obszary menu Enterprise nie były już wyszarzone.
Po imporcie
Strona licencji w sekcji This installation wyświetla każdą grupę funkcji zawartą w licencji wraz z liczbą stanowisk i okresem obowiązywania. Informuje również, w jaki sposób każda część jest dostarczana, na przykład jako skompilowana i licencjonowana w przypadku grupy Enterprise lub jako open source w przypadku poziomu podstawowego Community. Grupy spoza licencji pozostają na liście jako wyszarzone. Administratorzy mogą zawęzić zasięg grupy wewnątrz organizacji; nikt poza firmą Adverant nie może rozszerzyć uprawnień wynikających z licencji.
Stan licencji jest obliczany na nowo na podstawie dokumentu i daty przy każdym odczycie, dzięki czemu wygaśnięcie następuje bez użycia zaplanowanego zadania. W miarę zbliżania się końca okresu wszyscy użytkownicy instalacji widzą w konsoli to samo powiadomienie: LICENCE_ENDS_SOON na 30 dni przed końcem, a następnie LICENCE_IN_GRACE podczas okresu karencji. Członkowie widzą powiadomienie i daty; samą licencję widzą tylko administratorzy instalacji. Rozdział 2.13, Licencje, omawia odnawianie oraz drabinę wygasania.
W razie niepowodzenia
| Co Państwo widzą | Przyczyna | Co należy zrobić |
|---|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Zmieniono tylko jeden z dwóch kluczy | Proszę zmienić oba |
files/images.lock.json is the community lock; this install is edition enterprise |
Użyto pakietu chart Community | Proszę użyć pakietu chart Enterprise z sekcji Downloads |
image ... is a enterprise image; a community install takes only community images |
Nazwa obrazu Enterprise trafiła do renderowania Community | Proszę sprawdzić edition oraz folder pakietu chart |
ImagePullBackOff na obrazie Enterprise po aktualizacji |
Węzeł nie ma tokenu pobierania lub jego token stracił ważność | Proszę sprawdzić registries.yaml na tym węźle lub utworzyć nowy token |
| Kod odrzucenia licencji | Proszę sprawdzić powyższą tabelę odrzuceń | Proszę postępować zgodnie z odpowiednim wierszem; nic nie zostało zmienione |
Gdy strona licencji pokazuje wersję Enterprise oraz oczekiwane grupy, instalacja jest objęta licencją. Następnym przystankiem jest pierwsze uruchomienie w rozdziale 2.12, Pierwsze uruchomienie, jeśli nie przypisali Państwo jeszcze instalacji. Jeśli zostało to już zrobione, asystent nadal potrzebuje własnych kluczy modeli sztucznej inteligencji (AI) organizacji, zanim będzie mógł komukolwiek odpowiedzieć. Rozdział 2.14, Dostawcy i modele AI, pokazuje, jak je podłączyć.




