OpenBMC aracının temel komutları ve işlevleri

OpenBMC aracı, sistem olay günlükleriyle çalışma, sistem sabit yazılımını güncelleme, sistemi tanımlama, sistemi kapatma ve hizmetle ilgili diğer işlevler için destek sağlar.

OpenBMC aracı üst düzey seçenekleri

OpenBMC araç komutlarına ilişkin üst düzey seçenekler hakkında daha fazla bilgi edinin.

Bu görev hakkında

  • -H: BMC ' nin anasistem adı ya da IP adresi.
  • -U: Oturum açılacak kullanıcı adı.
  • -A: Parola istemek için bir bilgi istemi sağlar.
  • -P: Kullanıcı adının parolası.
  • -j: Çıkış biçimini JSON olarak değiştirin.
  • -t: Kullanılmakta olan ilke çizelgesinin yeri.
  • -T: Oturum açmaya, komutu çalıştırmaya ve oturumu kapatmaya ilişkin zaman istatistikleri sağlar.
  • -V: OpenBMC aracının geçerli sürümünü görüntüler.

Sistem olay günlüğü komutları

OpenBMC aracı için sistem olay günlüğü komutlarıyla ilgili daha fazla bilgi edinin.

Yordam

  • Sistem olay günlüklerinin bir listesini okunabilir biçimde yazdırmak için aşağıdaki komutu kullanın:
    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> sel print
  • Sistem olay günlüklerini ham verilerde listelemek için şu komutu kullanın:
    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> sel list
  • Bir sistem olay günlüğünün durumunu çözümlendi olarak değiştirmek için aşağıdaki komutu kullanın:
    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> sel resolve -n x, burada x , sistem olay günlüğü numarasıdır.
  • Sistem olay günlükleri de içinde olmak üzere tüm hizmet verilerini toplamak için aşağıdaki komutu kullanın:

    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> collect_service_data.

  • Donanımı devre dışı bırakmak üzere gard kayıtlarını temizlemek için aşağıdaki komutu kullanın:
    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> gardclear
  • Girdilerin uyarı günlüklerini temizlemek için aşağıdaki komutu kullanın:
    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> sel clear

Sistem sabit yazılımı güncelleme komutu

Sistem sabit yazılımı güncelleme komutu hakkında daha fazla bilgi edinin.

Yordam

  • Sistem sabit yazılımını güncellemek için aşağıdaki komutu kullanın:
    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> firmware flash <bmc or pnor> -f xxx.tar, burada bmc ya da pnor , sisteme yanıp sönmek istediğiniz görüntünün tipidir.
    Not: TAR dosyasıyla aynı klasörde değilseniz, dosyanın bulunduğu klasörün tam yolunu eklemeniz gerekir.
  • BMC ' de bulunan bir sabit yazılım görüntüsünü etkinleştirmek için aşağıdaki komutu kullanın:

    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> firmware activate <firmware image ID>

Sistem tanımlama komutları

Sistem tanımlama komutlarıyla ilgili daha fazla bilgi edinin.

Yordam

  • Mavi sistem tanımlama ışığını etkinleştirmek için aşağıdaki komutu kullanın:

    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> chassis identify on

  • Mavi sistem tanımlama ışığını kapatmak için aşağıdaki komutu kullanın:

    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> chassis identify off

  • Mavi sistem tanımlama ışığının durumunu denetlemek için aşağıdaki komutu kullanın:

    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> chassis identify status

Sistem açma ve kapama komutları

Sistem açma ve kapama komutlarıyla ilgili daha fazla bilgi edinin.

Yordam

  • Sistemin güç durumunu denetlemek için aşağıdaki komutu kullanın:

    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> chassis power status

  • Sistemi açmak için aşağıdaki komutu kullanın:

    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> chassis power on

  • Sistemi olağan bir şekilde kapmak için aşağıdaki komutu kullanın:

    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> chassis power softoff

  • Sistemi hemen kapmak için aşağıdaki komutu kullanın:

    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> chassis power hardoff

Sistem algılayıcı komutları

Sistem algılayıcı komutları hakkında daha fazla bilgi edinin.

Yordam

Tüm izleme algılayıcılarının listesini görüntülemek için aşağıdaki komutu kullanın:

openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> sensors print

veya

openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> sensors list

Sistem FRU komutları

Sistem FRU komutları hakkında daha fazla bilgi edinin.

Yordam

  • Tüm döküm öğelerinin listesini görüntülemek için aşağıdaki komutu kullanın:

    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> fru print

    veya

    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> fru list

  • Tüm FRU öğelerinin bilinen durumunu görüntülemek için aşağıdaki komutu kullanın:

    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> fru status

    Not: FRU öğesi, BMC tarafından değiştirilebilir bir FRU olarak atanmalıdır.
  • FRU durum komutlarının incelenmesini otomatikleştirmek ve sistem üzerinde performans etkisi olup olmadığını belirlemek için aşağıdaki komutu kullanın:

    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> health_check

    Not: Stok öğeleriyle ilişkilendirilmemiş sistem olay günlüğü girişleri olabileceğinden, bu komut sağlıklı bir sistem için garanti vermez.

Sistem BMC sıfırlama komutları

Sistem BMC sıfırlama komutlarıyla ilgili daha fazla bilgi edinin.

Yordam

  • BMC ' yi uzaktan ve AC döngüsü olmadan sıcaklığı sıfırlamak için aşağıdaki komutu kullanın:

    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> bmc reset warm

  • BMC ' yi uzaktan ve AC döngüsü olmadan soğuk ilk duruma getirmek için aşağıdaki komutu kullanın:

    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> bmc reset cold

Sistem döküm komutları

Sistem döküm komutlarıyla ilgili daha fazla bilgi edinin.

Yordam

  • Yeni bir döküm dosyası yaratmak için aşağıdaki komutu kullanın:

    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> dump create

  • Sistemdeki tüm döküm dosyalarını listelemek için aşağıdaki komutu kullanın:

    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> dump list

  • Belirli bir döküm dosyasını sistemden silmek için aşağıdaki komutu kullanın:

    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> dump delete -n <dump file entry>

  • Tüm döküm dosyalarını sistemden silmek için aşağıdaki komutu kullanın:

    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> dump delete all

  • Belirli bir döküm dosyasını almak için aşağıdaki komutu kullanın:

    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> dump retrieve -n <dump file entry>

  • Bir döküm dosyasını almak ve belirli bir dizine kaydetmek için aşağıdaki komutu kullanın:
    openbmctool -U <username> -P <password> -H <BMC IP address or BMC host name> dump retrieve -s <location to save dump file>
    Not: Bir konum belirtmezseniz, dosya geçici dizinde komutun çalıştırıldığı işletim sistemine kaydedilir.

Yerel BMC kullanıcı hesaplarının etkinleştirilmesi ve devre dışı bırakılması

local_userskomutlarıyla ilgili daha fazla bilgi edinin.

Bu görev hakkında

Kök gibi BMC üzerindeki yerel kullanıcı hesapları, local_users alt komutuyla devre dışı bırakılabilir, sorgulanabilir ve yeniden etkinleştirilebilir.
Not: Yerel kullanıcıları devre dışı bıraktıktan sonra, LDAP kullanıcısının OpenBMC aracını kullanarak yerel kullanıcıların etkinleştirilmesi de dahil olmak üzere BMC ile daha fazla etkileşim için kullanılabilir olması gerekir.

Yordam

  • Geçerli yerel kullanıcı hesabı durumunu görüntülemek için şu komutu kullanın:

    openbmctool <connection options> local_users queryenabled

  • Tüm yerel kullanıcı hesaplarını devre dışı bırakmak için şu komutu kullanın:

    openbmctool <connection options> local_users disableall

  • Tüm yerel kullanıcı hesaplarını etkinleştirmek için şu komutu kullanın:

    openbmctool <connection options> local_users enableall

rsyslog kullanılarak uzaktan günlüğe kaydetme

Uzaktan günlüğe kaydetme komutlarıyla ilgili daha fazla bilgi edinin.

Bu görev hakkında

BMC, RSYSLOGkomutunu kullanarak yerel günlükleri (systemd günlüğüne) dışarı akıtabilir. BMC, günlüklerdeki her şeyi gönderir. Her türlü filtreleme ve uygun depolama, rsyslog sunucusunda yönetilmelidir.

Yordam

  • rsyslog sunucusunu uzaktan günlüğe kaydetme için yapılandırmak üzere aşağıdaki komutu kullanın:

    openbmctool <connection options> logging remote_logging_config -a <IP address> -p <port>

    Not: IP adresi ve kapısı uzak rsyslog sunucusu içindir. Komut çalıştırıldıktan sonra, uzak rsyslog sunucusu BMC ' den günlükleri almaya başlar.
  • Uzaktan günlüğe kaydetmeyi devre dışı bırakmak için şu komutu kullanın:

    openbmctool <connection options> logging remote_logging disable

    Not: Uzaktan günlüğe kaydetmeyi, var olan bir uzak sunucudan yeni bir uzak sunucuya geçmeden önce devre dışı bırakın.
  • Uzaktan günlüğe kaydetme yapılandırmasını görüntülemek için aşağıdaki komutu kullanın:

    openbmctool <connection options> logging remote_logging view

    Not: Bu komut, uzak rsyslog sunucusunun IP adresini ve kapısını JavaScript Object Notation (JSON) biçiminde yazdırır.
  • REST API günlük kaydını açmak için şu komutu kullanın:

    openbmctool <connection options> logging rest_api on

  • REST API günlük kaydını kapatmak için şu komutu kullanın:

    openbmctool <connection options> logging rest_api off

    Not: REST API günlük kaydı varsayılan olarak kapalıdır.

Sertifika yönetimi

Sertifika yönetimi komutlarıyla ilgili daha fazla bilgi edinin.

Bu görev hakkında

Var olan sertifika ve özel anahtar dosyasını başka bir (büyük olasılıkla CA imzalı) sertifika ve özel anahtar dosyasıyla değiştirebilirsiniz. Sunucu, istemci ve kök sertifikaları kurabilirsiniz.

Yordam

  • HTTPS sunucu sertifikasını güncellemek için şu komutu kullanın:

    openbmctool <connection options> certificate update server https -f <File>

    Not: <File> , hem sertifikayı hem de özel anahtarı içeren, gizliliği artırılmış posta (PEM) dosyasıdır.
  • LDAP istemcisi sertifikasını güncellemek için aşağıdaki komutu kullanın:

    openbmctool <connection options> certificate update client ldap -f <File>

    Not: <File> , hem sertifikayı hem de özel anahtarı içeren PEM dosyasıdır.
  • LDAP kök sertifikasını güncellemek için şu komutu kullanın:

    openbmctool <connection options> certificate update authority ldap -f <File>

    Not: <File> , yalnızca sertifikayı içeren PEM dosyasıdır.
  • HTTPS sunucu sertifikasını silmek için şu komutu kullanın:

    openbmctool <connection options> certificate delete server https

    Not: Bir sertifikanın silinmesi, kendinden onaylı yeni bir sertifika yaratır ve kurar.
  • LDAP istemcisi sertifikasını silmek için şu komutu kullanın:

    openbmctool <connection options> certificate delete client ldap

  • LDAP kök sertifikasını silmek için şu komutu kullanın:

    openbmctool <connection options> certificate delete authority ldap

    Not: Kök sertifikanın silinmesi LDAP hizmetinin kesilmesine neden olabilir.

LDAP yapılandırması

LDAP yapılandırma komutlarıyla ilgili daha fazla bilgi edinin.

Bu görev hakkında

BMC ' de uzaktan kimlik doğrulaması için LDAP kullanılır. BMC, uzak kullanıcı yönetimi işlevlerini desteklemez. BMC, hem güvenli hem de güvenli olmayan LDAP yapılandırmasını destekler.

Yordam

  • LDAP yapılandırmasını oluşturmak için (güvenli olmayan) şu komutu kullanın:

    openbmctool.py <connection options> ldap enable --uri="ldap://<ldap server IP/hostname>" --bindDN=<bindDN> --baseDN=<basDN> --bindPassword=<bindPassword> --scope="sub/one/base" --serverType="OpenLDAP/ActiveDirectory"

    Not: uri parametresinde tam etki alanı adının ya da anasistem adının yapılandırılması, etki alanı adı sistemi (DNS) sunucusunun BMC ' de yapılandırılmasını gerektirir.
  • LDAP yapılandırmasını (güvenli) oluşturmak için aşağıdaki komutu kullanın:

    openbmctool.py <connection options> ldap enable --uri="ldaps://<ldap server IP/hostname>" --bindDN=<bindDN> --baseDN=<basDN> --bindPassword=<bindPassword> --scope="sub/one/base" --serverType="OpenLDAP/ActiveDirectory"

    Notlar:
    1. Yukarıdaki openbmctool.py komut dizgisini çalıştırdığınızda aşağıdaki hatayla karşılaşılabilir:

      xyz.openbmc_project.Common.Error.NoCACertificate

      Bu hata, BMC istemcisinin LDAP sunucusu sertifikasının bilinen bir sertifika yetkilisi (CA) tarafından imzalandığını doğrulaması gerektiği anlamına gelir. Bu hatayı çözmek için bir yöneticinin CA sertifikasını BMC ' ye yüklemesi gerekir.

    2. OpenBMC aracı, tek tek LDAP yapılandırma özelliği güncellemelerini desteklemez. Tek bir özelliği güncellemek için yöneticinin LDAP yapılandırmasını değiştirilen değerlerle yeniden oluşturması gerekir.
  • LDAP yapılandırmasını silmek için şu komutu kullanın:

    openbmctool.py <connection options> ldap disable

    Not: Komutu çalıştırmadan önce kök kullanıcı etkinleştirilmelidir; tersi durumda, BMC ' ye erişilemez. Tüm yerel kullanıcı hesaplarını etkinleştirmek için bkz. Yerel kullanıcı hesaplarını etkinleştirme ve devre dışı bırakma.
  • Ayrıcalık eşlemesi eklemek için aşağıdaki komutu kullanın:

    openbmctool.py <connection options> ldap privilege-mapper create --groupName=<groupName> --privilege="priv-admin/priv-user"

  • Ayrıcalık eşlemesini silmek için aşağıdaki komutu kullanın:

    openbmctool.py <connection options> ldap privilege-mapper delete --groupName=<groupName>

  • Ayrıcalık eşlemelerini listelemek için aşağıdaki komutu kullanın:

    openbmctool.py <connection options> ldap privilege-mapper list

    LDAP yapılandırması için normal iş akışı aşağıdaki sırada olur:
    1. DNS sunucusunu yapılandırın.
    2. LDAP ' ı yapılandırın.
      1. Güvenli LDAP yapılandırması için CA sertifikasını yapılandırın.
      2. Yerel kullanıcıyla LDAP yapılandırması oluşturun.
    3. Kullanıcı ayrıcalığını yapılandırın.
    Notlar:
    1. LDAP kimlik bilgileriyle oturum açtıktan sonra LDAP kimlik bilgileri için ayrıcalık eşlemesi eklemezseniz, aşağıdaki hata iletisini alırsınız:

      403, 'LDAP grubu ayrıcalık eşlemesi yok'.

      Ayrıcalık eşlemiekleyerek bu hatayı önleyebilirsiniz.

    2. Aşağıdaki hata iletisi, kullanıcının BMC üzerinde yeterli ayrıcalığa sahip olmadığını gösterir:

      Ayrıcalıklar yetersiz

      Ayrıcalık eşlemiekleyerek bu hatayı önleyebilirsiniz.

    3. LDAP ' ı kurduktan sonra, OpenBMC aracı bağlantı seçenekleri hem LDAP hem de yerel kullanıcılarla çalışır.

Ağ yapılandırması

Ağ yapılandırma komutları hakkında daha fazla bilgi edinin.

Yordam

  • DHCP ' yi etkinleştirmek için aşağıdaki komutu kullanın:

    openbmctool.py -H <BMC_IP> -U root -P <root password> network enableDHCP -I <Interface name>

  • DHCP ' yi devre dışı bırakmak için aşağıdaki komutu kullanın:

    openbmctool.py -H <BMC_IP> -U root -P <root password> network disableDHCP -I <Interface name>

  • Anasistem adını almak için aşağıdaki komutu kullanın:

    openbmctool.py -H <BMC_IP> -U root -P <root password> network getHostName

  • Anasistem adını ayarlamak için şu komutu kullanın:

    openbmctool.py -H <BMC_IP> -U root -P <root password> network setHostName -H <host name>

  • Etki alanı adını almak için aşağıdaki komutu kullanın:

    openbmctool.py -H <BMC_IP> -U root -P <root password> network getDomainName -I <Interface name>

  • Etki alanı adını ayarlamak için şu komutu kullanın:

    openbmctool.py -H <BMC_IP> -U root -P <root password> network setDomainName -I <Interface name> -D DomainName1,DomainName2,..

  • Ortam erişim denetimi (MAC) adresini almak için aşağıdaki komutu kullanın:

    openbmctool.py -H <BMC_IP> -U root -P <root password> network getMACAddress -I <Interface name>

  • MAC adresini ayarlamak için aşağıdaki komutu kullanın:

    openbmctool.py -H <BMC_IP> -U root -P <root password> network setMACAddress -I <Interface name> -MA xx:xx:xx:xx:xx

  • Varsayılan ağ geçidini almak için şu komutu kullanın:

    openbmctool.py -H <BMC_IP> -U root -P <root password> network getDefaultGW

  • Varsayılan ağ geçidini ayarlamak için şu komutu kullanın:

    openbmctool.py -H <BMC_IP> -U root -P <root password> network setDefaultGW -GW <default gw>

  • Geçerli ağ yapılandırmasını görüntülemek için aşağıdaki komutu kullanın:

    openbmctool.py -H <BMC_IP> -U root -P <root password> network view-config

  • Ağ saati iletişim kuralını (NTP) almak için aşağıdaki komutu kullanın:

    openbmctool.py -H <BMC_IP> -U root -P <root password> network getNTP -I <Interface name>

  • NTP ' yi ayarlamak için aşağıdaki komutu kullanın:

    openbmctool.py -H <BMC_IP> -U root -P <root password> network setNTP -I <Interface name> -N NTP1,NTP2,...

  • Etki alanı ad sistemini (DNS) almak için aşağıdaki komutu kullanın:

    openbmctool.py -H <BMC_IP> -U root -P <root password> network getDNS -I <Interface name>

  • DNS ' yi ayarlamak için aşağıdaki komutu kullanın:

    openbmctool.py -H <BMC_IP> -U root -P <root password> network setDNS -I <Interface name> -d DNS1,DNS2,...

  • IP adresini almak için aşağıdaki komutu kullanın:

    openbmctool.py -H <BMC_IP> -U root -P <root password> network getIP -I <Interface name>

  • IP adresini ayarlamak için aşağıdaki komutu kullanın:

    openbmctool.py -H <BMC_IP> -U root -P <root password> network addIP -a <ADDRESS> \-gw <GATEWAY> -l <PREFIXLENGTH> -p <protocol type> -I <Interface name>

  • IP adresini silmek için aşağıdaki komutu kullanın:

    openbmctool.py -H <BMC_IP> -U root -P <root password> network rmIP -I <Interface name> -a <ADDRESS>

  • Sanal bir yerel ağı (VLAN) etkinleştirmek için aşağıdaki komutu kullanın:

    openbmctool.py <connection options> network addVLAN -I <Interface name> -n <IDENTIFIER>

  • Bir sanal yerel ağı (VLAN) geçersiz kılmak için aşağıdaki komutu kullanın:

    openbmctool.py <connection options> network deleteVLAN -I <Interface name>

  • DHCP yapılandırma özelliklerini görüntülemek için aşağıdaki komutu kullanın:

    openbmctool.py <connection options> network viewDHCPConfig

  • DHCP özelliklerini yapılandırmak için aşağıdaki komutu kullanın:

    openbmctool.py <connection options> network configureDHCP -d <DNSENABLED> -n <HOSTNAMEENABLED> -t <NTPENABLED> -s <SENDHOSTNAMEENABLED>

    Not: DNSENABLED, HOSTNAMEENABLED, NTPENABLEDve SENDHOSTNAMEENABLED Boole değerleridir (true ya da false).
  • Ağ ayarlarını fabrika varsayılan ayarlarına sıfırlamak için aşağıdaki komutu kullanın:

    openbmctool.py <connection options> network nwReset

    Not: Sıfırlama ayarları, BMC yeniden başlatıldıktan sonra uygulanır.