bconf

Canlı yeniden yapılandırma isteklerini sunar, yapılandırma ayarlarını oturum yeniden başlatmadan etkin bellekteki yapılandırma ayarlarını güncelleştirir.

Özet

bconf action object_type=object_name "value_pair[;value_pair...]"] [-c "yorum"] [-f]
bconf hist [-l|-w] [-o nesne_tipi] [-u kullanıcı_adı] [-T zaman_dönemi] [-a işlem] [-f config_file] [history_file]
bconf disable
bconf -h [eylem [nesne_tipi]]
bconf -pack paket_dosyası_adı
bconf -V

İşlem özeti

addmember usergroup | hostgroup | queue | limit | gpool | serviceclass=object_name "value_pair[;değer_çifti ...]" [-c "yorum"]
rmmember usergroup | hostgroup | queue | limit | gpool | serviceclass=object_name "value_pair[;değer_çifti ...]" [-c "yorum"]
update user | usergroup | host | hostgroup | queue | limit | gpool | serviceclass=object_name "value_pair[;değer_çifti ...]" [-c "yorum"]
create usergroup | limit | serviceclass=object_name "value_pair[;value_pair ...]" [-c "yorum"]
delete usergroup | limit | serviceclass=object_name "value_pair[;value_pair ...]" [-c "yorum"] [-f]
set user |usergroup | limit=object_name "value_pair[;value_pair ...]" [-c "yorum"]
add host=object_name "value_pair[;value_pair ...]" [-c "yorum"]

Açıklama

The bconf command is enabled when the LSF_LIVE_CONFDIR parameter is defined in the lsf.conf file.

bconf komutu, LSF ya da herhangi bir yardımcı programı yeniden başlatmaksızın yapılanış değişikliklerine izin verir. Etkin LSF belleğinde değişiklikler yapılır ve güncellenen yapılandırma dosyaları, LSF_LIVE_CONFDIRparametresi tarafından tanımlanan dizine yazılır. Özgün yapılanış kütükleri değiştirilmez. Ancak, LSF yeniden başlatma sırasında LSF_LIVE_CONFDIR dizininde bulunan dosyaları yeniden yükler ya da kalıcı yapılandırma dosyaları yerine yeniden yapılandırma işlemi gerçekleştirmektedir.

Önemli: Canlı yeniden yapılandırmayı etkinleştirmeden önce, tüm yapılandırma dosyalarının hata ya da uyarı iletisi olmadığından emin olmak için badmin reconfig komutunu çalıştırın. Mümkün olan yerlerde, yapılandırma dosyalarındaki birden çok bölümü birleştir. Canlı yeniden yapılandırma ile kullanılan tüm yapılandırma dosyalarındaki yapılandırma dosyası şablonlarında kullanılan kısımların ve sözdiziminin sırasını alıkoy.

bconf komutu kullanılarak yapılan yapılandırma değişiklikleri geriye işlenemez. Yapılandırma isteklerini tersine çevirmek ve istenmeyen yapılandırma değişikliklerini geri almak için bconf komutunu kullanın. You can also manually remove or replace the configuration files in the LSF_LIVE_CONFDIR directory before restart or reconfiguration.

Yeniden başlatmanın ya da yeniden yapılandırma işleminden sonra yürütülen ilk bconf komutu, belleğe yüklenen dosyaları yedekler. bconf komutunun değiştirebileceği tüm dosyalar LSF_LIVE_CONFDIR dizininde yedeklenir ve *.bak dosyaları olarak yedeklenir. Yedekleme dosyaları, bconf komutlarının çalıştırılmadan önce her zaman yapılandırmayı temsil eder.

Küme yöneticileri tüm bconf komutlarını çalıştırabilir. Tüm kullanıcılar bconf hist sorgularını çalıştırabilir. Tüm bconf komut istekleri statik sunuculardan yapılmalıdır.

gpool yöneticileri, karşılık gelen garantili kaynak havuzunu yönetebilir.

kullanıcıpaylaşımları haklarına sahip kullanıcı grubu yöneticileri, kullanıcı paylaşımlarını ayarlayabilirler.

dolu haklarına sahip kullanıcı grubu yöneticileri aşağıdaki yapılandırmaları değiştirebilirler:
  • Kullanıcı paylaşımlarını ve grup üyelerini ayarla
  • Kullanıcı grubunu sil
  • Yeni kullanıcı grupları yarat

dolu haklarına sahip kullanıcı grubu yöneticileri, yalnızca üye kullanıcı grubu için dolu haklarına sahip olması durumunda kullanıcı grubuna bir kullanıcı grubu üyesi ekleyebilirler. bconf create komutu aracılığıyla bir kullanıcı grubu ekleyen kullanıcı grubu yöneticileri, yeni kullanıcı grubu için tam haklara sahip GROUP_ADMIN listesine otomatik olarak eklenir.

Önemli: Remove the configuration files in the LSF_LIVE_CONFDIR directory, or merge files into the LSF_CONFDIR directory before you disable live configuration, upgrade LSF, apply patches to LSF, or add server hosts.

bconf komutu, genel yapılandırma değişikliklerini destekler. bconf komutu tüm yapılandırmaları değiştiremez. Zamana dayalı yapılandırma için genel yapılandırmalar genel olarak değiştirilir ve etkin zaman penceresine ilişkin yapılandırma yalnızca zaman aralığı için değiştirilir.

bconf komutu aşağıdaki yapılandırma dosyalarını değiştirir:

  • lsb.resources
  • lsb.queues
  • lsb.users
  • lsb.hosts
  • lsf.cluster.clustername
  • lsb.serviceclasses
Önemli: Canlı yeniden yapılandırma etkinleştirildiğinde bu yapılandırma dosyalarının el ile değiştirilmesi, bconf komutunu geçersiz kılar. Daha fazla canlı yeniden yapılandırma isteği reddedilir.

The bconf command changes nesneler, or configuration blocks enclosed in Begin and End statements, in the configuration files. Bir bconf isteği, yapılandırılan birkaç nesneyi etkileyebilir. Örneğin, bir sınır ve kuyruk yapılanışındaki bir kullanıcı grubunun silinmesi, sınır ve kuyruk yapılanışını da değiştirir ve aşağıdaki doğrulama iletilerini döndürür:

bconf delete usergroup=ug1
bconf: Request to delete usergroup <ug1> impacts the following:
    <USERS> in limit <limit1>
    <USERS FAIRSHARE > in queue <big_mem_queue>
Are you sure you want to delete usergroup <ug1> (y/n)?

bconf komutuna karşılık gelen API, lsb_liveconfig. Daha fazla bilgi için IBM Spectrum LSF API Referenceadlı belgede yer alan bilgilere bakın.

Altkomutlar ve seçenekler

action object_type=object_name "value_pair[;value_pair...]"] [-c "comment"] [-f]
İşlem
işlem , canlı yeniden yapılandırma tarafından desteklenen, istenen işlemdir. Aşağıdaki anahtar sözcükler bir işlem değeri olabilir: addmember, rmmember, update, create, add, delete, set.
addmember
Bir nesneye üye ekler ya da bir nesnedeki var olan bir alanın listesine eklenir ya da varolan bir üyenin değerini günceller.

tümügibi, ayrılmış sözcükler, ~user1 ya da !host1gibi dışlanan öğeler ya da hostA[01-10] ya da hostA*gibi düzenli ifadelerin tanımladığı üyeler gibi ayrılmış sözcükler ile kullanılamaz.

Var olan bir üyeyle kullanıldığında, üye içinde üyenin değeri güncellenir.

rmmember
Bir üyeden bir üyeyi ya da varolan bir anahtarın (alanın) listesinden bir üyeyi kaldırır.
Kısıtlama: Gruplardan tüm üyeleri kaldıramazsınız ve listelerin tümü ( USER_SHARESdışında) olamaz. Grup ya da liste yalnızca diğerleri, Tümüya da allremotegibi ayrılmış sözcükleri içeremez ya da yalnızca dışlanmış üyeler içerebilir.

rmmember seçeneğini tümügibi, ayrılmış sözcükler, ~user1 ya da !host1gibi dışlanan öğeler ya da hostA[01-10] ya da hostA*gibi düzenli ifadelerin tanımladığı üyeler gibi ayrılmış sözcüklerle kullanamazsınız. badmin hghostadd komutuyla eklenen anasistemler, bconf rmmember komutuyla kaldırılamaz.

güncelleme
Eski değeri yeni değerle değiştirerek ya da önceden yapılandırılmamışsa, alanı ekleyerek güncelleştirilir.

Bir dış kullanıcı grubunu yeniden yüklemek için update usergroup=group_name ya da update hostgroup=group_name komutunu kullanın.

oluştur
Yeni bir nesne yaratır.
ekle
Yeni bir anasistem ekler.
Sil
Varolan bir nesneyi siler.
Bir kullanıcı grubunu aşağıdaki koşullar altında silemezsiniz:
  • Kullanıcı grubu çalışan ya da beklemedeki işleri içerir (denetlemek için busers komutunu çalıştırın)
  • Kullanıcı grubu, lsb.users dosyasındaki bir LSF çok kümeli yetenek UserMap bölümünde görünür.
  • Kullanıcı grubu, lsb.params dosyasındaki DEFAULT_USER_GROUP parametresi tarafından tanımlanan varsayılan kullanıcı grubudur.

Silinen kullanıcı grupları, sonraki restart ya da reconfig komutu çalıştırılıncaya kadar izin verilen kullanıcı grubu sayısı üst sınırına doğru sayılır. Silinen kullanıcı grupları, busers komut çıkışında yine de gösterilebilir.

grup
Bir güncelleme ya da yaratma işlemi zorlar.
object_type
Any block that is enclosed by BeginSection ... EndSection in a configuration file that is changed by a bconf command request. Bir nesne, bir tip ve ad içerir ve dosyanın nesne kısmında tanımlanan alanlar olan, anahtarlaradlı öznitelikleri içerir. Aşağıdaki anahtar sözcükler bir object_type değeri olabilir: user, usergroup, host, hostgroup, queue, limit, gpool. Tüm işlemler tüm nesne tipleri için geçerli değildir.
Kullanıcı
Aşağıdaki işlemler ve anahtar sözcüklerle birlikte kullanılabilir:
  • action - update, set
  • value_pair - lsb.users dosyasında şu anahtar sözcükler: MAX_JOBS, JL/P, MAX_PEND_JOBS
KullanıcıGrubu
Aşağıdaki işlemler ve anahtar sözcüklerle birlikte kullanılabilir:
  • action - addmember, rmmember, update, create, delete, set
  • value_pair - lsb.users kütüğündeki şu anahtar sözcükler: GROUP_MEMBER, JL/P, MAX_JOBS, MAX_PEND_JOBS, PRIORITY, USER_SHARES
anasistem
Aşağıdaki işlemler ve anahtar sözcüklerle birlikte kullanılabilir:
  • eylem - güncelle, ekle
  • value_pair lsb.hosts kütüğündeki şu anahtar sözcükler: MXJ, JL/U, EXIT_RATE, io, it, ls, mem, pg, r15s, r1m, r15m, swp, tmp, ut
  • value_pair - lsf.cluster.clustername dosyasında şu anahtar sözcükler: model, type, resources
anasistem grubu
Aşağıdaki işlemler ve anahtar sözcüklerle birlikte kullanılabilir:
  • action addmember, rmmember, update
  • value_pair - lsb.hosts dosyasında şu anahtar sözcük: GROUP_MEMBER
kuyruk
Aşağıdaki işlemler ve anahtar sözcüklerle birlikte kullanılabilir:
  • action - addmember, rmmember, update
  • value_pair - lsb.queues kütüğündeki şu anahtar sözcükler: UJOB_LIMIT, PJOB_LIMIT, QJOB_LIMIT, HJOB_LIMIT, FAIRSHARE
sınırı
Aşağıdaki işlemler ve anahtar sözcüklerle birlikte kullanılabilir:
  • action - addmember, rmmember, update, create, delete
  • value_pair - lsb.resources dosyasındaki şu anahtar sözcükler: QUEUES, PER_QUEUE, USERS, PER_USER, HOSTS, PER_HOST, PROJECTS, PER_PROJECT, SLOTS, SLOTS_PER_PROCESSOR, MEM, TMP, SWP, JOBS, RESOURCE
gpool
Aşağıdaki işlemler ve anahtar sözcüklerle birlikte kullanılabilir:
  • action - addmember, rmmember, update
  • value_pair - lsb.resources dosyasında şu anahtar sözcük: DISTRIBUTION
serviceclass
Aşağıdaki işlemler ve anahtar sözcüklerle birlikte kullanılabilir:
  • action - create, delete, update, addmember, rmmember
  • value_pair - lsb.serviceclasses kütüğündeki şu anahtar sözcükler: ACCESS_CONTROL, DESCRIPTION
nesne_adı
Var olan nesnenin ya da yaratılmakta olan nesnenin adı.
değer_çifti
Anahtar (nesne özniteliği) ve bir bconf komut isteğinde kullanılan izin verilen değerler. The değer_çifti has the form keyword=value, and it uses the same keywords and syntax as in LSF configuration files. Not all LSF configuration keywords can be used with all actions.

Birden çok değer_çifti girişini ayırmak için noktalı virgül kullanın. Use a dash - or empty parentheses () to reset keywords to default values, depending on the keyword in the LSF configuration files.

For more information about allowed actions, objects, and keywords, use the help command bconf -h action object.

Örnekler
bconf -h addmember hostgroup
bconf addmember hostgroup=hgroupA "GROUP_MEMBER = host1"

bconf rmmember hostgroup=hgroupA "GROUP_MEMBER=host1 host2"

bconf update host=host1 "MXJ=10; JL/U=5"

bconf create usergroup=groupA "GROUP_MEMBER=(elaine tina toby); USER_SHARES=([elaine,10] 
[default,5]); MAX_JOBS=500; MAX_PEND_JOBS=10000"

bconf rmmember queue=normal "FAIRSHARE=USER_SHARES[[joe, 10]]"

bconf addmember serviceclass=sla2 "ACCESS_CONTROL=QUEUES[normal]"

-c "açıklama"
liveconf.hist dosyasında bir yönetici açıklaması olarak yorum metnini günlüğe kaydeder. Açıklama dizgisinin uzunluk üst sınırı 512 karakterdir. Açıklama ' yı çift tırnak içine yerleştirin ve yeni satır karakterini (\n) eklemeyin.
-f
Etkileşimi devre dışı bırakır ve bconf delete komut isteklerini doğrulama olmadan çalıştırıp zorlar. Yalnızca sil işlemi için geçerlidir.
hist [-l|-w] [-o nesne_tipi] [-u kullanıcı_adı] [-T zaman_dönemi] [-a işlem] [-f config_file] [history_file]
Queries the bconf command history file liveconf.hist located under the $LSB_SHAREDIR/cluster_name/logdir directory, or queries a specific history file (geçmişlik_dosyası). Çıkış, belirtilen ölçütlere göre süzgeçten geçirilir. Varsayılan değer olarak, yalnızca yürürlükteki kullanıcı tarafından yapılan bconf komut istekleri görüntülenir.
-l
Uzun görüntü biçimi.
-w
Geniş görüntü biçimi.
-o nesne_tipi
Belirtilen nesne_tipi' yi içeren girdileri görüntüler. Şu object_type değerleri desteklenir: user, usergroup, host, hostgroup, queue, limit, gpool, serviceclass.
-u kullanıcı_adı
Belirtilen kullanıcıtarafından yapılan isteklere ilişkin girdileri görüntüler. Tüm kullanıcılardan bconf komut isteklerini görüntülemek için -u all seçeneğini belirleyin.
-T zaman_dönemi
Girdileri, belirtilen zaman dönemi içinde görüntüler. Sözdizimi için, bhist komut başvuruunda "Time Interval Format" (Zaman Aralığı Biçimi) başlıklı konuya bakın.
-a işlem
Belirtilen işlemiiçeren girdileri görüntüler. Aşağıdaki işlem değerleri desteklenir: addmember, rmmember, update, create, add, delete.
-f config_file
Belirtilen config_filedosyasını içeren girdileri görüntüler. Şu config_file değerleri destekleniyor: lsb.resources, lsb.queues, lsb.users, lsb.hosts, lsf.cluster.clusternameya da lsb.serviceclasses.
history_file
Belirtilen geçmiş dosyasındaki girişleri görüntüler. Varsayılan olarak, geçmiş dosyası liveconf.histolur.
Devre Dışı Bırak
Blocks all bconf command requests until the next reconfiguration or restart of daemons with the badmin reconfig, badmin mbdrestart, or lsadmin reconfig commands (for manual changes to lsf.cluster file). Geçerli yapılandırmaya karşılık gelen dosyaları düzenlediğinizden emin olmak için yapılandırmayı el ile değiştirmeden önce devre dışı bırak seçeneğini kullanın. Yalnızca birincil küme yöneticisi canlı yeniden yapılandırmayı devre dışı bırakabilir.
-h [işlem [nesne_tipi]]
Komut kullanımını stderr ve çıkışlara yazdırır. Her nesne tipiyle birlikte kullanılabilecek işlemler, nesneler ve anahtar sözcükler hakkında ek bilgi için kullanılır.
bconf -h action
Belirtilen işlem için izin verilen nesne tiplerini listeler.
bconf -h action object_type
Belirtilen işlem ve nesne_tipiiçin izin verilen değer çiftlerini listeler. Hem işlem , hem de nesne_tipi belirtilirse, -h seçeneğini atlayabilirsiniz.
-pack
Birden çok isteği okur ve bunları aynı anda mbatchd ' e gönderir. bconf , her bir satır tek bir bconf isteğiyle metin dosyasını okur ve ayrıştırır. Ancak, istekler bir arada gruplanır ve bir kerede mbatchd ' e gönderilir. İstekteki bir satır başarısız olursa, bconf -pack o satırda durur.
-v
LSF yayın sürümünü stderr ' e yazdırır ve çıkar.

bconf hist varsayılan çıkışı

The bconf hist command displays the bconf command events in shortened form, without comments or details of affected objects. Sütun içeriği gerektiği şekilde kısaltılır ve yıldız işaretiyle işaretlenir (*).

ZAMAN
bconf isteğinin saati.
Nesne
Belirtilen nesnenin tipi.
AD
Belirtilen nesnenin adı.
İŞLEM
Nesne üzerinde gerçekleştirilen işlem.
KULLANICI
bconf isteğini yapan kullanıcı.
IMPACTED_OBJ
bconf isteğinin bir sonucu olarak değiştirilen tüm nesneler.
bconf hist -u all
TIME                 OBJECT    NAME   ACTION   USER   IMPACTED_OBJ 
Nov 9 15:19:50 2010  limit     aaa    create   ellen  limit=aaa 
Nov 9 15:19:46 2010  limit     aaa    update   leyang limit=aaa 
Nov 9 15:19:37 2010  usergroup ug1    delete   ellen  queue=normal owners* 
                                                      limit=bbb
                                                      usergroupr=ug1
Nov 9 15:19:28 2010  queue     normal update   leyang queue=normal 
Nov 9 15:19:10 2010  host      host1  update   ellen  host=host1 

bconf hidst geniş çıkış (-w)

Geniş çıkış aynı kolonları görüntüler, ancak kolon içeriğini kesmeden görüntüler.
bconf hist -w
TIME                 OBJECT    NAME    ACTION   USER     IMPACTED_OBJ 
Nov  9 15:19:50 2011 limit     aaa     create   ellen    limit=aaa 
Nov  9 15:19:46 2011 limit     aaa     update   leyang   limit=aaa 
Nov  9 15:19:37 2011 usergroup ug1     delete   ellen    queue=normal owners q1 q2 q3; limit=bbb; 
usergroup=ug1

bconf hst long output with the -l option

Uzun çıkış, etkilenen her nesnenin yeni değeri de içinde olmak üzere, istenen bconf komutu olaylarına ilişkin tüm ayrıntıları görüntüler. Değiştirilen yapılanış kütüklerinin adları içerilir.
bconf hist -l
Mon Nov 18 15:19:45 2009: Limit <aaa> created by user <admin1> with requested values 
<PER_HOST=all; RESOURCE=[A,5]; USERS=ug1 ug2 ug3> and comments <This is an example of a create
 action on a limit object named aaa.>
Changes made:
Limit <aaa> created in lsb.resources with <PER_HOST=all; RESOURCE=[A,5]; USERS=ug1 ug2 ug3>
---------------------------------------------------------
Mon Nov 18 15:19:45 2009: Usergroup <ug1> deleted by user <admin1> with comments <This is an 
example of a delete action on a usergroup object named ug1.>
Changes made:
Usergroup <ug1> deleted in lsb.users
Limit <aaa> updated in lsb.resources with <USERS=ug2>
Queue <owners> updated in lsb.queues with <USERS=ug2 ug3>
---------------------------------------------------------
Mon Nov 18 15:19:45 2009: Queue <q1> updated by user <admin2> with requested values 
<FAIRSHARE=USERSHARE[[ellen, 2]];QJOB_LIMIT=10> and comments <This is an example of an update
 action on a queue object named q1.>
Changes made:
Queue <q1> updated in lsb.queues with <QJOB_LIMIT=10>
---------------------------------------------------------
Mon Nov 18 15:19:45 2009: Limit <aaa> member added by user <admin2> with requested values 
<USERS=julie> and comments <This is an example of an addmember action on a limit object named 
aaa.>
Changes made:
Limit <aaa> updated in lsb.resources with <USERS=ellen user4 julie>
---------------------------------------------------------
Wed Jul 28 17:16:28 2010: Host <host78> added by user <usr9> with requested value <mem=500/100>
Changes made:
Host <host78> added in <lsf.cluster.x123> with <hostname=host78>
Host <host78> added in <lsb.hosts> with <HOST_NAME=host78; MXJ=!; mem=500/100>
---------------------------------------------------------
Wed Jul 28 17:17:08 2010: Host <host78> updated by user <usr9> with requested value <mem=500/100>
Changes made:
Host <host78> updated in <lsb.hosts> with <mem=500/100>

Tanılama

Komut doğru şekilde çalıştırıldıysa, çıkış kodu0. Negatif bir çıkış kodu, hata içeren anahtar-değer çiftlerinin sayısını içerir.

Ayrıca bkz.

lsb.queues, lsb.hosts, lsb.resources, lsb.serviceclasses, lsb.users, lsf.cluster, lsf.conf