Özet
cvlabel -l [-agsv] [-F filtre]
cvlabel -L [-agv] [-F filtre]
cvlabel -j [-av] [-F filtre]
cvlabel -c [-T] [-F filtre]
cvlabel -C_format [-F filtre]
cvlabel -x
cvlabel [-frRvw] [-q kuyruk_derinligi] etiket_listesi
cvlabel [-fw] -u_HacimAdi
cvlabel [-fw] -U_AygitAdi
cvlabel -D_HacimAdi
Açıklama
cvlabel, Xsan Dosya Sistemi disklerini yapılandırırken kullanılır. Tüm depolama alanı ağı (SAN) disk aygıtlarını görebilen bir ana bilgisayar (host), disk etiketlerinin, bunlarla ilişkili aygıt adlarının ve isteğe bağlı olarak kullanılacak sektörlerin bir listesini oluşturmalıdır. mount_acfs(8) işlemi, Xsan depolama havuzu düğümleri için hangi disk sürücüsünün kullanılacağını belirlemek için hacim etiketlerini kullanır. Bir disk aygıtına yazılan etiket adı, Dosya Sistemi Yöneticisi (File System Manager - FSM) yapılandırmasındaki [Disk ...] adı ile eşleşmelidir. FSM yapılandırma dosyasının ayrıntıları için snfs_config(5) kılavuzuna bakın.
Öncelikle cvlabel aracını -l veya -L seçeneğiyle kullanmanız önerilir. Bu seçenek, sistemde bulunan tüm kullanılabilir disk aygıtlarını sunacaktır. Hacim etiketini tanımlamaya çalışacak ve sonuçları görüntüleyecektir. Bu, istemci tarafından hangi disk sürücülerinin görülebildiğini belirlemeye yardımcı olur.
Bir sonraki adım, label_list dosyasını oluşturmaktır. Dosyanız için şablon olarak /System/Library/Filesystems/acfs.fs/Contents/examples/cvlabels.example dosyasını kullanın. Veya cvlabel aracını -c seçeneğiyle çalıştırın; bu durumda cvlabel, bulunan tüm aygıtların listesini label_list dosyasıyla uyumlu bir biçimde standart çıktıya (stdout) yazacaktır.
Bir label_list dosyası oluşturulduktan sonra, istenen Xsan etiket güncellemeleriyle eşleşecek şekilde düzenlenmelidir. label_list dosyasında yer alan ve Xsan Dosya Sistemine ayrılmamış tüm LUN'lar, mevcut verilerin yanlışlıkla üzerine yazılmasını önlemek için label_list dosyasından kaldırılmalıdır. label_list üzerindeki tüm güncellemeler tamamlandığında, belirtilen LUN'lara etiket değişikliklerini uygulamak için bu dosya kullanılarak cvlabel çalıştırılmalıdır.
Bir etiket dosyası oluşturmak için son seçenek, bir biçim dizesiyle birlikte -C seçeneğini kullanmaktır. Bu seçenek, biçim dizesinin şablon etiketler oluşturmak için kullanılması dışında -c seçeneğiyle aynı şekilde davranır. Biçim dizesi, % işaretinin ardından gelen bir harfin depolama biriminden elde edilen bilgilerle değiştirildiği printf benzeri bir sözdizimi kullanır. Kullanılabilir biçim dizeleri şunlardır: %B sektör cinsinden boyut, %L lun numarası, %C denetleyici (controller) kimliği ve %S seri numarası. Çıktıyı cihazları etiketlemek için kullanmadan önce, cihazlar için benzersiz isimler üreten bir biçim kullanmaya özen gösterilmelidir.
Bazı RAID aygıtları özel işlem gerektirir. cvlabel, hangi aygıtların özel işlem gerektirdiğini belirlemek için raid dizeleri sorgulama tablosunu kullanır. Varsayılan tablo (-R seçeneğiyle görüntülenir), kullanıcı tarafından sağlanan /Library/Preferences/Xsan/raid-strings dosyasıyla geçersiz kılınabilir. Not: -R seçeneği genel kullanım için tasarlanmamıştır ve gelecekte kullanımdan kaldırılabilir. Yalnızca Apple Desteği tarafından önerildiğinde kullanın.
Seçenekler
-l, -L Sistemdeki kullanılabilir disk aygıtlarını listelemek için -l seçeneğini (kısa biçim) veya -L seçeneğini (uzun biçim) kullanın.
-j: Sistemdeki kullanılabilir disk aygıtlarını makine ve insan tarafından okunabilir bir biçimde listelemek için-jseçeneğini (JSON biçimi) kullanın.
-u HacimAdi
Belirtilen hacmin etiketini kaldırmak için -u HacimAdi seçeneğini kullanın.
-U AygitAdi
-U AygitAdi seçeneği, etiket adı yerine aygıt özel dosyasının yolunun kullanılması dışında -u seçeneğine benzer.
-s:-lseçeneğiyle birlikte kullanıldığında,-sseçeneği disk aygıtının seri numarasını yazdırır; bu, yinelenen etiketler ile birden fazla yol arasındaki farkı ayırt etmek için kullanılabilir.-g:-lveya-Lseçenekleriyle birlikte kullanıldığında,-gseçeneği GUID bilgilerini de yazdırır. GUID, zaman damgasını ve etiketi oluşturan düğümün MAC adresini içerir.-a:-lveya-Lseçenekleriyle birlikte kullanıldığında,-aseçeneği kullanılamayan disk aygıtlarını ve bunların neden kullanılamadıklarının bir açıklamasını da yazdırır. Bu durum genellikle büyük LUN'lar için işletim sistemi desteğinin olmamasından veya desteklenmeyen bir disk etiketi biçiminden kaynaklanır.
-F filtre
-c, -C, -l veya -L seçenekleriyle birlikte kullanıldığında, -F filtre seçeneği yalnızca sorgulama (inquiry) dizesi filtre dizesini içeren aygıtları listeler.
-v:-vseçeneği etiketleme işlemi hakkında daha fazla bilgi yazdırır. Birden fazla-vseçeneği birikerek, genellikle etiketleme işleminde hata ayıklamak için kullanılan daha fazla bilgiyi sağlar.-q: Etiketleme sırasında Komut Etiketi Kuyruk Derinliğini (Command Tag Queue Depth) ayarlamak için-qseçeneği kullanılabilir. Varsayılan olarak derinlik 16'ya ayarlanmıştır.-f:-fseçeneği etiketlemeyi zorlar ve bir disk aygıtını etiketlemeden (veya etiketini kaldırmadan) önce sizden onay istenmez. UYARI: Xsan label_list dosyasındaki hatalar veri kaybına neden olabilir.-c:-cseçeneği, standart çıktıya (stdout) cvlabel biçiminde bir şablon dosyası çıktısı verir. Bu şablon dosyası yerel sistem tarafından görülebilen tüm disk aygıtlarını yansıtacaktır. Bir cvlabel dosyası oluşturmak için bu şablonu kullanın. UYARI: Şablon dosyasını düzenleyerek etiketlenmesini istemediğiniz tüm aygıtları kaldırdığınızdan emin olun.-T:-Tseçeneği, etiketlerin eski VTOC biçiminden yeni EFI biçimine dönüştürülmesini kolaylaştırmak için-cseçeneğiyle birlikte kullanılabilir. Çıktı normal-cçıktısına benzer olacaktır, ancak dönüştürülmesine gerek olmayan veya güvenli bir şekilde dönüştürülemeyen aygıtlar, açıklayıcı metinlerle birlikte yorum satırları olarak çıktı verilecektir. Yalnızca dönüştürülebilir aygıtlar normal şekilde çıktı verilir.
-D HacimAdi
-D HacimAdi seçeneği, HacimAdi etiketini ascii biçiminde standart çıktıya (stdout) dökmek için kullanılabilir. Bu çıktıyı incelemek, etiketlerde hata ayıklarken yararlıdır.
-r: Etiket bilgilerinde hiçbir değişiklik olmasa bile, bir diskin zorla yeniden etiketlenmesini sağlamak için-rseçeneği kullanılabilir. Normalde bu tür diskler atlanır.-R: Varsayılan raid dizeleri sorgulama tablosunu görüntülemek için-Rseçeneği kullanılabilir. Xsan Dosya Sisteminin eski sürümleri için IRIX sistemlerinde EFI etiketlerinin desteklenmediğini unutmayın.-i:-iseçeneği artık desteklenmemektedir. Etiketler EFI biçiminde olmalıdır.-w:-wseçeneği, bir disk etiketi yazıldıktan veya bir hacmin etiketi kaldırıldıktan sonra talep edilen disk taramasının tamamlanmasını beklemesini cvlabel'a söyler. Disk taraması, dosya sistemi sunucusunun dahili aygıt tablolarını güncellemesini talep eder ve-wseçeneği bu işlemin tamamlandığından emin olmasını sağlar. Büyük bir SAN'da veya aygıt hataları yaşayan bir SAN'da disk taramasının birkaç saniye sürebileceğini unutmayın.
UYARI Bu programı son derece dikkatli kullanın! Bir sistem diskinin hacim etiketini değiştirmek, sisteminizde onarılamaz hasarlara yol açabilir. Sistemi çalışamaz hale getirebilir ve boot bakım programını kullanarak hacmi onarmak zorunda kalmanıza neden olabilir. Yalnızca Xsan Dosya Sisteminin depolama alanı ağı için kullanılacağından emin olduğunuz disk aygıtlarını etiketleyin.
Dosya Biçimi
/System/Library/Filesystems/acfs.fs/Contents/examples/cvlabels.example dosyasını bir şablon olarak kullanabilirsiniz.
Bir etiket girişi, tek bir satırda iki veya üç parametreden oluşur. Boşluklar ve yorum satırlarına izin verilir. Yorum satırları, satırın ilk boşluk olmayan karakteri olarak bir kare işareti (#) kullanılarak belirtilir.
label_list dosya biçimi aşağıdaki gibidir:
<Xsan_etiket_adi> <isletim_sistemi_aygit_adi> [<sektorler> [<tur>]]
Burada:
<Xsan_etiket_adi>
<Xsan_etiket_adi> parametresi, FSM yapılandırma dosyasında açıklandığı şekliyle diskin adıdır. Parametre bir [Disk <Xsan_etiket_adi>] girişiyle eşleşmelidir.
<isletim_sistemi_aygit_adi>
<isletim_sistemi_aygit_adi> parametresi, tam disk aygıtının işletim sistemindeki aygıt adıdır.
NOT: İşletim sistemi aygıt adları yeniden başlatmalardan sonra değişebilir ve sistemden sisteme farklılık gösterecektir. Xsan etiket dosyalarını her zaman aynı oturumda yapılandırın ve aygıtları aynı oturumda etiketleyin.
Windows sistemlerinde aygıtlar PhysicalDrive0 ile başlar ve yapılandırılan sürücü sayısına kadar artar.
<sektorler>
<sektorler> parametresi, FSM yapılandırma dosyasındaki [DiskType ...] yapılandırmasıyla eşleşen 512 baytlık sektörlerin sayısıdır. Bu, gerçek boyutlarından daha küçük yapılandırılması gereken diskler için gereklidir. Örneğin, MPIRE video diskleri, diskin son bölgesinin kullanılmasını engellemek için gerçek boyutunun altında yapılandırılmalıdır. <sektorler> belirtilmezse veya - olarak belirtilirse, cvlabel(8) programı kullanılabilir tüm hacmi kullanacaktır.
<tur>
<tur> parametresi, varsayılan etiket türünü geçersiz kılmak veya zaten bir etiketi olan bir diskin etiket türünü değiştirmek için kullanılır. Bir VTOC etiketini EFI etiketine dönüştürmek için değer EFI olmalıdır.
Örnekler
Bir sistemdeki tüm disk aygıtlarını listeleyin.
rock # cvlabel -L
/dev/sda [ATA ST500NM0011 PA08] MBR Controller 'default', Serial '5000C5004FDC5C85', Sector Size 512, Sectors Max 976754703 (500.1GB)
/dev/mapper/mpathai [Quantum StorNext QX H205] SNFS-EFI "dexter1d1" Controller '208000C0FF193C0F', Serial '600C0FF00014658335219B5801000000', Sector Size 512, Sectors 39030873055 (20.0TB), Stripebreadth 0
[...]
/dev/mapper/mpathap [DotHill DH4730 H205] unknown Controller '208000C0FF155519', Serial '600C0FF00019B6162739A65801000000', Sector Size 512, Sectors 18554669023 (9.5TB)
[...]
/dev/mapper/mpathan [Quantum QXS G22x] SNFS-EFI "snfs_data_bh-5600-1_L5" Controller '208000C0FF25E3DB', Serial '600C0FF0001BE2E0C9D94E5701000000', Sector Size 512, Sectors 140511467487 (71.9TB), Stripebreadth 3145728
Ardından bir şablon etiket dosyası oluşturun:
rock # cvlabel -c >label_list
Çıktı dosyası 'unknown' disk için bir giriş içerecektir:
CvfsDisk_UNKNOWN /dev/mapper/mpathao # host 0 lun 3 sectors 18554669023 sector_size 512 inquiry [DotHill DH4730 H205] serial 600C0FF00019B6165E39A65801000000
label_list dosyasını düzenleyin ve CvfsDisk_UNKNOWN değerini istenen etiket adıyla değiştirin:
CvfsDisk_39 /dev/mapper/mpathao
Şimdi disk aygıtlarını etiketleyin. label_list dosyanız komut satırında belirtilmelidir.
rock # cvlabel label_list
*WARNING* This program will over-write volume labels on the
devices specified in the file label_list.
After execution, the devices will only be usable by the
Xsan File System. You will have to re-partition the
devices to use them on a different file system.
Do you want to proceed? (Y / N) -> y
/dev/mapper/mpathap [DotHill DH4730 H205] unknown Controller '208000C0FF155519', Serial '600C0FF00019B6162739A65801000000', Sector Size 512, Sectors 18554669023 (9.5TB)
Do you want to label it SNFS-EFI - Name: CvfsDisk_39 Sectors: 18554669023 (Y / N) -> y
New Volume Label -Device: /dev/mapper/mpathap SNFS Label: CvfsDisk_39 Sectors: 18554669023.
Done. 1 source lines. 1 labels.
Etiketleme tamamlandı. Disk aygıtlarını tekrar listeleyin.
rock # cvlabel -L
/dev/sda [ATA ST500NM0011 PA08] MBR Controller 'default', Serial '5000C5004FDC5C85', Sector Size 512, Sectors Max 976754703 (500.1GB)
/dev/mapper/mpathai [Quantum StorNext QX H205] SNFS-EFI "dexter1d1" Controller '208000C0FF193C0F', Serial '600C0FF00014658335219B5801000000', Sector Size 512, Sectors 39030873055 (20.0TB), Stripebreadth 0
[...]
/dev/mapper/mpathap [DotHill DH4730 H205] SNFS-EFI "CvfsDisk_39" Controller '208000C0FF155519', Serial '600C0FF00019B6162739A65801000000', Sector Size 512, Sectors 18554669023 (9.5TB)
[...]
/dev/mapper/mpathan [Quantum QXS G22x] SNFS-EFI "snfs_data_bh-5600-1_L5" Controller '208000C0FF25E3DB', Serial '600C0FF0001BE2E0C9D94E5701000000', Sector Size 512, Sectors 140511467487 (71.9TB), Stripebreadth 3145728
Denetleyici seri numarasını ve lun numaralarını etiketlerin bileşenleri olarak kullanan tüm LSI depolama alanları için bir etiket dosyası oluşturun.
rock # cvlabel -C CVFS_%S_%L -F LSI > label_list
Varsayılan raid dizeleri sorgulama tablosunu standart çıktıya (stdout) görüntüleyin.
rock # cvlabel -R
# Raid inquiry string table
# Controls interpretation of raid mode pages based on inquiry strings
#
# Allowed types:
# LSI LSI (Engenio) Raid in AVT mode
# Clariion Clariion (EMC) Raid in Auto trespass mode
# Seagate Dual port Seagate JBODs
# JBOD No special handling (Real JBOD or RDAC driver)
# Quantum StorNext QX
# Quantum QXS
# String 1 String 2 Raid Type
"DGC" "" Clariion
"ENGENIO" "" LSI
"IBM" "1722-600" LSI
"IBM" "1742-900" LSI
"IBM" "1814" LSI
"IBM" "Universal Xport" LSI
"LSI" "VirtualDisk" JBOD
"LSI" "MegaRAID" JBOD
"LSI" "ProFibre" JBOD
"LSI" "Universal Xport" LSI
"NETAPP" "Universal Xport" LSI
"ENGENIO" "Universal Xport" LSI
"LSI" "" LSI
"SGI" "TP9300" LSI
"SGI" "TP9400" LSI
"SGI" "TP9500" LSI
"SGI" "TP9700" LSI
"SGI" "IS600" LSI
"SGI" "IS500" LSI
"SGI" "IS400" LSI
"SGI" "IS300" LSI
"STK" "FLEXLINE" LSI
"STK" "OPENstorage" LSI
"STK" "Universal Xport" LSI
"STK" "BladeCtlr" LSI
"Quantum StorNext QX" "" QX
"Quantum QXS" "" QX
"SEAGATE" "" Seagate
Kullanıcı tanımlı bir tablo oluşturmak için varsayılan raid dizeleri sorgulama tablosunu kullanın.
rock # cvlabel -R > /Library/Preferences/Xsan/raid-strings
Notlar
Bazı işletim sistemleri, bir disk etiketlendikten veya yeniden etiketlendikten sonra yeniden başlatma gerektirir. Yeni etiketler yazıldıktan veya mevcut etiketler güncellendikten sonra Xsan düğümlerinin yeniden başlatılması önerilir.
Dosyalar
/System/Library/Filesystems/acfs.fs/Contents/examples/cvlabels.example /System/Library/Filesystems/acfs.fs/Contents/examples/example.cfgx /Library/Preferences/Xsan/raid-strings
Ayrıca Bakınız
cvfs(8), snfs_config(5), mount_acfs(8)
Xsan Dosya Sistemi Ocak 2024 CVLABEL(8)