Utilizzo avanzato del comando cyberwatch

Questa documentazione spiega come utilizzare i parametri avanzati del comando cyberwatch tramite variabili d’ambiente.

Tutte le variabili seguenti possono essere modificate in due modi diversi:

In modo temporaneo, utilizzando la variabile nella riga di comando. Ad esempio, per eseguire un backup in un’altra directory:
```
 sudo CBW_BACKUP_DIR=/tmp/backups cyberwatch backup save
```
In modo «permanente», aggiungendole o modificandole nel file di configurazione della piattaforma di base /etc/cyberwatch/config.env (o in quello definito da ${CBW_CONFIG_FILE})

Variabili

`CBW_CONFIG_FILE`

Valore predefinito: /etc/cyberwatch/config.env

Consente di modificare il file che contiene tutti i parametri della piattaforma di base.

`CBW_CONFIG_DIR`

Valore predefinito: /etc/cyberwatch

Consente di modificare la directory che contiene i file di configurazione di Cyberwatch.

La modifica di questo parametro può modificare anche le variabili CBW_CERT_DIR e CBW_SSL_DIR.

`CBW_CERT_DIR`

Valore predefinito: ${CBW_CONFIG_DIR}/certs

Consente di modificare la directory di archiviazione dei certificati.

`CBW_SSL_DIR`

Valore predefinito: ${CBW_CONFIG_DIR}/ssl

Consente di modificare la directory che contiene il certificato presentato dall’interfaccia web (nginx.crt e nginx.key). Per ulteriori informazioni, consultare Modificare il certificato TLS di Cyberwatch.

`CBW_NGINX_UID`

Valore predefinito: 101 (0 con la piattaforma di base in versione 5.31)

Consente di modificare l’UID assegnato alla directory ${CBW_SSL_DIR} a ogni avvio. Deve corrispondere all’utente del container nginx. Da modificare solo in caso di isolamento dei container tramite namespace.

`CBW_NGINX_GID`

Valore predefinito: 101 (0 con la piattaforma di base in versione 5.31)

Consente di modificare il GID assegnato alla directory ${CBW_SSL_DIR} a ogni avvio, alle stesse condizioni di CBW_NGINX_UID.

`CERT_WARNING_DAYS`

Valore predefinito: 90

Numero di giorni prima della scadenza di un certificato a partire dal quale viene visualizzato un avviso all’avvio di Cyberwatch.

`CERT_RENEWAL_DAYS`

Valore predefinito: 45

Numero di giorni prima della scadenza a partire dal quale un certificato viene rinnovato: automaticamente all’avvio di Cyberwatch per i certificati dei servizi, oppure con il comando cyberwatch renew-certificates. Per ulteriori informazioni, consultare la procedura di rinnovo dei certificati TLS.

`CERT_VALIDITY_DAYS`

Valore predefinito: 365

Durata di validità, in giorni, dei certificati dei servizi generati o rinnovati da Cyberwatch.

`ROOT_CERT_VALIDITY_DAYS`

Valore predefinito: 3650

Durata di validità, in giorni, dei certificati radice generati da Cyberwatch.

`CBW_BACKUP_DIR`

Valore predefinito: /var/lib/cyberwatch/backups

Consente di modificare la directory di archiviazione dei file di backup. Per ulteriori informazioni sui backup, consultare Procedura di backup e ripristino di Cyberwatch.

`CBW_SKIP_BACKUP`

Valore predefinito: false

Consente di disattivare il meccanismo di backup dei database. Questi backup vengono eseguiti a ogni riavvio della piattaforma di base. Per ulteriori informazioni sui backup, consultare Procedura di backup e ripristino di Cyberwatch.

`CBW_REPORT_DIR`

Valore predefinito: /var/lib/cyberwatch/reports

Consente di modificare la directory di archiviazione dei report generati con il comando cyberwatch report.

`CBW_OFFLINE`

Valore predefinito: false

Consente di indicare se la piattaforma di base è offline o meno. Per ulteriori informazioni sull’amministrazione offline, consultare Guide all’amministrazione offline.

`CBW_DISABLE_ELK`

Valore predefinito: false

Consente di disattivare la distribuzione di Elasticsearch e Kibana integrati sui nodi master/single. Quando la variabile è impostata su true, lo stack ELK viene escluso dalla distribuzione di Cyberwatch. La modifica viene applicata al successivo cyberwatch configure oppure, solo su Docker Swarm, al successivo avvio. Per ulteriori informazioni, consultare Configurare Cyberwatch per l’utilizzo di un Elastic Stack esterno.

`CBW_NO_PULL`

Valore predefinito: false

Consente di disattivare il download delle immagini dal registro dei container. I comandi cyberwatch start e cyberwatch restart utilizzano allora le immagini già presenti sul nodo. Questo comportamento può essere modificato puntualmente, senza modificare il file di configurazione, con le opzioni --no-pull e --force-pull disponibili a partire dalla versione 5.32 della piattaforma di base. Ad esempio, per aggiornare un’istanza configurata con CBW_NO_PULL="true":

sudo cyberwatch restart --force-pull