mirmon - Online di Awan

PROGRAM:

NAMA

mirmon - pantau keadaan cermin

RINGKASAN

mirmon [-v] [-q] [-t batas waktu] [-c conf] [-dapatkan semua|perbarui|url url]

PILIHAN

-v Bertele-tele; mirmon biasanya hanya melaporkan kesalahan dan perubahan dalam daftar cermin.

-q Diam.

-t batas waktu
Mengatur batas waktu; defaultnya adalah 300.

-mendapatkan semua | perbarui | url
Dengan semua, periksa semua situs. Dengan memperbarui, selidiki pilihan situs ; lihat opsi
"max_poll" di bawah. Dengan url, periksa hanya yang diberikan url, yang harus muncul di
daftar cermin.

-c nama
Gunakan file konfigurasi nama. Daftar defaultnya adalah

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

PENGGUNAAN

Program ini dimaksudkan untuk dijalankan oleh cron setiap jam.

42 * * * * perl /path/to/mirmon -dapatkan pembaruan

Diam-diam menyelidiki subset situs dalam daftar yang diberikan, menulis hasilnya di 'status'
file dan menghasilkan halaman web dengan hasilnya. Subset berisi situs-situs yang
baru, buruk dan/atau tidak diperiksa untuk waktu tertentu.

Ketika tidak ada opsi 'get' yang ditentukan, program hanya menghasilkan halaman web baru dari yang terakhir
negara yang diketahui.

Program memeriksa cermin dengan menjalankan program (ditentukan pengguna) pada pipa. Pengguna
ditentukan) jumlah probe dijalankan secara paralel menggunakan IO nonblocking. Ketika sesuatu bisa terjadi
membaca dari pipa, itu mengalihkan pipa untuk memblokir IO dan membaca satu baris dari pipa.
Kemudian menyiram dan menutup pipa. Tidak ada upaya yang dilakukan untuk membunuh probe.

Probe harus mengembalikan sesuatu yang terlihat seperti

1043625600 ...

yaitu, sebaris teks yang dimulai dengan stempel waktu. Status keluar dari probe adalah
diabaikan.

KONFIG FILE

tempat
File konfigurasi dapat ditentukan dengan opsi -c. Jika -c tidak digunakan, program akan terlihat
untuk file konfigurasi di

· ./mirmon.conf

· $HOME/.mirmon.conf

· /etc/mirmon.conf

sintaksis
File konfigurasi terlihat seperti ini:

+------------------------------------------------- -
|# baris yang dimulai dengan '#' adalah komentar
|# baris kosong juga diabaikan
|# tab diganti dengan spasi
|
|# entri konfigurasi adalah pasangan 'kunci' dan 'nilai'
|# sebuah 'kunci' dimulai di kolom 1
|# 'nilai' adalah sisa baris
|somekey A_val B_val ...
|kunci lain X_val Y_val ...
|
|# garis indentasi direkatkan
|# tiga baris berikutnya berarti 'somekey part1 part2 part3'
| beberapa kunci bagian1
| bagian 2
| bagian 3
|
|# baris yang dimulai dengan '+' digabungkan
|# tiga baris berikutnya berarti 'somekey part1part2part3'
| beberapa kunci bagian1
|+ bagian2
|+ bagian3
|
|# baris dimulai dengan '.' terpaku juga
|# jangan gunakan '.' pada baris dengan sendirinya
|# 'somekey' mendapat nilai "part1\n part2\n part3"
| beberapa kunci bagian1
|. bagian 2
|. bagian 3
+------------------------------------------------- -

wajib entri
Nama Proyek nama
Tentukan nama plaintext pendek untuk proyek tersebut.

nama_proyek Apache
nama_proyek CTAN

proyek_url url
Tentukan url yang menunjuk ke 'rumah' proyek.

proyek_url http://www.apache.org/

mirror_list nama file
Tentukan file yang berisi cermin untuk diselidiki.

mirror_list /path/ke/mirror-list

Jika daftar cermin Anda dibuat oleh sebuah program, gunakan

mirror_list /path/ke/program arg1 ... |

Dua format yang didukung:

· polos : garis seperti

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

· apache : baris seperti yang ada di mirrors.list apache

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

Perhatikan bahwa dalam gaya 'polos' item ketiga dicadangkan untuk alamat email opsional :
alamat kontak situs.

Tentukan format yang diperlukan dengan opsi "list_style" (lihat di bawah). Gaya default
adalah 'polos'.

halaman web nama file
Tentukan di mana halaman laporan html ditulis.

ikon nama-direktori
Tentukan direktori tempat ikon dapat ditemukan, relatif terhadap halaman web, atau
relatif terhadap DOCUMENTROOT dari server web.

Jika/ketika halaman web tinggal di direktori ".../mirmon/" dan ikon tinggal di direktori
".../mirmon/icons/", tentukan

ikon ikon

Jika/ketika ikon hidup di "/path/to/DOCUMENTROOT/icons/mirmon/", tentukan

ikon /ikon/mirmon

penyelidikan program + argumen
Tentukan program+args untuk menyelidiki cermin. Contoh:

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

Sebelum program dimulai, %TIMEOUT% dan %URL% diganti dengan yang benar
batas waktu dan nilai url.

Di sini diasumsikan bahwa setiap jam server root menulis stempel waktu di
/path/to/archive/TIME.txt, misalnya dengan entri crontab seperti

42 * * * * perl -e 'waktu cetak, "\n"' > /path/to/archive/TIME.txt

Mirmon membaca satu baris output dari probe dan menafsirkan kata pertama pada itu
baris sebagai stempel waktu; Misalnya :

1043625600
1043625600 Sen 27 Jan 00:00:00 2003
1043625600 www.apache.org Sen 27 Jan 00:00:00 2003

Mirmon didistribusikan dengan program "penyelidikan" yang menangani url ftp, http dan rsync.

negara nama file
Tentukan di mana file yang berisi status ditulis.

Program membaca file ini saat startup dan menulis file saat mirror diperiksa
(-get ditentukan).

negara nama file
Tentukan file yang berisi kode negara; File harus berisi baris seperti

kami - Amerika Serikat
nl - Belanda

Paket mirmon berisi daftar ISO terbaru.

gadungan domain seperti backup, Menguasai diperbolehkan, dan dicantumkan pertama dalam laporan;
domain palsu huruf kecil-pertama (seperti backup) terdaftar terakhir.

opsional entri
max_probes jumlah
Secara opsional, tentukan jumlah probe paralel (default 25).

batas waktu detik
Secara opsional, tentukan batas waktu untuk probe (default 300).

Setelah penyelidikan terakhir dimulai, program menunggu + 10 detik, bersihkan
atas dan keluar.

proyek_logo logo
Secara opsional, tentukan (SRC dari IMG dari) logo untuk ditempatkan di kanan atas halaman.

project_logo /ikon/apache.gif
proyek_logo http://www.apache.org/icons/...

htm_head html
Secara opsional, tentukan beberapa HTML yang akan ditempatkan sebelumnya .

htm_head


htm_top html
Secara opsional, tentukan beberapa HTML untuk ditempatkan di dekat bagian atas halaman.

htm_top pengujian 1, 2, 3

htm_foot html
Secara opsional, tentukan HTML untuk ditempatkan di dekat bagian bawah halaman.

htm_foot




put_histo atas|bawah|tidak ada di mana-mana
Secara opsional, tentukan di mana histogram usia harus ditempatkan. Standarnya adalah 'atas'.

min_jajak pendapat waktu-spesifikasi
Untuk 'min_poll' lihat item berikutnya. A waktu-spesifikasi adalah angka yang diikuti oleh satuan 's'
(detik), atau 'm' (menit), atau 'h' (jam), atau 'd' (hari). Misalnya '3d' (tiga
hari) atau '36 jam' (36 jam).

max_poll waktu-spesifikasi
Secara opsional, tentukan interval probe maksimum. Ketika program dipanggil dengan opsi
'-get update', semua situs diperiksa yaitu:

· baru

situs muncul dalam daftar, tetapi tidak ada status yang diketahui

· buruk

penyelidikan terakhir situs tidak berhasil

· tua

penyelidikan terakhir lebih dari 'max_poll' yang lalu.

Situs tidak diperiksa jika pemeriksaan terakhir kurang dari 'min_poll' yang lalu. Jadi jika kamu
menentukan

min_poll 4j
max_poll 12j

situs 'terjangkau' diperiksa dua kali sehari dan situs 'tidak terjangkau' diperiksa di
paling enam kali sehari.

'min_poll' default adalah '1 jam' (1 jam). 'max_poll' default adalah '4 jam' (4 jam).

min_sinkronisasi waktu-spesifikasi
Secara opsional, tentukan seberapa sering mirror diperlukan untuk melakukan pembaruan.

'min_sync' default adalah '1d' (1 hari).

max_sync waktu-spesifikasi
Secara opsional, tentukan interval sinkronisasi maksimum yang diizinkan.

Situs yang melebihi batas akan dianggap 'lama'. 'max_sync' default adalah '2d' (2
hari).

selalu_get wilayah ...
Secara opsional, tentukan daftar wilayah yang harus selalu diperiksa.

selalu_dapatkan Master Tier1

Ini dimaksudkan untuk gadungan daerah 'like' Menguasai dan sebagainya

tidak_acak
Mirmon mencoba untuk menyeimbangkan beban probe selama mirmon berjalan setiap jam. Jika arus
run memiliki jumlah cermin di bawah rata-rata untuk diselidiki, mirmon memeriksa beberapa tambahan,
cermin yang dipilih secara acak, dipilih dari lintasan yang memiliki beban tertinggi.

Jika Anda tidak menginginkan perilaku ini, gunakan tidak_acak.

tidak_tambahkan_garis miring
Jika bagian url dari sebuah baris di mirror_list tidak diakhiri dengan garis miring ('/'), mirmon menambahkan
garis miring dan mengeluarkan peringatan kecuali dalam mode senyap.

Jika Anda tidak menginginkan perilaku ini, gunakan tidak_tambahkan_garis miring.

list_style polos|apache
Secara opsional, tentukan format ('polos' atau 'apache') dari daftar cermin.

Lihat deskripsi 'mirror_list' di atas. List_style default adalah 'polos'.

alamat URL situs web url
Secara opsional, tentukan url pengganti untuk sebuah situs.

Ketika akses ke suatu situs dibatasi (di Australia, misalnya), yang lain (kadang-kadang
secret) url dapat digunakan untuk menyelidiki situs. NS dari url adalah bagian antara
'://' dan '/' yang pertama.

env kunci nilai
Secara opsional, tentukan variabel lingkungan.

memasukkan nama file
Secara opsional, tentukan file yang akan disertakan.

File yang ditentukan diproses 'in situ'. Setelah file yang ditentukan dibaca dan
diproses, pemrosesan konfigurasi dilanjutkan di file tempat "sertakan" berada
ditemui. Kedalaman yang disertakan tidak terbatas. Namun, itu adalah kesalahan fatal untuk memasukkan
file dua kali dengan nama yang sama.

Menunjukkan
Ketika prosesor konfigurasi menemukan perintah 'tampilkan', itu membuang konten dari
konfigurasi saat ini menjadi menonjol, jika opsi "-v" ditentukan. Ini dimaksudkan untuk
debug.

keluar
Ketika prosesor konfigurasi menemukan perintah 'keluar', itu menghentikan program.
Ini dimaksudkan untuk debugging.

NEGARA FILE FORMAT

File negara terdiri dari baris; satu baris per situs. Setiap baris terdiri dari spasi
bidang yang terpisah. Ketujuh bidang tersebut adalah:

· bidang 1 : url

Url seperti yang diberikan dalam daftar cermin.

· bidang 2: usia

Stempel waktu cermin yang ditemukan oleh penyelidikan terakhir yang berhasil, atau 'undef' jika tidak ada pemeriksaan
pernah sukses.

· bidang 3: status penyelidikan terakhir

Status pemeriksaan terakhir, atau 'undef' jika cermin tidak pernah diperiksa.

· bidang 4: waktu penyelidikan terakhir yang berhasil

Stempel waktu penyelidikan terakhir yang berhasil atau 'undef' jika cermin tidak pernah
berhasil diselidiki.

· bidang 5: menyelidiki sejarah

Sejarah penyelidikan adalah daftar karakter 's' (untuk sukses) dan 'f' (untuk kegagalan)
menunjukkan hasil pemeriksaan. Hasil baru ditambahkan setiap kali cerminnya
diperiksa.

· bidang 6: sejarah negara

Sejarah negara terdiri dari cap waktu, karakter '-', dan daftar karakter yang menunjukkan
status masa lalu: 's' (segar), 'b' (lama), 'f' (lama), 'z' (buruk) atau 'x' (lewati). NS
stempel waktu menunjukkan kapan riwayat status terakhir diperbarui. Status saat ini
cermin ditentukan oleh usia cermin dan beberapa parameter konfigurasi
(min_sync, max_sync, max_poll). Riwayat status diperbarui ketika cerminnya
diperiksa. Jika pembaruan terakhir dari riwayat kurang dari 24 jam yang lalu, status terakhir
digantikan oleh status saat ini. Jika pembaruan terakhir dari riwayat lebih dari 24
jam yang lalu, status saat ini ditambahkan ke riwayat. Satu atau lebih 'lewati' adalah
dimasukkan, jika stempel waktu berumur dua hari atau lebih (ketika mirmon tidak berjalan lebih lama
dari dua hari).

· bidang 7: penyelidikan terakhir

Stempel waktu pemeriksaan terakhir, atau 'undef' jika cermin tidak pernah diperiksa.

INSTALASI

umum
· Catatan: File status (kosong) harus ada sebelum mirmon dijalankan.

· Repositori mirmon ada di sini:

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

· Tarball mirmon ada di sini:

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

instalasi saran
Untuk menginstal dan mengkonfigurasi mirmon, lakukan langkah-langkah berikut:

· Pertama, buat webdir :

cd DOKUMENTROOT
mkdir mirmon

Untuk AKAR DOKUMEN, ganti nama path lengkap dari root dokumen server web Anda.

· Lihat repositori mirmon:

cd /usr/local/src
svn checkout REPO mirmon

dimana

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

atau unduh paket dan buka kemasannya.

· Chdir ke direktori mirmon :

cd mirmon

· Buat file status (kosong):

sentuh state.txt

· Instal ikon di webdir :

mkdir DOCUMENTROOT/mirmon/ikon
ikon cp/* DOCUMENTROOT/mirmon/ikon

· Buat daftar cermin "mirror_list" ;

Gunakan editor favorit Anda, atau buat daftar dari database yang ada.

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

Alamat email adalah opsional.

· Buat file konfigurasi mirmon "mirmon.conf" dengan editor favorit Anda.

# baris harus dimulai di kolom pertama; tidak ada ruang putih terkemuka
Nama Proyek ....
proyek_url ....
mirror_list mirror_list
negara bagian.txt
negara negara.list
halaman web DOCUMENTROOT/mirmon/index.html
ikon /mirmon/ikon
penyelidikan /usr/bin/wget -q -O - -T %TIMEOUT% -t 1 %URL%TIME.txt

Ini mengasumsikan stempel waktu proyek ada di file "TIME.txt".

· Jika Anda memiliki url rsync, ubah baris probe menjadi:

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

· Jalankan mirmon:

perl mirmon -v -dapatkan semua

Laporan mirmon sekarang harus berada di 'DOCUMENTROOT/mirmon/index.html'

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

· Jika/kapan, di kemudian hari, Anda ingin mengupgrade mirmon :

cd /usr/local/src/mirmon
status svn -u
bangun

Gunakan mirmon online menggunakan layanan onworks.net