User Tools

Site Tools


rocrail-tracing-it

Tracciamento avanzato

Indice Rocrail ServerConfigurazione


Quando il server Rocrail è in esecuzione come servizio oppure demone è necessario attivare ulteriori elementi di tracciatura oltre a quelli predefiniti per aiutare l'amministratore.
Queste opzioni non sono modificabili tramite finestra di dialogo e sono solo utenti esperti.

Descrizione XML: http://www.rocrail.net/doc/rocrail-wrappers/wrapper-en.html#trace

Opzioni

Opzione Predefinita Descrizione
protpath . Percorso Protocollo; dove scrivere il file di trace. (Usare un percorso relativo solo se si usa un servizio http.) Il percorso è relativo per la pwd¹!
unique false Creare un unico file di trace all'avvio.
size 100 Dimensione dei file di trace in KB.
nr 10 Numero sequenziale dei file di trace. In caso di 0 o 1: tutti i trace sono scritti in solo file senza tenere conto delle dimensioni.
exceptionfile false Creare una file aggiuntibo per le eccezioni.
invoke ./xmail.pl Programma esterno o script da richiamare alla creazione del file eccezioni.
invokeasync false Il richiamo avverrà in un differente thread.
dumpsize 128 Dimensione massima del rilascio byte.


¹) pwd = process working directory

Unico

Per prevenire la sovrascrittura di file esistenti, in caso di un problema difficile da individuare, questo segnalino (flag) garantirà che i file di trace vengano nominati sempre con un nome univico.

Invoke

L'opzione invoke, unità con il file eccezioni, fornisce un sistema per notificare a qualcuno del prima eccezione scritta nel nuovo file eccezioni creato.
Dopo la revisione del file eccezioni, questo dovrà essere spostato o cancellato per rilevare un nuovo evento di attivazione quando si presenta una eccezione (se voluto)
Lo script o il programma sono definiti dall'utente, ma se il programma esterno dovesse bloccare il server Rocrail è consigliato di impostare l'invokeasync su true per evitarlo.

xmail.pl

Lo script di esempio in Perl invierà una email in caso della creazione di un file eccezioni:

#!/usr/bin/perl
require 5.000;
 
$mailaddr = $ARGV[0];
 
open(SENDMAIL, "| /usr/sbin/sendmail -t -n") || die "Unable to open sendmail";
print SENDMAIL "From: Rocrail\n";
print SENDMAIL "To: $mailaddr\n";
print SENDMAIL "Reply-To: Rocrail\n";
print SENDMAIL "Subject: Exception file created.\n";
print SENDMAIL "This email is sended to notify you because an exception file is created.\n";
close(SENDMAIL);
rocrail-tracing-it.txt · Last modified: 2022/02/28 19:13 by smitt48