Bu makalede sizlere HPE ProLiant sunucularda şasi (enclosure) seri numarasını yeniden girme veya düzeltme işlemini tüm ayrıntılarıyla anlatacağım. HPE altyapısında çalışan sistem yöneticileri için bu işlem özellikle donanım değişimi sonrası oluşan seri numarası tutarsızlıklarını gidermek adına kritik öneme sahiptir.
İşlem boyunca;
- Problemin nasıl ortaya çıktığını,
- Hangi araçların kullanılacağını,
- JSON tabanlı komut dosyasının nasıl oluşturulacağını
ve - RESTful Interface Tool (iLOrest) ile nasıl uygulanacağını
adım adım inceleyeceğiz.
Neden Şasi Seri Numarası Düzeltme Gereklidir?
Bir HPE ProLiant sistemi birden fazla FRU (Field Replaceable Unit) bileşenine sahiptir. Bu FRU’lar anakart, güç kaynağı, fan modülü, şasi ve benzeri fiziksel parçaların benzersiz seri (Serial Number) ve parça numarası (Part Number) kimliklerini taşır. Zaman zaman şu senaryolarda bu bilgiler bozulabilir veya sıfırlanabilir:
- Şasi veya node bileşenlerinden biri değiştirildiğinde,
- Firmware güncellemeleri sonrası FRU verileri hatalı yazıldığında,
- Donanım arızası veya ilorest/Redfish API kaynaklı yazılım hataları oluştuğunda.
Bu durumlarda HPE iLO arabirimi üzerinde şasi seri numarası genellikle “1234567890” gibi geçici bir değer olarak görünür. Böyle bir hata hem envanter yönetimi hem de garanti takibi açısından sorun yaratır. İşte bu yüzden orijinal şasi seri numarasının yeniden girilmesi gerekir.
HPE RESTful Interface Tool (iLOrest)
HPE RESTful Interface Tool (kısaca iLOrest), HPE sunucuların yönetimi için kullanılan komut satırı tabanlı bir araçtır.
Bu araç Redfish API aracılığıyla iLO (Integrated Lights-Out) yönetim arabirimine bağlanır ve sistem yapılandırmalarını değiştirmenize olanak tanır.
iLOrest’in Başlıca Özellikleri:
- JSON veya CSV tabanlı veri giriş/çıkışı sağlar.
- Sunucu donanım bilgilerini alabilir, FRU verilerini değiştirebilir.
- Windows, Linux ve macOS üzerinde çalışabilir.
- “login”, “rawpost”, “logout” gibi doğrudan API çağrıları ile esnek yönetim sağlar.
Kurulum Yolu (Varsayılan)
Windows sistemlerde kurulumdan sonra genellikle şu dizine yerleşir:
C:\Program Files\Hewlett Packard Enterprise\RESTful Interface Tool
Not: Eski sürümler (örneğin 3.2.2 öncesi) FRU bilgilerinde hatalı alan yazımı yapabiliyordu.
Bu nedenle HPE en az 3.3 veya üzeri sürüm kullanmanızı önermektedir.
İşleme Başlamadan Önce Gerekenler
Düzeltme işlemine geçmeden önce aşağıdaki kontrolleri tamamladığınızdan emin olun:
- Doğru şasi seri numarası elinizde olmalıdır.
(Bu bilgi genellikle cihaz üzerindeki etiketlerde veya envanter kayıtlarında yer alır.) - iLO erişim bilgilerine (IP, kullanıcı, parola) sahip olmanız gerekir.
- iLOrest aracı kurulu ve yönetici yetkisiyle çalıştırılabilir durumda olmalıdır.
- Sunucu işlem sırasında yoğun yük altında olmamalıdır.
- Güncel iLO firmware sürümü ve iLOrest versiyonu kullanılmalıdır.
Adım Adım Şasi Seri Numarası Düzeltme Süreci
Adım 1: iLOrest Dizini Açın
Komut İstemcisi’ni Yönetici olarak çalıştırın ve iLOrest kurulum klasörüne gidin:
cd "C:\Program Files\Hewlett Packard Enterprise\RESTful Interface Tool"
Adım 2: iLO Arayüzüne Giriş Yapın
Her node (blade) için oturum açmak gerekir.
Aşağıdaki komut ile iLO’ya bağlanın:
ilorest.exe login <ILO_IP> -u <iLOUserName> -p <iLOPassword>
Oturum açıldıktan sonra şu mesaj görünmelidir.
Discovering data… Done
Adım 3: Product ID (Parça Numarası) Bilgisini Öğrenin
Her node’un ürün kimliği (Product ID) bilgisine erişmek için:
ilorest.exe get --selector /redfish/v1/Systems/1/ ProductId
Bu çıktıdaki “ProductId” bilgisini not alın. Bu değer birazdan JSON dosyanızdaki "EnterPartNumber" alanına eklenecektir.
Adım 4: Şasi Seri Numarasını Temin Edin
Orijinal şasi seri numaranız cihaz üzerindeki etiketten veya kayıt sisteminizden alınmalıdır.
Bu değer "EnterSerialNumber" alanına yazılacaktır.
Adım 5: JSON Komut Dosyasını Hazırlayın
Bir metin dosyası açın ve aşağıdaki formatı ekleyin:
{
"path": "/redfish/v1/Chassis/1/Actions/Oem/Hpe/HpeServerChassis.ModifyEnclosureChassisFru/",
"body": {
"EnterPartNumber": "P12345-XYZ",
"EnterSerialNumber": "SN987654321"
}
}
Bu dosyayı şu isimle kaydedin:
Set_Enclosure_PN_SN.json
İpucu:
JSON yapısında fazladan boşluk, eksik tırnak veya yanlış alan adı kullanmayın.
Aksi halde komut yürütülmez ve API 400 (“Bad Request”) hatası döner.
Adım 6: JSON Dosyasını Uygulayın (rawpost Komutu)
Hazırladığınız JSON dosyasını sisteme göndermek için aşağıdaki komutu kullanın:
ilorest.exe rawpost Set_Enclosure_PN_SN.json
Başarılı bir işlemden sonra konsolda şu mesaj görünür:
The operation completed successfully.
Bu, seri numarasının başarıyla güncellendiği anlamına gelir.
Adım 7: Güncellemeyi Doğrulayın
Yeni seri numarasını kontrol etmek için:
ilorest.exe get --selector Chassis. --json SerialNumber
Çıktıda "SerialNumber": "SN987654321" değeri görünüyorsa işlem başarıyla tamamlanmıştır.
Adım 8: Oturumu Kapatın
Her işlem sonunda güvenlik açısından oturumu kapatmayı unutmayın:
ilorest.exe logout
Dikkat Edilmesi Gereken Noktalar
- Redfish Path sunucu modeline göre değişebilir. Bazı modellerde
/Chassis/0/dizini kullanılmaktadır. - iLO erişiminde HTTPS sertifika doğrulaması açık ise, güvenli bağlantı hataları oluşabilir. Gerekirse
--nosslparametresini geçici olarak kullanın. - Bazı FRU alanları sadece sunucu kapalıyken değiştirilebilir.
- Hatalı JSON veya hatalı Part Number girişi, FRU bilgilerini bozabilir. Her zaman orijinal envanter bilgilerinizi yedekleyin.
- Eğer “401 Unauthorized” veya “403 Forbidden” hatası alıyorsanız, kullanıcı hesabınızın Administrator rolünde olduğundan emin olun.
İşlemin Teknik Arka Planı (Redfish API Mantığı)
Bu işlem temelde Redfish REST API üzerinden “POST” metoduyla çalışır.
Aşağıdaki endpoint çağrılır:
POST /redfish/v1/Chassis/1/Actions/Oem/Hpe/HpeServerChassis.ModifyEnclosureChassisFru/
Ve JSON gövdesi (body) şu bilgileri taşır:
{
"EnterPartNumber": "P12345-XYZ",
"EnterSerialNumber": "SN987654321"
}
Bu POST isteği iLO firmware’e FRU (Field Replaceable Unit) güncellemesi komutu gönderir.
iLO bu bilgileri NVRAM (Non-Volatile Memory) alanına yazar ve sonraki sistem yeniden başlatmalarında BIOS tarafından okunur.
Bu işlem tamamlandığında:
- Şasi seri numarası orijinal haline döner.
- HPE InfoSight, OneView veya iLO web arayüzünde doğru envanter bilgisi görünür.
- Garanti kayıtları ve teknik destek doğrulaması sorunsuz şekilde yapılır.
- Envanter sisteminizle (ör. SCCM, SolarWinds vb.) senkronizasyon hataları ortadan kalkar.
