Manajemen Mailing List di iRedMail via command line (mlmmjadmin)
Script-script yang dapat digunakan untuk melakukan kegiatan manajemen mailing list di iRedMail diletakkan di bawah direktori /opt/mlmmjadmin/tools/. Script-script tersebut merupakan script yang dibuat menggunakan bahasa python, maka untuk dapat mengeksekusi script-script tersebut admin harus berpindah ke direktori tersebut dan mengeksekusi script-script tersebut menggunakan python. Error berikut ini adalah contoh jika script-script tersebut dieksekusi di luar direktori tersebut di atas:
# python3 maillist_admin.py create [email protected] > only_subscriber_can_post=yes disable_archive=no python3: can't open file '/root/maillist_admin.py': [Errno 2] No such file or directory
Respon python3: can’t open file dan seterusnya, merupakan error yang mengindikasikan bahwa script yang coba dieksekusi tidak ditemukan. Jika script-script tersebut ingin dieksekusi dari mana pun tanpa harus berpindah ke direktori /opt/mlmmjadmin/tools/, maka posisi script harus ditulis secara full path, seperti contoh berikut ini:
# python3 /opt/mlmmjadmin/tools/maillist_admin.py create [email protected] only_subscriber_can_post=yes disable_archive=no Created.
Respon Created. merupakan respon bahwa script tersebut di atas berhasil dieksekusi dan berhasil membuat sebuah mailing list baru dengan alamat [email protected].
Membuat Mailing List Baru
Berikut ini adalah perintah pembuatan mailing list baru dengan beberapa setting yang ditentukan di awal.
# python3 maillist_admin.py create [email protected] > only_subscriber_can_post=yes disable_archive=no
Perintah di atas adalah perintah yang digunakan untuk membuat mailing list baru dengan nama [email protected], dengan ketentuan hanya subscriber yang terdaftar dalam mailing list yang dapat mengirimkan pesan baru ke mailing list tersebut. Selain itu perintah di atas juga akan membuat mailing list melakukan pengarsipan pesan yang terkirim melalui mailing list tersebut.
Daftar setting pada sebuah mailing list yang dapat ditentukan, baik saat awal pembuatan maupun ditentukan kemudian menggunakan opsi update, dapat dilihat pada bagian “Menampilkan setting dari mailing list” di poin pembahasan di bawah poin ini.
Berikut ini adalah contoh pembuatan mailing list dengan alamat [email protected] dengan ketentuan seperti tersebut di atas.
# python3 /opt/mlmmjadmin/tools/maillist_admin.py create [email protected] only_subscriber_can_post=yes disable_archive=no Created.
Menampilkan Setting Dari Mailing List
Berikut ini adalah perintah untuk menampilkan semua setting yang diterapkan pada sebuah mailing list.
# python3 maillist_admin.py info [email protected]
Berikut ini adalah contoh setting untuk mailling list dengan alamat [email protected] yang telah dibuat pada poin sebelumnya di atas.
# python3 /opt/mlmmjadmin/tools/maillist_admin.py info [email protected] close_list=no only_moderator_can_post=no only_subscriber_can_post=yes disable_subscription=no disable_subscription_confirm=no disable_digest_subscription=no disable_digest_text=no disable_nomail_subscription=no if_mod_send_only_mod_moderate=yes moderated=no moderate_non_subscriber_post=no disable_retrieving_old_posts=yes only_subscriber_can_get_old_posts=yes disable_retrieving_subscribers=no notify_sender_when_moderated=no notify_owner_when_sub_unsub=no disable_send_copy_to_sender=no disable_notify_subscription_moderated=no disable_notify_when_missing_listaddress=no disable_notify_when_access_denied=no disable_notify_when_subscriber_only=no disable_notify_when_moderator_only=no disable_notify_when_exceeding_max_mail_size=no disable_archive=no tocc=yes enable_newsletter_subscription=no custom_headers=['List-Id: <[email protected]>', 'List-Post: <mailto:[email protected]>', 'List-Subscribe: <mailto:[email protected]?subject=Subscribe>', 'ListUnsubscribe: <mailto:[email protected]?subject=Unsubscribe>', 'Precedence: bulk'] remove_headers=[] extra_addresses=[] owner=['[email protected]'] owners=['[email protected]'] max_message_size= subject_prefix=b'' relay_host= smtp_helo= smtp_port=10027 name=b'' moderate_subscription=no moderators=['[email protected]'] subscription_moderators=[] footer_text=b'' footer_html=b''
Cara memperbarui (update) setting-setting di atas, dibahas pada poin berikutnya.
Memperbarui Setting Mailing List
Berikut ini adalah perintah untuk memperbarui (update) setting-setting pada sebuah mailing list.
# python3 maillist_admin.py update [email protected] > only_moderator_can_post=yes disable_subscription=yes
Contoh di atas mengubah setting mailing list menjadi hanya moderator mailing list yang dapat mengirimkan pesan melalui mailing list tersebut dan mailing list tidak menerima pendaftaran anggota baru (hanya moderator/pemilik mailing list yang dapat menambahkan anggota baru).
Contoh berikut ini akan membuat mailing list yang sebelumnya tidak memerlukan moderasi (moderated=no) menjadi ter-moderasi ( moderated=yes, moderator harus memberikan approval sebelum pesan dikirimkan ke anggota mailing list).
# python3 maillist_admin.py update [email protected] moderated=yes
Menghapus Akun Mailing List
Berikut ini adalah perintah untuk menghapus sebuah mailing list.
# python3 maillist_admin.py delete [email protected]
Sebagai contoh, berikut ini adalah contoh perintah untuk menghapus mailing list dengan alamat [email protected].
# python3 /opt/mlmmjadmin/tools/maillist_admin.py delete [email protected] Removed [email protected] (archived).
Respon Removed [email protected] (archived). merupakan indikasi bahwa perintah di atas berhasil dieksekusi dan mailing list dengan alamat [email protected] telah dihapus. Informasi (archived) yang disebutkan dalam respon perintah di atas karena mailing list tersebut sebelumnya disetting dengan opsi disable_archive=no yang berarti mailing list akan disimpan ke dalam arsip jika dihapus (email-email lamanya tetap tersimpan).
Melakukan Pengecekan Apakah Email Tertentu Menjadi Anggota Di Sebuah Mailing List
Berikut ini adalah perintah untuk melakukan pengecekan apakah sebuah email menjadi anggota pada sebuah mailing list.
# python3 maillist_admin.py has_subscriber [email protected] > [email protected]
Sebagai contoh berikut ini adalah contoh untuk melakukan pengecekan apakah email [email protected] terdaftar sebagai anggota mailing list [email protected].
# python3 /opt/mlmmjadmin/tools/maillist_admin.py has_subscriber [email protected] [email protected] [NO] Mailing list <[email protected]> does NOT have subscriber <[email protected]>.
Respon [NO] Mailing list <[email protected]> does NOT have subscriber <[email protected]>. mengindikasikan bahwa email [email protected] tidak terdaftar sebagai anggota di mailing list [email protected].
Berikut ini adalah contoh lain untuk melakukan pengecekan apakah email [email protected] terdaftar sebagai anggota mailing list [email protected].
# python3 /opt/mlmmjadmin/tools/maillist_admin.py has_subscriber [email protected] [email protected] [YES] Mailing list <[email protected]> has subscriber <[email protected]>.
Respon [YES] Mailing list <[email protected]> has subscriber <[email protected]>. di atas mengindikasikan bahwa alamat email [email protected] terdaftar sebagai anggota mailing list [email protected].
Menampilkan Semua Anggota Pada Sebuah Mailing List
Berikut ini adalah perintah untuk menampilkan semua anggota pada sebuah mailing list.
# python3 maillist_admin.py subscribers [email protected]
Berikut ini adalah contoh untuk melakukan pengecekan daftar anggota pada mailing list [email protected].
# python3 /opt/mlmmjadmin/tools/maillist_admin.py subscribers [email protected] [email protected], (normal) [email protected], (normal) [email protected], (normal)
Respon berupa tiga baris di atas, yaitu :
[email protected], (normal) [email protected], (normal) [email protected], (normal)
merupakan daftar anggota pada mailing list [email protected].
Menampilkan Nama Mailing Apa Saja Yang Diikuti Oleh Satu Alamat Email
Berikut ini adalah perintah untuk melakukan pengecekan mailing list apa saja yang diikuti oleh sebuah alamat email.
# python3 maillist_admin.py subscribed [email protected]
Berikut ini adalah contoh perintah untuk melakukan pengecekan mailing list apa saja yang diikuti oleh email [email protected]. Dengan kata lain perintah berikut ini akan menampilkan di mailing list apa saja email [email protected] terdaftar sebagai anggota.
# python3 /opt/mlmmjadmin/tools/maillist_admin.py subscribed [email protected] [email protected], '(normal)
Dari respon perintah di atas, didapat informasi bahwa email [email protected] terdaftar hanya di mailing list [email protected] saja.
Menambahkan Alamat Email Sebagai Anggota Pada Sebuah Mailing List
Berikut ini adalah perintah untuk menambahkan satu atau beberapa alamat email untuk menjadi anggota pada sebuah mailing list.
# python3 maillist_admin.py add_subscribers [email protected] <mail> <mail> <mail>
Perintah di atas dapat menambahkan satu atau langsung beberapa alamat email sekaligus. Jika lebih dari satu alamat email yang hendak ditambahkan, maka alamat-alamat email tersebut dituliskan berurutan dengan dipisahkan spasi.
Sebagai contoh, berikut ini adalah perintah untuk menambahkan email [email protected], [email protected], dan [email protected] ke dalam mailing list [email protected].
# python3 /opt/mlmmjadmin/tools/maillist_admin.py add_subscribers [email protected] [email protected] [email protected] [email protected] Added.
Respon Added. di atas mengindikasikan bahwa perintah berhasil diekseksui dan tiga alamat email [email protected], [email protected], dan [email protected] berhasil ditambahkan ke mailing list [email protected].
Menghapus Anggota Dari Sebuah Mailing List
Berikut ini adalah perintah untuk menghapus anggota pada sebuah mailing list.
# python3 maillist_admin.py remove_subscribers [email protected] <mail> <mail> <mail>
Sama seperti halnya penambahan anggota mailing list yang dijelaskan pada poin sebelumnya, penghapusan anggota mailing list juga dapat menghapus satu atau langsung beberapa email sekaligus dengan cara menuliskan alamat-alamat email yang akan dihapus secara berurutan dengan dipisahkan spasi.
Berikut ini adalah contoh penghapusan email [email protected], [email protected], dan [email protected] dari mailing list [email protected].
# python3 /opt/mlmmjadmin/tools/maillist_admin.py remove_subscribers [email protected] [email protected] [email protected] [email protected] Removed.
Respon Removed. di atas mengindikasikan bahwa perintah berhasil dieksekusi dan alamat email [email protected], [email protected], dan [email protected] berhasil dihapus dari mailing list [email protected].