Versiune 1.0.0-alpha.1cea mai recentă
Capitolul 2.7
Instalarea ediției Enterprise și aplicarea unei licențe
Ce se schimbă când instalați ediția Enterprise, cum să solicitați o licență din contul dvs. Adverant, cele trei moduri de a o importa împreună cu fiecare cod de refuz și cum și-a trecut Harrow Port Authority proiectul pilot Community la Enterprise pe loc, fără a pierde nimic.
Această pagină a fost tradusă cu ajutorul IA din originalul în limba engleză. Dacă există neclarități, pagina în limba engleză rămâne cea de referință. Citiți această pagină în limba engleză

O instalare Enterprise are două jumătăți, iar acestea sosesc pe căi diferite. Imaginile Enterprise vin împreună cu chart-ul Helm Enterprise, descărcate cu un token de preluare (pull token). Licența sosește sub forma unui fișier semnat din contul dumneavoastră Adverant, pe care îl importați în instalarea aflată în execuție. Niciuna dintre jumătăți nu funcționează fără cealaltă: imaginile fără licență rulează la nivelul de bază Community, iar o licență fără imagini Enterprise nu are ce să activeze.
La Harrow Port Authority am procedat în această ordine, la șase săptămâni după proiectul pilot Community din capitolul 2.6, Instalarea ediției Community pe Kubernetes. Actualizarea la chart-ul Helm Enterprise a necesitat o singură fereastră de mentenanță; importul licenței a durat două minute. Acest capitol acoperă ambele jumătăți. Începe cu o instalare de la zero și se încheie cu o instalare Community existentă, convertită pe loc.
Ce diferă față de Community
Două valori și chart-ul care le citește.
# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
enabled: trueTot restul din fișierul de valori rămâne exact așa cum a fost, mai ales numele instalării și custozii. Cele două chei trebuie să corespundă, iar chart-ul refuză edition: enterprise cu enterprise.enabled: false, sau invers.
Ediția trebuie să corespundă și cu fișierul de blocare a imaginilor din chart. Fiecare pachet chart conține fișierul de blocare pentru o singură ediție, iar fișierul de blocare Enterprise listează imaginile Community plus versiunile Enterprise. Dacă direcționați un fișier de valori Enterprise către chartul Community, generarea se oprește cu files/images.lock.json is the community lock; this install is edition enterprise. Prin urmare, instalarea Enterprise necesită chartul Enterprise.
Chart-ul Helm și pachetul Enterprise se află pe pagina Descărcări (Downloads) a contului dumneavoastră Adverant, care urmărește licența dumneavoastră. Fișierul chart-ului are același nume ca cel pentru Community, nexus-1.0.0-alpha.1.tgz, așa că păstrați-le pe cele două în dosare separate. Verificați-l exact așa cum descrie capitolul 2.4, Obținerea și verificarea unei versiuni, în raport cu cheia de versiune a cărei amprentă ați verificat-o:
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
Apoi rulați bucla de verificare a semnăturilor din capitolul 2.4, Obținerea și verificarea unei versiuni, peste enterprise/nexus/files/images.lock.json. Aceasta acoperă atât imaginile Enterprise, cât și pe cele comune.
Tokenul de extragere (pull token)
Imaginile Community sunt publice. Imaginile Enterprise necesită un token de preluare (pull token) din pagina Tokenuri de preluare și comenzi de instalare (Pull tokens and install commands) a contului dumneavoastră, configurat pentru mediul de execuție al containerelor de pe nodurile dumneavoastră, așa cum arată capitolul 2.4, Obținerea și verificarea unei versiuni, pasul 3. Pe k3s, aceasta înseamnă o intrare configs pentru registry.adverant.ai în /etc/rancher/k3s/registries.yaml pe fiecare nod.
Creați câte un token pentru fiecare cluster și setați-i o dată de expirare pe care să o observați din timp. Când un token expiră, podurile aflate în execuție își continuă activitatea, dar un pod reprogramat pe un nod care nu are încă imaginea nu o va putea descărca. Noi am trecut data de expirare a tokenului în același calendar cu cea a certificatului.
O instalare Enterprise de la zero
Dacă instalați ediția Enterprise de la început, urmați capitolul 2.6, Instalarea ediției Community pe Kubernetes, pas cu pas, cu trei diferențe:
Puneți tokenul de preluare pe fiecare nod înainte de pasul 6.
Folosiți valorile Enterprise (cele două chei de mai sus) la pasul 4.
La pasul 6, instalați din fișierul chart-ului Enterprise pe care l-ați descărcat:
helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45m
Tot ceea ce urmează după comanda de instalare este identic cu capitolul 2.6, Instalarea ediției Community pe Kubernetes, la fel și regula privind --wait: nu îl folosiți. Dacă instalați în schimb cu nexusctl, adăugați --edition enterprise la comandă:
nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterpriseCând toate sarcinile de lucru sunt pregătite, parcurgeți prima rulare din capitolul 2.12, Prima rulare. Licența este unul dintre cele șase elemente pe care consola le afișează înainte ca cineva să se conecteze. Până când aceasta este importată, instalarea rulează la nivelul de bază Community, iar fiecare zonă Enterprise este afișată estompat, cu un lacăt.
Solicitarea licenței
O licență de la Adverant este emisă pentru identitatea unei singure instalări, cea pe care depozitul de chei a generat-o sub keys.installationName la instalare. Prin urmare, contul trebuie să știe la ce instalare vă referiți înainte de a putea emite o licență.
- Conectați-vă la contul dumneavoastră Adverant la
https://account.adverant.ai. - În instalare, deschideți Această instalare (This installation), apoi Licență (Licence). Aceasta afișează un cod de unică folosință și amprenta instalării.
- În contul dumneavoastră, deschideți Revendicați o implementare (Claim a deployment) și introduceți codul. Apoi comparați amprenta primită de cont cu cea afișată de instalare, grup cu grup; fiecare grup trebuie să corespundă.
- Apăsați butonul de revendicare. Instalarea se alătură secțiunii Implementări (Deployments) din contul dumneavoastră, cu versiunea și starea licenței sale.
- Adverant emite licența pentru acea instalare. Descărcați fișierul din contul dumneavoastră; acesta este denumit după identificatorul licenței sale,
<licence-id>.json.
Un cod de revendicare funcționează o singură dată și pentru scurt timp. Dacă expiră, contul îl refuză cu CLAIM_CODE_EXPIRED, iar instalarea afișează unul nou.
Există alte două căi, iar capitolul 2.13, Licențe, le acoperă integral pe amândouă. Echipamentele dedicate (appliances) și kiturile edge nu au ecran pentru a afișa un cod, astfel încât sunt revendicate cu o cheie de revendicare tipărită pe cutie, introdusă în Introduceți o cheie de revendicare (Enter a claim key) sau citită din fișierul de comandă al producătorului. O instalare fără conexiune externă folosește Schimbul offline (Offline exchange): aceasta creează un fișier semnat de cerere de licență, îl transferați în contul dumneavoastră și aduceți înapoi fișierul de licență. O dată pe an, aceasta creează o declarație de utilizare semnată, în același mod. Fiecare fișier din cadrul schimbului este semnat, astfel încât un fișier modificat pe parcurs este refuzat, cu LICENCE_REQUEST_SIGNATURE_INVALID pentru o cerere și USAGE_FILE_SIGNATURE_INVALID pentru un fișier de utilizare.
Ce conține fișierul de licență
Licența este un document JSON în formatul nexus-licence/v1, semnat de două ori de Adverant cu două chei independente. Nu este nevoie să îl citiți, dar este util să știți ce conține atunci când cineva întreabă ce ați achiziționat.
| Câmp | Ce indică |
|---|---|
licence_id |
Identificatorul propriu al licenței, un UUID (identificator unic universal) cu litere mici |
type |
alpha, evaluation sau commercial |
licensee |
Numele organizației și identificatorul de client Adverant |
scope |
Instalarea căreia îi este destinată și orice organizații nominalizate printr-o atribuire |
edition |
enterprise |
grants |
Grupurile de funcționalități pe care le deblochează, fiecare pentru întreaga instalare sau pentru organizații nominalizate |
add_ons și domain_packs |
Capabilități licențiate separat; pachetul de Logistică și maritim (Logistics and maritime pack) este unul dintre ele |
metric |
Modul în care este contorizată licența, named-seat, per-core sau per-environment, precum și cantitatea |
term |
starts_on, ends_on, precum și zilele de avertizare și de grație |
matrix |
Versiunea matricei de ediții în raport cu care a fost redactată |
signatures |
Cele două semnături ale Adverant |
O licență de evaluare durează cel mult 30 de zile, pentru cel mult cinci persoane nominalizate, fără perioadă de grație. O licență comercială avertizează cu 30 de zile înainte de expirare și oferă apoi, în mod implicit, 30 de zile de grație. Ce se întâmplă la fiecare treaptă a acestei scări este descris în capitolul 2.13, Licențe.
Semnăturile acoperă documentul exact așa cum l-a creat Adverant. Trimiteți-l exact așa cum l-ați primit; nu îl deschideți într-un editor care l-ar putea reformata.
Importarea licenței
Doar un administrator al instalării poate importa o licență: un proprietar sau administrator al întregii organizații care deține instalarea, în timp ce este conectat la aceasta. Și un administrator complet de platformă poate importa una. Licența nu este niciodată o valoare în diagramă sau un fișier montat într-un pod. Aceasta merge către serviciul de autentificare, nexus-auth, care o verifică offline în raport cu rădăcinile de încredere integrate în propria sa imagine și o înregistrează într-o singură tranzacție. O puteți importa în trei moduri, iar toate ajung în același loc.
În consolă
În timpul primei rulări, deschideți Șase lucruri înainte ca cineva să se conecteze (Six things before anyone signs in), apoi Licență (Licence). Pagina Importați licența (Import the licence) preia fișierul: trageți-l pe pagină sau selectați-l. Pagina îl verifică offline pe instalarea însăși, apoi listează grupurile de funcționalități pe care le deschide, indicând modul în care este protejat fiecare și până când. Grupurile pe care licența nu le include rămân listate, dar estompate.
Ulterior, același import se face prin butonul Importați o licență nouă (Import a new licence) de pe pagina de licență a instalării. Când o licență a expirat, pagina de licență restricționată oferă opțiunea Importați o licență reînnoită (Import a renewed licence).
Cu nexusctl
nexusctl licence import <licence-id>.jsonnexusctl trimite fișierul, nemodificat, către ruta de import a instalării în calitate de administrator al instalării și raportează starea licenței sau codul de refuz din tabelul de mai jos.
Prin API
Ruta de import face parte din interfața de programare a aplicațiilor (API) a serviciului de autentificare, la adresa dumneavoastră hosts.auth. Corpul cererii este documentul de licență, octet cu octet:
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> este tokenul de acces al unui administrator al instalării conectat. Folosiți --data-binary, niciodată -d, deoarece acesta din urmă elimină întreruperile de linie și modifică astfel octeții pe care îi trimiteți. Ruta nu acceptă niciun șir de interogare și nimic în corpul cererii în afară de document; un corp care încearcă să numească o organizație sau o persoană la nivelul său superior este refuzat înainte ca orice să fie citit.
Un import reușit răspunde cu 201 Created. Într-o formă prescurtată, corpul arată astfel:
{
"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 numără organizațiile de pe instalare care dețin acum licența. tenants_without_organisation numără organizațiile nominalizate în licență pe care această instalare nu le găzduiește.
Când importul este refuzat
Un import refuzat nu modifică nimic: nu se scrie niciun rând, iar licența în vigoare, dacă există una, rămâne neschimbată. Jurnalul de audit al instalării înregistrează fiecare încercare, inclusiv pe cele refuzate.
| Cod | Stare | Ce înseamnă | Ce trebuie să faceți |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Una dintre cele două semnături ale Adverant lipsește sau nu poate fi verificată; fișierul a fost modificat după semnare | Solicitați din nou fișierul de la Adverant; nu îl editați |
LICENCE_FORMAT_INVALID |
422 | Fișierul nu este o licență pe care această versiune să o poată citi | Trimiteți fișierul exact așa cum l-a furnizat Adverant |
LICENCE_ROOT_UNKNOWN |
422 | Este semnată cu o cheie în care această instalare nu are încredere | Solicitați o licență semnată pentru rădăcinile de încredere ale acestei versiuni sau faceți upgrade |
LICENCE_MATRIX_MISMATCH |
422 | Este redactată în raport cu o matrice de ediții pe care această versiune nu o citește sau acordă un grup pe care această versiune nu îl cunoaște | Faceți upgrade sau solicitați o licență redactată pentru această versiune |
LICENCE_OTHER_INSTALLATION |
409 | A fost emisă pentru o altă instalare | Solicitați o licență emisă pentru identitatea acestei instalări |
TRANSITION_NOT_PERMITTED |
409 | O licență cu acest identificator a fost deja importată; fiecare se importă o singură dată | Solicitați de la Adverant o licență nouă dacă termenii trebuie modificați |
LICENCE_REVOKED |
403 | Adverant a retras această licență | Solicitați una nouă de la Adverant |
LICENCE_LOCKED |
403 | Perioada de valabilitate a licenței nu a început; până atunci se aplică nivelul de bază Community | Importați-o din nou în prima zi de valabilitate sau ulterior |
RECORD_NOT_FOUND |
404 | Instalarea nu a fost încă declarată, deci nu are o identitate în raport cu care să se facă verificarea | Finalizați pasul primului administrator (capitolul 2.12, Prima rulare), apoi importați |
VALIDATION_FAILED |
400 | Corpul cererii nu a putut fi citit sau a depășit 1 MiB, ori a fost trimis un șir de interogare | Trimiteți fișierul ca întreg corp al cererii, fără interogare |
Mai poate fi returnat un cod la un import reușit, ca notificare și nu ca refuz: LICENCE_CLOCK_BEHIND_FLOOR înseamnă că ceasul instalării indică o oră anterioară celei mai recente ore pe care a înregistrat-o deja, astfel încât licența este citită la acea oră ulterioară. Darea ceasului înapoi nu reactivează niciodată o licență expirată. Doar un token de resetare a timpului pe care Adverant îl semnează pentru instalare coboară acest prag.
Trecerea de la Community la Enterprise pe loc
Așa am procedat la Harrow. Nimic nu este reinstalat și nimic nu este migrat: este aceeași instalare, cu aceeași identitate și aceleași date, având mai multe componente activate. Numele instalării și custozii rămân exact așa cum au fost; la un upgrade, cârligul (hook) de custodie verifică dacă depozitul de chei este deja inițializat și nu face nimic altceva.
Puneți tokenul de preluare pe fiecare nod și reporniți mediul de execuție al containerelor de acolo.
Descărcați diagrama Enterprise din Descărcări (Downloads) și verificați atât diagrama, cât și imaginile sale, conform instrucțiunilor de mai sus.
Modificați cele două valori din fișierul dumneavoastră de valori existent:
edition: enterpriseșienterprise.enabled: true. Nu modificați nimic altceva.Rulați verificarea preliminară (preflight) cu noul fișier.
nexusctl preflight --context harrow-prod --values harrow-values.yamlActualizați versiunea instalată la diagrama Enterprise, din nou fără
--wait.helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45mLa un upgrade, cârligele (hooks) rulează înainte de lansarea noilor poduri, iar fiecare migrare aplică doar fișierele pe care nu le-a aplicat anterior. Secretele generate sunt citite din instalare și păstrate. Helm încheie cu:
NAME: nexus NAMESPACE: nexus STATUS: deployed REVISION: 2Așteptați ca sarcinile de lucru să fie gata, exact ca în capitolul 2.6, Instalarea ediției Community pe Kubernetes, pasul 7.
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900sImportați licența, prin oricare dintre cele trei metode de mai sus.
În consolă, deschideți Această instalare (This installation), apoi Licență (Licence), apoi Trecere la Enterprise (Move to Enterprise). Pagina citește licența și afișează ce se va descărca și ce se va modifica înainte ca orice să aibă loc. De asemenea, numără persoanele și conținutul organizației și le marchează pe fiecare ca fiind păstrate. Apăsați Preia și activează (Fetch and switch on). Fiecare componentă este verificată în raport cu cheia de versiune a Adverant înainte de a fi utilizată, iar grupurile de funcționalități se activează pe rând.
Fereastra noastră a fost de o oră; operațiunile din cadrul ei au durat aproximativ douăzeci de minute, cea mai mare parte fiind așteptarea după schemă în timp ce rulau cârligele. Participanții la proiectul pilot s-au conectat în dimineața următoare în același spațiu de lucru, zonele Enterprise din meniu nemaifiind estompate.
După import
Pagina de licență din Această instalare (This installation) listează fiecare grup de funcționalități din licență, împreună cu locurile și perioada sa de valabilitate. De asemenea, indică modul în care este livrată fiecare parte, de exemplu compilată și licențiată pentru un grup Enterprise, sau cu sursă deschisă (open source) pentru nivelul de bază Community. Grupurile din afara licenței rămân listate, dar estompate. Administratorii pot restrânge aria de acoperire a unui grup în interiorul organizației; nimeni în afară de Adverant nu poate extinde ceea ce acordă o licență.
Starea licenței este recalculată din document și din dată la fiecare citire, astfel încât expirarea are loc fără o sarcină programată. Toți utilizatorii de pe instalare văd aceeași notificare în consolă pe măsură ce se apropie finalul: LICENCE_ENDS_SOON cu 30 de zile înainte de expirare, apoi LICENCE_IN_GRACE în timpul perioadei de grație. Membrii văd notificarea și datele; doar administratorii instalării văd licența în sine. Capitolul 2.13, Licențe, acoperă reînnoirea și scara de expirare.
Dacă acest lucru eșuează
| Ce vedeți | Cauză | Ce trebuie să faceți |
|---|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Doar una dintre cele două chei a fost modificată | Modificați-le pe amândouă |
files/images.lock.json is the community lock; this install is edition enterprise |
A fost utilizată diagrama Community | Utilizați diagrama Enterprise din Descărcări (Downloads) |
image ... is a enterprise image; a community install takes only community images |
Un nume de imagine Enterprise a ajuns într-o generare Community | Verificați edition și dosarul diagramei |
ImagePullBackOff la o imagine Enterprise după upgrade |
Un nod nu are token de preluare sau tokenul său nu mai este valabil | Verificați registries.yaml pe acel nod sau creați un token nou |
| Un cod de refuz al licenței | Consultați tabelul de refuzuri de mai sus | Urmați instrucțiunile de pe rândul corespunzător; nimic nu a fost modificat |
Când pagina de licență afișează Enterprise și grupurile pe care le așteptați, instalarea este licențiată. Următorul pas este prima rulare din capitolul 2.12, Prima rulare, dacă nu ați revendicat încă instalarea. Dacă ați făcut-o, asistentul are încă nevoie de propriile chei pentru modelele de inteligență artificială (IA) ale organizației înainte de a putea răspunde cuiva. Capitolul 2.14, Furnizori și modele de IA, arată cum să le conectați.




