PrijavaRezervirajte prezentaciju

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

17 min čitanja

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.

Dvije paralelne trake koje vode u jedan okvir desno s oznakom "Instalacija izdanja Enterprise". Gornja traka: "Račun za Adverant: Preuzimanja" vodi do "Chart za Enterprise i njegov zaključani popis slika", zatim do "helm install ili helm upgrade, edition: enterprise", s bočnim okvirom "token za preuzimanje na svakom čvoru" koji je s njim povezan. Donja traka: "Račun za Adverant: Instalacije" vodi do "potpisana datoteka licencije", zatim do "uvoz u pokrenutu instalaciju". Obje se trake spajaju u desnom okviru. Ispod njega nalazi se opis u kojem piše "slike bez licencije rade na osnovnoj razini izdanja Community".
Dvije polovice instalacije izdanja Enterprise i odakle svaka dolazi.

Š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: true

Sve 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.json
1.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:

  1. Postavite token za preuzimanje na svaki čvor prije 6. koraka.

  2. Upotrijebite vrijednosti za Enterprise (dva gore navedena ključa) u 4. koraku.

  3. 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 enterprise

Kada 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.

  1. Prijavite se na svoj račun za Adverant na adresi https://account.adverant.ai.
  2. Na instalaciji otvorite Ova instalacija (This installation), a zatim Licencija (Licence). Prikazat će se jednokratni kôd i otisak instalacije.
  3. 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.
  4. Pritisnite gumb za preuzimanje vlasništva. Instalacija se pridružuje odjeljku Instalacije (Deployments) na vašem računu, sa svojom verzijom i stanjem licencije.
  5. 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.

Preuzmi vlasništvo nad instalacijom
Preuzmi vlasništvo nad instalacijom
Preuzimanje vlasništva nad instalacijom na računu za Adverant. Prvo se unosi jednokratni kôd, a zatim se otisak uspoređuje u grupama od po četiri znaka, tako da nitko ne može preuzeti vlasništvo nad instalacijom ispred koje se osobno ne nalazi.

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.

Izvanmrežna razmjena
Izvanmrežna razmjena
Izvanmrežna razmjena na računu za Adverant. Potpisane datoteke prenose se ručno u oba smjera, a datoteka koja je putem izmijenjena odbija se uz navođenje točnog razloga.

Š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).

Uvoz licencije
Uvoz licencije
Uvoz licencije u konzoli. Datoteka se provjerava na samoj instalaciji; stranica navodi što ona otključava po grupama značajki, a datoteka koja ne prođe provjeru potpisa tretira se kao da ne postoji, uz pripadajući kôd pogreške.

Pomoću alata nexusctl

nexusctl licence import <licence-id>.json

nexusctl š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.

  1. Postavite token za preuzimanje na svaki čvor i ondje ponovno pokrenite izvršno okruženje kontejnera.

  2. Dohvatite chart za Enterprise iz odjeljka Preuzimanja (Downloads) te provjerite njega i njegove slike kako je gore opisano.

  3. Promijenite dvije vrijednosti u postojećoj datoteci s vrijednostima: edition: enterprise i enterprise.enabled: true. Ne mijenjajte ništa drugo.

  4. Pokrenite predprovjeru (preflight) s novom datotekom.

    nexusctl preflight --context harrow-prod --values harrow-values.yaml
  5. Nadogradite 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 45m

    Pri 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: 2
  6. Prič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=900s
  7. Uvezite licenciju, na bilo koji od tri gore navedena načina.

  8. 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.

S izdanja Community na Enterprise
S izdanja Community na Enterprise
Prelazak instalacije izdanja Community na Enterprise. Stranica potvrđuje da je licencija vjerodostojna i navodi što će se dohvatiti prije samog dohvaćanja; osobe i datoteke organizacije označene su kao zadržane.

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.

Licenca i što ona otključava
Licenca i što ona otključava
Ovo je stranica licencije instalacije izdanja Enterprise. Brojke na vrhu prikazuju broj mjesta i rok valjanosti; ispod njih navedena je svaka grupa značajki s načinom na koji je zaštićena, dok grupe izvan licencije ostaju zasivljene.

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.