mirmon - Online nel cloud

PROGRAMMA:

NOME

mirmon - monitora lo stato dei mirror

SINOSSI

mirmon [-v] [-q] [-t timeout] [-c conf] [-get all|aggiorna|url url]

VERSIONI

-v Sii prolisso; Mirmon normalmente riporta solo errori e modifiche nell'elenco dei mirror.

-q Silenzio.

-t timeout
Imposta il timeout ; l'impostazione predefinita è 300.

-ottenere tutti | aggiornamento | URL
Con contro tutti i, sonda tutti i siti. Insieme a update, sondare una selezione dei siti ; vedi opzione
"max_poll" di seguito. Insieme a URL, sonda solo il dato URL, che deve apparire nel
lista specchio.

-c Nome
Usa il file di configurazione Nome. L'elenco predefinito è

./mirmon.conf $HOME/.mirmon.conf /etc/mirmon.conf

USO

Il programma deve essere eseguito da cron ogni ora.

42 * * * * perl /percorso/di/mirmon -get update

Analizza silenziosamente un sottoinsieme dei siti in un determinato elenco, scrive i risultati nello 'stato'
file e genera una pagina web con i risultati. Il sottoinsieme contiene i siti che sono
nuovo, difettoso e/o non sondato per un periodo di tempo specificato.

Quando non viene specificata alcuna opzione 'get', il programma genera semplicemente una nuova pagina web dall'ultima
stato conosciuto.

Il programma controlla i mirror eseguendo un programma (specificato dall'utente) su una pipe. Un utente
specificato) il numero di probe viene eseguito in parallelo utilizzando IO non bloccanti. Quando qualcosa può essere
read from the pipe, commuta la pipe in blocco IO e legge una riga dalla pipe.
Quindi lava e chiude il tubo. Non viene fatto alcun tentativo di uccidere la sonda.

La sonda dovrebbe restituire qualcosa che assomiglia

1043625600 ...

ovvero una riga di testo che inizia con un timestamp. Lo stato di uscita della sonda è
ignorato.

CONFIGURA RISORSE

località
Un file di configurazione può essere specificato con l'opzione -c. Se -c non viene utilizzato, il programma guarda
per un file di configurazione in

· ./mirmon.conf

· $HOME/.mirmon.conf

· /etc/mirmon.conf

sintassi
Un file di configurazione assomiglia a questo:

+----------------------------------- -
|# le righe che iniziano con '#' sono commenti
|# Anche le righe vuote vengono ignorate
|# le tabulazioni sono sostituite da uno spazio
|
|# le voci di configurazione sono coppie 'chiave' e 'valore'
|# una 'chiave' inizia nella colonna 1
|# il 'valore' è il resto della riga
|qualcosa A_val B_val ...
|altra chiave X_val Y_val ...
|
|# linee rientrate sono incollate
|# le tre righe successive significano 'qualche chiave parte1 parte2 parte3'
|qualche parte chiave1
| parte 2
| parte 3
|
|# le righe che iniziano con un '+' sono concatenate
|# le tre righe successive significano 'qualche chiave parte1parte2parte3'
|qualche parte chiave1
|+ parte2
|+ parte3
|
|# righe che iniziano con '.' sono anche incollati
|# non usare un '.' su una linea da solo
|# 'somekey' ottiene il valore "part1\n part2\n part3"
|qualche parte chiave1
|. parte 2
|. parte 3
+----------------------------------- -

necessario voci
Nome del progetto Nome
Specificare un breve nome in testo normale per il progetto.

nome_progetto Apache
nome_progetto CTAN

URL_progetto URL
Specifica un URL che punti alla 'home' del progetto.

URL_progetto http://www.apache.org/

lista_specchio nome del file
Specificare il file contenente i mirror da sondare.

mirror_list /percorso/a/mirror-list

Se la tua lista di mirror è generata da un programma, usa

mirror_list /percorso/a/programma arg1 ... |

Sono supportati due formati:

· semplice: linee come

us http://www.tux.org/ [e-mail] ...
nl http://apache.cs.uu.nl/dist/ [e-mail] ...
nl rsync://archive.cs.uu.nl/apache-dist/ [e-mail] ...

· apache: righe come quelle in apache mirrors.list

ftp noi ftp://ftp.tux.org/pub/net/apache/dist/ [email protected] ...
http nl http://apache.cs.uu.nl/dist/ [email protected] ...

Nota che in stile 'semplice' il terzo elemento è riservato a un indirizzo email opzionale:
l'indirizzo di contatto del sito.

Specificare il formato richiesto con l'opzione "list_style" (vedi sotto). Lo stile predefinito
è "semplice".

pagina web nome del file
Specificare dove viene scritta la pagina del report html.

Icone nome-directory
Specificare la directory dove si trovano le icone, relativa al pagina web, o
relativo alla DOCUMENTROOT del web server.

Se/quando il pagina web vive nella directory ".../mirmon/" e le icone vivono nella directory
".../mirmon/icons/", specificare

icone icone

Se/quando le icone si trovano in "/path/to/DOCUMENTROOT/icons/mirmon/", specificare

icone/icone/mirmon

sonda Programma + argomenti
Specifica il programma+args per sondare i mirror. Esempio:

sonda /usr/bin/wget -q -O - -T %TIMEOUT% -t 1 %URL%TIME.txt

Prima che il programma venga avviato, %TIMEOUT% e %URL% vengono sostituiti con il corretto
valori di timeout e URL.

Qui si presume che ogni ora il server root scriva un timestamp in
/path/to/archive/TIME.txt, ad esempio con una voce crontab come

42 * * * * perl -e 'stampa ora, "\n"' > /percorso/a/archivio/ORA.txt

Mirmon legge una riga di output dalla sonda e interpreta la prima parola su quella
riga come timestamp ; per esempio :

1043625600
1043625600 Lun Gen 27 00:00:00 2003
1043625600 www.apache.org lun gen 27 00:00:00 2003

Mirmon è distribuito con un programma "probe" che gestisce gli URL ftp, http e rsync.

stato nome del file
Specificare dove viene scritto il file contenente lo stato.

Il programma legge questo file all'avvio e scrive il file quando vengono sondati i mirror
(-get è specificato).

paesi nome del file
Specificare il file contenente i codici paese; Il file dovrebbe contenere righe come

noi - Stati Uniti
nl - Paesi Bassi

Il pacchetto mirmon contiene un elenco ISO recente.

Falso domini come di riserva, Maestro sono consentiti e sono elencati per primi nella relazione;
domini falsi con caratteri minuscoli (come di riserva) sono elencati per ultimi.

opzionale voci
max_probes numero
Specificare facoltativamente il numero di sonde parallele (predefinito 25).

timeout secondo
Specificare facoltativamente il timeout per le sonde (predefinito 300).

Dopo l'avvio dell'ultima sonda, il programma attende + 10 secondi, pulisce
su ed esce.

logo_progetto logo
Specificare facoltativamente (l'SRC dell'IMG di) un logo da posizionare in alto a destra nella pagina.

logo_progetto /icons/apache.gif
logo_progetto http://www.apache.org/icons/...

htm_head html
Specificare facoltativamente del codice HTML da inserire prima .

htm_head


htm_top html
Facoltativamente, specifica del codice HTML da posizionare nella parte superiore della pagina.

htm_top test 1, 2, 3

htm_piede html
Specificare facoltativamente l'HTML da posizionare nella parte inferiore della pagina.

htm_piede




put_histo alto|basso|da nessuna parte
Specificare facoltativamente dove deve essere posizionato l'istogramma dell'età. L'impostazione predefinita è "in alto".

min_sondaggio tempo-spec
Per 'min_poll' vedere l'elemento successivo. UN tempo-spec è un numero seguito da un'unità 's'
(secondi), o 'm' (minuti), o 'h' (ore), o 'd' (giorni). Ad esempio '3d' (tre
giorni) o '36h' (36 ore).

max_sondaggio tempo-spec
Specificare facoltativamente l'intervallo massimo della sonda. Quando il programma viene chiamato con l'opzione
'-get update', vengono sondati tutti i siti che sono:

· nuovo

il sito appare nell'elenco, ma non c'è stato noto

· cattivo

l'ultima sonda del sito non è andata a buon fine

· vecchio

l'ultima sonda è stata più di 'max_poll' fa.

I siti non vengono sondati se l'ultima verifica è stata inferiore a 'min_poll' fa. Quindi, se tu
specificare

min_sondaggio 4h
max_sondaggio 12h

i siti "raggiungibili" vengono sondati due volte al giorno e i siti "irraggiungibili" vengono sondati a
la maggior parte sei volte al giorno.

Il valore predefinito 'min_poll' è '1h' (1 ora). Il valore predefinito 'max_poll' è '4h' (4 ore).

sin_min tempo-spec
Specificare facoltativamente la frequenza con cui i mirror sono necessari per eseguire un aggiornamento.

Il valore predefinito "min_sync" è "1d" (1 giorno).

max_sincronizzazione tempo-spec
Specificare facoltativamente l'intervallo di sincronizzazione massimo consentito.

I siti che superano il limite saranno considerati "vecchi". Il valore predefinito 'max_sync' è '2d' (2
giorni).

sempre_get regione ...
Specificare facoltativamente un elenco di regioni che devono essere sempre sondate.

sempre_ottieni il livello principale 1

Questo è destinato a falso regioni piace Maestro ecc.

no_randomizzare
Mirmon cerca di bilanciare il carico della sonda sulle esecuzioni orarie di mirmon. Se la corrente
run ha un numero inferiore alla media di specchi da sondare, mirmon sonda alcuni extra,
specchi scelti a caso, scelti tra le corse che hanno il carico più alto.

Se non vuoi questo comportamento, usa no_randomizzare.

no_aggiungi_barra
Se la parte url di una riga in mirror_list non termina con una barra ('/'), mirmon aggiunge
una barra ed emette un avviso a meno che non sia in modalità silenziosa.

Se non vuoi questo comportamento, usa no_aggiungi_barra.

list_style semplice|apache
Specificare facoltativamente il formato ('semplice' o 'apache') dell'elenco mirror.

Vedi la descrizione di 'mirror_list' sopra. Il list_style predefinito è 'semplice'.

URL del sito site URL
Specificare facoltativamente un URL sostitutivo per un sito.

Quando l'accesso a un sito è limitato (in Australia, per esempio), un altro (a volte
secret) può essere utilizzato per sondare il sito. Il di un URL è la parte tra
'://' e il primo '/'.

ENV chiave APPREZZIAMO
Specificare facoltativamente una variabile di ambiente.

includere nome del file
Specificare facoltativamente un file da includere.

Il file specificato viene elaborato "in situ". Dopo che il file specificato è stato letto e
elaborato, l'elaborazione della configurazione viene ripresa nel file in cui era "include"
incontrato. La profondità di inclusione è illimitata. Tuttavia, è un errore fatale da includere
un file due volte con lo stesso nome.

mostrare attraverso le sue creazioni
Quando il processore di configurazione incontra il comando 'show', scarica il contenuto del
configurazione corrente per risaltare, se è specificata l'opzione "-v". Questo è destinato a
debug.

exit
Quando il processore di configurazione incontra il comando 'exit', termina il programma.
Questo è destinato al debug.

STATO RISORSE FORMATO

Il file di stato è costituito da righe; una riga per sito. Ogni riga è composta da uno spazio bianco
campi separati. I sette campi sono:

· campo 1 : url

L'URL come indicato nell'elenco dei mirror.

· campo 2: età

Il timestamp del mirror trovato dall'ultima sonda riuscita, o "undef" se non è stata rilevata nessuna sonda
mai successo.

· campo 3 : stato ultima sonda

Lo stato dell'ultima sonda, o 'undef' se il mirror non è mai stato sondato.

· campo 4 : ora ultima sonda riuscita

Il timestamp dell'ultima sonda riuscita o "undef" se il mirror non è mai stato
sondato con successo.

· campo 5 : cronologia sonda

La cronologia della sonda è un elenco di caratteri 's' (per il successo) e 'f' (per il fallimento)
indicando il risultato della sonda. I nuovi risultati vengono aggiunti ogni volta che lo specchio è
sondato.

· campo 6 : storia dello stato

La cronologia dello stato consiste in un timestamp, un carattere '-' e un elenco di caratteri che indicano
uno stato passato: 's' (fresco), 'b' (vecchio), 'f' (vecchio), 'z' (cattivo) o 'x' (salta). Il
timestamp indica quando la cronologia dello stato è stata aggiornata l'ultima volta. Lo stato attuale di
lo specchio è determinato dall'età dello specchio e da alcuni parametri di configurazione
(min_sync, max_sync, max_poll). La cronologia dello stato viene aggiornata quando il mirror è
sondato. Se l'ultimo aggiornamento della cronologia risale a meno di 24 ore fa, l'ultimo stato
viene sostituito dallo stato attuale. Se l'ultimo aggiornamento della cronologia è stato superiore a 24
ore fa, lo stato corrente viene aggiunto alla cronologia. Uno o più "salta" è
inserito, se il timestamp è vecchio di due o più giorni (quando mirmon non è stato eseguito per più
di due giorni).

· campo 7 : ultima sonda

Il timestamp dell'ultima sonda, o 'undef' se il mirror non è mai stato sondato.

MONTAGGIO

generale
· Nota: il file di stato (vuoto) deve esistere prima dell'esecuzione di mirmon.

· Il repository mirmon è qui:

https://svn.science.uu.nl/repos/project.mirmon/trunk/

· Il tarball mirmon è qui:

http://www.staff.science.uu.nl/~penni101/mirmon/mirmon.tar.gz

installazione suggerimenti
Per installare e configurare mirmon, procedi come segue:

· Per prima cosa, crea la webdir :

cd DOCUMENTROOT
mkdir mirmon

Nel DOCUMENTROOT, sostituisci il percorso completo della radice del documento del tuo server web.

· Controlla il repository mirmon:

cd /usr/locale/sorgente
svn verifica REPO mirmon

where

REPO = https://svn.science.uu.nl/repos/project.mirmon/trunk/

oppure scarica il pacchetto e scompattalo.

· Chdir nella directory mirmon:

cd Mirmone

· Creare il file di stato (vuoto):

tocca state.txt

· Installa le icone nella webdir :

mkdir DOCUMENTROOT/mirmon/icons
cp icone/* DOCUMENTROOT/mirmon/icons

· Creare una lista mirror "mirror_list" ;

Usa il tuo editor preferito o genera l'elenco da un database esistente.

nl http://archive.cs.uu.nl/your-project/ [email protected]
uk http://mirrors.this.org/your-project/ [email protected]
us http://mirrors.that.org/your-project/ [email protected]

Gli indirizzi email sono facoltativi.

· Crea un file di configurazione mirmon "mirmon.conf" con il tuo editor preferito.

# righe devono iniziare nella prima colonna; nessuno spazio bianco iniziale
Nome del progetto ....
URL_progetto ....
lista_specchio lista_specchio
stato stato.txt
paesi paesi.lista
pagina_web DOCUMENTROOT/mirmon/index.html
icone /mirmon/icone
sonda /usr/bin/wget -q -O - -T %TIMEOUT% -t 1 %URL%TIME.txt

Ciò presuppone che il timestamp del progetto sia nel file "TIME.txt".

· Se si dispone di URL rsync, modificare la riga del probe in:

sonda perl /usr/local/src/mirmon/probe -t %TIMEOUT% %URL%TIME.txt

· Esegui mirmon :

perl mirmon -v -ottieni tutto

Il rapporto mirmon ora dovrebbe essere in "DOCUMENTROOT/mirmon/index.html"

http://www.your.project.org/mirmon/

· Se/quando, in un secondo momento, desideri aggiornare mirmon:

cd /usr/local/src/mirmon
stato svn -u
alzati

Usa mirmon online utilizzando i servizi onworks.net