9.3. Comandi di amministrazione principali¶
Contenuti
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;