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]İşlem özeti
addmember usergroup | hostgroup | queue | limit | gpool | serviceclass=object_name "value_pair[;değer_çifti ...]" [-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.
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.
- 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.
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
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.
Örneklerbconf -h addmember hostgroupbconf 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)
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=ug1bconf hst long output with the -l option
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