Verzija 1.0.0-alpha.1najnovije
Poglavlje 2.7
Instaliranje izdanja Enterprise i primena licence
Šta se menja kada instalirate izdanje Enterprise, kako da zatražite licencu sa svog Adverant naloga, tri načina da je uvezete sa svim kodovima odbijanja i kako je Harrow Port Authority na licu mesta prebacio svoj Community pilot na Enterprise bez ikakvog gubitka.
Ovu stranicu je sa engleskog originala prevela AI tehnologija. Ako nešto nije jasno, merodavna je stranica na engleskom. Pročitajte ovu stranicu na engleskom

Enterprise instalacija se sastoji iz dve polovine, i one stižu različitim putevima. Enterprise slike dolaze sa Enterprise chartom i preuzimaju se pomoću tokena za povlačenje. Licenca stiže kao potpisana datoteka iz Vašeg Adverant naloga, a Vi je uvozite u pokrenutu instalaciju. Nijedna polovina ne funkcioniše bez druge: slike bez licence rade na osnovnom nivou Community izdanja, a licenca bez Enterprise slika nema šta da uključi.
U Harrow Port Authority smo to uradili upravo tim redosledom, šest nedelja nakon Community pilota iz poglavlja 2.6, Instaliranje Community izdanja na Kubernetes. Nadogradnja na Enterprise chart trajala je jedan period održavanja; uvoz licence trajao je dva minuta. Ovo poglavlje obuhvata obe polovine. Počinje novom instalacijom, a završava se postojećom Community instalacijom koja prelazi na Enterprise bez premeštanja.
Šta se razlikuje u odnosu na Community
Dve vrednosti i chart koji ih čita.
# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
enabled: trueSve ostalo u datoteci vrednosti ostaje tačno kakvo je bilo, a pre svega naziv instalacije i čuvari. Dva ključa moraju da se slažu, a chart odbija edition: enterprise sa enterprise.enabled: false, kao i obrnuto.
Izdanje takođe mora da se slaže sa zaključanim spiskom slika charta. Svaki chart paket nosi zaključani spisak za jedno izdanje, a Enterprise spisak navodi Community slike i Enterprise buildove. Ako Enterprise datoteku vrednosti usmerite na Community chart, renderovanje se zaustavlja sa files/images.lock.json is the community lock; this install is edition enterprise. Zato je za Enterprise instalaciju potreban Enterprise chart.
Enterprise chart i paket nalaze se na stranici Preuzimanja u Vašem Adverant nalogu, koja prati Vašu licencu. Datoteka charta ima isti naziv kao Community datoteka, nexus-1.0.0-alpha.1.tgz, pa ih čuvajte u odvojenim fasciklama. Proverite je tačno onako kako opisuje poglavlje 2.4, Preuzimanje i verifikacija izdanja, u odnosu na ključ izdanja čiji ste otisak proverili:
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 proveru potpisa iz poglavlja 2.4, Preuzimanje i verifikacija izdanja, nad enterprise/nexus/files/images.lock.json. Ona obuhvata Enterprise slike kao i zajedničke slike.
Token za preuzimanje
Community slike su javne. Za Enterprise slike potreban je token za povlačenje sa stranice Tokeni za povlačenje i komande za instalaciju u Vašem nalogu, podešen za izvršno okruženje kontejnera na Vašim čvorovima, kao što prikazuje poglavlje 2.4, Preuzimanje i verifikacija izdanja, korak 3. Na k3s to je unos configs za registry.adverant.ai u /etc/rancher/k3s/registries.yaml na svakom čvoru.
Napravite jedan token po klasteru i dodelite mu datum isteka koji ćete primetiti. Kada token istekne, pokrenuti podovi nastavljaju da rade, ali pod koji se ponovo rasporedi na čvor koji još nema sliku ne može da je povuče. Datum isteka tokena uneli smo u isti kalendar kao i datum isteka sertifikata.
Nova Enterprise instalacija
Ako Enterprise instalirate od početka, pratite poglavlje 2.6, Instaliranje Community izdanja na Kubernetes, korak po korak, uz tri razlike:
Postavite token za povlačenje na svaki čvor pre koraka 6.
U koraku 4 koristite Enterprise vrednosti (dva gore navedena ključa).
U koraku 6 instalirajte iz preuzete datoteke Enterprise charta:
helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45m
Sve posle komande za instalaciju isto je kao u poglavlju 2.6, Instaliranje Community izdanja na Kubernetes, kao i pravilo o --wait: ne koristite ga. Ako umesto toga instalirate pomoću nexusctl, dodajte --edition enterprise komandi:
nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterpriseKada su sva radna opterećenja spremna, prođite kroz prvo pokretanje opisano u poglavlju 2.12, Prvo pokretanje. Licenca je jedna od šest stavki koje konzola navodi pre nego što se bilo ko prijavi. Dok se ne uveze, instalacija radi na osnovnom nivou Community izdanja, a svaka Enterprise oblast prikazana je zasivljeno, sa katancem.
Podnošenje zahteva za licencu
Licenca kompanije Adverant izdaje se za identitet jedne instalacije, onaj koji je skladište ključeva generisalo pod keys.installationName prilikom instalacije. Zato nalog mora da zna na koju instalaciju mislite pre nego što može da je izda.
- Prijavite se na svoj Adverant nalog na
https://account.adverant.ai. - Na instalaciji otvorite Ova instalacija, zatim Licenca. Prikazuju se jednokratni kod i otisak instalacije.
- U svom nalogu otvorite Preuzmi implementaciju i unesite kod. Zatim uporedite otisak koji je nalog primio sa onim koji prikazuje instalacija, grupu po grupu; svaka grupa mora da se poklapa.
- Pritisnite dugme za preuzimanje. Instalacija se pridružuje Implementacijama Vašeg naloga, sa svojom verzijom i stanjem licence.
- Adverant izdaje licencu za tu instalaciju. Preuzmite datoteku iz svog naloga; nazvana je po identifikatoru licence,
<licence-id>.json.
Kod za preuzimanje važi jednom i kratko vreme. Ako istekne, nalog ga odbija sa CLAIM_CODE_EXPIRED, a instalacija prikazuje novi.
Postoje još dva puta, a poglavlje 2.13, Licence, detaljno opisuje oba. Uređaji i edge kompleti nemaju ekran na kome bi prikazali kod, pa se preuzimaju pomoću ključa za preuzimanje odštampanog na kutiji, koji se unosi na stranici Unesite ključ za preuzimanje ili se čita iz datoteke porudžbine proizvođača. Instalacija bez izlaza na mrežu koristi Razmenu van mreže: ona pravi potpisanu datoteku zahteva za licencu, Vi je prenosite do svog naloga, a datoteku licence prenosite nazad. Jednom godišnje na isti način pravi potpisani izveštaj o korišćenju. Svaka datoteka u razmeni je potpisana, pa se datoteka izmenjena usput odbija, sa LICENCE_REQUEST_SIGNATURE_INVALID za zahtev i USAGE_FILE_SIGNATURE_INVALID za datoteku o korišćenju.
Šta sadrži datoteka licence
Licenca je JSON dokument u formatu nexus-licence/v1, koji je Adverant potpisao dva puta, pomoću dva nezavisna ključa. Ne morate ga čitati, ali je korisno znati šta sadrži kada Vas neko pita šta ste kupili.
| Polje | Šta navodi |
|---|---|
licence_id |
Sopstveni identifikator licence, UUID (univerzalno jedinstveni identifikator) malim slovima |
type |
alpha, evaluation ili commercial |
licensee |
Naziv organizacije i Adverant identifikator korisnika |
scope |
Instalacija za koju je namenjena i sve organizacije koje dodela navodi |
edition |
enterprise |
grants |
Grupe funkcija koje otključava, svaku za celu instalaciju ili za navedene organizacije |
add_ons i domain_packs |
Mogućnosti koje se licenciraju zasebno; paket za logistiku i pomorstvo je jedna od njih |
metric |
Način obračuna licence, named-seat, per-core ili per-environment, i količina |
term |
starts_on, ends_on i broj dana upozorenja i dodatnog roka |
matrix |
Verzija matrice izdanja prema kojoj je napisana |
signatures |
Dva potpisa kompanije Adverant |
Licenca za evaluaciju traje najviše 30 dana, za najviše pet imenovanih osoba, bez dodatnog roka. Komercijalna licenca upozorava 30 dana pre isteka, a zatim podrazumevano daje 30 dana dodatnog roka. Šta se dešava na svakom koraku te lestvice opisano je u poglavlju 2.13, Licence.
Potpisi pokrivaju dokument onakav kakvim ga je Adverant napravio. Pošaljite ga tačno onakvog kakvog ste ga primili; ne otvarajte ga u uređivaču koji bi mogao da ga preuredi.
Uvoz licence
Licencu može da uveze samo administrator instalacije: vlasnik ili administrator cele organizacije koja poseduje instalaciju, dok je prijavljen na nju. Može je uvesti i administrator sa punim pravima na platformi. Licenca nikada nije vrednost charta niti datoteka montirana u pod. Ona se unosi u servis za prijavljivanje, nexus-auth, koji je proverava van mreže u odnosu na korene poverenja ugrađene u njegovu sopstvenu sliku i beleži je u jednoj transakciji. Možete je uvesti na tri načina, i svi vode do istog rezultata.
U konzoli
Tokom prvog pokretanja otvorite Šest stavki pre nego što se bilo ko prijavi, zatim Licenca. Stranica Uvoz licence prihvata datoteku: prevucite je na stranicu ili je izaberite. Stranica je proverava van mreže na samoj instalaciji, a zatim navodi grupe funkcija koje otvara, kao i način i rok zaštite svake od njih. Grupe koje licenca ne obuhvata ostaju navedene, zasivljeno.
Kasnije je isti uvoz dostupan preko dugmeta Uvezi novu licencu na stranici licence instalacije. Kada licenca istekne, ograničena stranica licence nudi Uvezi obnovljenu licencu.
Pomoću nexusctl
nexusctl licence import <licence-id>.jsonnexusctl šalje datoteku, neizmenjenu, na rutu za uvoz instalacije kao administrator instalacije i prijavljuje stanje licence ili kod odbijanja iz tabele ispod.
Preko API-ja
Ruta za uvoz deo je aplikativnog programskog interfejsa (API) servisa za prijavljivanje, na Vašoj adresi hosts.auth. Telo zahteva je dokument licence, 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, nikada -d, koji uklanja prelome redova i tako menja bajtove koje šaljete. Ruta ne prihvata upitni niz niti išta u telu osim dokumenta; telo koje na najvišem nivou pokušava da navede organizaciju ili osobu odbija se pre nego što se bilo šta pročita.
Uspešan uvoz odgovara sa 201 Created. U skraćenom obliku, telo 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 imaju licencu. tenants_without_organisation broji organizacije koje licenca navodi, a koje ova instalacija nema.
Kada je uvoz odbijen
Odbijeni uvoz ništa ne menja: nijedan red se ne upisuje, a važeća licenca, ako postoji, ostaje nepromenjena. Revizorski dnevnik instalacije beleži svaki pokušaj, uključujući i odbijene.
| Kod | Status | Šta znači | Šta učiniti |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Jedan od dva potpisa kompanije Adverant nedostaje ili se ne može verifikovati; datoteka je izmenjena nakon potpisivanja | Zatražite datoteku ponovo od kompanije Adverant; ne menjajte je |
LICENCE_FORMAT_INVALID |
422 | Datoteka nije licenca koju ovo izdanje može da pročita | Pošaljite datoteku tačno onakvu kakvu Vam je Adverant dao |
LICENCE_ROOT_UNKNOWN |
422 | Potpisana je ključem kome ova instalacija ne veruje | Zatražite licencu potpisanu za korene poverenja ovog izdanja ili izvršite nadogradnju |
LICENCE_MATRIX_MISMATCH |
422 | Napisana je prema matrici izdanja koju ovo izdanje ne čita ili dodeljuje grupu koju ovo izdanje ne poznaje | Izvršite nadogradnju ili zatražite licencu napisanu prema ovom izdanju |
LICENCE_OTHER_INSTALLATION |
409 | Izdata je za drugu instalaciju | Zatražite licencu izdatu za identitet ove instalacije |
TRANSITION_NOT_PERMITTED |
409 | Licenca sa ovim identifikatorom je već uvezena; svaka se uvozi jednom | Zatražite novu licencu od kompanije Adverant ako uslovi moraju da se promene |
LICENCE_REVOKED |
403 | Adverant je povukao ovu licencu | Zatražite novu od kompanije Adverant |
LICENCE_LOCKED |
403 | Rok licence još nije počeo; do tada važi osnovni nivo Community izdanja | Uvezite je ponovo na njen prvi dan ili kasnije |
RECORD_NOT_FOUND |
404 | Instalacija još nije deklarisana, pa nema identitet prema kome bi se vršila provera | Završite korak prvog administratora (poglavlje 2.12, Prvo pokretanje), a zatim izvršite uvoz |
VALIDATION_FAILED |
400 | Telo je bilo nečitljivo ili veće od 1 MiB, ili je poslat upitni niz | Pošaljite datoteku kao celo telo, bez upita |
Uz uspešan uvoz može da se vrati još jedan kod, kao obaveštenje, a ne kao odbijanje: LICENCE_CLOCK_BEHIND_FLOOR znači da sat instalacije pokazuje vreme ranije od najkasnijeg vremena koje je već zabeležila, pa se licenca čita prema tom kasnijem vremenu. Vraćanje sata unazad nikada ne oživljava isteklu licencu. Samo token za resetovanje vremena koji Adverant potpiše za instalaciju spušta tu donju granicu.
Prelazak sa izdanja Community na Enterprise na licu mesta
Ovo smo uradili u Harrow. Ništa se ne instalira ponovo i ništa se ne migrira: to je ista instalacija, sa istim identitetom i istim podacima, samo sa više uključenih funkcija. Naziv instalacije i čuvari ostaju tačno kakvi su bili; pri nadogradnji, kuka za čuvanje proverava da li je skladište ključeva već inicijalizovano i ne radi ništa drugo.
Postavite token za povlačenje na svaki čvor i tamo ponovo pokrenite izvršno okruženje kontejnera.
Preuzmite Enterprise chart sa stranice Preuzimanja i verifikujte njega i njegove slike kao što je gore opisano.
Promenite dve vrednosti u postojećoj datoteci vrednosti:
edition: enterpriseienterprise.enabled: true. Ništa drugo ne menjajte.Pokrenite preflight proveru sa novom datotekom.
nexusctl preflight --context harrow-prod --values harrow-values.yamlNadogradite izdanje na Enterprise chart, ponovo bez
--wait.helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45mPri nadogradnji, kuke se izvršavaju pre uvođenja novih podova, a svaka migracija primenjuje samo datoteke koje ranije nije primenila. Generisane tajne se čitaju iz instalacije i zadržavaju. Helm se završava sa:
NAME: nexus NAMESPACE: nexus STATUS: deployed REVISION: 2Sačekajte radna opterećenja, tačno kao u poglavlju 2.6, Instaliranje Community izdanja na Kubernetes, korak 7.
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900sUvezite licencu na bilo koji od tri gore opisana načina.
U konzoli otvorite Ova instalacija, zatim Licenca, a zatim Prelazak na Enterprise. Stranica čita licencu i, pre nego što se bilo šta dogodi, prikazuje šta će biti preuzeto i šta će se promeniti. Takođe prebrojava ljude i sadržaj organizacije i svaku stavku označava kao zadržanu. Pritisnite Preuzmi i uključi. Svaki deo se proverava u odnosu na Adverant ključ izdanja pre nego što se upotrebi, a grupe funkcija se uključuju jedna po jedna.
Naš vremenski prozor bio je jedan sat; posao u okviru njega trajao je dvadesetak minuta, uglavnom čekanje na šemu dok su se izvršavali hookovi. Učesnici pilot-projekta prijavili su se sledećeg jutra u isti radni prostor, a Enterprise oblasti menija više nisu bile zasivljene.
Nakon uvoza
Stranica licence u okviru Ova instalacija navodi svaku grupu funkcija u licenci, sa brojem mesta i trajanjem. Takođe navodi kako se svaki deo isporučuje, na primer kompajliran i licenciran za Enterprise grupu ili otvorenog koda za Community osnovni nivo. Grupe izvan licence ostaju navedene, zasivljene. Administratori mogu da suze ono do čega grupa dopire unutar organizacije; niko osim kompanije Adverant ne može da proširi ono što licenca dodeljuje.
Stanje licence se ponovo utvrđuje iz dokumenta i datuma pri svakom čitanju, pa do isteka dolazi bez zakazanog zadatka. Svi na instalaciji vide isto obaveštenje u konzoli kako se kraj približava: LICENCE_ENDS_SOON od 30 dana pre kraja, a zatim LICENCE_IN_GRACE tokom perioda odloženog isteka. Članovi vide obaveštenje i datume; samo administratori instalacije vide samu licencu. Poglavlje 2.13, Licence, obrađuje obnovu i stepene isteka.
Ako ovo ne uspe
| Šta vidite | Uzrok | Šta učiniti |
|---|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Promenjen je samo jedan od dva ključa | Promenite oba |
files/images.lock.json is the community lock; this install is edition enterprise |
Korišćen je Community chart | Koristite Enterprise chart iz odeljka Preuzimanja |
image ... is a enterprise image; a community install takes only community images |
Naziv Enterprise image-a dospeo je u Community render | Proverite edition i fasciklu charta |
ImagePullBackOff na Enterprise image-u nakon nadogradnje |
Čvor nema pull token ili njegov token više nije važeći | Proverite registries.yaml na tom čvoru ili napravite novi token |
| Kod odbijanja licence | Pogledajte tabelu odbijanja iznad | Pratite odgovarajući red; ništa nije promenjeno |
Kada stranica licence prikazuje Enterprise i grupe koje ste očekivali, instalacija je licencirana. Sledeći korak je prvo pokretanje u poglavlju 2.12, Prvo pokretanje, ako još niste preuzeli vlasništvo nad instalacijom. Ako jeste, asistentu su i dalje potrebni sopstveni ključevi modela veštačke inteligencije (AI) organizacije pre nego što može bilo kome da odgovori. Poglavlje 2.14, AI provajderi i modeli, pokazuje kako da ih povežete.




