Merydion 1.9

Guida dell'amministratore

Le guide dell'installazione, della console e dell'organizzazione in un solo documento da leggere offline o stampare, nella tua lingua.

Generata dalle guide del portale, Merydion 1.9.

Per chi installa Merydion

Installazione e aggiornamento

Tutto Merydion — il portale, le sei app e i servizi che le reggono — gira su una macchina sola. La build lo prepara sulla macchina di sviluppo in una di due forme: un'immagine per Docker su un server Linux raggiunto da un suo dominio, o una cartella che gira su Windows 11 senza installare nulla. La macchina che lo fa girare non ha bisogno di un compilatore.

Questa guida segue le due strade fino all'accesso del primo amministratore, poi copre ciò che tiene in salute l'installazione: aggiornamenti, backup, l'interruttore del coming soon e la politica di sicurezza del portale. I comandi sono quelli della cartella deploy del repository.

Prima di cominciare

Le due strade per installare la suite, e il file che ne nomina gli amministratori.

Scegliere la strada

La build gira sulla macchina di sviluppo, con il repository e i suoi strumenti, e consegna solo ciò che serve alla macchina di destinazione per girare — mai il codice sorgente. Esiste in due forme, con gli stessi servizi e le stesse app.

  1. L'immagine per Docker è adatta a un server Linux con Docker Engine e un suo dominio: Caddy, dentro il container, ottiene il certificato da Let's Encrypt, quindi il dominio deve puntare alla macchina e le porte 80 e 443 devono essere raggiungibili.
  2. La cartella è adatta a una macchina Windows 11 x64 senza Docker: contiene i servizi come programmi, Caddy e le pagine web, e serve HTTPS sulla porta 8080 con un certificato suo.
  3. Entrambe partono con un insieme di dati vuoto e diventano utilizzabili con il primo amministratore: vedi Il primo amministratore.
  4. Qualunque strada scegli, tieni il repository sulla macchina di sviluppo: gli aggiornamenti si costruiscono lì.

Suggerimento L'immagine è la strada per un server aperto su Internet; la cartella va bene per una prova o per una macchina della rete locale.

Il file degli amministratori

La console dell'installazione si apre solo agli account elencati in un file di testo chiamato ADMINISTRATORS. Essere proprietari di un'organizzazione non basta: il file è l'unico elenco.

  1. Scrivi un'email d'accesso per riga; una riga che comincia con # è un commento, e maiuscole e minuscole non contano.
  2. Con l'immagine il file è ADMINISTRATORS alla radice del repository sul server, montato in sola lettura nel container.
  3. Con la cartella è ADMINISTRATORS accanto a SERVER_CONFIGURATION.json; la variabile MERYDION_ADMINISTRATORS_FILE può indicare un altro percorso.
  4. Il file si rilegge a ogni controllo: aggiungere o togliere una riga vale subito, senza riavviare nulla.

Suggerimento Un file assente o vuoto vuol dire nessun amministratore: la console allora rifiuta tutti.

L'immagine su un server Linux

Costruisci l'immagine, prepara il server e avvia il container sul tuo dominio.

Costruire l'immagine

L'immagine si costruisce sulla macchina di sviluppo, con Docker Desktop in modalità container Linux, e arriva al server come file: al server non servono né un registry né il codice sorgente.

  1. Dalla radice del repository esegui .\rebuild_container_release.ps1 -NoSeedData: costruisce l'immagine, verifica che non contenga sorgenti e che ci sia ogni parte compilata, la avvia per prova e la salva come deploy\docker\merydion-allinone.tar con la sua impronta.
  2. Copia l'immagine e la sua impronta sul server, per esempio con scp deploy/docker/merydion-allinone.tar* admin@merydion.example.com:/tmp/.
  3. Sul server verifica l'impronta e carica l'immagine: cd /tmp && sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.

Suggerimento Senza -NoSeedData la build impacchetta anche merydion-data.tar.gz con i dati della macchina di sviluppo — dati personali e chiave privata del servizio d'accesso compresi: non è per un'installazione nuova.

Preparare il server

Sul server mantieni la disposizione del repository: il file compose trova i suoi vicini per percorso relativo. I file qui sotto sono del server, mai dell'immagine.

  1. Fai puntare al server il record DNS del tuo dominio e apri verso Internet le porte 80 e 443.
  2. In deploy/prod-allinone/Caddyfile scrivi un'email vera nel blocco globale: Let's Encrypt ci scrive prima che un certificato scada.
  3. Crea deploy/prod-allinone/.env con MERYDION_DOMAIN=merydion.example.com e, perché le email di verifica partano, MERYDION_AUTH_SMTP_PASSWORD= seguito dalla password della casella.
  4. Crea SERVER_SECRETS.json alla radice del repository, leggibile solo da te (chmod 600): lì vanno gli altri segreti dei servizi, e se non ce ne sono contiene { "services": {} } — senza il file il container non parte.
  5. Scrivi la tua email in ADMINISTRATORS, alla radice del repository.

Suggerimento Un segreto non va mai in SERVER_CONFIGURATION.json, che è versionato e tiene vuoti i campi segreti; la variabile di un campo vince su SERVER_SECRETS.json.

Avviare il container

Il container contiene il gateway, i servizi, il portale e le app. Parte dall'immagine caricata, senza costruire nulla sul server.

  1. Dalla radice del repository: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d.
  2. Controlla che giri: docker compose -f deploy/prod-allinone/docker-compose.yml ps deve dire running, non restarting.
  3. Alla prima visita Caddy ottiene il certificato, e ci vuole fino a un minuto: poi curl -sS https://merydion.example.com/health risponde ok.
  4. Se il container continua a ripartire, un servizio si è fermato e ha portato con sé gli altri: leggi perché con docker compose -f deploy/prod-allinone/docker-compose.yml logs --tail=80.

Suggerimento Le videochiamate su questo server chiedono anche la porta UDP del servizio media e un relay TURN: il runbook del nodo singolo nel repository descrive le impostazioni in più.

La cartella su Windows

Costruisci la cartella copia-ed-esegui e avviala su una macchina Windows.

Costruire la cartella

La cartella si costruisce sulla macchina di sviluppo e si copia così com'è: la macchina Windows che la fa girare non installa nulla — né Rust, né Node, né Docker.

  1. Dalla radice del repository esegui .\rebuild_bare_release.ps1 -NoSeedData: assembla deploy\bare\out\ con i servizi come programmi, Caddy, il portale e le app, la configurazione e gli script di avvio e arresto.
  2. Se alla radice del repository esiste SERVER_SECRETS.json viaggia nella cartella, che allora va tenuta riservata; altrimenti scrivi il file sulla macchina di destinazione, o imposta le variabili dei segreti prima di avviare.
  3. Copia la cartella out sulla macchina Windows 11 x64, dove preferisci.

Suggerimento Con -NoSeedData la cartella contiene un insieme di dati vuoto; senza, una copia dei dati della macchina di sviluppo, dati personali compresi.

Avviare la cartella

Due script avviano e fermano tutto. Le porte si scelgono a ogni avvio: su una macchina pulita il gateway prende la 8080 e i servizi le porte dalla 9001.

  1. In PowerShell, nella cartella, esegui .\start.ps1: avvia in background i servizi e Caddy, apre nel firewall le porte che il gateway non copre e aspetta che l'accesso risponda.
  2. .\start.ps1 --list stampa che cosa avvierebbe e su quali porte, senza avviare nulla.
  3. Apri https://localhost:8080/ sulla macchina stessa, o il suo indirizzo sulla porta 8080 dalla rete locale.
  4. Il certificato è della macchina: il browser avvisa una volta — accetta l'avviso, o esegui l'avvio come amministratore perché Caddy installi la sua autorità di certificazione.
  5. .\stop.ps1 ferma tutto, sulle porte che l'avvio ha preso davvero.

Suggerimento Se un altro programma occupa una porta, solo quel ruolo passa alla porta libera successiva, e l'avvio lo dice a schermo.

Primo accesso ed esercizio

Il primo amministratore, gli aggiornamenti, i backup, il coming soon e la politica di sicurezza.

Il primo amministratore

La registrazione è aperta solo a chi ha un codice invito, e i codici si generano nella console — che ancora nessuno può aprire. Il primo codice si genera sulla macchina stessa.

  1. Immagine: sul server, dalla radice del repository, docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Cartella: in PowerShell, nella cartella, $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. Il comando stampa un codice nella forma XXXX-XXXX-XXXX; invite-code 5 ne stampa cinque.
  4. Sul portale fai clic su Accedi, poi su Crea account: inserisci il codice e registrati con l'email scritta in ADMINISTRATORS, poi confermala con il codice dell'email di verifica.
  5. Accedi: Diagnostica, in fondo a ogni pagina, apre la console, dove si generano gli altri codici invito.

Suggerimento Se l'email di verifica non arriva, controlla la password della casella: il servizio d'accesso dice all'avvio quando manca.

Aggiornare

Un aggiornamento sostituisce l'immagine e tiene i dati: stanno nel volume del container, che appartiene al progetto e non all'immagine.

  1. Sulla macchina di sviluppo, con il repository aggiornato, costruisci la nuova immagine: .\rebuild_container_release.ps1 -NoSeedData.
  2. Copiala sul server, verificala e caricala come la prima volta: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Avvia con lo stesso comando della prima volta: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d si accorge della nuova immagine e ricrea il container, con un'interruzione di pochi secondi.
  4. Apri la console sulla scheda Aggiornamento: dove una riga dice Aggiornamento disponibile, fai clic su Esegui aggiornamento — fino ad allora le funzioni dati di quel servizio restano spente.

Suggerimento Prima di ogni aggiornamento controlla nella diagnostica che le copie dei database siano a posto (la scheda «Copie dei database») e copia i file: l'aggiornamento dei database lavora su una copia e tiene l'originale finché la copia non è verificata, ma le copie sono la tua strada per tornare indietro.

Copie e ripristino

Ogni servizio tiene una copia continua dei database che gestisce — account, indici dei documenti, posta, chat — al più un secondo indietro, e la ripristina a qualunque istante degli ultimi sette giorni. I file veri e propri — documenti, allegati, anteprime — si scrivono una volta e non cambiano più: si copiano a parte, o stanno in un bucket S3.

  1. Porta le copie dei database fuori dalla macchina: registra una destinazione della classe backups su un bucket S3 o su un altro disco, e attivala.
  2. Immagine: copia i file, senza i database, mentre gira: docker run --rm -v merydion-prod-allinone_merydion_state:/d:ro -v "$PWD/files":/b alpine sh -c 'tar czf /b/files-$(date +%F).tgz -C /d --exclude="*.db" --exclude="*.db-*" --exclude=./backups --exclude=./restores .' scrive un archivio datato nella cartella files.
  3. Cartella: fermala con .\stop.ps1, copia per intero la cartella data, poi riavviala.
  4. Se un amministratore ha registrato un'altra destinazione per i file, copia la sua cartella nello stesso giro: i file nati dopo la sua attivazione stanno solo lì.
  5. Tieni le copie lontano dalla macchina che proteggono.

Suggerimento Per riportare un database o l'installazione intera a un istante, ferma l'installazione e usa merydion-storage copies restore (la procedura «Copie e ripristino» del runbook): scrive i database ripristinati in una cartella nuova, che poi prende il posto della vecchia.

Mettere il sito in coming soon

Il coming soon mostra a ogni visitatore solo una pagina d'anteprima mentre l'installazione si prepara: il portale, le app, Palatys e la console aspettano dietro di lei, anche per gli amministratori.

  1. Accedi come amministratore e apri https://merydion.example.com/coming-soon.html?enabled=true: la pagina conferma e il sito è in coming soon.
  2. Per riaccendere il sito apri https://merydion.example.com/coming-soon.html?enabled=false: dopo la conferma la pagina ti porta alla home.
  3. Se non hai fatto l'accesso, la pagina te lo chiede prima; a un account che non è amministratore lo dice, e non cambia nulla.
  4. Lo stato è il file site/coming-soon nella cartella dei dati: toglierlo riaccende il sito anche senza la pagina.

Suggerimento La pagina del coming soon esiste in inglese e in italiano; a un visitatore di un'altra lingua arriva quella inglese.

Accendere le statistiche di visita

Il sito può contare le visite con Google Analytics 4, chiedendo prima il consenso a ogni visitatore: finché un visitatore non accetta, non si carica niente di Google. Le statistiche restano spente finché l'installazione non indica il suo ID di misurazione, e la console d'amministrazione non le ha mai.

  1. In Google Analytics crea una proprietà e uno stream di dati web per l'indirizzo del sito, e copia il suo ID di misurazione (comincia con G-).
  2. Immagine: nel file .env accanto a docker-compose.yml aggiungi MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX e ricrea il container con docker compose up -d. Cartella: esporta la stessa variabile nella sessione prima di start.ps1.
  3. Apri il sito in una finestra privata: in basso a sinistra compare l'avviso sulle statistiche di visita, e in fondo a ogni pagina compare «Preferenze sui cookie».
  4. Per spegnere le statistiche svuota la variabile e ricrea il container: l'avviso sparisce, e i browser di chi aveva accettato smettono di caricare Google Analytics.

Suggerimento L'informativa privacy e quella sui cookie descrivono già le statistiche, in ogni lingua, per l'installazione che le accende. Nella proprietà imposta la conservazione dei dati che vuoi — Google tiene i dati di una visita al più 14 mesi — e lascia spenti i segnali di Google: il sito li spegne anche dalla sua parte.

Offrire il sito ai motori di ricerca

Ogni installazione dice ai motori di ricerca di non indicizzarla finché non accende l'indicizzazione: una copia del sito che non è quella ufficiale — un'installazione di prova, quella di un'organizzazione — non le fa mai concorrenza nei risultati. Gli indirizzi che le pagine, le anteprime e le mappe del sito dichiarano nominano il sito ufficiale, https://merydion.eu, e le pagine dell'account, la console e la pagina di un indirizzo che non esiste non entrano mai in un indice.

  1. Solo sull'installazione che serve il sito ufficiale. Immagine: nel file .env accanto a docker-compose.yml aggiungi MERYDION_SITE_INDEXING=1 e ricrea il container con docker compose up -d. Cartella: esporta la stessa variabile nella sessione prima di start.ps1.
  2. Verifica: curl -I https://merydion.eu/ non mostra più l'intestazione X-Robots-Tag: noindex, e https://merydion.eu/robots.txt indica https://merydion.eu/sitemap.xml.
  3. In Google Search Console e in Bing Webmaster Tools verifica il dominio con un record DNS e invia https://merydion.eu/sitemap.xml.
  4. Per togliere di nuovo il sito dai motori di ricerca svuota la variabile e ricrea il container: ogni risposta torna a dire noindex, e i motori lasciano le pagine alla visita successiva.

Suggerimento Un portale generato per un altro indirizzo imposta MERYDION_SITE_ORIGIN (per esempio https://www.example.com) quando lo si genera: gli indirizzi canonici, le alternative di lingua, le anteprime e le mappe del sito nominano allora quell'indirizzo. La pagina di un indirizzo che non esiste risponde nella lingua della sua cartella, con lo stato 404.

La Content-Security-Policy del portale

Le pagine del portale girano sotto una Content-Security-Policy stretta che manda il gateway: una pagina può usare solo i propri file, richieste alla propria origine, immagini anche da data: e blob:, e nessuna cornice di un altro sito. È ciò che impedisce a un frammento di markup intruso di eseguire codice. L'unica eccezione sono le statistiche di visita: le pagine che possono contare le visite ammettono anche gtag.js di Google, solo nel suo percorso, e la raccolta di Google Analytics, che si caricano solo dopo che un visitatore ha accettato.

  1. Un portale personalizzato con script o stili scritti dentro le pagine non funziona: script e stili vanno in file propri.
  2. window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE e window.MERYDION_DIAGNOSTICS_BASE possono spostare una famiglia di richieste solo sotto un altro percorso della stessa origine; un indirizzo su un'altra origine si ignora, con un errore nella console del browser.
  3. Le pagine della console dell'installazione portano la politica senza l'eccezione delle statistiche e, in più, non si possono mostrare dentro una cornice.
  4. La politica vive in apps/portal-csp.mjs e nei tre Caddyfile, e un test le tiene uguali: si cambia insieme in tutti e quattro i posti.

Suggerimento Il modulo d'accesso del servizio d'identità e la pagina di rifiuto della console arrivano con una politica propria, ancora più stretta.

Per chi amministra l'installazione

Console dell'installazione

La console è lo strumento di chi gestisce un'installazione Merydion. Mostra se ogni servizio funziona, come stanno i nodi e se i database sono aggiornati, e gestisce account, codici invito, organizzazioni e governance della condivisione, accanto ai feedback, alle richieste di supporto e ai messaggi che le persone inviano.

Questa guida percorre le sue sezioni una per una. Governare una singola organizzazione dall'interno è descritto nella guida all'amministrazione dell'organizzazione.

Per cominciare

Chi può aprire la console, che cosa dice la sua panoramica e come funzionano le sue sezioni.

Aprire la console

La console si apre solo per gli amministratori dell'installazione: gli account elencati, uno per riga, nel suo file ADMINISTRATORS. Il file si rilegge a ogni controllo, quindi aggiungere o togliere una riga vale subito.

  1. Accedi con un account amministratore.
  2. Apri il menu dell'account in alto a destra e scegli Console di amministrazione: la vedono solo gli amministratori dell'installazione. Puoi anche aprire diagnostics.html.
  3. Chiunque altro riceve, al posto della console, una pagina nella lingua della pagina chiesta che dice perché. Senza accesso, Accedi riporta alla console una volta entrato; con un altro account, scegli Torna allo spazio di lavoro oppure Accedi con un altro account.

Suggerimento Come nominare il primo amministratore lo spiega la guida all'installazione.

Leggere la panoramica

La console si apre sulla Panoramica, che dice che cosa nell'installazione chiede attenzione: i servizi che non rispondono, i database da aggiornare, le richieste di supporto ricevute e gli utenti in attesa di verifica.

  1. Leggi le quattro cifre: una cifra su una scheda colorata chiede attenzione, una su una scheda semplice no; un trattino vuol dire che la si sta ancora leggendo.
  2. Sotto Database da aggiornare, Servizi non verificati conta i servizi di cui non si sono potuti verificare i database.
  3. Fai clic su una cifra per aprire la sezione dove occupartene; Indietro ti riporta alla panoramica.
  4. Aggiorna ora rilegge tutte le cifre.

Suggerimento Le cifre dei servizi e dei database sono quelle di Stato e di Aggiornamento dei database: si leggono una volta per entrambe le sezioni, e si rinnovano mentre le guardi.

Spostarsi fra le sezioni

La console raggruppa le sue sezioni per mestiere — Salute (Panoramica, Stato), Topologia (Panoramica, Nodi, Celle, Instradamento, Storage, Eventi), Persone e organizzazioni (Utenti, Organizzazioni, Codici invito, Condivisione), Operazioni (Aggiornamento dei database) e Voce degli utenti (Supporto, Feedback, Messaggi) — e ne mostra una alla volta.

  1. Fai clic su una sezione nella colonna a sinistra per aprirla.
  2. Con il fuoco su una sezione, i tasti freccia su e giù aprono la seguente o la precedente, anche da un gruppo all'altro; Home e Fine aprono la prima e l'ultima.
  3. L'indirizzo segue la sezione che apri — per esempio diagnostics.html#diag-scope-status —: puoi salvarlo nei preferiti o mandarlo, e ricaricando la pagina resti lì.
  4. Su uno schermo stretto la colonna diventa un elenco in cima alla pagina: scegli lì la sezione.

Suggerimento Una sezione legge ciò che mostra la prima volta che la apri, e la console non chiede nulla prima di aver verificato che il tuo account può amministrare. Ogni sezione ha il suo Aggiorna ora; una che non riesce a leggere dice che cosa e perché, e Riprova rilegge.

Orientarsi nella console

La console è un'app della suite: in alto la barra del titolo, a sinistra la colonna delle sezioni, in basso la barra di stato. La barra del titolo nomina l'installazione e ne dice lo stato; la barra di stato dice se i servizi rispondono, quando è arrivato l'ultimo annuncio e su quale canale la console parla col gateway.

  1. Leggi il nome dell'installazione nella barra del titolo, accanto al quadrante: sotto, un punto e lo stato dei suoi nodi — tutti in linea, o quanti in ciascuno stato — e il numero degli avvisi attuali.
  2. La pillola accanto alla campanella dice la versione di Merydion con cui è costruita la console.
  3. Nella barra di stato leggi se tutti i servizi rispondono, o quale non risponde, e da quanto è arrivato l'ultimo annuncio.
  4. A destra della barra di stato, «TLS 1.3» è il canale che il gateway ha letto per le richieste della console; «Senza TLS» dice che la connessione non è cifrata.
  5. Il sole o la luna accanto alla lingua passano fra il tema chiaro e quello scuro; la lingua apre l'elenco delle lingue del Portal.

Suggerimento Sulla pagina di un servizio o di un nodo la colonna delle sezioni resta: è segnata la sezione da cui viene la pagina, e un clic su un'altra sezione la apre nella console.

Leggere gli avvisi attuali

La campanella nella barra del titolo conta gli avvisi della topologia dell'installazione — un nodo o un servizio che non risponde, un ruolo che nessun nodo in linea tiene, servizi che girano con versioni diverse — e li elenca.

  1. Guarda il numero sulla campanella: è il numero degli avvisi attuali; nessun numero, nessun avviso.
  2. Fai clic sulla campanella per aprire l'elenco: ogni avviso è una frase che nomina il nodo, il servizio o il ruolo.
  3. Segui «Apri la panoramica della topologia» in fondo all'elenco per vedere i nodi e i servizi.
  4. Esc, o un clic altrove, chiude l'elenco.

Suggerimento Gli avvisi sono quelli di adesso: un avviso se ne va da sé quando ciò che lo causava è risolto. La console li rilegge ogni 30 secondi mentre la sua scheda è in vista.

Dare un nome all'installazione

Il nome dell'installazione compare nella barra del titolo della console. Lo tiene la topologia dell'installazione, con chi lo ha impostato e quando; senza un nome, la console mostra il nome dell'host che hai raggiunto.

  1. Fai clic sulla rotellina a destra della barra del titolo: si apre Impostazioni dell'installazione.
  2. Scrivi il nome, fino a 64 caratteri — per esempio Produzione.
  3. Scegli Salva: la barra del titolo mostra subito il nome nuovo.
  4. Per togliere il nome, svuota il campo e salva.

Suggerimento Gli spazi all'inizio e alla fine si tolgono. Ogni modifica resta fra gli eventi della topologia, con l'account che l'ha fatta.

Servizi e database

Lo stato dei servizi, il loro dettaglio e i log, la topologia coi suoi nodi, celle, instradamento, storage ed eventi, e l'aggiornamento dei database.

Controllare lo stato dei servizi

Stato elenca gli undici servizi dell'installazione, ognuno con icona, nome, descrizione e indirizzo di salute.

  1. Leggi la luce di ogni riga: Operativo quando il servizio risponde al controllo di salute entro 6 secondi, Non raggiungibile quando non risponde.
  2. I controlli si ripetono da soli ogni 30 secondi mentre Stato o la panoramica sono in vista, e si fermano quando la scheda del browser è nascosta; Aggiorna ora li ripete subito e aggiorna Ultimo controllo.
  3. Fai clic sullo stato di un servizio per aprire il suo dettaglio di salute, o sulla sua icona dei log per leggerne i log.
  4. Runtime serviti elenca ciò che il browser esegue da file del front-end, come gli effetti video, con Servito o Non servito.

Suggerimento Quando un servizio è Non raggiungibile, i suoi log spesso dicono perché.

Leggere il dettaglio di salute di un servizio

Ogni servizio ha una pagina con il suo dettaglio di salute: uno stato complessivo e una scheda per ognuno dei suoi sottosistemi.

  1. Aprila facendo clic sullo stato del servizio in Stato.
  2. La pastiglia in alto dice Operativo, Degradato o Non operativo.
  3. Ogni scheda mostra un sottosistema con la sua luce, il nome, un riepilogo e le sue cifre.
  4. La pagina non si aggiorna da sola: fai clic su Aggiorna ora. Il percorso in cima alla pagina riporta a Stato e alla console.

Suggerimento Degradato vuol dire che il servizio funziona ma una sua parte no: la scheda di quel sottosistema dice quale.

Leggere i log di un servizio

Ogni servizio ha una pagina con i suoi log, in una console che ha l'aspetto di un terminale.

  1. Aprila con l'icona dei log del servizio in Stato.
  2. Scegli il giorno in Giorno: l'elenco mostra i giorni che hanno log, dal più recente.
  3. La console mostra le ultime righe di quel giorno, colorate per livello — ERROR, WARN, INFO, DEBUG, TRACE — e scorre fino all'ultima.
  4. Le righe più vecchie sono state omesse. vuol dire che il server ha tagliato le righe più vecchie; Nessuna voce di log per questo giorno. che il giorno non ha un file; Il logging su file non è attivo per questo servizio. che il servizio non scrive log su file.

Suggerimento Aggiorna ora rilegge il giorno scelto.

Leggere la topologia dell'installazione

In Topologia la console mostra l'installazione come la descrivono il registro della topologia e gli annunci dei servizi. La sua Panoramica dice in sei cifre come sta, quali ruoli tiene ogni nodo e quali servizi si sono annunciati.

  1. Leggi le sei cifre: i nodi, i servizi Rust annunciati, le celle SQLite, le destinazioni dei byte, l'ultimo giro delle copie e gli avvisi. I nodi e gli avvisi sono nel colore della console quando va tutto bene, in ocra o in rosso quando qualcosa chiede attenzione; un trattino vuol dire che il dato non c'è ancora.
  2. Ultima ora e Oggi, accanto al titolo, mostrano per ogni cifra che ha una serie il valore peggiore del periodo e l'ora in cui è stato toccato; le cifre senza serie restano quelle di adesso e lo dicono. Ora torna allo stato presente.
  3. Ruoli × nodi ha una riga per ruolo e una colonna per nodo: un quadrato pieno è un ruolo acceso su quel nodo. Il nome di un nodo apre la sua pagina; Mostra altri aggiunge le colonne dei nodi seguenti, e la tabella scorre dentro la sua carta.
  4. Sotto la tabella tre verifiche — nessun ruolo senza nodi, nessuna versione mista, tutti rispondono — diventano l'avviso in parole quando non passano.
  5. Servizi annunciati elenca ogni servizio col nome del suo binario, quante istanze si sono annunciate, la versione e un punto, verde quando tutte rispondono; la prima riga è l'ingresso, caddy.
  6. La sezione si rilegge da sola ogni 30 secondi mentre la console è aperta, e si ferma quando la scheda del browser è nascosta; Aggiorna ora la rilegge subito.

Suggerimento Davanti a un avviso apri la pagina del nodo che nomina: i suoi ruoli e servizi dicono quale servizio non risponde. Versioni diverse di solito vogliono dire un aggiornamento ancora in corso su qualche nodo.

Sorvegliare i nodi

Nodi elenca i nodi che il registro della topologia conosce, ordinati per ruolo con i nuovi in cima: per ognuno l'indirizzo, i ruoli, lo stato, la CPU e la memoria che ha annunciato, le celle che tiene e l'età del suo ultimo annuncio. Ogni riga apre la pagina del nodo, e un nodo che entra nell'installazione compare da sé.

  1. Scegli uno stato sopra l'elenco — Tutti, In linea, Nuovi, In drenaggio, Fuori linea, e Irraggiungibili quando ce n'è almeno uno —: accanto a ciascuno il numero dei nodi. Filtra i nodi, accanto al titolo, cerca nel nome e nell'identità.
  2. Un nodo nuovo sta in cima, col punto ocra: si è annunciato da sé ed è senza lavoro, e la sua riga offre Metti in linea e Rifiuta.
  3. La CPU oltre il 70% è in ocra, e così le celle oltre l'80% della capacità dichiarata; un trattino fra le celle vuol dire che il nodo non tiene il ruolo dati. Quando l'installazione ha più nodi di quanti l'elenco ne mostra, Mostra altri aggiunge i seguenti.
  4. Pesi e capacità, accanto al titolo, apre i pesi dei ruoli e le capacità del nodo che scegli: un peso va da 1 a 1000, e 100 è il nodo normale del ruolo; un campo di capacità vuoto la lascia non dichiarata. Salva vale solo se nessuno ha cambiato il nodo nel frattempo.
  5. La pagina di un nodo ha a sinistra i sette ruoli: quello acceso porta la barretta, e i servizi del ruolo sono gettoni accesi quando girano lì e rispondono; un gettone apre, più in basso, la configurazione e le risorse di quel servizio. A destra la Configurazione effettiva, raggruppata per origine: il seme del primo avvio, ciò che decide la topologia, ciò che dice la configurazione, lo stato del nodo e i segreti, oscurati.
  6. Configura cambia nome, ruoli, pesi e capacità del nodo; accanto stanno le azioni che il suo stato ammette, ciascuna chiesta prima.
  7. Risorse mostra l'host del nodo: in Ora CPU, memoria, rete, disco, traffico mensile e processi, aggiornati ogni 5 secondi dal servizio d'identità del nodo; in Ultima ora e Oggi la CPU e la memoria minuto per minuto, come i servizi le hanno annunciate.

Suggerimento Un segreto non lascia mai il processo che lo tiene: la pagina ne mostra solo il nome, da dove viene e il cartellino oscurato. La configurazione cambia solo quando un servizio riparte.

Mettere in linea, drenare e dismettere i nodi

Ogni stato di un nodo offre solo le azioni che il registro della topologia ammette da lì: nella riga di un nodo nuovo in Nodi, e nella testata della pagina di ogni nodo, accanto a Configura. Ogni azione chiede prima, nominando il nodo e dicendo che cosa succederà davvero; ciò che niente disfa — Rifiuta, Dismetti e Dichiara caduto — si conferma scrivendo l'identità del nodo.

  1. Nuovo: Metti in linea dà lavoro al nodo — celle nuove, le celle che la topologia sposta, stanze, lavori di render, montaggi —, e la topologia lo accetta solo quando sente il nodo: almeno uno dei suoi servizi si annuncia o, per un nodo col solo ruolo Ingresso, che non ha servizi da annunciare, il suo ingresso risponde. Fino ad allora il pulsante resta spento e dice perché. Rifiuta è la dismissione del nodo: esce da ogni vista, la sua identità e la sua epoca non si riusano più, e un suo processo che riprova a unirsi resta fuori.
  2. In linea: Drena fa smettere subito al nodo di ricevere lavoro e sposta le sue celle sui nodi più scarichi, al più 4 alla volta; un bucket che monta si monta su un altro nodo di storage, mentre una cartella sul suo disco resta e la sposti da Storage. Quando non gli resta niente e le sue richieste in corso sono finite, entro 30 secondi, passa fuori linea da sé. Un nodo irraggiungibile non si drena.
  3. In drenaggio: la carta Drenaggio in corso segue il drenaggio ogni 5 secondi finché è in vista — chi l'ha avviato e quando, le celle ancora sul nodo su quelle che aveva, coi loro tipi, gli spostamenti aperti per fase, e che cosa lo trattiene, a parole: celle il cui spostamento è stato rifiutato o annullato, tipi che nessun nodo in linea può ricevere, una cartella sul suo disco, servizi che non hanno chiuso il censimento delle sue celle, un nodo che tace —, oppure Niente lo trattiene. Interrompi il drenaggio rimette il nodo in linea: gli spostamenti del drenaggio non ancora assegnati si annullano e le loro celle restano su di lui.
  4. Irraggiungibile, o in drenaggio e muto: Dichiara caduto, mai offerto per un nodo che tiene il ruolo Controllo. La conferma dice prima la politica della ripresa in vigore, letta in quel momento. La topologia accetta la dichiarazione solo quando il lease del nodo è scaduto da più di 10 secondi, e prima la rifiuta: con la ripresa automatica in quel momento dichiara caduto il nodo da sé, quindi confermare non lo anticipa mai; con la ripresa manuale la tua conferma è l'unico modo perché le sue celle ripartano altrove. La politica è una chiave di Instradamento.
  5. Caduto: la carta Ripresa del nodo caduto segue le sue celle mentre ripartono su altri nodi dall'ultimo istante copiato; i montaggi che teneva si perdono, e una destinazione che da allora nessuno serve è nominata finché non la monti su un altro nodo di storage. Metti in linea resta spento, e dice perché, finché la topologia non sente di nuovo il nodo: allora interrompe la ripresa, e ciò che è già ripartito altrove resta lì.
  6. Fuori linea: Metti in linea gli ridà lavoro; Dismetti lo toglie per sempre, come Rifiuta fa per un nodo nuovo, e la topologia rifiuta finché il nodo tiene ancora celle, spostamenti, montaggi o lease.
  7. Una riuscita si dice in un avviso e la pagina rilegge il nodo: la sua testata dice dove è andato. Un rifiuto si dice sotto la testata, con le parole del suo motivo.

Suggerimento La topologia non dichiara mai caduto il proprio nodo né uno che tiene il ruolo Controllo, e rifiuta di drenare l'ultimo nodo in linea col ruolo Controllo, Identità o Dati, o l'ultimo che scrive una destinazione attiva: il rifiuto nomina il ruolo o la destinazione.

Leggere le celle

Celle mostra dove vivono i dati dell'installazione: ogni cella è un database SQLite con un solo nodo proprietario. La riga sotto il titolo conta le celle, i loro tipi e i nodi dati; il grafico, i tipi e le tabelle dicono come le celle si distribuiscono e quanto sono grandi.

  1. Scegli che cosa mostra il grafico accanto al titolo: Per nodo disegna una colonna per ogni nodo dati e la linea della capacità in celle che ogni nodo dichiara — un nodo oltre l'80% della sua capacità è in ocra, un nodo nuovo, ancora senza lavoro, nel colore della console —; Per tipo disegna una riga per ogni tipo di cella, coi nodi che lo tengono; Per organizzazione le organizzazioni con più celle, coi loro nodi e, per un'organizzazione divisa, i servizi in cui le sue entità hanno celle proprie.
  2. Celle per tipo ha una tessera per ogni tipo, col suo conteggio e la sua dimensione. Una dimensione sono i byte dei database delle celle, ciò che uno spostamento trasferisce: i servizi le misurano solo mentre qualcuno guarda la sezione, così alla prima visita le dimensioni sono in arrivo e compaiono coi prossimi annunci; la riga sotto i tipi dice poi dal censimento di quanti nodi vengono e quanto è vecchio. Una dimensione misurata su una parte delle celle dice quante ne sono state misurate.
  3. Celle più grandi elenca le celle coi database più grandi e Scritte più di recente quelle scritte per ultime, ciascuna col nodo che la tiene. Le scritture di una cella non le conta nessuno: le celle più attive si mostrano come le scritte più di recente.
  4. Celle e dimensioni per nodo è il grafico per nodo a parole: per ogni nodo il suo stato, le sue celle, la capacità con la quota usata o non dichiarata, la dimensione delle sue celle, l'età del suo censimento e le celle messe da parte. Un nodo che torna dopo una ripresa mette da parte una cella le cui copie non avevano tutte le sue scritture: aspetta un operatore, e la tabella lo dice.
  5. La sezione rilegge da sé finché è in vista — ogni 10 secondi mentre qualcosa arriva o si sposta, ogni 30 secondi altrimenti —; Aggiorna ora legge subito.
  6. Su uno schermo stretto le carte stanno una sotto l'altra, e il grafico per nodo scorre di lato dentro la sua carta; per un lettore di schermo, i valori del grafico sono quelli della tabella Celle e dimensioni per nodo.

Suggerimento I conteggi vengono dal registro della topologia e sono esatti; le dimensioni vengono dall'ultimo censimento dei servizi, e nessuno misura i dischi finché nessuno guarda.

Riequilibrare le celle

Piano del riequilibrio mostra che cosa il ribilanciatore sposterebbe per pareggiare i nodi dati: solo il prossimo lotto, perché il carico di una singola cella non lo misura nessuno e il riequilibrio intero non si può prevedere. Accanto, l'interruttore del ribilanciatore automatico e la carta Perché, seguita dal nome di un nodo, che dice dove vanno le celle nuove e perché.

  1. Leggi il contrassegno del piano: prova a secco è il prossimo lotto come il ribilanciatore lo calcola adesso; autorizzato, quando un operatore lo ha applicato; in corso, con quanti spostamenti del lotto sono arrivati; applicato, quando sono arrivati. Il lotto si dice con le sue celle, i suoi byte, i nodi che lascia e quelli che raggiunge, poi una riga per ogni tipo e percorso.
  2. Leggi sotto il piano che cosa fa il ribilanciatore e perché — in equilibrio, in attesa che lo scarto duri, spento, in assestamento dopo il lotto di prima, senza budget —, con lo scarto fra i nodi dati e la soglia, e il budget dell'ultima ora: spostamenti, byte e spostamenti insieme.
  3. Applica il piano, offerto mentre un riequilibrio è dovuto, autorizza il ribilanciatore: al suo prossimo giro, entro pochi secondi, chiede il lotto come lo calcola allora, che può essere diverso da quello mostrato, e sempre dentro il suo budget. Vale anche col ribilanciatore automatico spento, e non aspetta la durata minima. Il contrassegno segue poi il lotto, e la riga sotto il piano dice chi l'ha autorizzato e che cosa ha fatto il ribilanciatore.
  4. Quando il ribilanciatore non chiederebbe più un lotto — meno di due nodi dati con un punteggio, un drenaggio in corso, uno scarto dentro la soglia, il lotto di prima in assestamento, il budget esaurito, dimensioni che mancano ancora, nessuna cella misurata che si possa spostare —, la topologia rifiuta e la carta dice perché, a parole.
  5. Ribilanciatore automatico: Spegni tiene il piano calcolato e mostrato qui ma non sposta niente da sé — un piano si può ancora applicare, e drenaggi e riprese spostano le loro celle come sempre —; Accendi lascia che il ribilanciatore chieda i lotti da sé quando lo scarto resta sopra la soglia per la durata minima. Tutti e due chiedono prima.
  6. Leggi la carta Perché: il punteggio di carico del nodo su cui vanno le celle nuove dei servizi dati — la quota libera: più alta, più libero — col suo motivo, le misure che lo compongono, ciascuna con la quota in uso e il suo peso, i candidati più liberi e l'isteresi, che tiene il lavoro nuovo sul nodo scelto prima finché resta vicino al migliore.

Suggerimento Drenaggi e spostamenti degli operatori non contano nel budget del ribilanciatore. Soglia, durata minima, budget e quando una cella è fredda sono chiavi della politica, in Instradamento.

Spostare una cella e seguire gli spostamenti

Spostamenti in corso elenca gli spostamenti aperti delle celle, chiunque li abbia chiesti — il ribilanciatore, un drenaggio, una ripresa o un operatore —, e da Celle puoi spostare tu una cella sul nodo dati che scegli.

  1. Leggi ogni spostamento: la cella col suo tipo e la sua chiave, il nodo che lascia e quello che raggiunge, la sua fase — In trasferimento, Copiati, Assegnati — con una barra, chi l'ha chiesto e quando; un passo che continua a non riuscire si dice sotto la fase, con quante volte.
  2. Interrompi ferma uno spostamento in trasferimento o copiato chiesto da un operatore o dal ribilanciatore: la cella resta attiva sul suo nodo alla stessa epoca, e ciò che la destinazione ha ripristinato finora si scarta; una cella di cui interrompi uno spostamento del ribilanciatore non viene scelta di nuovo da lui per un giorno. Uno spostamento di un drenaggio o di una ripresa non ha Interrompi e dice di chi è: un drenaggio si interrompe dalla pagina del nodo, una ripresa rimettendo in linea il nodo. Uno spostamento assegnato non si interrompe più.
  3. Sposta… su una riga di Celle più grandi o di Scritte più di recente apre la dialog con la cella e il nodo che la tiene: scegli il nodo d'arrivo fra gli altri nodi dati in linea e premi Sposta.
  4. Sposta una cella…, accanto al titolo, chiede il tipo, la chiave come la scrive il registro — un'organizzazione, un utente, o organizzazione/impronta per un'entità — e il nodo d'arrivo, e legge quale nodo tiene la cella prima di chiedere. Anche la ricerca della console trova Sposta una cella…, e ne apre la dialog.
  5. La conferma nomina la cella, il nodo che lascia e quello che raggiunge: le sue scritture attendono mentre la sorgente la consegna e la destinazione la ripristina, la sorgente toglie i suoi file dopo la grazia, e uno spostamento di un operatore non conta nel budget del ribilanciatore.
  6. Un rifiuto si dice nella dialog, a parole: una cella che si sta già spostando o che è già su quel nodo, una destinazione che non prende celle nuove o non ha il ruolo, troppi spostamenti aperti di quel servizio sul nodo, una cella senza un posto proprio — un'entità di un'organizzazione indivisa si sposta con la sua organizzazione.

Suggerimento Mentre una cella si sposta le sue scritture attendono e si chiede di riprovarle, e la sua epoca rifiuta quelle in ritardo: niente si perde.

Vedere dove va il lavoro nuovo

Instradamento dice dove va il lavoro nuovo e perché: la politica della topologia, il punteggio di ogni nodo, il nodo prescelto per ogni assegnazione e le ultime scelte con la loro motivazione. La riga sotto il titolo conta i nodi e le assegnazioni, e ricorda che un punteggio è la quota libera: più alto, più libero.

  1. Punteggi elenca ogni nodo in ogni ruolo che riceve lavoro — Dati, Calcolo, Storage — col suo stato, il peso del ruolo quando non è 100, il suo punteggio e le sue misure, ciascuna con la quota in uso e la sua parte dei pesi del ruolo; una misura oltre il 70% per la CPU, o l'80% per le altre, è in ocra. Un nodo che non ha ancora annunciato un carico lo dice; Carica altri nodi legge i seguenti.
  2. Prescelti dice dove va adesso il lavoro nuovo — le celle nuove di ogni servizio dati, le stanze nuove delle chiamate, i lavori di render, le letture e le scritture di ogni destinazione montata —, ciascuno col suo nodo, il suo motivo e da quando è scelto. Un'assegnazione che nessun nodo in linea può ricevere è nominata sotto l'elenco.
  3. Apri Perché sotto una riga per leggere la motivazione della scelta: il punteggio col suo motivo — il più libero, l'unico candidato, il nodo che chiede o il prescelto di prima entro l'isteresi —, le misure con la quota in uso e il loro peso, i candidati più liberi e l'isteresi. Una motivazione lasciata aperta resta aperta quando la sezione rilegge.
  4. Scelte recenti elenca le ultime scelte, dalla più recente: l'ora, l'assegnazione, il nodo scelto col suo motivo, e la cella e il nodo che ha chiesto quando ci sono. Assegnazione le restringe a un'assegnazione, e Carica altre legge le più vecchie. La motivazione di una scelta passata mostra le misure di quel momento, non i pesi con cui è stata fatta, che il registro non tiene.
  5. La sezione rilegge ogni 30 secondi finché è in vista; Aggiorna ora legge subito.

Suggerimento Quante scelte tiene il registro è una chiave della politica, Scelte conservate: Scelte recenti mostra solo quelle tenute.

Cambiare la politica della topologia

Politica, in Instradamento, tiene le chiavi della topologia in tre parti — Carico, Ribilanciamento e Nodi —, ciascuna col suo valore, il predefinito quando il valore ne è diverso, e chi l'ha cambiata e quando. Cambia… accanto a una chiave ne apre il modulo.

  1. Carico: Pesi delle misure, quanto conta ogni misura nel punteggio di un nodo dati, di calcolo e di storage — 0 toglie una misura, e ogni ruolo ne tiene almeno una sopra zero; Saturazione, dove un nodo si conta pieno in connessioni, richieste in corso e celle aperte; Isteresi, quanto vicino al punteggio migliore il nodo che chiede, o il prescelto di prima, tiene il lavoro nuovo; Scelte conservate, quante scelte tiene il registro per Scelte recenti.
  2. Ribilanciamento: Ribilanciatore automatico, lo stesso interruttore di Celle; Soglia dello scarto, lo scarto fra i punteggi dei nodi dati che fa partire un riequilibrio, che finisce alla metà; Durata minima, per quanto lo scarto deve durare prima che il ribilanciatore chieda un lotto da sé; Budget, gli spostamenti e i byte all'ora e gli spostamenti insieme; Fredda dopo, dopo quanto senza scritture una cella è fredda — il ribilanciatore sposta prima le fredde, e 0 rende fredda ogni cella.
  3. Nodi: Nodi che si uniscono, se un nodo che si unisce va in linea da sé o resta nuovo finché un operatore non lo mette in linea da Nodi; Ripresa, se la topologia dichiara caduto da sé un nodo che tace quando il suo lease è scaduto da più di 10 secondi, o aspetta che lo faccia un operatore dalla pagina del nodo — fino ad allora le celle del nodo non si raggiungono.
  4. Nel modulo ogni campo dice i limiti che la topologia accetta, e un valore sbagliato si dice sotto il suo campo e non parte. Salva chiede prima, dicendo che cosa fa davvero il cambio — dove va il lavoro nuovo, che cosa potrà chiedere il ribilanciatore, chi dichiara caduto un nodo —, poi scrive la chiave e rilegge la sezione.
  5. Ogni cambio si scrive nel registro della topologia col tuo nome: la riga sotto la chiave dice chi l'ha cambiata e quando, ed Eventi lo mostra.

Suggerimento La console controlla ogni valore coi limiti della topologia e non scrive un valore che ne esce; la topologia rifiuta un valore solo quando è una topologia di un'altra versione, coi limiti diversi, e il rifiuto si dice con le parole della sezione.

Tracciare una richiesta

Tracce delle richieste, in Instradamento, elenca le finestre di raccolta e le tracce che hanno raccolto. Una richiesta si traccia solo dentro una finestra aperta da un amministratore: fuori, nessun servizio ne registra niente.

  1. Apri una finestra… chiede che cosa raccogliere — un utente, con l'identità pseudonima che mostrano gli eventi; un'app, col client_id a cui è destinato il suo token; o un percorso come lo riceve il gateway, che comincia con /api/ —, per quanti minuti, al più 30, e perché. Il motivo resta negli eventi della topologia col tuo nome, e le finestre aperte insieme sono al più quattro.
  2. I servizi cominciano a raccogliere al prossimo annuncio, entro 5 secondi, e smettono quando la finestra finisce o quando la chiudi prima con Chiudi.
  3. Ogni traccia raccolta è una riga: quando, la richiesta, il suo esito, l'app e l'utente, il tempo nel sistema. La riga porta alla pagina della traccia.
  4. La pagina della traccia mostra il percorso: una riga per tappa — l'ingresso dal gateway, l'instradamento al nodo che possiede la cella, le verifiche del token, la cella in SQLite, i byte dello storage —, ciascuna col suo nodo e servizio, il suo tempo e il suo esito, poi il tempo nel sistema. Finché possono arrivare altre tappe la pagina rilegge la traccia da sé.
  5. Access token mostra ciò che ha visto il servizio che ha verificato il token: l'intestazione e il contenuto, i primi caratteri della firma, e ogni verifica con la sua regola. Le richieste rifiutate con lo stesso token nella finestra sono elencate col perché in parole, e i gettoni sotto il percorso si accendono solo quando una sonda del servizio d'identità li conferma.
  6. Copia la traccia copia la pagina come testo, senza la firma.

Suggerimento Il token non si conserva mai: una traccia tiene l'intestazione e il contenuto decodificati, l'esito di ogni verifica e i primi 12 caratteri della firma. Le tracce vivono solo nella memoria della topologia, al più un'ora dopo la fine della loro finestra.

Leggere lo storage

Storage mostra dove stanno i byte dell'installazione: una colonna per classe — file degli utenti, allegati, anteprime e copie dei database — con le sue destinazioni, quanto è piena ciascuna rispetto alle soglie, e i nodi di storage che le montano e quanti byte servono.

  1. Leggi ogni colonna: la destinazione contornata è l'attiva della classe, quella che riceve le scritture nuove; sotto ogni destinazione vedi il tipo (disco o S3), la cartella o il bucket, la misura contro la soglia di spazio e i nodi che la montano.
  2. La tacca sulla misura segna dove la rotazione prepara la prossima destinazione; oltre la tacca la misura diventa ocra, e alla soglia la prossima destinazione pronta della classe diventa da sola l'attiva.
  3. Leggi Montaggi: una riga per nodo di storage, con le destinazioni che monta e lo stato di ogni montaggio, l'epoca del suo ultimo cambio e i byte che serve al secondo.
  4. Leggi gli eventi dello storage in fondo alla pagina: chi ha registrato, attivato, montato o svuotato che cosa, dal più recente; Mostra altri legge i precedenti.
  5. La pagina si rilegge ogni 30 secondi finché è in vista; Aggiorna ora la rilegge subito.

Suggerimento Una destinazione senza soglia mostra solo i byte contati dalla registrazione: i contatori sono indicativi, e la rotazione decide solo su un conteggio che il nodo di storage fa elencando la destinazione.

Governare le destinazioni

Da Storage si aggiunge una destinazione — una cartella sul disco di un nodo di storage o un bucket di un servizio compatibile S3 — e la si attiva, sigilla, svuota, dismette, e se ne cambiano le soglie; Rotazione stabilisce quando la prossima destinazione deve essere pronta e quando diventa l'attiva.

  1. Premi Aggiungi destinazione: dalle un nome e la classe che servirà, scegli disco con una cartella assoluta o S3 con endpoint, regione, bucket e il riferimento della credenziale — il nome che il nodo di storage risolve dai suoi segreti, mai la credenziale —, il nodo di storage che la monta e, se vuoi, le soglie. Il nodo la verifica prima di servirla; fino ad allora è nuova.
  2. Apri il menu di una destinazione col suo pulsante: offre solo ciò che il suo stato permette. Attiva per una classe la rende l'attiva di quella classe; Sigilla passa ogni classe che serve alla sua prossima destinazione, quella che la rotazione sceglierebbe, e la conferma la nomina.
  3. Soglie… stabilisce lo spazio, in GB o TB, e gli oggetti; un campo vuoto vuol dire nessuna soglia. La rotazione valuta le soglie nuove al giro seguente.
  4. Svuota sposta i byte di una destinazione sigillata nell'attiva della loro classe, in sfondo; Sospendi lo svuotamento lo ferma. Dismetti toglie una destinazione pronta che non ha mai ricevuto byte: confermalo scrivendone il nome.
  5. Premi Rotazione per stabilire la preparazione e la rotazione, in percento della soglia, e se la destinazione che la rotazione sigilla si svuota da sé nella nuova attiva.

Suggerimento Ogni azione chiede prima, nominando la destinazione e dicendo che cosa succederà; quando la topologia rifiuta, il motivo compare accanto alla destinazione, a parole.

Montare, smontare e svuotare

Una destinazione serve i suoi byte dai nodi di storage che la montano: Montaggi mostra una riga per nodo di storage, e dal menu di una destinazione la si monta su un nodo, la si smonta da uno o se ne sposta un montaggio su un altro nodo.

  1. Leggi Montaggi: ogni nodo di storage con le destinazioni che monta, lo stato di ogni montaggio — un punto verde serve, uno ocra si sta verificando, un anello si sta smontando —, l'epoca del suo ultimo cambio e i byte che serve al secondo.
  2. Scegli Monta su… nel menu, o il pulsante su una destinazione che nessuno serve: scegli un nodo di storage, nuovo o in linea, e il modo. Il nodo verifica la cartella o il bucket prima di servirla.
  3. Scegli Smonta da un nodo: il nodo smette di ammettere operazioni nuove, lascia finire quelle in corso fino a 60 secondi e annulla le altre. L'ultimo nodo che serve in scrittura una destinazione attiva non si smonta finché non è attiva un'altra destinazione: la conferma lo dice.
  4. Scegli Sposta da un nodo… per spostare un montaggio su un altro nodo di storage, nuovo o in linea: il primo drena, il secondo verifica.
  5. Mentre una destinazione si svuota, la sua scheda mostra la barra verso l'attiva della sua classe con la quota dei riferimenti spostati, poi la grazia, la rimozione delle vecchie copie e la verifica per conteggio.

Suggerimento Smontare non perde mai un byte: le letture vanno a un altro nodo che monta la destinazione, e senza uno i suoi file rispondono «non disponibile» finché non si rimonta — mai «non trovato».

Leggere la mappa dell'installazione

Mappa mostra l'installazione intera a colpo d'occhio: i nodi in tre fasce per ruolo, ogni nodo dati una tessera col mosaico delle sue celle sulla sua capacità, le copie continue dei database col nastro dei loro ultimi giri, e gli ultimi eventi che hanno cambiato l'installazione, ciascuno col suo autore.

  1. Leggi le fasce: Ingresso · controllo · identità ha una tessera per nodo coi suoi ruoli e i servizi che vi rispondono; Dati ha una tessera per nodo dati — il nome, lo stato, il mosaico di quaranta posti (le sue celle sulla capacità dichiarata in Pesi e capacità, o sul nodo dati più pieno quando non ne è dichiarata una), quante celle tiene e la sua CPU —; Calcolo · storage · TURN ha un gettone per nodo. Ogni tessera e ogni gettone apre la pagina del suo nodo.
  2. Segui un nodo che cade: il contorno ocra dice che il suo lease non è rinnovato; il contorno rosso con «isolato · N» dice che il lease è scaduto e il nodo si è isolato da sé; «fuori linea · N» dice che la topologia lo ha dichiarato caduto e ne riprende le celle dalle copie — i posti che ha perso sono contornati di rosso —, e i nodi che le ricevono hanno il contorno nel pigmento, coi posti ricevuti più scuri, per un'ora dopo la fine della ripresa.
  3. Scegli che cosa dice il colore delle tessere con Ruoli · Carico · Celle: gli stati, la CPU (ocra oltre il 70%) o le celle sulla capacità (ocra oltre l'80%).
  4. Copie continue dice ogni quanto ogni processo copia i suoi database, il nastro degli ultimi trenta giri dell'installazione — ogni barra il giro più lungo del suo secondo, il più recente nel pigmento, uno più lungo della cadenza in ocra —, dove vanno le copie e fin dove indietro si ripristina un database.
  5. Eventi mostra gli ultimi eventi che hanno cambiato la mappa, una corsa di celle riprese o spostate in una riga, col loro autore: una persona col suo login, un lavoro come «topologia», un nodo col suo nome. Tutti gli eventi apre la sezione Eventi.
  6. La mappa si rilegge ogni 5 secondi finché è in vista; Aggiorna ora legge subito. Un'installazione con più di quattro righe di nodi dati scorre dentro la carta.

Suggerimento Quando un nodo cade, tieni aperta la mappa: vedi il lease scadere, il nodo isolarsi da sé, le sue celle recintate e riprese sui nodi più scarichi — e negli Eventi chi ha fatto che cosa, minuto per minuto.

Leggere gli eventi della topologia

Eventi è il registro della topologia, dal più recente: che cosa è successo all'installazione — ai suoi nodi, celle, lease, storage e politica —, ogni evento col suo autore, una persona o un lavoro della topologia. La riga sotto il titolo dice quanti eventi il registro conserva.

  1. Scegli un tipo sopra l'elenco — Tutti, Nodi, Celle, Lease, Storage, Politica, Topologia — e un nodo in Nodo: l'elenco mostra gli eventi di quella famiglia che nominano quel nodo, come soggetto o fra i nodi di prima e di dopo. I filtri restano nell'indirizzo della pagina, così un collegamento li conserva.
  2. Leggi ogni riga: l'ora, con la data quando non è oggi; il punto e la parola della famiglia; che cosa è successo, a parole; il suo soggetto — un nodo è un collegamento alla sua pagina, una cella è il suo tipo e la sua chiave —; e sotto il suo autore: un amministratore col suo account, un lavoro della topologia con ciò che fa, come la presenza, i lease o il ribilanciatore.
  3. Apri Prima e dopo su una riga per leggere che cosa l'evento ha cambiato, come l'ha scritto il registro; niente vuol dire che non c'era un valore.
  4. Carica altri legge gli eventi più vecchi. La topologia legge il suo registro un tratto alla volta: quando un tratto non ha eventi per i tuoi filtri la console prosegue da sé qualche volta, poi lo dice e offre Continua a cercare — dice che nessun evento corrisponde solo quando non resta niente di più vecchio.
  5. Gli eventi nuovi arrivano in cima ogni 30 secondi finché la sezione è in vista; Aggiorna ora legge subito.

Suggerimento Un cambio della politica, un drenaggio, un nodo dichiarato caduto o un piano applicato portano il nome di chi li ha fatti: Eventi è il posto dove trovare chi ha cambiato che cosa, e quando.

Aggiornare i database

Aggiornamento controlla, per ogni servizio, se i suoi database sono alla versione che il server si aspetta. Finché non lo sono, le funzioni sui dati di quel servizio restano spente per proteggere i dati.

  1. Leggi ogni riga: Totale e Da aggiornare, con Aggiornato, Aggiornamento disponibile, Non raggiungibile — il servizio non ha risposto — o Verifica non riuscita, con il motivo sotto la riga.
  2. Esegui aggiornamento compare solo quando qualcosa è da aggiornare. La conferma nomina il servizio, quanti database passano a quale versione e che non si può annullare: scrivi l'identificativo del servizio che mostra — per esempio auth — e conferma; il server aggiorna in sottofondo mentre la riga dice Aggiornamento in corso…
  3. La riga si ricontrolla ogni 2 secondi finché il server non ha finito, e un avviso dice com'è andata; Aggiornamento non riuscito dice che non ce l'ha fatta.
  4. L'icona del database apre la pagina di dettaglio, con ogni database, il suo percorso, la versione attuale e quella di destinazione e lo stato — compresi Più recente del server e Non ancora creato; anche da lì si avvia l'aggiornamento.

Suggerimento Puoi chiudere la pagina durante un aggiornamento: quando la riapri, riprende a sorvegliarlo.

Account e organizzazioni

Account, codici invito, organizzazioni e governance della condivisione.

Gestire gli account

Account elenca gli utenti registrati: nome, email, stato — Attivo, Sospeso, In attesa di verifica o Disattivato — e data di registrazione.

  1. Registro accessi apre la storia degli accessi di un utente: ora, evento, esito, indirizzo IP e client.
  2. Reimposta password apre un campo in cui scrivi una nuova password e fai clic su Applica: le sessioni dell'utente vengono chiuse.
  3. Sospendi chiede prima, nominando l'utente: non potrà più accedere, le sue sessioni si chiudono e un'app che ha già aperta si ferma entro pochi minuti; Riattiva lo fa rientrare, senza conferma.
  4. Elimina chiede di scrivere l'email dell'utente: toglie per sempre l'account, il profilo, le appartenenze alle organizzazioni e le sessioni; i file, la posta e le conversazioni che ha nelle app non vengono eliminati.
  5. Crea utente aggiunge un account con email e password, attivo da subito.

Suggerimento Una password impostata da qui chiude ogni sessione dell'utente: comunicagli la nuova per un canale sicuro.

Generare codici invito

Merydion è su invito: ogni codice invito apre una sola registrazione, e chi lo usa lo brucia.

  1. Fai clic su Genera codice invito: il codice nuovo compare accanto al pulsante, pronto da consegnare alla persona che inviti.
  2. L'elenco mostra i codici, dal più recente: Disponibile o Bruciato, la data di creazione e, una volta usato, Usato da con l'account che ha aperto.
  3. Fai clic su un codice per selezionarlo per intero, poi copialo.

Suggerimento Consegna ogni codice a una persona sola: una volta usato, non apre una seconda registrazione.

Gestire le organizzazioni

Tenant elenca tutte le organizzazioni dell'installazione, con tipo, stato, membri e amministratori; un'organizzazione senza amministratori è messa in evidenza.

  1. In Crea organizzazione scrivi il Nome dell'organizzazione e fai clic su Crea tenant.
  2. Per rinominare un'organizzazione cambia il nome nella sua riga e fai clic su Rinomina.
  3. Membri apre il pannello di un'organizzazione: cambia il ruolo di un membro, Rimuovi un membro dopo una conferma che nomina la persona e l'organizzazione — l'ultimo amministratore resta, e la riga lo dice —, e invita persone come nella pagina dell'organizzazione.
  4. L'associazione diretta aggiunge subito un utente, senza invito, con il ruolo che scegli: è riservata agli amministratori dell'installazione.

Suggerimento Per dare a un'organizzazione il suo primo amministratore, associa una persona con il ruolo Amministratore, oppure invitala come amministratore.

Governare la condivisione

Governance imposta la policy di condivisione e le etichette di riservatezza di qualunque organizzazione, e mostra il registro di audit delle sue decisioni di condivisione.

  1. Scrivi l'identificativo dell'organizzazione in Tenant: si caricano la sua policy, le sue etichette e il suo registro.
  2. In Policy di condivisione imposta Condivisione interna, Link pubblici, Richieste file e Co-editing in tempo reale, poi fai clic su Salva policy, che si accende solo quando qualcosa è cambiato.
  3. In Etichette di riservatezza aggiungi un'etichetta con nome, colore e Blocca la condivisione, oppure eliminane una: la conferma la nomina e, per un'etichetta che blocca la condivisione, ricorda che i documenti che la portano tornano condivisibili pubblicamente.
  4. Registro di audit elenca le decisioni recenti con ora, soggetto, azione, risorsa, decisione e motivo, l'azione detta a parole, come Link pubblico o Salvataggio di una sessione di co-editing; Voci sceglie quante, da 1 a 500.

Suggerimento Gli amministratori di un'organizzazione impostano le stesse regole dalla loro pagina; qui puoi farlo per qualunque organizzazione.

Feedback, richieste e messaggi

Ciò che le persone inviano: valutazioni, richieste di supporto e messaggi dal sito.

Leggere i feedback

Feedback raccoglie le valutazioni e i commenti che le persone inviano con Aiuto → Feedback nelle app, dal più recente.

  1. Leggi il riepilogo: la media dei voti, il numero di feedback ricevuti e una barra per ogni voto dal 5 all'1.
  2. Fai clic su una barra per vedere solo quel voto, di nuovo per togliere il filtro; Solo con un commento lascia i feedback che ne hanno uno, e Tutti toglie i filtri.
  3. App sceglie l'app di cui leggi i feedback.
  4. Ogni scheda mostra il voto, il riferimento, il commento, chi l'ha inviato, l'app con la sua versione e la piattaforma.

Suggerimento Quando i feedback sono più di quelli che l'elenco mostra, una riga lo dice: il riepilogo li conta sempre tutti.

Gestire le richieste di supporto

Richieste di supporto è la coda delle richieste che le persone aprono con Aiuto → Supporto nelle app, dalla più recente.

  1. Ogni scheda mostra l'impatto, la categoria, il riferimento, l'oggetto e la descrizione, chi l'ha scritta, l'app con la sua versione, la piattaforma, la lingua e la data.
  2. Mostra tutta la descrizione apre una descrizione lunga, e Mostra meno la richiude.
  3. La ricerca e i filtri App, Impatto e Categoria restringono la coda; il conteggio dice quante richieste sono mostrate sul totale.
  4. Rispondi via email apre il tuo programma di posta verso l'autore, con il riferimento e l'oggetto già nell'oggetto del messaggio.

Suggerimento Rispondi per email e tieni il riferimento nell'oggetto, così la conversazione resta unita.

Leggere i messaggi dal sito

Messaggi raccoglie ciò che i visitatori scrivono con il modulo contatti del sito, dal più recente. Il modulo non manda email a nessuno: la console è l'unico posto in cui i messaggi arrivano.

  1. La ricerca restringe i messaggi per nome, email, oggetto o testo.
  2. Mostra tutto il messaggio apre un messaggio lungo.
  3. Rispondi via email apre il tuo programma di posta verso chi ha scritto, con Re: e il riferimento nell'oggetto.
  4. Elimina, quando chi ha scritto lo chiede, toglie un messaggio per sempre: conferma con Elimina definitivamente, oppure torna indietro con Annulla o Esc.

Suggerimento I messaggi si cancellano da soli dopo 12 mesi.

Per chi amministra un'organizzazione

Amministrazione dell'organizzazione

L'amministrazione dell'organizzazione è la pagina in cui proprietari e amministratori governano la loro organizzazione. Si apre sull'organizzazione che amministri, e le sue sezioni si susseguono a sinistra: panoramica, persone, spazio, servizi, condivisione e due registri.

Questa guida percorre ogni sezione. Gestire l'intera installazione è un altro mestiere, descritto nella guida alla console dell'installazione.

Per cominciare

Apri la pagina e leggi la panoramica della tua organizzazione.

Aprire l'amministrazione dell'organizzazione

La pagina è dei proprietari e degli amministratori di un'organizzazione. Il tuo spazio personale non è un'organizzazione da amministrare, quindi qui non compare mai.

  1. Apri il menu dell'account in alto a destra, oppure le azioni rapide del tuo spazio di lavoro, e scegli Amministra organizzazione: compare solo se amministri un'organizzazione.
  2. Dopo aver accettato un invito da amministratore, anche Amministra l'organizzazione nella pagina dell'invito porta qui.
  3. Se amministri più di un'organizzazione, scegli quella da governare nel selettore Organizzazione in alto.
  4. Aggiorna ora rilegge tutte le sezioni e scrive l'ora dell'ultimo controllo.

Suggerimento Se non hai effettuato l'accesso la pagina mostra Accedi, che ti riporta qui; se non amministri alcuna organizzazione lo dice, ricorda che i diritti d'amministrazione li concede un proprietario o un amministratore dell'organizzazione e ti riporta allo spazio di lavoro; se l'organizzazione non si può leggere, Riprova la rilegge.

Leggere la panoramica

La testata nomina l'organizzazione, il suo tipo, il suo stato e quando è stata creata. Le sezioni si susseguono a sinistra, una alla volta.

  1. Panoramica mostra le cifre dell'organizzazione: membri, amministratori, servizi accesi sul totale e spazio in uso.
  2. Per rinominare l'organizzazione cambia Nome e fai clic su Salva: la testata e il selettore prendono subito il nome nuovo.
  3. Passa da una sezione all'altra facendoci clic, oppure con le frecce, Home e Fine.
  4. Un pallino su Persone, e una banda nella panoramica, avvisano che l'organizzazione non ha più amministratori.
  5. Ogni sezione dice quando sta caricando; una che non riesce a leggere ciò che mostra dice che cosa e perché, con Riprova, e una vuota propone il passo successivo.

Suggerimento Un'organizzazione senza amministratori non si può governare finché qualcuno non riceve il ruolo: chiedi all'amministratore dell'installazione.

Persone

I membri e i loro ruoli, e gli inviti a entrare.

Gestire membri e ruoli

Persone elenca chi fa parte dell'organizzazione: nome, email e ruolo. Per proprietari e amministratori una riga dice da quando e chi li ha designati.

  1. Scegli un ruolo nella riga di una persona — Proprietario, Amministratore o Membro: il cambio vale subito e concede o revoca l'amministrazione.
  2. Se il server rifiuta un cambio, torna il ruolo di prima: l'organizzazione deve conservare almeno un amministratore.
  3. Rimuovi chiede prima, nominando la persona e l'organizzazione: per rientrare servirà un nuovo invito, da accettare. Se il server rifiuta, la riga dice perché.
  4. Oltre sei membri, Cerca una persona filtra l'elenco per nome o email.

Suggerimento Per far entrare qualcuno di nuovo, invitalo: vedi Invitare persone nell'organizzazione.

Invitare persone nell'organizzazione

Da Persone inviti un indirizzo come membro o come amministratore. La persona entra solo accettando, quindi nessuno viene aggiunto senza il suo consenso, e la risposta è la stessa che l'indirizzo abbia un account o no.

  1. In Invita una persona scrivi l'email, scegli il ruolo proposto — Membro o Amministratore — e fai clic su Invia l'invito.
  2. L'invito vale sette giorni. In Inviti vedi quelli in attesa, scaduti compresi, e quelli rifiutati e revocati di recente, ognuno con chi ha invitato e quando scade.
  3. Reinvia manda di nuovo l'invito con una scadenza nuova; Revoca lo annulla, e il collegamento nell'email smette di funzionare.
  4. In attesa, Scaduto, Rifiutato e Revocato dicono a che punto è ogni invito: la membership nasce solo quando la persona accetta.

Suggerimento Aggiungere qualcuno subito, senza invito, è riservato all'amministratore dell'installazione, dalla console.

Spazio e servizi

Quanto può archiviare ogni membro, e quali app può usare l'organizzazione.

Impostare le quote di spazio

Spazio mostra, per ogni membro, quanto archivia rispetto alla sua quota.

  1. Leggi ogni riga: lo spazio usato sulla quota, con una barra che diventa rossa dal 90%.
  2. Per cambiare una quota scrivi il nuovo valore in Quota (GB) — un numero intero maggiore di zero — e fai clic su Salva: Quota aggiornata. lo conferma.
  3. Un membro che non ha mai aperto Aerarys non ha ancora uno spazio: impostare una quota lo crea.

Suggerimento Quando lo spazio di un membro non si può leggere, la riga lo dice invece di mostrare zero.

Accendere e spegnere le app

Servizi ha un interruttore per ognuna delle sei app. Ai membri dell'organizzazione un'app spenta non permette di accedere, né sul web né nelle app desktop, e la sua tessera nel loro spazio di lavoro è attenuata.

  1. Leggi ogni riga: Disponibile o Spento, con chi l'ha impostato e quando — oppure che non è mai stata limitata.
  2. Fai clic su un interruttore per spegnere un'app: la conferma nomina l'app e l'organizzazione e ricorda che i membri non potranno più aprirla; finché non confermi, l'interruttore resta acceso.
  3. L'avviso che segue offre Annulla, che riaccende l'app: resta finché non lo chiudi.
  4. Fai di nuovo clic sull'interruttore per riaccenderla, senza conferma.
  5. Se il server rifiuta il cambio, l'interruttore torna com'era e la riga dice che la modifica non è stata salvata.

Suggerimento Spegnere un'app non cancella nulla: i documenti restano dove sono, e li ritrovi appena l'app è di nuovo accesa.

Condivisione

Che cosa può uscire dall'organizzazione, le etichette di riservatezza e i registri di ciò che è successo.

Impostare le regole di condivisione

Condivisione ha quattro interruttori che decidono che cosa può uscire dall'organizzazione: condividere con un collega, link pubblici, richieste file e co-editing in tempo reale. La pagina cambia solo ciò che tocchi, e non parte mai da un valore che non ha letto.

  1. Leggi i quattro interruttori. Un interruttore col trattino non è ancora stato letto, e resta bloccato finché lo stato attuale non è caricato.
  2. Fai clic su un interruttore per cambiare solo quella regola: le altre conservano il loro valore.
  3. Se un altro amministratore ha cambiato le regole dopo che hai aperto la pagina, la tua modifica non viene salvata: fai clic su Ricarica per vedere lo stato attuale, poi decidi di nuovo.
  4. Se lo stato attuale non si può leggere, gli interruttori restano bloccati finché non lo si legge.

Suggerimento Ogni decisione che queste regole prendono resta nel Registro condivisioni.

Gestire le etichette di riservatezza

Le etichette di riservatezza sono le classificazioni che i documenti dell'organizzazione possono portare, come Riservato. Un'etichetta può vietare la condivisione pubblica di ciò che la porta.

  1. In Etichette di riservatezza scrivi il Nome dell'etichetta, spunta Vieta la condivisione pubblica se serve, e fai clic su Aggiungi etichetta.
  2. Un nome già usato viene rifiutato.
  3. Per togliere un'etichetta fai clic su Elimina e conferma: la conferma la nomina e, per un'etichetta che vieta la condivisione pubblica, ricorda che i documenti che la portano tornano condivisibili con un link pubblico o una richiesta di file.

Suggerimento Un'etichetta non si rinomina mai: il suo nome è la sua identità, ed è già scritto sui documenti che la portano.

Leggere il registro delle condivisioni

Registro condivisioni elenca le ultime 100 decisioni di condivisione prese per l'organizzazione, dalla più recente.

  1. Leggi ogni riga: quando, l'azione e la risorsa, l'esito — Consentito o Negato — e chi ha chiesto. L'azione è detta a parole: Condivisione interna, Link pubblico, Richiesta file, Ingresso nel co-editing in tempo reale, Salvataggio di una sessione di co-editing o Amministrazione dello spazio di una persona.
  2. Una decisione Negato vuol dire che una regola di condivisione o un'etichetta di riservatezza ha fermato la condivisione.

Suggerimento Aggiorna ora, in cima alla pagina, rilegge il registro.

Leggere il registro di Simposys

Registro di Simposys raccoglie chi ha cambiato i team, i canali e le chat di gruppo dell'organizzazione: membri aggiunti o tolti, ruoli, codici d'ingresso, indirizzi e webhook dei canali, e messaggi eliminati da un moderatore.

  1. Leggi ogni riga: chi ha fatto cosa, in quale team, canale o chat di gruppo, e quando — dalla più recente.
  2. Fai clic su Carica altre voci per vedere gli eventi precedenti.

Suggerimento Se in questo momento il registro di Simposys non si può leggere, la sezione lo dice: riprova con Aggiorna ora.