Gambaran Umum Inisialisasi Pencadangan

Tahap pencadangan ini menginisialisasi penulis dan pemohon dengan mengisi struktur data internal mereka, menentukan parameter cadangan dan membangun komunikasi penulis/pemohon melalui panggilan yang diperlukan untuk IVssBackupComponents::GatherWriterMetadata. Untuk informasi selengkapnya, lihat Ringkasan Pemrosesan Cadangan menurut VSS.

Tabel berikut ini memperlihatkan urutan tindakan dan peristiwa yang diperlukan untuk inisialisasi cadangan.

Tindakan pemohon	Peristiwa	Tindakan penulis
Membuat antarmukaIVssBackupComponentsdan menginisialisasinya untuk mengelola cadangan (lihat CreateVssBackupComponents, IVssBackupComponents::InitializeForBackup) dan secara opsional mengaktifkan atau menonaktifkan penulis pada sistem.	Tidak	Tidak
Secara opsional mengatur konteks untuk operasi salinan bayangan dan secara opsional mengkueri sistem tentang penyedia dan salinan bayangan yang didukungnya (lihat IVssBackupComponents::SetContext, IVssBackupComponents::Query).	Tidak	Tidak
Pemohon dapat memberikan informasi tambahan tentang menangani operasi pencadangan dan pemulihan (lihat IVssBackupComponents::SetBackupState)	Tidak	Tidak
Memulai kontak asinkron dengan penulis (lihat IVssBackupComponents::GatherWriterMetadata)	Identifikasi	Membuat Dokumen Metadata Penulis (lihat Bekerja dengan Dokumen Metadata Penulis, CVssWriter::OnIdentify, IVssCreateWriterMetadata)

 

Tindakan Pemohon selama Inisialisasi Pencadangan

ObjekIVssBackupComponents hanya dapat digunakan untuk satu cadangan. Oleh karena itu, pemohon harus melanjutkan hingga akhir cadangan, termasuk merilis antarmuka IVssBackupComponents. Jika cadangan perlu dihentikan lebih awal dari yang direncanakan, pengaju perlu memanggil IVssBackupComponents::AbortBackup dan kemudian melepaskan objek IVssBackupComponents (informasi selengkapnya dapat dilihat di Membatalkan Operasi VSS). Jangan mencoba melanjutkan antarmuka IVssBackupComponents.

Biasanya, Dokumen Komponen Cadangan pemohon diinisialisasi sebagai kosong. Dokumen Komponen Cadangan yang Tersimpan dapat dimuat saat IVssBackupComponents::InitializeForBackup dipanggil, biasanya untuk mendukung volume tiruan bayangan yang dapat dipindahkan. Dalam hal ini, komunikasi antara penulis dan pemohon akan agak berbeda dengan apa yang dijelaskan di bawah ini. (Lihat Mengimpor Volume Salinan Bayangan yang Dapat Diangkut untuk informasi lebih lanjut.)

Untuk menambahkan volume ke set salinan bayangan, pemohon harus terlebih dahulu mengatur konteks untuk operasi salinan bayangan dengan memanggil IVssBackupComponents::SetContext. Jika metode ini tidak dipanggil, konteks default untuk salinan bayangan, VSS_CTX_BACKUP, digunakan. Untuk informasi tentang mengatur konteks salinan bayangan, lihat Konfigurasi Konteks Salinan Bayangan.

Untuk memulai proses penyelesaian penyiapan sebelum pencadangan, pemohon harus memanggil IVssBackupComponents::SetBackupState. Dengan melakukan ini, pemohon menunjukkan kepada penulis:

• Jenis cadangan (seperti yang didefinisikan dalam VSS_BACKUP_TYPE)
• Apakah cadangan menyertakan status sistem yang dapat di-boot
• Apakah pemohon mendukung pemilihan komponen individual atau mencadangkan seluruh volume.

Semua pemohon yang berpartisipasi dalam operasi pencadangan dan pemulihan harus selalu memanggil IVssBackupComponents::GatherWriterMetadata. Metode ini memulai komunikasi penulis-pemohon dengan menghasilkan peristiwa VSS Identify, di mana penulis kemudian membuat dokumen metadatanya.

Sebelum memanggil IVssBackupComponents::GatherWriterMetadata, pemohon memiliki kesempatan untuk secara eksplisit mengaktifkan atau menonaktifkan penulis dan kelas penulis tertentu menggunakan IVssBackupComponents::EnableWriterClasses, IVssBackupComponents::DisableWriterInstances, dan IVssBackupComponents::DisableWriterClasses (secara default, semua kelas diaktifkan). Setelah IVssBackupComponents::GatherWriterMetadata dipanggil, panggilan-panggilan ini tidak berpengaruh.

Karena tidak ada cara untuk mendapatkan daftar penulis pada sistem sebelum memanggil IVssBackupComponents::GatherWriterMetadata, pemohon dapat mempertimbangkan untuk membuat dan kemudian menghapus instans kedua IVssBackupComponents untuk mendapatkan daftar.

Tidak perlu memanggil IVssBackupComponents::GatherWriterStatus setelah selesai IVssBackupComponents::GatherWriterMetadata. Penulis yang gagal memproses peristiwa Identifikasi yang dihasilkan oleh pemanggilan tidak akan menjadi bagian dari daftar penulis yang menyediakan metadata yang ditemukan oleh IVssBackupComponents::GetWriterMetadataCount dan IVssBackupComponents::GetWriterMetadata (lihat Menentukan Status Penulis).

Tindakan Penulis selama Inisialisasi Cadangan

Sebagai respons terhadap peristiwa Identifikasi, VSS memanggil metode handler virtual setiap penulis, CVssWriter::OnIdentify. Seorang penulis menciptakan Dokumen Metadata Penulis-nya dengan menggantikan implementasi default CVssWriter::OnIdentify dan menggunakan antarmuka IVssCreateWriterMetadata.

Perhatikan bahwa aplikasi selain pemohon saat ini (misalnya, aplikasi sistem) dapat menghasilkan Peristiwa Identifikasi yang harus ditangani oleh penulis. Selain itu, tidak ada cara bagi penulis untuk menentukan dari dalam CVssWriter::OnIdentify aplikasi mana yang telah menghasilkan peristiwa Identifikasi.

Hal ini terjadi, mengingat bahwa penulis dapat menerima beberapa peristiwa Identifikasi saat memproses operasi pencadangan, penulis tidak boleh mengatur informasi status di CVssWriter::OnIdentify handler.

Sebagai gantinya, CVssWriter::OnIdentify harus melakukan algoritma yang konsisten untuk membuat Dokumen Metadata Penulis penulis, terutama karena setelah penulis membuat dokumen, pemohon maupun penulis tidak dapat memodifikasinya. Dari titik ini seterusnya, ini adalah dokumen baca-saja.

Ini berarti bahwa jumlah dan jenis komponen yang terkait dengan penulis, file mana yang merupakan bagian dari setiap komponen, dan pengecualian eksplisit file dari operasi pencadangan atau pemulihan data tidak dapat diubah setelah penulis selesai memproses acara Identifikasi.

Semua penulis yang berpartisipasi dengan VSS diharuskan untuk melakukan hal berikut:

1. Tunjukkan metode pemulihan untuk semua komponen yang dikelola oleh penulis menggunakan IVssCreateWriterMetadata::SetRestoreMethod.
2. Tambahkan setidaknya satu komponen menggunakan IVssCreateWriterMetadata::AddComponent (lihat Definisi Komponen oleh Penulis untuk informasi selengkapnya tentang spesifikasi komponen).

Penulis menunjukkan file untuk berpartisipasi dalam operasi pencadangan atau pemulihan dengan menambahkan set file —kombinasi jalur, spesifikasi file, dan bendera rekursi—ke komponen tertentu menggunakan IVssCreateWriterMetadata::AddFilesToFileGroup, IVssCreateWriterMetadata::AddDatabaseFiles, atau IVssCreateWriterMetadata::AddDatabaseLogFiles, bergantung pada jenis (Lihat Menambahkan File ke Komponen.)

Penulis mungkin juga memiliki satu atau beberapa komponen kosong, komponen yang tidak ada file yang ditambahkan. Ini sangat berguna dalam mengatur komponen penulisan. (Lihat Penjejakan Logis Komponen.)

Penulis menggunakan IVssCreateWriterMetadata::AddExcludeFiles untuk secara eksplisit mencegah file disertakan dalam cadangan. Pengecualian eksplisit ini berguna karena karakter wildcard dapat digunakan untuk menetapkan file yang akan dimasukkan (lihat Spesifikasi Daftar File yang Dikecualikan). Perhatikan bahwa daftar file yang dikecualikan lebih diutamakan daripada daftar file komponen.

IVssCreateWriterMetadata::AddAlternateLocationMapping digunakan untuk membuat pemetaan lokasi alternatif untuk set file tertentu yang telah ditambahkan ke salah satu komponen penulis. Pemetaan ini digunakan selama pemulihan file saat memulihkan ke lokasi asal file tidak memungkinkan atau tidak diinginkan. (Lihat Gambaran umum Pemulihan File Aktual dan Lokasi Pencadangan dan Pemulihan Non-Default.)

Karena kumpulan file cadangan ditentukan dalam Dokumen Metadata Penulis, set file tersebut tidak dapat dimodifikasi nanti. Oleh karena itu, sebuah program harus dikodekan sehingga definisi set file akan menyertakan semua file yang diperlukan untuk cadangan, baik berdasarkan nama atau melalui karakter wildcard. Mungkin saja, ini mencakup beberapa file yang mungkin dibuat setelah peristiwa Identifikasi.