Hypermail

Dodi Maryanto 13295044
Dosen: Onno W. Purbo

Hypermail adalah sebuah software sederhana yang bertujuan untuk mengarsipkan 
sebuah mailing list ke dalam halaman sebuah web. Dalam mailinglist, mail-mail 
yang sudah dibaca biasanya dihapus, namun ada kalanya mail yang telah terhapus 
tadi ternyata diperlukan untuk hal lain. Agar mail-mail dalam mailinglist 
tidak hilang begitu saja, dibuatlah sebuah program sederhana yang mempunyai 
interface web yang berguna untuk mengarsipkan mail-mail tadi. Untuk melihat 
arsip, tinggal buka netscape dan dapat dicari mail mana yang dibutuhkan.

Hypermail dapat diinstall dengan 3 cara. Penulis memakai unix jenis FreeBSD 
yang memungkinkan untuk menginstall dengan 3 cara tadi. Cara mengintall yang 
dibahas dalam tulisan ini adalah : manual, dengan menggunakan port dan yang 
terakhir pkg_add.Tiga cara ini mempunyai tingat kesulitan yang berbeda, namun 
sebaiknya cara manual-lah yang sebaiknya dipilih karena dengan demikian 
dapat diketahui apa saja yang ditambahkan ke dalam sistem dan apabila 
terdapat kegagalan , lebih mudah untuk mencari letaknya dan pada akhirnya 
lebih mudah menyelesaikannya.

Untuk menginstall hypermail , persyaratannya :

1. System operasi Unix
2. System sudah menjadi web server atau mejalankan httpd (www.apache.org)
3. System berfungsi sebagai mail server (www.sendmail.org atau www.qmail.org).
3. Mempunyai software kompresi tar dari GNU (ftp.gnu.org). 
4. Mailling list yang akan diarsipkan harus mempunyai format Mailbox sedangkan
   format seperti maildir belum disupport.

Hypermail dapat diambil pada ftp://ftp.landfield.com/hypermail atau di 
ftp://ftp.faqs.org/hypermail. Untuk informasi terbaru tentang hypermail dapat 
mendatangi http://www.eit.com/software/hypermail/hypermail.html.

Cara I : Manual
Untuk cara manual, hal yang dilakukan semuanya dengan tangan, tanpa 
menggunakan script yang sudah jadi. Bebeda dengan cara ke-2 dan 3 yang sudah 
mengotomatiskan semuanya. Cara ini dimulai dari :

1. Ambil paket software hypermail pada ftp site yang disebutkan diatas.
   Paket hypermail masih berbentuk source code, jadi masih perlu dicompile.

2. Uncompress file yang didownload tadi, dengan cara :
   # zcat hypermail-1.02.tar.gz |tar xvf -

3. Edit file config.h untuk menyesuaikan konfigurasi. Biasanya file ini di 
   biarkan seperti semula. Dengan konfigurasi default ini, hypermail berjalan 
   tanpa masalah.

4. Setelah itu, paket hypermail tinggal dicompile dengan mengetikkan :
   # make
   # make install

5. Untuk memulai hypermail bekerja, dokumentasi perlu dibaca dulu. Hypermail
   membutuhkan file konfigurasi. Option-optionnya dapat dibaca secara lengkap
   pada entry manual ( # man hypermail) atau pada /usr/local/share/
   doc/hypermail/hypermail.html . 

Cara II : memakai port.
Pada freebsd, secara optional mempunyai sekumpulan port yang diletakkan pada 
/usr/ports. Ports adalah sekumpulan aplikasi yang dapat dijalankan di freebsd 
dan ports itu sendiri menyediakan cara yang mudah untuk menginstall 
aplikasi-aplikasi tersebut. Masing-masing aplikasi mempunyai direktory port 
sendiri. Untuk menginstall hypermail memakai port, mudah saja, yaitu :

1. Masuk ke direktory dimana port hypermail berada.
   # cd /usr/ports/www/hypermail
   Hypermail yang sudah diporting adalah versi 1.02 .

2. Compile dan install, dengan mengetikkan :
   # make
   # make install

3. Binary dan manual sudah terinstall dan letaknya dapat dilihat pada 
   /usr/ports/www/hypermail/work/hypermail-1.02.orig/Makefile .

Cara III: memakai pkg_add.
Pkg_add merupakan cara menginstall paket software (aplikasi) yang sudah 
dikompile dulu sebelumnya. Jadi yang dilakukan oleh pkg_add adalah meletakkan 
file binary dan manual (kalau ada) pada tempat defaultnya. Untuk menggunakan 
pkg_add cukup sederhana , yaitu :

1. Ambil paket hypermail yang sudah dikompile untuk freebsd yang didapatkan 
   dari ftp.freebsd.org/pub/FreeBSD/packages-stable/All .

2. Setelah diambil, tinggal ketik :
   # pkg_add nama_pkg.tar.gz

Kedua langkah diatas dapat digantikan oleh :
1. # /stand/sysinstall

2. Dari menu yang ditampilkan pilih untuk mengintall packages dan tulis lengkap
   ftp site yang akan dituju untuk mengambilnya. Setelah itu pilih nama packges
   yang terletak pada direktory www .
   Setelah download selesai, maka secara otomatis akan di-pkg_add oleh   
   sysinstall. 

Konfigurasi Hypermail

Setelah file-file binary dan manual telah tercopy ke hardisk, maka yang perlu 
diperhatikan selanjutnya membuat file konfigurasi agar hypermail dapat bekerja 
sesuai dengan yang diinginkan.

Hal pertama sebelum memulai konfigurasi, perlu ditambahkan sebuah user yang 
bernama hypermail yang akan berlangganan mailinglist tertentu. Hal ini 
dilakukan dengan :
# adduser
Environment utk user ini agar aman , tidak perlu diberikan shell. Untuk 
mensubscribe sebuah mailinglist dapat dipergunakan account yang lain.
Option-option yang digunakan dalam hypermail dibedakan lagi menjadi beberapa, 
yaitu :

1. Input / Ouput
   Untuk mengambil mail yang akan diarsipkan, hypermail perlu ditunjuk ke 
sebuah direktory dimana terdapat mail-mail yang dimaksudkan. Mail-mail ini 
harus mempunyai format mailbox (merujuk pada RCF 822) . Jenis optionnya :
-i                      : mail diambil dari standard input, seperti crt.
-m "nama_mailbox"       : mail diambil dari mailbox . Perhatian : 
                          option -m dan -i tidak dapat dipakai bersamaan.
-d "nama_direktory"     : merupakan nama direktory yang akan dipakai untuk 
                          menyimpan arsip    
-c "nama_file"          : hypermail akan membaca file konfigurasi 
                          sesuai dengan nama yang diberikan.

Contoh pernggunaan :
   1. hypermail -m "/home/hypermail/mail/ARC" -d "/data/arsip/ARC"
      Ini menyatakan bahwa hypermail akan membaca arsip dari /home/hypermail
      /mail/ARC (format mailbox) dan akan menyimpannya di /data/arsip/ARC .

   2. cat "/var/mail/hypermail" |hypermail -i -d "/data/arsip/ARC"
      Artinya bahwa hypermail akan membaca mail spoolnya pada direktory 
      /var/mail/hypermail dan menampilkannya di monitor (CRT) dan akan diarsip
      diletakkan pada /data/arsip/ARC .

2. Interface arsip
   Option pada bagian ini memberikan sebuah nama kepada arsip dan memberikan 
link-link ke bagian arsip yang lain. Optionnya adalah :
-l "nama_label" : memberikan nama kepada sebuah arsip
-b "nama_URL"   : arsip yang telah diberi nama tadi dapat diberikan keterangan
                  tambahan informasi tentang apakah arsip maillinglist ini.
-a "nama_URL"   : arsip tambahan yang ada (selain yang sedang dibuat) dapat
                  dibuatkan linknya dengan menambahkan nama URL-nya.

Contoh penggunaan :
   1. hypermail -l "ARC-LIST" -b "http://www.arc.itb.ac.id/arsip/tentang.html"
      -a "http://www.ee.itb.ac.id/maillinglist"
      Command ini menyatakan mailing yang diarsipkan bernama ARC-LIST dan infor
      masi tentang ini didapatkan dari www.arc.itb.ac.id/arsip/tentang.html  
      serta link lainnya didapatkan pada www.ee.itb.ac.id/maillinglist .

3. Updating
   Hypermail mempunyai beberapa metode untuk memperbaharui arsipnya. Yang 
pertama yaitu menghapus semua arsip dan mengulanginya lagi dari awal. Hal ini 
dilakukan untuk merewrite arsip yang sudah tidak diperlukan lagi atau pun 
rusak. Yang lainnya yaitu memperbaharui arsip per kedatangan mail yang baru. 
Option yang digunakan :
-x      : merewrite semua arsip yang ada
-u      : menambahkan file html satu persatu ke dalam arsip dan juga
          memperharui indexnya.

Contoh pernggunaan :
   1. hypermail -x -m "/home/hypermail/ARC" -d "/data/arsip/ARC-LAMA"
      Semua yang ada di /data/arsip/ARC-LAMA dihapus oleh file-file
      baru yang didapatkan dari /home/hypermail/ARC .
   2. hypermail -u -m "/home/hypermail/ARC -d "/data/arsip/ARC-LAMA"
      Sama seperti diatas, namun pembaharuan dilakukan satu persatu dan
      tidak menghapus file yang lama.

4. Misc
   Hanya ada satu option yaitu -p , yang memperlihatkan progres yang 
dikerjakan oleh hypermail.

Menjalankan hypermail dapat dilakukan secara otomatis dengan menggunakan cron 
atau pun aliases. untuk menggunakan cron dapat diset agar hypermail dijalankan 
setiap 1 jam untuk mengarsipkan mail-mail yang baru (ada atau pun tidak).
Sedangkan untuk aliases dapat ditambahkan pada /etc/aliases , line berikut ini:
# hypermail aliases 
list : hypermail "|hypermail -u -m "/home/hypermail/mail/ARC" -d  
"/data/arsip/ARC" -l "ARC_LIST" "

Setelah file aliases diedit, perlu dijalankan perintah newaliases untuk 
memperbaharuinya. Setelah itu hypermail akan berjalan secara otomatis setiap 
ada mail baru yang datang.