Yeni bir düğümü hizmete alma

Kümeler düğüm eklenerek büyür. Donanımın kurulumu, düğüme sistemin kurulması ve düğümün kümeye kabulü vStack Center dışında, kurulum süreci ve Cluster Manager aracılığıyla gerçekleşir. vStack Center prosedüre daha sonra, düğüm kümeye zaten görünür olduğunda ancak henüz iş yükü çalıştırmadığı, envanteri çıkarılmadığı ve disklerini kullanıma sunmadığı aşamada dahil olur.

Sorumluluklar kesin olarak ayrılmıştır. Cluster Manager küme üyeliğini ve düğüm durumlarını yönetir; vStack Center onun görünümünü gösterir ve komutları ona iletir. Düğüm aracısı donanımı, paket sürümlerini ve sistem ayarlarını bildirir. Bunlar vStack Center veritabanında saklanır ve düğüm kartında gösterilir.

Bu nedenle bir düğümle yapılan tüm işler iki aşamada gerçekleşir. Envanter ve yazılım sürümlerinin toplanması düğüm aracısına verilen bir komuttur ve komutun kendisi sonucu bildirmez. Sonuç, düğüm geri bildirimde bulunduğunda ekranda daha sonra görünür. Verilerin ne kadar güncel olduğunu kontrol etmek için Last_seen sütununu kullanın: bu sütun düğümün en son ne zaman bildirimde bulunduğunu gösterir.

Yeni bir düğümdeki diskler birbirinden bağımsız iki adımdan geçer ve bunları karıştırmak pahalıya mal olabilir. Bir diski çevrimiçi yapmak, onu tüm küme düğümlerine görünür kılar. Bu, diski bir ZFS havuzunun üyesi yapmaz: havuz düğümde oluşturulur ve vStack Center bu işlemi sağlamaz.

Düğümü hizmete alma aşaması	Gerçekleştiren	Nerede gerçekleştirilir
Donanım kurulumu, sistem kurulumu, kümeye kabul	Kurulum süreci ve Cluster Manager	vStack Center dışında — vStack OS belgelerine bakın
Düğümün iş yükü kabul etmesini etkinleştirme	vStack Center'dan gelen komutla Cluster Manager	Web arayüzünde kullanılamaz — API'yi kullanın
Donanım ve yazılım sürümlerini toplama	Düğüm aracısı	Düğüm kartı: Hardware bölümü, Software düğmesi
Sistem ayarlarını hizalama	Düğüm aracısı	Düğüm kartı: Configure düğmesi
Diskleri kümede çevrimiçi yapma	Düğüm aracısı	Web arayüzünde kullanılamaz — API'yi kullanın
Düğümün disklerinden bir ZFS havuzu oluşturma	Düğüm	vStack Center'da kullanılamaz
Düğümde havuz servisini başlatma	Cluster Manager	Havuz kartı: Actions → Start pool
Küme kapasitesini doğrulama	vStack Center	Overview, Server Nodes, Storage Resources ekranları

Ön koşullar

• Bu prosedürdeki her işlem için, ana bilgisayar verilerinin toplanması da dahil olmak üzere gerekli olan Cluster master rolü (role_id=1);
• feature.hardware_inventory bayrağı: bu bayrak olmadan toplanan envanter ve çekirdek kullanımı gösterilmez;
• feature.physical_disc_management bayrağı: bu bayrak olmadan disklerin listelenmesi, göstergelerin yakılması, bir diskin kümede çevrimiçi yapılması ve bir diskin yedek olarak işaretlenmesi dahil fiziksel disk işlemleri kullanılamaz;
• feature.node_config_management bayrağı: bu bayrak olmadan düğüm ayarları ve yazılım sürümlerinin toplanması kullanılamaz;
• Düğüm kümeye zaten kabul edilmiş ve Server Nodes tablosunda görünür olmalıdır;
• Yeni düğümün disklerinin seri numaralarının listesi: diskler seri numarasına göre doğrulanır;
• vStack Center 3.0.5 sürümü.

Etkin bayraklar küme seçeneklerinde listelenir. Bunları orada kontrol edin.

Adım 1. Düğümün kümeye görünür olduğundan emin olun

Mevcut durumu okuyarak başlayın. Düğüm Cluster Manager'ın görünümünde ortaya çıkana kadar, onu hizmete almaya yönelik hiçbir komutun hedefi olmaz.

1. Provider Data Center → Server Nodes bölümünü açın. Yeni düğüm tabloda ID, Name, Health, CPU (Cores) ve RAM (GB) sütunlarına sahip yeni bir satır olarak ve bilinen node01…node05 sekmelerinin yanında ayrı bir sekme olarak görünür.
2. Düğümün ID değerini kaydedin: bu değere daha sonra hem komutlar hem de doğrulama için ihtiyacınız olacak.
3. Health değerini kontrol edin. Bir düğümün birbirinden bağımsız iki durum değerlendirmesi vardır: yöneticinin izin verdiği ve fiilen gerçekleşen. Bu ikili "Küme, düğümler ve servisler" sayfasında açıklanmıştır.

Tablonun içeriğini Cluster Manager sağlar. Tablo boşsa ve ekran bir durum alma hatası bildiriyorsa, küme üyeliği verileri kullanılamıyor demektir. Cluster Manager'ın erişilebilirliğini kontrol edin ve düğümü hizmete almaya başlamayın.

Adım 2. Düğümün iş yükü kabul etmesini etkinleştirin

Bir düğümü hizmete almak yönetimsel izin verir; düğümü başlatmaz. vStack Center etkinleştirme komutunu Cluster Manager'a iletir, ardından düğüm iş yükü kabul etmeye başlar.

Bir düğümü etkinleştirme ve devre dışı bırakma web arayüzünde kullanılamaz. Bir yönetici işlemi API üzerinden gerçekleştirir — API başvurusuna bakın. Sonucu Server Nodes tablosunda kontrol edin: etkinleştirilmiş bir düğüm artık çalışması yasaklanmış olarak işaretlenmez ve Health sütunu gerçek durumunu gösterir.

Kabul edilen bir komut, düğümün durumunu zaten değiştirdiği anlamına gelmez; Cluster Manager'ın komutu aldığı anlamına gelir. Gerçek değişikliği Health gösterir ve düğüm geri bildirimde bulunduğunda güncellenir. Düğüm tanımlayıcısı bir sayıdır: küme, yabancı karakterler içeren bir değeri komutu göndermeden önce -20122 koduyla reddeder.

Adım 3. Donanım envanterini toplayın

Teslim edilen donanımı irsaliyeyle karşılaştırmak ve diskleri kasada bulmak için envantere hemen ihtiyacınız vardır. Bu iki aşamada çalışır: toplama, ardından okuma.

1. Yeni düğümün envanterini başlatın. Toplama tek bir düğümü veya tüm kümeyi hedefleyebilir ve tek bir aygıt sınıfıyla sınırlandırılabilir. Bir düğümü hizmete alırken tam tarama uygundur: bir sınıf seçmeyin ve aracının her şeyi toplamasına izin verin.

   Aygıt sınıfı	Toplanan veriler
   ifnet	Ağ arabirimleri
   ses	Disk kasaları
   cam	Disk alt sistemi
   nvme	NVMe aygıtları
   smbios	SMBIOS verileri
   Sınıf seçilmemiş	Tam envanter

2. Düğüm kartını açın ve Hardware bölümünü genişletin. Inner view sekmesi düğümün donanımını Manufacturer / Description / Product / Serial number / Version tablosunda gösterir. İç içe Node data, CPU ve RAM sekmeleri görünümler arasında geçiş yapar.

3. CPU donanımını Utilization sekmesinde kontrol edin: bu sekme NUMA etki alanına göre çekirdek kullanımını, en fazla on dakika önceki verilerle gösterir. Portgroup sekmesi ağ bilgilerini Name, Hash, Last_seen, MAC, Proto ve Status sütunlarında gösterir.

4. Disk konumlarını Disks bölümünde Placement sekmesinde kontrol edin. Enclosure_device, Enclosure_id, Dev_index ve Device sütunları daha sonra bir diski kasada bulmak için kullanacağınız bilgileri sağlar.

Yeni etkinleştirilmiş bir düğümde Utilization sekmesinin boş olması normaldir: aracı henüz bildirimde bulunmamıştır. Kartı daha sonra yeniden açın.

Adım 4. Yazılım sürümlerini kümenin geri kalanıyla hizalayın

Düğümler arasındaki sürüm farklılıkları genellikle beklenmeyen küme davranışlarına yol açar. Yeni bir düğüm kendi imajındaki sürümle gelir ve bu sürümün neredeyse her zaman kontrol edilmesi gerekir.

1. Software öğesine tıklayın. Düğme hem düğüm listesinde hem de düğüm kartında bulunur. Her paketin sürümünü ve en son algılandığı zamanı gösteren Name / Version / Last_seen tablosu açılır. Düğüm paket sürümleri ve küme sürümleri ayrı ayrı gösterilir.
2. Last_seen değerini kontrol edin. Eski bir değer, düğümün bir süredir bildirimde bulunmadığı ve gösterilen sürümün kurulu sürümden farklı olabileceği anlamına gelir. Bu durumda yazılım sürümlerinin toplanmasını başlatın ve tabloyu yeniden açın.
3. Yeni düğümü hizmette olan herhangi bir düğümle karşılaştırın. Gerekli paket sürümleri farklıysa düğümü hizmete almayı durdurun ve düğümü güncelleyin.

Bazı paketler isteğe bağlıdır: vStack-vm-prio, vStack-storage-san ve vStack-zpool tabloda bulunmayabilir. Bunların yeni bir düğümde bulunmaması bir toplama hatasını göstermez ve düğümü hizmete almayı geri almak için bir neden değildir.

Adım 5. Düğüm yapılandırmasını uygulayın

Sistem ayarları gruplandırılmıştır ve her birinin bir sınıfı vardır: değerin içinde geçerli olduğu bir profil. Yeni düğüm, hizmetteki düğümlerde zaten yapılandırılmış olan değerlerin aynısını alır; bu nedenle önce referans yapılandırmayı okuyun, ardından uygulayın.

1. Hizmetteki bir düğümün kartını açın ve Configure öğesine tıklayın. Ayarlar, mevcut değerleri ve en son algılanma zamanlarıyla gruplar halinde gösterilir. Yeni düğümde aynı olması gereken değerleri kaydedin.
2. Bir değeri düzenlemeden önce ayarın sayısal mı yoksa dize mi olduğunu kontrol edin: formun neyi kabul edeceğini bu belirler.
3. Yeni düğümün kartında Configure öğesini açın, değerleri girin ve geçerli olacakları sınıfı seçin. Değişikliği tek bir düğüme hedefleyin: bir düğümü hizmete alırken değişikliği tüm kümeye göndermeye gerek yoktur.
4. Değişikliği onaylayın. Komut düğüm aracısına iletildiğinden sonuç hemen görünmez. Ayarları yeniden açın: değiştirilen ayarın değeri ve algılanma zamanı güncellenir.

vStack Center sayısal ayarların aralığını kendisi denetler: minimumun altındaki bir değer -23124 koduyla, maksimumun üzerindeki bir değer ise -23125 koduyla reddedilir. Bu tür değerler düğümlere gönderilmez. Bilinmeyen bir ayar -23121 koduyla, istenen sınıfa sahip olmayan bir ayar ise -23123 koduyla reddedilir.

Adım 6. Düğümün disklerini kümede çevrimiçi yapın

Yeni düğümün diskleri başlangıçta "ham" durumdadır: düğüm onları görür, ancak küme görmez. Bir diski çevrimiçi yapmak onu tüm düğümlere görünür kılar. İşlem yıkıcıdır ve idempotent değildir: zaten çevrimiçi olan bir diski yeniden çevrimiçi yapma girişimi -24706 koduyla reddedilir.

Bir diski kümede çevrimiçi yapma, yedek olarak işaretleme ve kümeden kaldırma web arayüzünde kullanılamaz. Bir yönetici bunları API üzerinden gerçekleştirir — API başvurusuna bakın. Diskin kümede görüneceği blok boyutu ve seri numarası da orada belirtilir.

1. Düğümün neleri algıladığını kontrol edin. Düğüm kartının Disks bölümünü açın. Sekmeler aynı listenin farklı görünümlerini gösterir: Disk props — ID, Model, Size (GB), Status; ZFS props — Pool name, Vdev_pool_name, Vdev_guid, Vdev_pool_guid; Placement — kasadaki konum; LED on panel — Led_fault ve Led_locate.
2. Birbirinden bağımsız üç özelliği ayırt edin: diskin sağlık durumu olan Status; diskin rolü (boş, bölümlenmiş, havuz üyesi, yedek); ve "kümede çevrimiçi" bayrağı. Hiçbiri diğerinden çıkarılamaz. Diskin kümede çevrimiçi olma bayrağını yalnızca API gösterir.
3. Gerekli diskleri çevrimiçi yapın ve listeyi yeniden okuyun. Diskin rolü değişmez: kümede çevrimiçi yapmak rolünü etkilemez.
4. Acil bir değişimde yerine geçecek disk bulunabilmesi için bazı diskleri hemen yedek olarak işaretlemeyi düşünün. Bir diski yedek olarak işaretlemek diske bir servis etiketi yazar; bu nedenle düğüm, işlem zorlanmadıkça canlı veri içeren bir diskte bu işlemi reddeder.

uyarı

Bir diski kümede çevrimiçi yapmak onu bir ZFS havuzuna eklemez. Havuz, düğümdeki çevrimiçi disklerden oluşturulur; vStack Center bu işlemi sağlamaz. Bir havuz var olana kadar düğümün diskleri kümeye tek bir bayt bile kapasite eklemez.

Bir diskin kasadaki göstergelerini doğrudan arayüzden yakabilirsiniz: Disks bölümündeki Front view ve Inner view sekmeleri her disk için konum ve arıza göstergesi düğmeleri sağlar. Sonuç LED on panel sekmesinde görünür.

Adım 7. Yeni düğümde havuz servisini başlatın

Bir havuz, düğümde bir küme servisi olarak çalışır. Servis etkinleştirilip başlatılana kadar, diskler çevrimiçi olsa ve havuz oluşturulmuş olsa bile havuz hiçbir kapasite sağlamaz.

1. Provider Data Center → Storage Resources bölümünü açın. ZFS pools tablosu kümenin havuzlarını GUID, Name, Health, Consuming, Scrubbing, Resilvering, Current node ve Capacity (RAW) sütunlarıyla gösterir. Current node, havuzu şu anda hangi düğümün barındırdığını belirtir.
2. Tablodan havuzu açın ve Actions menüsünde Start pool öğesini seçin.
3. Storage Resources bölümüne dönün ve havuzun çalışıyor olarak gösterildiğinden ve Current node değerinin yeni düğümü gösterdiğinden emin olun.

Bir servisin birbirinden bağımsız iki özelliği vardır: çalışmasına izin verilip verilmediği anlamına gelen izin ve şu anda çalışıp çalışmadığı anlamına gelen durum. Devre dışı bırakılmış bir servis, kaç kez başlatmaya çalışırsanız çalışın başlamaz. Bir servisi etkinleştirme ve devre dışı bırakma web arayüzünde kullanılamaz; bir yönetici bu işlemleri API üzerinden gerçekleştirir. İşlem sırası ve yaygın hatalar "Küme servislerini yönetme" sayfasında açıklanmıştır.

Kabul edilen bir komut, servisin fiilen başladığını değil, Cluster Manager'ın komutu aldığını doğrular. Bir havuz servisinin adı harflerden, rakamlardan ve alt çizgilerden oluşur, örneğin zpool_ssd01; küme kısa çizgileri, noktaları veya boşlukları kabul etmez.

Adım 8. Küme kapasitesini doğrulayın

Son adım, düğümün gerçekten hizmette mi yoksa yalnızca etkinleştirilmiş mi olduğu sorusunu yanıtlar. Düğümün kaynakları hem düğüm bazındaki görünümde hem de küme toplamlarında görünmelidir.

1. Provider Data Center → Overview bölümünü açın. Ekran CPU, bellek ve depolama için kapasiteyi, tahsisi ve fiili tüketimi bir araya getirir. Toplamlar yeni düğümün kaynakları kadar artmalıdır.
2. Resources sekmesine gidin: tablo düğümleri Node name, Node health ve Consuming sütunlarıyla gösterir. Yeni düğüm listede görünmelidir.
3. Server Nodes bölümünde CPU (Cores) ve RAM (GB) sütunlarını kullanarak düğüm bazındaki görünümü, Storage Resources bölümünde ise düğümün havuzlarını doğrulayın.

Yeni etkinleştirilmiş bir düğümde CPU (Cores) ve RAM (GB) değerlerinin boş olması, metriklerinin henüz kullanılamadığı anlamına gelir. Tahsis edilen değerler yine de doğrudur. Havuz oluşturulup servisi başlatılana kadar düğümün havuzları da görünmez.

İşin tamamlanması

1. Kurulum sırasında yaktığınız göstergeleri söndürün: düğüm kartı → Disks bölümü → Front view veya Inner view sekmeleri. Sonucu LED on panel sekmesinde Led_fault ve Led_locate sütunlarında kontrol edin.
2. Son fiziksel değişikliklerden sonra envanteri ses ve cam sınıflarını kullanarak yeniden çalıştırın.
3. Referans yapılandırmayı kaydedin: yeni düğüm için Configure ve Software öğelerini açın. Bu, düğümü bir sonraki sefer karşılaştıracağınız durumdur.
4. Düğümü hizmete almayı geri alıyorsanız, iş yükü kabul etme iznini iptal edin ve disklerini kümeden kaldırın. Her iki işlem de API'yi kullanır. Canlı bir havuza ait bir disk bu şekilde kaldırılamaz: havuz bozulmuş duruma düşer ve düğüm işlemi reddeder.

Sonucun doğrulanması

Ne kontrol edilmeli	Nereye bakılmalı	Beklenen sonuç
Düğüm bir küme üyesi	Server Nodes	Düğümün ID ve Name değerlerine sahip yeni bir satır
Düğüm etkin ve çalışıyor	Server Nodes, Health sütunu	Düğüm çalışması yasaklanmış olarak işaretlenmemiş ve çalışıyor olarak gösteriliyor
Donanımın envanteri çıkarılmış	Düğüm kartı, Hardware bölümü	Inner view sekmesi dolu ve Last_seen güncel
Sürümler kümeyle eşleşiyor	Software düğmesi	Çekirdek sürümü ve gerekli paketler hizmetteki bir düğümle eşleşiyor
Yapılandırma uygulanmış	Düğüm kartı, Configure	Değerler referans yapılandırmayla eşleşiyor ve algılanma zamanları güncel
Diskler kümeye görünür	Düğüm kartı, Disks bölümü	Gerekli diskler listede görünüyor; API "kümede çevrimiçi" bayrağını gösteriyor
Havuz servisi çalışıyor	Storage Resources	Havuz ZFS pools tablosunda görünüyor, Current node yeni düğüm ve Health = ONLINE
Kapasite hesaba katılmış	Overview	CPU, bellek ve depolama toplamları artmış

Bir sorun çıkarsa

Ne görüyorsunuz	Neden	Ne yapmalı
Düğüm Server Nodes tablosunda yok	Cluster Manager düğümü henüz kümeye kabul etmemiş	vStack Center'da düğümü hizmete almaya başlamayın; kurulum aşamasına dönün
Düğüm tablosu boş, hata kodu -2	Cluster Manager ile iletişim başarısız oldu	Cluster Manager'ın erişilebilirliğini kontrol edin: küme üyeliği verileri kullanılamıyor
Düğüm ve servis komutları için hata kodu -713	Komut Cluster Manager'a iletilemedi	Yukarıdakiyle aynı; komut düğümlere ulaşmadı
Hata kodu -20122	Düğüm tanımlayıcısı doğrulaması başarısız oldu	Düğüm tanımlayıcısını yabancı karakter içermeyen bir sayı olarak belirtin
Hata kodu -20512, -20522	Servis adı veya düğüm tanımlayıcısı doğrulaması başarısız oldu	ZFS pools tablosundaki Name sütununda yer alan servis adını ve Server Nodes bölümündeki düğümü kullanın
Hata kodu -403 "Access denied"	İşlem yalnızca Cluster master rolü için kullanılabilir	Küme düzeyinde bir rolle oturum açın
Hata kodu -26001, -26101	feature.hardware_inventory bayrağı devre dışı	Bayrağı küme seçeneklerinde etkinleştirin
Hata kodu -23110 veya -23301	feature.node_config_management bayrağı devre dışı	Yapılandırma yönetimi için de aynısını yapın
Hata kodu -24201	feature.physical_disc_management bayrağı devre dışı	Fiziksel disk yönetimi için de aynısını yapın
Hata kodu -200	Küme durum haritası kullanılamıyor ve veri toplanacak düğüm yok	Düğümlerin ONLINE durumuna dönmesini bekleyin ve yeniden deneyin
Hata kodu -23203	Geçersiz bir aygıt sınıfı seçildi	3. adımdaki tablodan bir sınıf seçin
Hata kodu -23124 veya -23125	Sayısal ayar değeri minimumun altında veya maksimumun üzerinde	Değeri ayarın sınırları içinde belirleyin
Hata kodu -24702, -24704	Aygıt yolu veya disk seri numarası biçimi doğrulaması başarısız oldu	Yolu ve seri numarasını Disks bölümüyle karşılaştırın
Hata kodu -24703	Geçersiz blok boyutu	512 veya 4096 belirtin
Hata kodu -24706	Disk zaten kümede çevrimiçi	Yeniden denemeye gerek yok; diskin kümede çevrimiçi olma bayrağını kontrol edin
Hata kodu -24707	İstenen seri numarası düğümdeki başka bir disk tarafından zaten kullanılıyor	Başka bir değer seçin veya düğümün bir değer ataması için boş bırakın
Hata kodu -24504	Diskte zaten yıkıcı bir işlem devam ediyor	Düğümün önceki komuta yanıt vermesini bekleyin
Hata kodu -24503	Disk zaten yedek olarak işaretlenmiş	Yeniden denemeye gerek yok
Komut kabul edildi, ancak veriler değişmedi	Toplama ve yazma eşzamansızdır: komut yalnızca düğüm aracısına iletilmiştir	Ekranı yeniden açın; değerlerin ne kadar güncel olduğunu görmek için Last_seen değerini kontrol edin
Disk çevrimiçi, ancak küme kapasitesi artmadı	Bir diski kümede çevrimiçi yapmak bir ZFS havuzu oluşturmaz	Havuzu düğümde oluşturun, ardından servisini etkinleştirip başlatın
Düğüm etkin, ancak CPU (Cores) ve RAM (GB) boş	Metrik deposunda düğüm için henüz veri yok	Metrik toplanmasını bekleyin ve düğüm kartındaki Perfdata bölümünü kontrol edin

Ayrıca bkz.

• Küme mimarisi, her nesne için durum ikilisi ve özellik bayrakları — "Küme, düğümler ve servisler".
• Düğüm işlemlerinin tam kümesi — "Küme düğümlerini yönetme".
• Havuz servisleri ve düğüm atamaları — "Küme servislerini yönetme".
• Hizmetteki bir düğümde planlı disk değişimi — "Bir düğümde planlı disk değişimi".

API yöntemleri

Bu sayfadaki API işlemleri: node-list, get-statusmap, cluster-node-enable, cluster-node-disable, node-inventory, host-inventory, node-hw-list, node-cpu-cores, node-software-inventory, node-software, node-config-map, node-config-get, node-config-set, pd-list, pd-status-map, pd-use, pd-unuse, pd-spare, pd-led, cluster-service-enable, cluster-service-start, cluster-overview, cluster-totals — API başvurusuna bakın.