bbvirt - Dalam Talian di Awan

JADUAL:

NAMA

bbvirt - palam panas peranti BitBabbler ke dalam domain terurus libvirt

SINOPSIS

bbvirt tindakan [pilihan]

bbvirt melampirkan|lepaskan peranti [pilihan]

bbvirt lampirkan-semua|tanggalkan-semua [domain] [pilihan]

DESCRIPTION

. bbvirt program adalah percubaan untuk menghilangkan sedikit kesakitan daripada apa yang sedang berlaku
diperlukan untuk mengedarkan berbilang peranti USB antara hos dan mesin maya tetamu.
Walaupun terdapat beberapa cara di mana ini boleh dikonfigurasikan dan diuruskan, pada masa ini tiada
daripada mereka sebenarnya menyediakan penyelesaian yang lengkap dan koheren sendiri, semuanya jatuh
kurang daripada markah dalam beberapa cara yang ketara dan menjengkelkan. Matlamat di sini adalah untuk bersatu
cukup daripada penggodaman tersebut untuk benar-benar mendapatkan semua fungsi yang kita inginkan sekarang, sehingga
Sokongan asli libvirt untuk ini cukup baik untuk tidak memerlukannya lagi.

Pada masa ini ini berkaitan dengan mesin maya QEMU/KVM terurus libvirt.

Servis do we mahu?
Tingkah laku ideal di sini agak mudah. Memandangkan beberapa nombor sewenang-wenangnya BitBabbler
peranti, kita sepatutnya boleh menetapkannya sama ada pada mesin hos atau kepada VM tetamu
berjalan di atasnya, dan sebaik sahaja kita berbuat demikian, mereka harus berkelakuan dengan cara biasa yang diharapkan daripada mana-mana
Peranti USB.

- Jika ia dipalamkan semasa mesin tetamu dihidupkan, ia harus dilihat oleh itu
mesin seperti yang akan dilakukan oleh tuan rumah.

- Jika ia dipalamkan selepas mesin dihidupkan, ia hendaklah disambungkan ke dalamnya
mesin kerana ia akan berada pada hos.

- Jika ia dicabut semasa mesin berjalan, ia hendaklah ditanggalkan dengan bersih
ia, kerana mereka akan menjadi hos.

Mengapa tidak boleh we mempunyai ia?
Pada masa ini, libvirt memberi kita dua cara untuk menetapkan peranti USB daripada hos kepada a
domain tetamu.

- Kami boleh menetapkan mereka mengikut vendor USB dan ID produk mereka. Tetapi itu hanya berfungsi apabila ada
hanyalah satu peranti jenis itu dalam hos. Yang agak tidak berguna dalam kebanyakan
kes yang kami ambil berat di sini, di mana hos dan setiap tetamu berkemungkinan
mempunyai satu atau lebih peranti BitBabbler mereka sendiri diperuntukkan kepada mereka.

- Kami boleh menetapkan mereka mengikut alamat logik mereka pada bas USB. Tetapi itu bukan pemalar
yang boleh kami konfigurasikan secara statik untuk domain. Setiap kali peranti dipalamkan, atau
dipasang semula, atau set semula, atau mesin hos dibut semula, alamat itu mungkin akan berubah
memandangkan ia diperuntukkan secara dinamik apabila peranti disenaraikan di dalam bas.

Terdapat cara ketiga, tetapi ia bergantung pada memintas konfigurasi libvirt biasa untuk dibuat
penggunaan terus keupayaan QEMU untuk menetapkan peranti mengikut alamat fizikalnya pada bas.
Mana yang lebih baik, tetapi masih bukan peluru ajaib kerana ia bergantung pada palam yang sama
peranti ke dalam port yang sama setiap kali (dan apabila port tersebut disenaraikan dalam
dengan cara yang sama oleh hos pada setiap but semula, yang tidak dijamin sama ada). Ia juga memaksa
kami untuk melompat melalui gelung lain, kerana kami memerlukan komplikasi tambahan untuk menguruskan
akses kebenaran peranti secara manual di luar libvirt, tetapi masih dalam penyelarasan
dengannya.

Kegagalan yang lebih besar, yang mana semua kaedah tersebut mempunyai persamaan, adalah semuanya bergantung kepada
peranti sudah dipasang sebelum tetamu dimulakan. Jika ia dimasukkan selepas
tetamu dimulakan, atau dialih keluar dan dipasang semula semasa tetamu sedang berjalan, atau jika hos
bas atau hab melantun menyebabkan penyambungan semula, maka peranti tidak akan (semula) dilampirkan pada
tetamu. Satu-satunya cara untuk membetulkannya jika ia berlaku ialah dengan memasang semula peranti secara manual dengan
mantera misteri dalam XML (yang bergantung pada anda mengetahui alamat baharu peranti), atau
untuk mematikan sepenuhnya dan memulakan semula tetamu. Bukan kemuncak mesra pengguna
operasi yang kami cari di sini.

Servis boleh we do mengenai ia?
Terdapat tampung yang diserahkan kepada libvirt beberapa tahun lalu yang akan membenarkan peranti
untuk ditentukan oleh kedua-dua ID produk USB dan nombor sirinya, tetapi itu mendapat beberapa dorongan-
belakang, dan setakat ini masih belum digunakan di hulu. Itu akan pergi jauh
ke arah menjadikannya mudah dan bersih, meninggalkan kami hanya dengan aspek palam panas untuk ditangani
dengan. Kami akan meninggalkan kecaman marah tentang itu sebagai latihan untuk pembaca ...

Alternatif lain ialah kita boleh mewakilkan mencari alamat logik peranti kepada palam panas
pengurus seperti udev(7). Ini menarik dalam erti kata yang kita boleh tahu bila alamat
sesuatu peranti berubah dan apa yang ia berubah, tetapi udev sendiri tidak begitu mesra kepada
idea penyesuaian pentadbir tempatan (walaupun boleh dilakukan, nampaknya mendapat
semakin sangat tidak digalakkan) dan menggunakannya masih memerlukan beberapa gam luaran untuk
menterjemah peristiwanya kepada sesuatu yang libvirt boleh bertindak untuk mengkonfigurasi tetamu
mesin.

. bbvirt program menyediakan gam itu, dan kaedah yang mesra pengguna untuk menetapkan yang
peranti harus dimiliki oleh domain tetamu yang mana dan bahagian hadapan yang boleh digunakan secara manual
atau oleh tugas terkawal pentadbir lain untuk menambah atau mengalih keluar peranti BitBabbler dengan cepat dan mudah
daripada mana-mana mesin tetamu yang sedang berjalan.

Tetapi batasan pendekatan ini ialah ia tidak dapat mengetahui dengan mudah bila mesin tetamu berada
bermula yang sepatutnya mempunyai peranti yang telah dipalamkan ditambahkan padanya. Secara teorinya kita
boleh menambahkannya pada definisi domain yang berterusan, tetapi itu mempunyai masalahnya sendiri kerana
kami hanya boleh menambah peranti mengikut alamat logik sementara mereka, dan kami tidak dapat menjamin bahawa kami
akan dipanggil untuk mengalih keluar mereka daripada domain sekali lagi apabila alamat tersebut menjadi tidak sah
(seperti jika hos tiba-tiba dimatikan atau sebaliknya tidak ditutup dengan bersih), jadi kami
boleh berakhir dengan banyak entri basi terkumpul dalam konfigurasi domain yang berterusan,
yang kemudiannya boleh memadankan beberapa peranti yang sama sekali berbeza dengan apa yang kami ingin lampirkan
ia. Ini bermakna sehingga entah bagaimana ia diperbaiki, ia hanya selamat untuk menambahkannya pada tetamu langsung
domain, supaya ia akan sentiasa dialih keluar semula apabila ia dihentikan, tidak kira bagaimana ia
akhirnya terhenti.

Jelas sekali kami masih mempunyai beberapa cara untuk mencapai cita-cita kami di sini.

Servis if we melanda it bersama *dua* tukul?
Nampaknya hanya ada dua cara kita boleh diberitahu tentang mesin tetamu
bermula pada masa kini. Satu melibatkan menjalankan satu lagi proses daemon, yang boleh dilakukan
lebih daripada sekadar duduk menunggu seseorang memulakan tetamu supaya ia boleh memberitahu kami
tentang itu. Tetapi kemudian kita akan mempunyai satu lagi perkara untuk dikonfigurasikan, satu lagi proses
berlari, dan lebih banyak masalah dengan memikirkan cara memastikan kita tidak kalah dalam perlumbaan apabila
hos dibut, antara mendapatkan set awal peristiwa peranti, proses itu berlaku
bersedia dan aktif, dan mana-mana tetamu yang akan dimulakan secara automatik semasa but sebenarnya bermula.

Cara lain ialah menggunakan cangkuk libvirt. Yang seterusnya mempunyai masalah tidak sebenarnya
membolehkan kami menjalankan sebarang fungsi libvirt daripadanya, yang perlu kami lakukan untuk melampirkan
peranti kepada hos. Dan yang kami tidak dapat menjamin bahawa kami hanya boleh memasang secara lalai,
kerana hanya terdapat satu cangkuk sedemikian pada sistem, yang mungkin sudah ada oleh pentadbir tempatan
guna...

Terdapat cara ketiga, tetapi itu melibatkan memerlukan pentadbir setempat untuk memulakan semua tetamu
mesin melalui pembungkus kita sendiri, bukannya melalui apa-apa mekanisme yang sudah mereka ketahui
dan gunakan. Yang tidak berskala untuk menyokong peranti USB lain dalam situasi yang sama, antara
banyak cara yang akan menjadi penyelesaian yang mengerikan untuk dikenakan kepada orang ramai.

Tetapi ada kelemahan yang boleh kita eksploitasi. Kita boleh menggunakan cangkuk libvirt qemu untuk mencetuskan a
menukar acara untuk udev, yang seterusnya boleh menyeru bbvirt dengan cara yang sama seperti itu
berlaku jika peranti itu benar-benar disambungkan ke palam panas, yang memberi kita lapisan amaran tambahan
kita perlu dapat melakukannya dengan selamat dari mata kail. Rube Goldberg akan berbangga, dan
sesetengah kepingan mungkin memerlukan pemasangan tangan, tetapi dengan semua ini tersedia, kita boleh melakukannya
sesuatu yang menyerupai fungsi USB biasa dalam mesin tetamu.

Ia tidak cantik, tetapi ia akan berfungsi dengan apa yang perlu kita usahakan.

Ok, hanya memberitahu me di mana kepada melanda ia.
Untuk menyusun ini bersama-sama, anda perlu memastikan semua yang berikut:

- The udev(7) peraturan daripada pakej bit-babbler dipasang. Jika anda memasang ini
daripada pakej Debian yang sepatutnya sudah dilakukan. Jika anda tidak melakukannya, anda perlu melakukannya
memasang peraturan yang terdapat dalam debian/bit-babbler.udev daripada pakej sumber kepada a
tempat yang sesuai pada sistem anda (mungkin /etc/udev/rules.d).

- The bbvirt(1) skrip dipasang di tempat di mana udev peraturan akan menemuinya. Jika awak
tidak memasang ini daripada pakej Debian, dan ia tidak ada / usr / bin, maka anda perlukan
untuk tweak udev peraturan yang sesuai.

- Peranti yang anda ingin gunakan dalam mesin tetamu, dan mesin yang anda ingin gunakan,
dinyatakan dalam bbvirt fail konfigurasi. Lokasi lalai untuk itu ialah
/etc/bit-babbler/vm.conf. Jika anda ingin menggunakan fail lain, anda perlu lulus fail tersebut
lokasi dengan --config pilihan dalam udev peraturan, dan kemas kini skrip cangkuk gunakan itu
fail juga. Butiran tentang perkara yang boleh anda masukkan ke dalam fail itu diterangkan dalam
CONFIGURATION PILIHAN seksyen di bawah.

- Fail cangkuk libvirt dipasang. Jika semua perkara di atas dilakukan, maka peranti akan menjadi
ditambahkan pada mesin tetamu yang sedang berjalan jika ia dipalamkan semasa tetamu sedang berjalan.
Langkah terakhir ini memastikan peranti yang telah dipalamkan akan ditambahkan pada baharu
memulakan tetamu juga (yang termasuk tetamu yang dimulakan secara automatik apabila hos
but mesin).

Sehingga terdapat beberapa cara selamat kita boleh memasang ini tanpa bercanggah dengan atau menulis ganti
cangkuk sedia ada, semua orang perlu melakukan langkah ini secara manual. Jika anda telah memasang
pakej Debian, maka contoh skrip cangkuk yang kami sediakan untuk ini boleh jadi
dijumpai dalam /usr/share/doc/bit-babbler/examples/qemu-hook. Jika anda tidak, ia boleh didapati
in libvirt/qemu-hook daripada pakej sumber.

Anda perlu memasang fail itu sebagai /etc/libvirt/hooks/qemu, atau gabungkan kandungannya dengan
yang ada qemu fail di sana jika anda sudah mempunyai set cangkuk itu. Jika fail itu tidak
sebelum ini wujud, anda perlu memulakan semula libvirtd(8) untuk mendapatkannya mula menggunakannya.

Itu sepatutnya meliputi semua automasi yang diperlukan, tetapi anda juga boleh melampirkan dan menanggalkan peranti
secara manual pada bila-bila masa juga. Butiran melakukan itu akan diterangkan dalam berikut
bahagian. Jika tidak, dengan semua perkara di atas dilakukan, tidak ada sebab lain untuk perlu memohon
bbvirt secara langsung.

PILIHAN

Terdapat dua mod operasi utama untuk bbvirt yang dipilih oleh permulaan
pilihan tindakan. Jika tindakan yang perlu dilakukan ialah melampirkan or lepaskan kemudian hanya satu peranti
akan diambil tindakan, dan peranti yang sepatutnya mesti dinyatakan dengan jelas, walaupun jika
hanya terdapat satu peranti pada hos pada masa itu. Apabila menyeru bbvirt secara manual,
yang peranti boleh ditentukan oleh nombor sirinya, alamat logiknya pada bas (dalam
bentuk busnum:devnum, diberikan sebagai integer perpuluhan), atau alamat fizikalnya pada bas (dalam
bentuk busnum-pelabuhan[.port ...]).

Jika tindakan yang perlu dilakukan ialah lampirkan-semua or tanggalkan-semua, maka peranti untuk bertindak adalah
dipilih oleh domain persatuan sebaliknya. Sekiranya domain dinyatakan secara eksplisit, kemudian semua
peranti yang diperuntukkan kepada domain tetamu itu dalam fail konfigurasi akan diambil tindakan
atas dengan cara yang sama seolah-olah bbvirt telah dipanggil untuk setiap daripada mereka secara individu dengan
melampirkan or lepaskan tindakan. Jika tidak domain disediakan, kemudian semua tetamu yang dikonfigurasikan
domain akan diambil tindakan dengan cara ini.

Pilihan tambahan berikut tersedia:

-C, --config
Tentukan fail konfigurasi alternatif untuk mengimport tugasan peranti daripadanya.
Jika laluan ke fail tidak disediakan secara eksplisit, maka ia akan dicari dalam
yang /etc/bit-babbler direktori (dengan a .conf akhiran).

-c, --sambung=URI
nyatakan dara(1) sambungan URI untuk menggunakan. Ini akan mengatasi a DOMAIN_URI menetapkan
untuk domain dalam fail konfigurasi. Jika itu tidak ditetapkan menggunakan salah satu daripada ini
kaedah kemudiannya dara lalai untuk pengguna berjalan bbvirt akan digunakan.

-D, --domain=nama
Tentukan domain libvirt untuk bertindak. Ini boleh digunakan untuk mengatasi peranti
peruntukan daripada fail konfigurasi apabila bbvirt dipanggil secara manual, atau untuk bertindak
pada peranti atau domain yang tidak dinyatakan dalam fail konfigurasi pada masa ini.

-b, --busnum=num
Tentukan nombor bas USB yang dilampirkan peranti. Pilihan ini kebanyakannya
digunakan untuk mengelak bbvirt perlu mencari perkara ini apabila ia sudah diketahui (seperti bila
ia dipanggil daripada a udev peraturan). Biasanya tidak ada banyak alasan untuk lulus ini jika
menyeru bbvirt secara manual, kerana anda hanya boleh menentukan peranti mengikut logiknya atau
alamat fizikal sebaliknya.

-d, --devnum=num
Tentukan nombor peranti USB yang peranti diberikan pada masa ini. Bersama dengan
nombor bas, ini membentuk alamat logik peranti. Pilihan ini adalah
kebanyakannya digunakan untuk mengelak bbvirt perlu mencari perkara ini apabila ia sudah diketahui (seperti
seperti apabila ia dipanggil daripada a udev peraturan). Biasanya tidak ada banyak alasan untuk lulus
ini jika memohon bbvirt secara manual, kerana anda hanya boleh menentukan peranti dengannya
alamat logik sebaliknya.

-n, --lari kering
Jangan pasang atau tanggalkan sebarang peranti, cuma tunjukkan perkara yang akan dicuba jika ini adalah a
lari secara langsung. Pilihan ini membayangkan tahap minimum --verbose, tetapi keterlaluan mungkin
ditingkatkan lagi dengan memberikan pilihan itu secara eksplisit.

-v, --verbose
Buat lebih bising tentang apa yang sebenarnya berlaku. Ia mungkin dihantar beberapa kali kepada
meningkatkan lagi verbositi.

-?, - membantu
Tunjukkan ringkasan ringkas tentang pilihan yang tersedia.

CONFIGURATION PILIHAN

. bbvirt fail konfigurasi mengandungi tugasan berubah-ubah menggunakan menampar(1) cangkerang
sintaks. Ia diperoleh sebagai coretan shell, jadi anda pada dasarnya boleh membina
konfigurasi untuk setiap domain secara dinamik, tetapi kebanyakannya tugasan statik mudah
peranti ke domain sudah memadai. Jika anda memilih untuk menjalankan kod di dalamnya, anda sepatutnya sangat
defensif tentang jarak nama mana-mana pembolehubah lain yang anda gunakan, atau sebarang kesan sampingan lain yang anda gunakan
mungkin menyebabkan berlaku. Sebarang bilangan domain tetamu boleh dikonfigurasikan di dalamnya.

Untuk setiap domain tetamu, dua pembolehubah mengawal tingkah laku bbvirt:

DOMAIN_URI_domain=URI
Pembolehubah ini adalah pilihan, dan menetapkan dara(1) sambungan URI untuk digunakan apabila
memasang atau menanggalkan peranti daripada yang diberikan domain. Jika --sambung pilihan adalah
secara eksplisit disampaikan kepada bbvirt ia akan mengatasi apa yang ditetapkan di sini. Jika sambungan
URI tidak ditetapkan menggunakan salah satu daripada kaedah ini kemudiannya dara lalai untuk pengguna
berlari bbvirt akan digunakan (yang biasanya akan menjadi root jika dijalankan dari udev).

DOMAIN_RNG_domain=( peranti siri nombor ... )
Pembolehubah ini diperlukan jika laluan automatik peranti ke domain adalah
dikehendaki. Ia adalah tatasusunan bash, diisi dengan senarai yang diasingkan ruang bagi semua
nombor siri peranti yang anda mahu berikan domain. Ia bukan satu kesilapan untuk
peranti untuk disenaraikan di sini yang tidak dipalamkan pada masa ini. Adalah penting untuk
memastikan bahawa peranti hanya diberikan kepada satu domain walaupun, dan peranti itu
yang diberikan kepada domain tetamu tidak akan digunakan oleh a seedd(1) contoh berjalan pada
tuan rumah (yang bermaksud seedd konfigurasi perlu diluluskan senarai eksplisit
peranti yang mungkin digunakan juga).

Nombor siri peranti mesti sentiasa digunakan di sini. Anda tidak boleh menentukan peranti dengan
alamat logik atau fizikalnya di dalam bas (seperti yang anda boleh lakukan di kebanyakan tempat lain di mana
kami mengambil ID peranti).

Gunakan bbvirt dalam talian menggunakan perkhidmatan onworks.net