# Manuale di &ksysguard;

## Introduzione

&ksysguard; è il Gestore dei Processi e il Monitor delle Prestazioni. È caratterizzato da una architettura client/server che permette il controllo sia di host locali che remoti. L'interfaccia grafica utilizza i cosiddetti sensori per ottenere le informazioni che visualizza. Un sensore può restituire un semplice valore o informazioni più complesse come delle tabelle. Per ogni tipo di informazione è disponibile uno o più display. I display sono organizzati in fogli di lavoro che possono essere salvati e caricati indipendentemente l'uno dall'altro. Così, &ksysguard; non è solo un semplice gestore dei processi ma anche uno strumento molto potente per controllare grandi server farm.

## Usare &ksysguard;

### Per iniziare

&ksysguard; può essere lanciato dal menu di partenza, tramite la voce Controllo di Sistema di KDE nel menu sistema. Alternativamente, puoi lanciarlo digitando `ksysguard` in un terminale.

La finestra principale di &ksysguard; consiste in una barra dei menu, una barra degli strumenti opzionale, il browser dei sensori e lo spazio di lavoro. Quando viene lanciato per la prima volta puoi vedere la tua macchina locale elencata come localhost nel browser dei sensori e 2 pagine nello spazio di lavoro. Questa è l'impostazione predefinita.

Questa impostazione predefinita è sufficiente per un utente inesperto per amministrare un po' il sistema. Un utente con esperienza o addirittura un amministratore di sistema di un grande laboratorio informatico ha necessità differenti. Per indirizzare un'ampia gamma di utenti, &ksysguard; è altamente flessibile.

### Il Browser dei Sensori

Il browser dei sensori visualizza gli host registrati ed i loro sensori in forma di albero. Fai clic sulle maniglie dell'albero per aprire o chiudere una ramificazione. Ogni sensore controlla un certo valore di sistema.

#### Connettersi ad altri host

Per connetterti ad un nuovo host utilizza Connettiti all'host dal menu File. Una finestra di dialogo apparirà e ti permetterà di inserire il nome dell'host a cui vuoi connetterti. Al di sotto del nome puoi scegliere il metodo di connessione. L'impostazione predefinita è ssh, la shell sicura. In alternativa può essere usata rsh, la shell remota, o la modalità daemon. Fai clic su OK per stabilire la connessione. In breve tempo il nuovo host apparirà nel browser dei sensori e potrai navigare la lista dei sensori.

Per stabilire una connessione, deve essere installato nel nuovo host un programma chiamato ksysguardd, che può essere lanciato nei seguenti due modi.

modalità daemon

- Puoi lanciare ksysguardd in fase di avvio del computer in modalità Daemon aggiungendo `-d` come argomento. In questo caso, devi selezionare modalità daemon nella finestra di dialogo della connessione di ksysguard. Uno svantaggio di questo tipo di connessione è che non sarai in grado di uccidere o cambiare la priorità dei processi con il Gestore dei Processi e lo scambio dei dati attraverso la rete non sarà criptata.

modalità shell

- In questa modalità ksysguardd è lanciato in fase di connessione da ksysguard. Perché ciò sia possibile, la sua posizione deve essere inclusa nel tuo `PATH`. Sfortunatamente ssh non elabora il tuo file `.profile` così la tua impostazione regolare del `PATH` non sarà disponibile. Invece usa un `PATH` predefinito come `/bin:/usr/bin`. Dato che è molto probabile che &kde; non sia installato in queste cartelle hai bisogno di creare o aggiornare un file nella tua cartella home. Il file è chiamato `environment` e deve trovarsi in una cartella nascosta chiamata `.ssh`. Guarda la pagina di manuale di ssh per maggiori dettagli. Il file deve contenere una linea simile a:

      PATH=/bin:/usr/bin:/opt/kde/bin

  assumendo che ksysguardd possa essere trovato sotto `/opt/kde/bin/ksysguardd`.

  Quando usi ssh dovresti assicurarti di avere il tuo file `identity.pub` installato nella macchina remota e che la chiave host della macchina remota sia già registrata sulla tua macchina. Il modo più semplice per verificare ciò è digitare `ssh `hostremoto ksysguardd`` in una shell. Se ricevi il benvenuto di ksysguardd puoi digitare `quit` ed ogni cosa è a posto.

Per gli esperti: ksysguardd è un programma molto piccolo che è linkato solamente alla libc. Così può anche essere usato su macchine che non hanno installato &kde; completo di tutto, quali i server. Se scegli l'opzione di comando personalizzata nella connessione dell'host devi specificare il comando completo per lanciare ksysguardd.

#### Disconnettersi dagli host

Per disconnetterti da un host, seleziona l'host nel browser dei sensori e scegli Disconnettiti dall'Host dal menu file. Se hai ancora sensori in uso, la cornice del display diverrà grigia ed il display non verrà più aggiornato.

### Lo Spazio di Lavoro

Lo spazio di lavoro è organizzato come fogli di lavoro. Seleziona Nuovo dal menu File per creare un nuovo foglio di lavoro. Apparirà una finestra di dialogo dove potrai impostare il nome, la dimensione e l'intervallo di aggiornamento del fogli di lavoro. Di nuovo, per rimuovere un foglio di lavoro seleziona Chiudi dal menu File. Qualsiasi modifica sarà salvata nel file del foglio di lavoro. Se un foglio di lavoro non è mai stato salvato, ti sarà chiesto un nome per il file. I fogli di lavoro consistono di celle organizzate in una griglia.

Ogni cella può essere riempita con un display per uno o più sensori. Puoi riempire una cella trascinando un sensore dal browser dei sensori e rilasciandolo sopra alla cella. Se c'è più di un tipo di visualizzazione disponibile per quel tipo di sensore, apparirà un menu a comparsa. Puoi quindi selezionare quale visualizzazione preferisci utilizzare. Certi tipi di visualizzazioni possono visualizzare più di un sensore. Aggiungi più sensori ad un display trascinandoli dal browser dei sensori e rilasciandoli sopra al display già esistente.

I fogli di lavoro possono essere configurati facendo clic su Proprietà Foglio di Lavoro nel menu Modifica. Nella finestra di dialogo che appare puoi impostare le dimensioni e l'intervallo di aggiornamento. Questo intervallo di aggiornamento è utilizzato da ogni display nel foglio di lavoro, che ha Utilizza l'intervallo di aggiornamento del foglio di lavoro impostato nella propria finestra di dialogo di configurazione del timer.

La voce Configura Stile del menu Impostazioni ti dà la possibilità di configurare gli attributi globali di stile e li applica al foglio di lavoro correntemente attivo.

I display possono essere configurati facendovi clic con il tasto destro del mouse. Compare così un menu a comparsa dove puoi selezionare se vuoi modificare le proprietà di quel display, rimuoverlo dal foglio di lavoro, cambiare il tipo e valore del suo intervallo di aggiornamento, o mettere in pausa e riprendere il suo aggiornamento.

#### Grafico del Segnale

Il grafico del segnale stampa campioni di uno o più sensori nel tempo. Se sono visualizzati diversi sensori, i valori sono impilati in colori diversi. Se il display è largo abbastanza verrà visualizzata una griglia per mostrare l'intervallo dei campioni rappresentati. Per impostazione predefinita è attiva la modalità di intervallo automatico, così il minimo e il massimo valore saranno impostati automaticamente. A volte si desiderano valori minimo e massimo fissi. In questo caso, puoi disattivare la modalità di intervallo automatico e impostare i valori nella finestra di dialogo delle proprietà.

#### Multimetro

Il multimetro visualizza i valori del sensore come un contatore digitale. Nella finestra di dialogo delle proprietà puoi specificare un limite inferiore ed uno superiore. Se viene oltrepassato l'intervallo, il display viene colorato con il colore di allarme.

#### Il Controllore dei Processi

Il Controllore dei Processi fornisce una lista di processi sul tuo sistema. La lista può essere ordinata secondo ogni colonna. Basta premere il pulsante sinistro del mouse sull'intestazione della colonna.

La lista mostra le seguenti informazioni riguardo ad ogni processo. Per favore, nota che non tutte le proprietà sono disponibili su ogni sistema operativo.

Nome

- Il nome dell'eseguibile che ha lanciato il processo.

PID

- L'ID del Processo. Un numero unico per ogni processo.

PPID

- L'ID del Processo del padre del processo.

UID

- L'ID dell'utente che ha lanciato il processo.

GID

- L'ID del gruppo a cui il processo appartiene.

Stato

- Lo stato del processo.

Utente%

- Il carico del processore del processo nello spazio utente (in percentuale).

Sistema%

- Il carico del processore del processo nello spazio di sistema (in percentuale).

Nice

- La priorità di schedulazione.

DimensioneVm

- La quantità totale di memoria virtuale utilizzato dal processo (in kByte).

VmRss

- La quantità totale di memoria fisica utilizzata dal processo (in kByte).

Login

- Il nome di login dell'utente che ha lanciato il processo.

Comando

- Il comando completo di lancio del processo.

Al di sotto della tabella trovi quattro pulsanti che saranno ora descritti dalla sinistra alla destra.

##### La Visuale ad Albero

La visuale ad albero è stata progettata per mostrare le relazioni tra i processi correnti. Un processo che è stato lanciato da un altro processo è chiamato figlio di quel processo. Un albero è un modo elegante per mostrare la relazione padre-figlio. Il processo init è l'antenato di tutti i processi.

Se non sei interessato ai figli di un particolare processo puoi fare clic sulla piccola casella alla sinistra del padre ed il sotto-albero si chiuderà. Un altro clic su quella casella riaprirà nuovamente il sotto-albero.

##### Il Filtro dei Processi

Il Filtro dei Processi può essere usato per ridurre il numero di processi visualizzati nella tabella. Puoi filtrare i processi di cui non sei interessato. Attualmente puoi visualizzare tutti i processi, solo i processi di sistema, solo i processi degli utenti o solo i tuoi processi.

##### Il Pulsante Aggiorna

Questo pulsante può essere usato per forzare un immediato aggiornamento della lista dei processi.

##### Il Pulsante Uccidi

Se hai selezionato uno o più processi puoi premere il pulsante uccidi per ucciderli. Viene spedito un cosiddetto segnale SIGKIL ai processi che causa la loro immediata terminazione. Se queste applicazioni hanno ancora dei dati non salvati questi dati saranno persi. Quindi utilizza questo pulsante con cura.

#### GrafBarre

GrafBarre visualizza il valori del sensore come barre oscillanti. Nella finestra di dialogo delle proprietà puoi specificare i valori minimo e massimo dell'intervallo ed un limite inferiore e superiore. Se l'intervallo è oltrepassato, il display viene colorato con il colore di allarme.

#### Log dei sensori

Il log dei sensori non visualizza nessun valore, ma li registra in un file con l'informazione aggiuntiva della data e dell'ora. Per ogni sensore puoi specificare un limite inferiore e superiore nella finestra di dialogo delle proprietà. Se l'intervallo è superato, la voce della tabella del sensore viene colorata con il colore di allarme e viene spedito un evento di knotify.

#### File di log

Il monitor del file di log visualizza il contenuto di un file, ad esempio `/var/log/messages`. Nella finestra di dialogo delle proprietà puoi comporre una lista di espressioni regolari che saranno confrontate con il contenuto del file. Se viene verificata una delle espressioni regolari, viene spedito un evento di knotify.

#### Vista Lista

La vista lista visualizza i dati di diversi sensori come una tabella.

## Configurare ksysguardd

L'interfaccia grafica è disponibile su qualsiasi piattaforma su cui giri &kde;. Il back-end è disponibile al momento sulle seguenti versioni di &UNIX;:

&Linux; 2.x

- Per far funzionare ksysguardd è necessario compilare il Kernel di &Linux; con il file-system `/proc` abilitato. Questa è l'impostazione predefinita e la maggior parte delle Distribuzioni &Linux; ce l'hanno già.

FreeBSD

- Il programma ksysguardd deve essere posseduto dal gruppo `kmem` e deve avere il bit setgid impostato.

&Solaris;

- Ancora da scrivere

Il supporto per altre piattaforme è in fase di sviluppo. Il tuo aiuto è veramente apprezzato.

## Riconoscimenti e licenza

&ksysguard; è attualmente sviluppato e mantenuto da Chris Schläger cs@kde.org. &ksysguard; è una riscrittura di KTop, il gestore dei progetti di KDE 1.x. Diverse altre persone hanno lavorato su KTop:

- A. Sanda alex@darkstar.ping.at

- Ralf Mueller ralf@bj-ig.de

- Bernd Johannes Wuebben wuebben@math.cornell.edu

- Nicolas Leclercq nicknet@planete.net

Il porting verso altre piattaforme oltre a &Linux; è stato fatto da:

- FreeBSD: Hans Petter Bieker zerium@traad.lavvu.no

&underFDL; &underGPL;