9.3. Comandi di amministrazione principali

9.3.1. Introduzione

I comandi di amministrazione sono contenuti nella directory:

{{SANET_INSTALL_DIR}}/bin/

9.3.2. sanet-manage

{{SANET_INSTALL_DIR}}/bin/sanet-manage [ <comando> ]

Il comando sanet-manage permette di compiere numerose operazioni di amministrazione.

Note

il comando sanet-manage e’ equivalente al comando:

python {{SANET_INSTALL_DIR}}/manage.py [ <comando> ]

Questo comando in realta’ funziona solo specificando almeno un sottocomando.

L’elenco completo dei sottocomandi e’ disponibile con:

sanet-manage helpme

oppure

sanet-manage help

Per una descrizione dei singoli sotto-comandi disponibili si rimanda a Command line tools.

Warning

Esiste il comando “djangohelp” per ottenere l’elenco completo di tutti i comandi “django” disponibili, ma NON VA USATO poiche’ mostra anche comandi presenti esclusivamente per finalita’ di debug e diagnostica. Se usati senza le opportune precauzioni potrebbero lasciare il sistema in uno stato incosistente/inutilizzabile.

sanet-manage djangohelp

Questo comando mostra anche comandi ad uso interno/debug. NON USATE COMANDI che non vengono elencati usando “help(me)”.

9.3.2.1. Sotto-comandi principali

9.3.2.1.1. sanetdata

Lancio:

sanet-manage sanetdata
Questo comando effettua un checkup dell’installazione effettuando le seguenti operazioni automatiche:
  • inizializzazione di directory/file di sistema
  • aggiornamento del database da una release all’altra
  • fix di dati corrotti

Danger

questo comando deve essere SEMPRE eseguito quando sanet NON e’ in esecuzione.

Note

Questo comando puo’ essere lanciato un numero illimitato di volte.

Attention

Questo comando cancella le sessioni WEB attualmente memorizzate dal sistema. Una volta lanciato, tutte le sessioni WEB che richiedono autenticazione (login) devono essere ripristinate.

9.3.2.1.2. get_config

Lancio:

sanet-manage get_config [ option_name ]

Produce un dump su standard output della configurazione corrente del sistema caricata dal file di configurazione “settings.py”.

Questo comando e’ utile per estrarre informazioni parziali di configurazione:

$ sanet-manage get_config  SANET_INSTALL_DIR
/usr/share/sanet

Per avere tutta la configurazione:

$ sanet-manage get_config

...
BASE_DIR /opt/sanet3
BASE_URL_PREFIX 
BASE_WEB_URL_PREFIX web
BROKER_ADDRESS ('localhost',)
BROKER_AUTH ('sanet', 'sanet')
COMMENTS_ALLOW_PROFANITIES False
ADMINS ()
ADMIN_FOR ()
ALLOWED_INCLUDE_ROOTS ()
APPEND_SLASH True
AUTHENTICATION_BACKENDS ('sanet_common.django.auth.backends.dummy.DummyBackend',)
BASE_DIR /opt/sanet3
BASE_URL_PREFIX 
BASE_WEB_URL_PREFIX web
BROKER_ADDRESS ('localhost',)
BROKER_AUTH ('sanet', 'sanet')
CACHES {'default': {'LOCATION': '', 'BACKEND': 'django.core.cache.backends.locmem.LocMemCache'}}
...
...
...
...

9.3.2.2. Comandi per amministrazione utenti

9.3.2.2.1. createsuperuser

Crea l’utente superuser del sistema. Utile per avere una prima utenza per accedere attraverso l’interfaccia web:

{{SANET_INSTALL_DIR}}/bin/sanet-manage createsuperuser

9.3.2.2.2. changepassword

Cambiare la password “locale” di un utente

{{SANET_INSTALL_DIR}}/bin/sanet-manage changepassword <username>

Esempio:

$ sanet-manage changepassword admin
Password: ******

9.3.2.2.3. test_user_password

9.3.2.2.3.1. test_user_password

Questo comando verifica le credenziali di accesso di un utente utilizzando il modulo di autenticazione configurato per il sistema:

sanet-manage test_user_password <username>

Esempio:

$ sanet-manage test_user_password foo
Password: *********
Invalid credentials

E’ utile per controllare se il sistema di autenticazione utilizzato funziona correttamente:

9.3.3. CLI

Si rimanda alla sezione: CLI (Command Line Interface).

9.3.4. entables

Si rimanda alla sezione: Comandi di gestione.

9.3.5. dbshell

Questo comando permette di accedere al database interno:

{{SANET_INSTALL_DIR}}/bin/sanet-manage dbshell

Warning

il database interno di sanet e’ suddiviso in schemi e per accedere ad i dati di un tenant bisogna usare il comando

set search_path to  <tenant name>, public;