Panduan Update Database dan Konfigurasi INLISLite Untuk INLISLite versi 1.x, 2.x, dan 212 revisi tahun 2014 Oleh Aristianto Hakim, S.IPI1 A. Pemahaman Dalam perjalanannya sejak dibangun dan disebarluaskan pada tahun 2011, program aplikasi INLISLite telah mengalami banyak penyempurnaan dan perkembangan fitur. Penyempurnaan dan perkembangan fitur-fitur dalam sebuah program aplikasi adalah suatu hal yang biasa dilakukan untuk menjawab permasalahan yang ditemukan serta mengakomodasi usulan dan saran dari penggunanya. Hingga pertengahan tahun 2015 ini, program aplikasi INLISLite yang beredar adalah versi 2.1.2 dengan beberapa revisi penyempurnaan dan pengembangan. Untuk mengetahui perkembangan revisinya, Anda dapat melihat laman Updater pada situs web INLISLite, http://inlislite.perpusnas.go.id/?read=updater Versi program aplikasi INLISLite yang terinstal di tempat Anda mungkin saja berbeda dengan tempat lain, tergantung kapan mereka melakukan instalasi INLISLite. Selama pengembangan, terjadi juga perubahan pada struktur databasenya. Jika program aplikasi INLISLite yang Anda miliki merupakan versi 1.x, 2.x, atau 212 revisi 2014 dan belum pernah dimutakhirkan, kemungkinan akan terjadi ketidaksesuaian struktur database. Untuk itu perlu dilakukan pemutakhiran / update database dan konfigurasi INLISLite. B. Persiapan 1. Pastikan aplikasi MySQL Administrator telah terinstal Aplikasi MySQL Administrator digunakan untuk melakukan kegiatan backup database, restore database, dan jika perlu memutakhirkan isi ruas-ruas data. a. Ikon aplikasi ini terlihat seperti gambar berikut: b. File instalasi MySQL Administrator tersedia dalam bundel bimtek. Anda juga dapat mengunduhnya dari Situs web INLISLite (http://inlislite.perpusnas.go.id) 1 Aristianto Hakim adalah pustakawan pada Sub Bidang Otomasi Perpustakaan Nasional RI Hlm 1 dari 9 2. Pastikan aplikasi SQLYog telah terinstal Aplikasi SQLYog dalam panduan ini hanya digunakan untuk melakukan pemutakhiran dan penyesuaian struktur database INLISLite yang lama sehingga sama dengan struktur database INLISLite pembanding (yang paling mutakhir). Anda dapat menggunakan versi trial-nya untuk keperluan ini (versi trial berlaku 14 hari sejak diinstalasi) a. Ikon aplikasi ini terlihat seperti gambar berikut: b. File instalasi SQLYog versi trial terdapat dalam bundel bimtek. Anda juga dapat mengunduhnya melalui https://www.webyog.com/product/sqlyog 3. Jika Anda menggunakan INLISLite versi portabel, pastikan service nya telah dijalankan melalui inlislite-launcher 4. Pastikan Anda telah mengetahui / mencatat nama database, nomor port dan password database INLISLite yang digunakan. Untuk memastikannya: a. Bukalah folder program aplikasi INLISLite yang akan dimutakhirkan b. Bukalah folder inlis.lite c. Bukalah file web.config yang terdapat di dalam folder tersebut dengan aplikasi Notepad d. Carilah baris program koneksi database sbb: <add name="ConnectionStringMySQL" connectionString="Server=localhost;Port=XXXX;Database=YYYY;User Id=root; Password=ZZZZ;" providerName="MySql.Data.MySqlClient" /> e. Catatlah tulisan “Port=XXXX” yang tertera di sana f. Catatlah tulisan “Database=YYYY” yang tertera di sana g. Catatlah tulisan “Password=ZZZZ” yant tertera di sana h. Keluarlah dari aplikasi Notepad 5. Lakukan backup database INLISLite yang akan dimutakhirkan Backup database dimaksudkan untuk mengantisipasi terjadinya kegagalan yang mengakibatkan kerusakan data saat melakukan pemutakhiran struktur database INLISLite. Panduan cara backup database INLISLite tersedia dalam bundel bimtek. Panduan backup data ini juga dapat diunduh dari laman Panduan di situs web INLISLite, http://INLISLite.perpusnas.go.id/?read=panduan Hlm 2 dari 9 C. Memutakhirkan Struktur Database INLISLite Dalam panduan ini, pemutakhiran struktur database akan dilakukan melalui proses pembandingan dan sinkronisasi dengan struktur database INLISLite terbaru. Disamping itu juga menambahkan beberapa master data stored function yang dibutuhkan. Langkahnya adalah sebagai berikut: 1. Lakukan penambahan master data baru dan stored procedure baru, caranya: a. Jalankan aplikasi MySQL Administrator b. Isikan ruas port dan password database sebagaimana yang telah dicatat pada saat Persiapan di atas. Klik OK untuk masuk c. Di dalam jendela MySQL Administrator, klik menu Restore di panel kiri d. Di kanan bawah jendela Restore, klik tombol Open Backup File e. Carilah file masterdata_updater.sql yang tersedia di dalam folder database_updater, kemudian klik tombol Open Hlm 3 dari 9 f. Pada bagian Target schema, klik Another Schema dan pilihlah database INLISLite yang akan dimutakhirkan g. Pada bagian Option, klik untuk mencontreng pilihan Ignore Errors h. Klik tombol Start Restore, dan biarkan proses restorasi file masterdata ini selesai dengan status successfully Hlm 4 dari 9 i. Klik tombol Close j. klik lagi tombol Open Backup File k. Carilah file function_updater.sql yang tersedia di dalam folder database_updater, kemudian klik tombol Open l. Pada bagian Target schema, biarkan terpilih Another Schema dan pilihlah database INLISLite yang akan dimutakhirkan m. Pada bagian Option, biarkan tercontreng pilihan Ignore Errors n. Klik tombol Start Restore, dan biarkan proses restorasi file masterdata ini selesai dengan status successfully o. Klik tombol Close p. Penambahan datamaster dan stored function selesai 2. Lakukan restore database inlislite pembanding Langkah melakukan restore database ini sama seperti cara menambahkan master data dan stored function di atas, tetapi perlu diperhatikan bahwa: File yang di-restore adalah file db_inlislite_pembanding yang tersedia dalam folder database_updater Pada bagian Target Schema Anda memilih Another Schema dan berilah nama “inlislite_pembanding” Pada bagian Options, klik untuk mencontreng pilihan “Create database if they don’t exist” Setelah restorasi database inlislite pembanding ini berhasil, maka pastikan database dengan nama inlislite_pembanding telah terpasang. Caranya, klik menu Catalogs pada panel kiri, kemudian lihat di dalam kotak Schemata. Hlm 5 dari 9 Restore database inlislite pembanding selesai. Keluarlah dari aplikasi MySQL Administrator 3. Lakukan Sinkronisasi struktur database inlislite Sinkronisasi ini perlu dilakukan untuk memastikan struktur database inlislite yang saat ini digunakan akan termutakhirkan dan sama persis denngan struktur database inlislite pembanding. Cara melakukan sinkronisasi adalah sebagai berikut: a. Jalankan aplikasi SQLYog b. Isikan password dan nomor port database inlislite sebagaimana yang telah diketahui / dicatat pada bagian persiapan. Klik tombol Connect c. Setelah koneksi berhasil maka akan terbuka layar kerja SQLYog d. Pilih menu Powertools dan klik sub menu Schema Syncronization Tool... Hlm 6 dari 9 e. Pada jendela Schema Syncronization Tool, pilih database dengan nama inlislite_pembanding di sebelah kiri (kotak Select Source). Di kotak sebelah kanan (select target), pilih database dengan nama inlislite f. Pada sisi kanan, pastikan terpilih Only Tables. g. Klik tombol Compare yang ada di sisi kanan jendela tersebut h. Biarkan proses perbandingan berjalan Hlm 7 dari 9 hingga berstatus “Successfull” i. Klik tombol Execute All Dan klik tombol Yes pada jendela konfirmasi yang muncul j. Biarkan proses sinkronisasi dan pemutakhiran struktur database berjalan, sehingga pada bagian kiri bawah muncul tab Messages yang berisi pesan terkait jumlah row data yang tersinkronisasi, Execution time, Transfer time, dan Total time Jumlah row dan lamanya waktu proses yang berlangsung dapat berbedabeda pada setiap komputer. k. Proses perbandingan dan sinkronisasi / pemutakhiran struktur database telah selesai l. Keluarlah dari program aplikasi SQLYog Hlm 8 dari 9 D. Memutakhirkan Konfigurasi INLISLite Langkah selanjutnya adalah memutakhirkan file konfigurasi INLISLite. File ini bernama web.config yang berada di setiap folder program INLISLite yaitu checkpoint, inlis.lite, member, dan opac. Langkah pemutakhirannya adalah sebagai berikut 1. Bukalah folder database_updater 2. Bukalah folder checkpoint dan bukalah file web.config dengan aplikasi Notepad a. Carilah baris program koneksi database koneksi sbb: <add name="ConnectionStringMySQL" connectionString="Server=localhost;Port=XXXX;Database=YYYY;User Id=root; Password=ZZZZ;" providerName="MySql.Data.MySqlClient" /> b. Rubahlah nilai XXXX, YYYY, dan ZZZZ sesuai dengan data yang telah dicatat pada saat persiapan c. Simpanlah perubahan kemudian keluar dari aplikasi Notepad 3. Lakukan hal yang sama pada file web.config yang terdapat dalam folder inlis.lite, member, dan opac untuk memastikan konfigurasi koneksi databasenya juga telah sesuai dengan apa yang telah dicatat pada saat persiapan 4. Copy (salin) folder checkpoint, inlis.lite, member, dan opac dari folder database_updater tersebut 5. Bukalah folder program inlislite yang akan dimutakhirkan 6. Paste folder-folder yang telah disalin tersebut untuk me-replace folder-folder checkpoint, inlis.lite, member, dan opac yang lama 7. Proses pemutakhiran konfigurasi INLISLite telah selesai E. Hubungi Bantuan Teknis Apabila Anda masih menemui kesulitan dalam melakukan update INLISLite ini, silahkan menghubungi kami sebagaimana tertera pada situs web INLISLite (http://INLISLite.pnri.go.id), atau melalui grup facebook INLISLite Perpustakaan Indonesia (https://www.facebook.com/groups/INLISLite/) Hlm 9 dari 9