man/network
man · Ağ

$ postmulti

Bölüm 1 · Ağ

Postfix çoklu örnek yöneticisi

Sözdizimi

   Çoklu örnek yönetimini etkinleştirme:

       postmulti -e init [-v]

   Yineleyici modu:

       postmulti -l [-aRv] [-g grup] [-i ad]

       postmulti -p [-av] [-g grup] [-i ad] postfix-komutu...

       postmulti -x [-aRv] [-g grup] [-i ad] unix-komutu...

   Yaşam döngüsü yönetimi:

       postmulti -e create [-av] [-g grup] [-i ad] [-G grup] [-I ad] [parametre=değer ...]

       postmulti -e import [-av] [-g grup] [-i ad] [-G grup] [-I ad] [yapılandırma_dizini=/yol]

       postmulti -e destroy [-v] -i ad

       postmulti -e deport [-v] -i ad

       postmulti -e enable [-v] -i ad

       postmulti -e disable [-v] -i ad

       postmulti -e assign [-v] -i ad [-I ad] [-G grup]

Açıklama

postmulti(1) komutu, bir Postfix yöneticisinin tek bir ana bilgisayarda (host) birden fazla Postfix örneğini yönetmesini sağlar.

postmulti(1) iki temel çalışma modu uygular. Yineleyici modunda, birden fazla Postfix örneği için aynı komutu yürütür. Yaşam döngüsü yönetimi modunda ise bir örnek ekler veya siler ya da bir örneğin çoklu örnek durumunu değiştirir.

Her çalışma modunun kendine özgü bir komut sözdizimi vardır. Bu nedenle, her mod aşağıda ayrı bölümlerde belgelenmiştir.

Arka Plan

Çoklu örnek yapılandırması, bir birincil Postfix örneği ile yapılandırma dizini yol adları birincil örneğin main.cf dosyasında kayıtlı olan bir veya daha fazla ikincil örnekten oluşur. Postfix örnekleri program dosyalarını ve belgeleri paylaşır, ancak kendi yapılandırma, kuyruk ve veri dizinlerine sahiptir.

Şu anda, çoklu örnek yapılandırmasında birincil örnek olarak yalnızca varsayılan Postfix örneği kullanılabilir. postmulti(1) komutu şu anda alternatif bir birincil örnek seçmek için bir -c seçeneğini desteklememektedir ve MAIL_CONFIG ortam değişkeni varsayılan olmayan bir yapılandırma dizinine ayarlanmışsa ölümcül bir hata ile sonlanır.

postmulti(1) ile çoklu örnek yönetiminin daha ayrıntılı bir açıklaması için MULTI_INSTANCE_README kılavuzuna bakın.

Yineleyici Modu

Yineleyici modunda, postmulti tüm Postfix örneklerinde sırayla aynı işlemi gerçekleştirir.

Çoklu örnek desteği etkinleştirilmemişse, istenen komut yalnızca birincil örnek için gerçekleştirilir.

Yineleyici modu aşağıdaki komut seçeneklerini uygular:

Örnek seçimi

  • -a: İşlemi tüm örneklerde gerçekleştirir. Varsayılan budur.

-g grup İşlemi yalnızca belirtilen grubun üyeleri için gerçekleştirir.

-i ad İşlemi yalnızca belirtilen ada sahip örnek için gerçekleştirir. Örnek adını veya örneğin yapılandırma dizininin mutlak yol adını belirtebilirsiniz. Birincil Postfix örneğini seçmek için "-" belirtin.

  • -R: Yineleme sırasını tersine çevirir. Bu, "hedef" (sink) örneklerin "kaynak" (source) örneklerden önce başlatıldığı çoklu örnek sistemlerini güncellerken uygun olabilir.

Bu seçenek -p ile birlikte kullanılamaz.

Liste modu

  • -l: Postfix örneklerini örnek adı, örnek grup adı, etkin/devre dışı durumu ve yapılandırma dizini ile birlikte listeler.

Postfix wrapper modu -p postfix-komutu postfix-komutunu yürütmek için postfix(1)'i çağırır. Bu seçenek postfix-wrapper(5) arayüzünü uygular.

• "start" (başlat) benzeri komutlarla, etkinleştirilmemiş örnekler için "postfix check" yürütülür. Komutların tam listesi postmulti_start_commands parametresi ile belirtilir.

• "stop" (durdur) benzeri komutlarla, yineleme sırası tersine çevrilir ve devre dışı bırakılmış örnekler atlanır. Komutların tam listesi postmulti_stop_commands parametresi ile belirtilir.

• "reload" (yeniden yükle) ve başlatılmış bir örnek gerektiren diğer komutlarla, devre dışı bırakılmış örnekler atlanır. Komutların tam listesi postmulti_control_commands parametresi ile belirtilir.

• "status" (durum) ve başlatılmış bir örnek gerektirmeyen diğer komutlarla, komut tüm örnekler için yürütülür.

-p seçeneği ayrıca belirtilen bir örneği veya örnek grubunu başlatmak/durdurmak vb. için etkileşimli olarak da kullanılabilir. Örneğin, yalnızca "msa" grubundaki örnekleri başlatmak için postmulti(1)'i şu şekilde çağırın:

postmulti -g msa -p start

Komut modu -x unix-komutu Belirtilen unix-komutunu tüm Postfix örnekleri için yürütür. Komut; MAIL_CONFIG, command_directory, daemon_directory, config_directory, queue_directory, data_directory, multi_instance_name, multi_instance_group ve multi_instance_enable için uygun ortam ayarlarıyla çalışır.

Diğer seçenekler

  • -v: Hata ayıklama amacıyla ayrıntılı günlük kaydını etkinleştirir. Birden fazla -v seçeneği yazılımın giderek daha ayrıntılı bilgi vermesini sağlar.

Yaşam Döngüsü Yönetimi Modu

-e seçeneği ile postmulti(1), bir Postfix örneği eklemek veya silmek ve mevcut bir örneğin çoklu örnek durumunu yönetmek için kullanılabilir.

Aşağıdaki seçenekler uygulanmıştır:

Mevcut örnek seçimi

  • -a: Bir örnek oluştururken veya içe aktarırken, yeni örneği ikincil örnek listesinin en önüne yerleştirir.

-g grup Bir örnek oluştururken veya içe aktarırken, yeni örneği belirtilen grubun üyesi olan ilk ikincil örnekten önce yerleştirir.

-i ad Bir örnek oluştururken veya içe aktarırken, yeni örneği eşleşen ikincil örnekten önce yerleştirir.

Diğer yaşam döngüsü işlemlerinde, işlemi belirtilen mevcut örneğe uygular. Birincil Postfix örneğini seçmek için "-" belirtin.

Yeni veya mevcut örnek adı ataması -I ad Belirtilen örnek adını mevcut bir örneğe, yeni oluşturulan bir örneğe veya içe aktarılan bir örneğe atar. "-" (örneği "adsız" yapar) dışındaki örnek adları "postfix-" ile başlamalıdır. Bu kısıtlama, sistem dosyalarıyla ad çakışması olasılığını azaltır.

-G grup Belirtilen grup adını mevcut bir örneğe veya yeni oluşturulan ya da içe aktarılan bir örneğe atar.

Örnek oluşturma/silme/durum değişikliği -e eylem Yönetilen örnekleri "düzenler" (edit). Aşağıdaki eylemler desteklenmektedir:

init postmulti(1) komutunun Postfix örneklerini yönetmek için kullanılabilmesinden önce bu komut gereklidir. "postmulti -e init" komutu, aşağıdakileri ayarlayarak birincil örneğin main.cf dosyasını günceller:

multi_instance_wrapper = ${command_directory}/postmulti -p -- multi_instance_enable = yes

Tercih ederseniz bunları başka yollarla da ayarlayabilirsiniz.

create Yeni bir Postfix örneği oluşturur ve bunu birincil örneğin multi_instance_directories parametresine ekler. Yeni örneğin özel dizinleri için varsayılan değerleri oluşturmada kullanılan kısa bir ad vermek için "-I ad" seçeneği önerilir. Örneği bir gruba atamak için "-G grup" seçeneği belirtilebilir, aksi takdirde yeni örnek hiçbir grubun üyesi olmaz.

Yeni örneğin main.cf dosyası, birincil örnekten kopyalanan paylaşılan dosyaların konumlarını belirten parametreleri içeren standart (stock) main.cf dosyasıdır. "Adsız" (nameless) örnekler için, örneği posta günlüklerinde benzersiz şekilde tanımlayacak "postfix-" ile başlayan benzersiz bir "logtag" (günlük etiketi) elde etmek üzere "syslog_name" parametresini manuel olarak ayarlamalısınız. "-I ad" seçeneğiyle örneğe kısa bir ad atamak daha basittir.

İsteğe bağlı "ad=değer" argümanları; örneğin config_directory, queue_directory ve data_directory parametrelerini belirtir. Örneğin:

postmulti -I postfix-mumble \

-G mygroup -e create
config_directory=/my/config/dir
queue_directory=/my/queue/dir
data_directory=/my/data/dir

Bu yol adlarından herhangi biri sağlanmazsa, program karşılık gelen birincil örnek yol adını alarak ve son yol adı bileşenini -I seçeneğinin değeriyle değiştirerek yol adını oluşturmaya çalışır.

Örnek yapılandırma dizini zaten mevcutsa ve hem main.cf hem de master.cf dosyası içeriyorsa, create işlemi örneği olduğu gibi "içe aktarır" (import). Mevcut örnekler için create ve import işlemleri aynıdır.

import Mevcut bir örneği postmulti(1) çoklu örnek yöneticisi tarafından yönetilen örnekler listesine aktarır. Bu, örneği birincil örneğin multi_instance_directories listesine ekler. "-I ad" seçeneği sağlanırsa, örnek için yeni adı belirtir ve örneğin yapılandırma dizini için varsayılan bir konum tanımlamak üzere kullanılır (yukarıdaki create işleminde olduğu gibi). Örneği bir gruba atamak için "-G grup" seçeneği kullanılabilir. "-I ad" seçeneğine dayalı varsayılan yol adını geçersiz kılmak için "config_directory=/yol" argümanı ekleyin.

destroy İkincil bir Postfix örneğini yok eder. Yok edilmeye aday olabilmesi için bir örneğin devre dışı bırakılmış, durdurulmuş olması ve kuyruğunun hiçbir mesaj içermemesi gerekir. Birincil Postfix örneğini yok etme girişimleri, örneği yok etmeden ölümcül bir hatayı tetikler.

Örnek, birincil örneğin main.cf dosyasındaki alternate_config_directories parametresinden kaldırılır ve veri, kuyruk ve yapılandırma dizinleri Postfix sistemi tarafından oluşturulan dosya ve dizinlerden temizlenir. main.cf ve master.cf dosyaları, ilk oluşturulmalarından bu yana değiştirilmiş olsalar bile yapılandırma dizininden kaldırılır. Son olarak, örnek yönetilen örnekler listesinden çıkarılır (deport).

Örneğin özel dizinlerinde başka dosyalar varsa dizinler tamamen silinemeyebilir; yöneticiyi uyarmak için bir uyarı günlüğe kaydedilir. create eylemi aracılığıyla "yeni" (fresh) dizinler kullanılarak oluşturulan bir örneğin, destroy eylemiyle (önce devre dışı bırakılmışsa) tamamen kaldırılması beklenir. Örnek yapılandırma ve kuyruk dizinleri ek dosyalarla (erişim ve yeniden yazma tabloları, chroot hapis içeriği vb.) doldurulmuşsa, örnek dizinleri tamamen kaldırılmayacaktır.

destroy eylemi potansiyel olarak tehlikeli dosya silme işlemlerini tetikler. Örneğin veri, kuyruk ve yapılandırma dizinlerinin doğru ayarlandığından ve değerli herhangi bir dosya içermediğinden emin olun.

deport İkincil bir örneği yönetilen örnekler listesinden çıkarır (deport). Bu, örnek yapılandırma dizinini birincil örneğin multi_instance_directories listesinden siler, ancak hiçbir dosya veya dizini kaldırmaz.

assign Seçilen örneğe yeni bir örnek adı veya yeni bir grup adı atar. "Grup yok" belirtmek için "-G -" ve "ad yok" belirtmek için "-I -" kullanın. Bir örneği "adsız" yapmayı seçerseniz, ilgili main.cf dosyasında uygun bir syslog_name ayarlayın.

enable Seçilen örneği etkin olarak işaretler. Bu, örneğin main.cf dosyasındaki multi_instance_enable parametresini "yes" olarak ayarlamaktan ibarettir.

disable Seçilen örneği devre dışı olarak işaretler. Bu, örneğin "postfix start", "postmulti -p start" vb. komutlarla başlatılmayacağı anlamına gelir. Örnek yine de "postfix -c config-directory start" ile başlatılabilir.

Diğer seçenekler

  • -v: Hata ayıklama amacıyla ayrıntılı günlük kaydını etkinleştirir. Birden fazla -v seçeneği yazılımın giderek daha ayrıntılı bilgi vermesini sağlar.

Ortam

postmulti(1) komutu, belirli bir örnek için istenen komutu yürütmeden önce aşağıdaki ortam değişkenlerini dışa aktarır (export):

MAIL_VERBOSE Bu, -v komut satırı seçeneği mevcut olduğunda ayarlanır.

MAIL_CONFIG Örneğin yapılandırma dizininin konumu.

Yapılandırma Parametreleri

config_directory ('postconf -d' çıktısına bakın) Postfix main.cf ve master.cf yapılandırma dosyalarının varsayılan konumu.

daemon_directory ('postconf -d' çıktısına bakın) Postfix destek programlarını ve arka plan programlarını (daemon) içeren dizin.

import_environment ('postconf -d' çıktısına bakın) Bir Postfix işleminin, Postfix olmayan bir üst (parent) işlemden içe aktaracağı ortam parametrelerinin listesi.

multi_instance_directories (boş) Varsayılan olmayan Postfix yapılandırma dizinlerinin isteğe bağlı bir listesi; bu dizinler, Postfix yürütülebilir dosyalarını ve belgelerini varsayılan Postfix örneğiyle paylaşan ve varsayılan Postfix örneğiyle birlikte başlatılan, durdurulan vb. ek Postfix örneklerine aittir.

multi_instance_group (boş) Bu Postfix örneğinin isteğe bağlı örnek grup adı.

multi_instance_name (boş) Bu Postfix örneğinin isteğe bağlı örnek adı.

multi_instance_enable (hayır) Bu Postfix örneğinin bir çoklu örnek yöneticisi tarafından başlatılmasına, durdurulmasına vb. izin verir.

postmulti_start_commands (start) postmulti(1) örnek yöneticisinin "start" (başlatma) komutları olarak kabul ettiği postfix(1) komutları.

postmulti_stop_commands ('postconf -d' çıktısına bakın) postmulti(1) örnek yöneticisinin "stop" (durdurma) komutları olarak kabul ettiği postfix(1) komutları.

postmulti_control_commands (reload flush) postmulti(1) örnek yöneticisinin, çalışan örnekler üzerinde işlem yapan "control" (kontrol) komutları olarak kabul ettiği postfix(1) komutları.

syslog_facility (mail) Postfix günlük kaydının (logging) syslog tesisi (facility).

syslog_name ('postconf -d' çıktısına bakın) Syslog kayıtlarında işlem adının önüne eklenen bir önek, böylece örneğin "smtpd" değeri "önek/smtpd" (prefix/smtpd) haline gelir.

Postfix 3.0 ve sonraki sürümlerde mevcuttur:

meta_directory ('postconf -d' çıktısına bakın) Birden fazla Postfix örneği arasında paylaşılan postfix-files, dynamicmaps.cf ve çoklu örnek şablon dosyaları main.cf.proto ile master.cf.proto gibi yürütülemez (non-executable) dosyaların konumu.

shlib_directory ('postconf -d' çıktısına bakın) Postfix dinamik olarak bağlı kütüphanelerinin (libpostfix-.so) konumu ve dynamicmaps.cf dosyasında göreli bir yol adına sahip Postfix veritabanı eklentilerinin (postfix-.so) varsayılan konumu.

Dosyalar

$meta_directory/main.cf.proto, standart yapılandırma dosyası $meta_directory/master.cf.proto, standart yapılandırma dosyası $daemon_directory/postmulti-script, yaşam döngüsü yardımcı programı

Ayrıca Bakınız

postfix(1), Postfix kontrol programı postfix-wrapper(5), Postfix çoklu örnek API'si

Benioku (Readme) Dosyaları

Bu bilgileri bulmak için "postconf readme_directory" veya "postconf html_directory" komutunu kullanın. MULTI_INSTANCE_README, Postfix çoklu örnek yönetimi

Tarihçe

postmulti(1) komutu, Postfix 2.6 sürümüyle birlikte sunulmuştur.

Lisans

Secure Mailer lisansı bu yazılımla birlikte dağıtılmalıdır.

Yazar(lar)

Victor Duchovni Morgan Stanley

Wietse Venema IBM T.J. Watson Research P.O. Box 704 Yorktown Heights, NY 10598, USA

POSTMULTI(1)