Verzija 1.0.0-alpha.1najnovije
Poglavlje 2.7
Instaliranje izdanja Enterprise i primjena licencije
Što se mijenja kada instalirate izdanje Enterprise, kako zatražiti licenciju sa svog Adverant računa, tri načina njezina uvoza sa svakim kodom odbijanja te kako je Harrow Port Authority prebacio svoj pilot-projekt izdanja Community na Enterprise na istom mjestu bez ikakvog gubitka.
Ovu je stranicu s engleskog izvornika preveo AI. Ako je išta nejasno, mjerodavna je stranica na engleskom jeziku. Pročitajte ovu stranicu na engleskom jeziku

Instalacija izdanja Enterprise sastoji se od dvije polovice koje stižu različitim putevima. Slike izdanja Enterprise dolaze s Helm chartom za Enterprise i preuzimaju se pomoću tokena za preuzimanje (pull token). Licencija stiže kao potpisana datoteka s vašeg računa za Adverant te je uvozite u pokrenutu instalaciju. Nijedna polovica ne radi bez druge: slike bez licencije rade na osnovnoj razini izdanja Community, a licencija bez slika izdanja Enterprise nema što uključiti.
U organizaciji Harrow Port Authority to smo učinili tim redoslijedom, šest tjedana nakon pilot-projekta izdanja Community opisanog u poglavlju 2.6, Instaliranje izdanja Community na Kubernetes. Nadogradnja na chart za Enterprise zahtijevala je jedan prozor za održavanje; uvoz licencije trajao je dvije minute. Ovo poglavlje obuhvaća obje polovice. Počinje sa svježom instalacijom, a završava s postojećom instalacijom izdanja Community koja prelazi na novu verziju na istom mjestu.
Što se razlikuje od izdanja Community
Dvije vrijednosti i chart koji ih čita.
# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
enabled: trueSve ostalo u datoteci s vrijednostima ostaje točno onako kako je i bilo, a prije svega naziv instalacije i skrbnici ključeva. Dva se ključa moraju podudarati, pa chart odbija edition: enterprise uz enterprise.enabled: false, ili obrnuto.
Izdanje se također mora podudarati sa zaključanim popisom slika (images lock) u chartu. Svaki paket chartova nosi zaključani popis za jedno izdanje, a zaključani popis za Enterprise navodi slike za Community plus verzije izgrađene za Enterprise. Ako datoteku s vrijednostima za Enterprise usmjerite na chart za Community, generiranje se zaustavlja uz files/images.lock.json is the community lock; this install is edition enterprise. Stoga instalacija izdanja Enterprise zahtijeva chart za Enterprise.
Chart i paket za Enterprise nalaze se na stranici Preuzimanja (Downloads) vašeg računa za Adverant, koji prati vašu licenciju. Datoteka charta ima isti naziv kao i ona za Community, nexus-1.0.0-alpha.1.tgz, stoga ih držite u zasebnim mapama. Provjerite je točno onako kako opisuje poglavlje 2.4, Preuzimanje i provjera izdanja, u odnosu na ključ izdanja čiji ste otisak provjerili:
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
Zatim pokrenite petlju za provjeru potpisa iz poglavlja 2.4, Preuzimanje i provjera izdanja, nad enterprise/nexus/files/images.lock.json. Ona obuhvaća slike za Enterprise jednako kao i one dijeljene.
Token za povlačenje
Slike za Community su javne. Slike za Enterprise zahtijevaju token za preuzimanje sa stranice Tokeni za preuzimanje i naredbe za instalaciju (Pull tokens and install commands) na vašem računu, konfiguriran za izvršno okruženje kontejnera vaših čvorova, kako je prikazano u poglavlju 2.4, Preuzimanje i provjera izdanja, 3. korak. Na sustavu k3s to je unos configs za registry.adverant.ai u /etc/rancher/k3s/registries.yaml na svakom čvoru.
Izradite po jedan token za svaki klaster i dodijelite mu datum isteka koji ćete primijetiti. Kada token istekne, pokrenuti podovi nastavljaju s radom, ali pod koji se ponovno rasporedi na čvor koji još nema sliku ne može je preuzeti. Datum isteka tokena upisali smo u isti kalendar u kojem je i datum isteka certifikata.
Čista instalacija izdanja Enterprise
Ako instalirate Enterprise od samog početka, slijedite poglavlje 2.6, Instaliranje izdanja Community na Kubernetes, korak po korak, uz tri razlike:
Postavite token za preuzimanje na svaki čvor prije 6. koraka.
Upotrijebite vrijednosti za Enterprise (dva gore navedena ključa) u 4. koraku.
U 6. koraku instalirajte iz datoteke charta za Enterprise koju ste preuzeli:
helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45m
Sve nakon naredbe za instalaciju isto je kao u poglavlju 2.6, Instaliranje izdanja Community na Kubernetes, pa tako i pravilo za --wait: nemojte ga koristiti. Ako umjesto toga instalirate pomoću nexusctl, dodajte --edition enterprise u naredbu:
nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterpriseKada su sva radna opterećenja spremna, prođite kroz prvo pokretanje u poglavlju 2.12, Prvo pokretanje. Licencija je jedna od šest stavki koje konzola navodi prije nego što se itko prijavi. Dok se ne uveze, instalacija radi na osnovnoj razini izdanja Community, a svako područje izdanja Enterprise prikazano je zasivljeno s ikonom lokota.
Zahtijevanje licencije
Licencija tvrtke Adverant izdaje se za identitet jedne instalacije – onaj koji je spremište ključeva izradilo pod keys.installationName pri instalaciji. Stoga račun mora znati na koju instalaciju mislite prije nego što može izdati licenciju.
- Prijavite se na svoj račun za Adverant na adresi
https://account.adverant.ai. - Na instalaciji otvorite Ova instalacija (This installation), a zatim Licencija (Licence). Prikazat će se jednokratni kôd i otisak instalacije.
- Na svom računu otvorite Preuzmi vlasništvo nad instalacijom (Claim a deployment) i unesite kôd. Zatim usporedite otisak koji je račun primio s onim koji prikazuje instalacija, grupu po grupu; svaka se grupa mora podudarati.
- Pritisnite gumb za preuzimanje vlasništva. Instalacija se pridružuje odjeljku Instalacije (Deployments) na vašem računu, sa svojom verzijom i stanjem licencije.
- Adverant izdaje licenciju za tu instalaciju. Preuzmite datoteku sa svog računa; nazvana je prema svom identifikatoru licencije,
<licence-id>.json.
Kôd za preuzimanje vlasništva vrijedi jednokratno i kratko vrijeme. Ako istekne, račun ga odbija uz CLAIM_CODE_EXPIRED, a instalacija prikazuje novi kôd.
Postoje još dva načina, a poglavlje 2.13, Licencije, u potpunosti obrađuje oba. Uređaji (appliances) i rubni kompleti (edge kits) nemaju zaslon za prikaz koda, pa se vlasništvo nad njima preuzima pomoću ključa za preuzimanje otisnutog na kutiji, koji se upisuje na stranici Unesite ključ za preuzimanje (Enter a claim key) ili čita iz datoteke narudžbe proizvođača. Instalacija bez izlaza na internet koristi izvanmrežnu razmjenu (Offline exchange): ona izrađuje potpisanu datoteku zahtjeva za licenciju, vi je prenosite na svoj račun, a zatim vraćate datoteku licencije natrag. Jednom godišnje na isti način izrađuje potpisano izvješće o korištenju. Svaka datoteka u razmjeni je potpisana, pa se datoteka izmijenjena putem odbija, uz LICENCE_REQUEST_SIGNATURE_INVALID za zahtjev i USAGE_FILE_SIGNATURE_INVALID za datoteku o korištenju.
Što sadrži datoteka licencije
Licencija je JSON dokument u formatu nexus-licence/v1, koji je Adverant dvaput potpisao dvama neovisnim ključevima. Ne morate ga čitati, ali korisno je znati što se u njemu nalazi kada netko pita što ste kupili.
| Polje | Što u njemu piše |
|---|---|
licence_id |
Vlastiti identifikator licencije, UUID (univerzalno jedinstveni identifikator) ispisan malim slovima |
type |
alpha, evaluation ili commercial |
licensee |
Naziv organizacije i korisnički identifikator za Adverant |
scope |
Instalacija za koju je izdana i sve organizacije navedene u odobrenju |
edition |
enterprise |
grants |
Grupe značajki koje otključava, svaku za cijelu instalaciju ili za navedene organizacije |
add_ons i domain_packs |
Mogućnosti koje se licenciraju zasebno; Paket za logistiku i pomorstvo (Logistics and maritime pack) jedna je od njih |
metric |
Način obračuna licencije, named-seat, per-core ili per-environment, te količina |
term |
starts_on, ends_on te dani upozorenja i počeka |
matrix |
Verzija matrice izdanja prema kojoj je licencija napisana |
signatures |
Dva potpisa tvrtke Adverant |
Evaluacijska licencija traje najviše 30 dana, za najviše pet imenovanih osoba, bez razdoblja počeka. Komercijalna licencija upozorava 30 dana prije isteka, a zatim prema zadanim postavkama daje 30 dana počeka. Što se događa na svakom koraku te ljestvice opisano je u poglavlju 2.13, Licencije.
Potpisi štite dokument u obliku u kojem ga je Adverant izradio. Pošaljite ga točno onako kako ste ga primili; nemojte ga otvarati u uređivaču teksta koji bi ga mogao preoblikovati.
Uvoz licencije
Samo administrator instalacije može uvesti licenciju: vlasnik ili administrator cijele organizacije koja je vlasnik instalacije, dok je u nju prijavljen. Potpuni administrator platforme također je može uvesti. Licencija nikada nije vrijednost u chartu niti datoteka montirana u pod. Ona odlazi u servis za prijavu, nexus-auth, koji je provjerava izvanmrežno u odnosu na korijenske certifikate povjerenja ugrađene u vlastitu sliku te je bilježi u jednoj transakciji. Možete je uvesti na tri načina, a svi završavaju na istom mjestu.
U konzoli
Tijekom prvog pokretanja otvorite Šest stavki prije nego što se itko prijavi (Six things before anyone signs in), a zatim Licencija (Licence). Stranica Uvoz licencije (Import the licence) prima datoteku: ispustite je na stranicu ili je odaberite. Stranica je provjerava izvanmrežno na samoj instalaciji, a zatim navodi grupe značajki koje otvara, uz prikaz načina zaštite svake od njih i roka valjanosti. Grupe koje licencija ne uključuje ostaju navedene, ali zasivljene.
Kasnije se isti taj uvoz vrši putem gumba Uvezi novu licenciju (Import a new licence) na stranici licencije same instalacije. Kada licencija istekne, ograničena stranica licencije nudi opciju Uvezi obnovljenu licenciju (Import a renewed licence).
Pomoću alata nexusctl
nexusctl licence import <licence-id>.jsonnexusctl šalje neizmijenjenu datoteku na rutu za uvoz instalacije s ovlastima administratora instalacije te izvješćuje o stanju licencije ili kodu odbijanja iz donje tablice.
Putem API-ja
Ruta za uvoz dio je aplikacijskog programskog sučelja (API) servisa za prijavu, na vašoj adresi hosts.auth. Tijelo zahtjeva je sam dokument licencije, bajt po bajt:
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> je pristupni token prijavljenog administratora instalacije. Koristite --data-binary, a nikada -d, koji uklanja prijelome redaka i tako mijenja bajtove koje šaljete. Ruta ne prima niz upita (query string) niti išta u tijelu osim samog dokumenta; tijelo koje na najvišoj razini pokuša navesti organizaciju ili osobu odbija se prije nego što se išta pročita.
Uspješan uvoz vraća odgovor 201 Created. Skraćeno, tijelo odgovora izgleda ovako:
{
"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 broji organizacije na instalaciji koje sada posjeduju licenciju. tenants_without_organisation broji organizacije navedene u licenciji koje ova instalacija ne obuhvaća.
Kada je uvoz odbijen
Odbijeni uvoz ne mijenja ništa: ne zapisuje se nijedan redak, a važeća licencija, ako postoji, ostaje kakva je i bila. Dnevnik revizije instalacije bilježi svaki pokušaj, uključujući i one odbijene.
| Kod | Status | Što to znači | Što učiniti |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Jedan od dva potpisa tvrtke Adverant nedostaje ili nije valjan; datoteka je izmijenjena nakon potpisivanja | Ponovno zatražite datoteku od tvrtke Adverant; nemojte je uređivati |
LICENCE_FORMAT_INVALID |
422 | Datoteka nije licencija koju ovo izdanje može pročitati | Pošaljite datoteku točno onako kako vam ju je Adverant dao |
LICENCE_ROOT_UNKNOWN |
422 | Potpisana je ključem kojem ova instalacija ne vjeruje | Zatražite licenciju potpisanu za korijenske certifikate povjerenja ovog izdanja ili izvršite nadogradnju |
LICENCE_MATRIX_MISMATCH |
422 | Napisana je prema matrici izdanja koju ovo izdanje ne čita ili odobrava grupu koju ovo izdanje ne poznaje | Izvršite nadogradnju ili zatražite licenciju napisanu za ovo izdanje |
LICENCE_OTHER_INSTALLATION |
409 | Izdana je za drugu instalaciju | Zatražite licenciju izdanu za identitet ove instalacije |
TRANSITION_NOT_PERMITTED |
409 | Licencija s ovim identifikatorom već je uvezena; svaka se uvozi samo jednom | Zatražite novu licenciju od tvrtke Adverant ako se uvjeti moraju promijeniti |
LICENCE_REVOKED |
403 | Adverant je povukao ovu licenciju | Zatražite novu od tvrtke Adverant |
LICENCE_LOCKED |
403 | Rok valjanosti licencije još nije započeo; do tada vrijedi osnovna razina izdanja Community | Ponovno je uvezite na prvi dan valjanosti ili nakon njega |
RECORD_NOT_FOUND |
404 | Instalacija još nije deklarirana, pa nema identitet u odnosu na koji bi se izvršila provjera | Dovršite korak prvog administratora (poglavlje 2.12, Prvo pokretanje), a zatim izvršite uvoz |
VALIDATION_FAILED |
400 | Tijelo zahtjeva bilo je nečitljivo ili veće od 1 MiB, ili je poslan niz upita | Pošaljite datoteku kao cijelo tijelo zahtjeva, bez upita |
Pri uspješnom uvozu može se vratiti još jedan kôd, kao obavijest, a ne kao odbijanje: LICENCE_CLOCK_BEHIND_FLOOR znači da sat instalacije pokazuje vrijeme ranije od najkasnijeg vremena koje je već zabilježio, pa se licencija čita prema tom kasnijem vremenu. Vraćanje sata unatrag nikada ne oživljava isteklu licenciju. Samo token za ponovno postavljanje vremena koji Adverant potpiše za instalaciju spušta tu donju granicu.
Prelazak s izdanja Community na Enterprise na istom mjestu
To je ono što smo učinili u organizaciji Harrow. Ništa se ponovno ne instalira i ništa se ne migrira: to je ista instalacija, s istim identitetom i istim podacima, samo je više toga uključeno. Naziv instalacije i skrbnici ključeva ostaju točno onakvi kakvi su i bili; pri nadogradnji, skrbnička kuka (custody hook) provjerava je li spremište ključeva već inicijalizirano i ne radi ništa drugo.
Postavite token za preuzimanje na svaki čvor i ondje ponovno pokrenite izvršno okruženje kontejnera.
Dohvatite chart za Enterprise iz odjeljka Preuzimanja (Downloads) te provjerite njega i njegove slike kako je gore opisano.
Promijenite dvije vrijednosti u postojećoj datoteci s vrijednostima:
edition: enterpriseienterprise.enabled: true. Ne mijenjajte ništa drugo.Pokrenite predprovjeru (preflight) s novom datotekom.
nexusctl preflight --context harrow-prod --values harrow-values.yamlNadogradite izdanje na chart za Enterprise, ponovno bez
--wait.helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45mPri nadogradnji, kuke (hooks) se izvršavaju prije pokretanja novih podova, a svaka migracija primjenjuje samo one datoteke koje još nije primijenila. Generirane tajne ponovno se čitaju iz instalacije i zadržavaju. Helm završava s:
NAME: nexus NAMESPACE: nexus STATUS: deployed REVISION: 2Pričekajte da radna opterećenja postanu spremna, točno kao u poglavlju 2.6, Instaliranje izdanja Community na Kubernetes, 7. korak.
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900sUvezite licenciju, na bilo koji od tri gore navedena načina.
U konzoli otvorite Ova instalacija (This installation), zatim Licencija (Licence), pa Prijeđi na Enterprise (Move to Enterprise). Stranica čita licenciju i prikazuje što će se dohvatiti i što će se promijeniti prije nego što se išta dogodi. Također prebrojava osobe i sadržaj organizacije te svaku stavku označava kao zadržanu. Pritisnite Dohvati i uključi (Fetch and switch on). Svaki se dio prije upotrebe provjerava u odnosu na ključ izdanja tvrtke Adverant, a grupe značajki uključuju se jedna po jedna.
Naš prozor za održavanje trajao je sat vremena; sam rad unutar njega trajao je oko dvadeset minuta, od čega je većina otišla na čekanje sheme dok su se izvršavale kuke. Sudionici pilot-projekta sljedećeg su se jutra prijavili u isti radni prostor, u kojem područja izbornika za Enterprise više nisu bila zasivljena.
Nakon uvoza
Stranica licencije pod stavkom Ova instalacija (This installation) navodi svaku grupu značajki u licenciji s pripadajućim brojem mjesta i rokom valjanosti. Također navodi kako se pojedini dio isporučuje, primjerice kompiliran i licenciran za grupu Enterprise ili kao otvoreni kôd za osnovnu razinu Community. Grupe izvan licencije ostaju navedene, ali zasivljene. Administratori mogu suziti doseg grupe unutar organizacije; nitko osim tvrtke Adverant ne može proširiti ono što licencija odobrava.
Stanje licencije pri svakom se čitanju ponovno izračunava iz dokumenta i datuma, tako da do isteka dolazi bez zakazanog posla u pozadini. Svi na instalaciji vide istu obavijest u konzoli kako se približava kraj: LICENCE_ENDS_SOON od 30 dana prije isteka, a zatim LICENCE_IN_GRACE tijekom razdoblja počeka. Članovi vide obavijest i datume; samo administratori instalacije vide samu licenciju. Poglavlje 2.13, Licencije, obrađuje obnovu i ljestvicu isteka.
Ako ovo ne uspije
| Što vidite | Uzrok | Što učiniti |
|---|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Promijenjen je samo jedan od dva ključa | Promijenite oba |
files/images.lock.json is the community lock; this install is edition enterprise |
Korišten je chart za Community | Upotrijebite chart za Enterprise iz odjeljka Preuzimanja (Downloads) |
image ... is a enterprise image; a community install takes only community images |
Naziv slike za Enterprise dospio je u generiranje za Community | Provjerite edition i mapu charta |
ImagePullBackOff na slici za Enterprise nakon nadogradnje |
Čvor nema token za preuzimanje ili njegov token više nije valjan | Provjerite registries.yaml na tom čvoru ili izradite novi token |
| Kôd odbijanja licencije | Pogledajte gornju tablicu odbijanja | Slijedite upute u pripadajućem retku; ništa nije promijenjeno |
Kada stranica licencije prikazuje Enterprise i grupe koje ste očekivali, instalacija je licencirana. Sljedeća je postaja prvo pokretanje u poglavlju 2.12, Prvo pokretanje, ako još niste preuzeli vlasništvo nad instalacijom. Ako jeste, asistentu su još uvijek potrebni vlastiti ključevi modela umjetne inteligencije (AI) vaše organizacije prije nego što ikome može odgovoriti. Poglavlje 2.14, Pružatelji i modeli AI-ja, pokazuje kako ih povezati.




