Kali ini saya akan menulis petunjuk instalasi dan konfigurasi Oracle BI Publisher Enterprise Edition. Berikut ini lingkungan (environment) tempat saya melakukan instalasi. Mohon Anda perhatikan dulu,
LINGKUNGAN INSTALASI
- Sistem operasi: Micro$*ft Wi*dows XP SP3
- Spesifikasi hardware: Intel Core2Duo T8100 @2.10GHz, RAM 2,00GB
- Server: Apache Tomcat 6.0.13
- Versi JDK: 1.6.0 Update 6
- Versi Oracle BI Publisher: 10.1.3.3.2
Berikut adalah langkah-langkahnya,
DEPLOYMENT ORACLE BI PUBLISHER SERVER
- Periksa folder installer BI publisher
Pastikan terdapat 4 folder utama:doc/
,install/
,manual/
,stage/
, danTranslations/
- Silakan masuk ke Tomcat Web Application Manager
- Pilih bagian deploy (WAR file to deploy)
- Sebarkan (deploy) file bernama
xmlpserver.war
yang berada di foldermanual/generic
- Apabila proses deployment berhasil maka path
/xmlpserver
akan muncul di bagian Applications dari Tomcat Web Application Manager
KONFIGURASI REPOSITORI DAN FONT ORACLE BI PUBLISHER SERVER
Setelah aplikasi berhasil di-deploy, silakan ikuti langkah-langkah di bawah ini,
- Salin (copy) folder
XMLP/
darimanual/
ke server; tempatnya terserah Anda, asalkan masih berada di folder Apache Tomcat :D
Misal:<direktori_apache_tomcat>/webapps/xmlpserver
(tempat deployment aplikasi .war tadi), atau di tempat lain
Catatan:<direktori_apache_tomcat>
tempat saya ada diD:\apps\Tomcat6\
, silakan sesuaikan dengan tempat Anda melakukan instalasi Apache Tomcat. - Silakan modifikasi file
xmlp-server-config.xml
yang berada di<direktori_apache_tomcat>/WEB-INF/
Akan muncul skema XML sebagai berikut
- Gantilah atribut path pada tag file dengan path tempat Anda menyalin folder
XMLP/
pada nomor 1
Misal:
- Salin (copy) font yang ada pada folder
manual/fonts
ke direktori font yang dipakai oleh Java Runtime Environment di tempat Anda masing-masing.
Misal ke:D:\java\jre1.6.0_06\lib\fonts
- Jalankan ulang (restart) server Anda
- Sekarang silakan jalankan BI Publisher Server dengan membuka
http://<hostname>:<port>/xmlpserver
- Masuk log dengan akun "Administrator" dan sandi (password) "Administrator"
- Selanjutnya, silakan lakukan konfigurasi minimal pada server (baca bagian selanjutnya).
Catatan: demi keamanan, silakan modifikasi akun superuser Administrator tersebut.
Setelah Oracle BI Publisher server berhasil di-install, langkah selanjutnya adalah melakukan konfigurasi minimal, yaitu konfigurasi Scheduler dan Data Source. Konfigurasi hal lain tergantung dari kebebasan dan kreativitas Anda. Silakan baca Dokumentasi Oracle BI Publisher di folder
doc/
pada tempat installer Oracle BI Publisher untuk tahu lebih lengkap. Hal tersebut akan terlalu banyak apabila diulas dalam satu tulisan ini.Konfigurasi Oracle BI Publisher Scheduler
- Silakan masuk ke bagian Admin > Scheduler Configuration
- Masukkan parameter yang diperlukan, antara lain:
- Jenis DBMS (yang didukung untuk penjadwalan hanya Oracle/minimal 8i, IBM DB2/minimal versi 6, Micro$*ft SQL Server, MySQL, dan Sybase)
- Koneksi (memanfaatkan fasilitas JDBC, pastikan Anda sudah memiliki kelas driver untuk masing-masing DBMS)
Contoh:jdbc:oracle:thin@localhost:1521:orcl
apabila menggunakan DBMS Oracle dengan instans (instance) orcl - Akun (username) dan sandi (password), pastikan akun ini memiliki kewenangan (privilege) yang cukup untuk melakukan penambahan skema serta transaksi
INSERT
,UPDATE
, danDELETE
record. - Kelas driver basis data (misal:
oracle.jdbc.driver.OracleDriver
untuk DBMS Oracle)
- Untuk menguji apakah koneksi ke basis data berhasil, silakan uji dengan mengklik tombol "Test Connection"
- Apabila sudah berhasil, silakan tambah skema untuk scheduler tadi dengan mengklik tombol "Install Schema"
Konfigurasi Oracle BI Publisher Data Source
- Silakan masuk ke bagian Admin > Data Sources
Catatan: Perhatikan bahwa ada pengaturan untuk koneksi JDBC, koneksi JNDI, dan File (XML). Umumnya yang dipakai adalah koneksi JDBC atau File. - Untuk file, yang didukung adalah file XML, dan untuk menambahkannya silakan klik "Add Data Source".
- Masukkan parameter yang dibutuhkan.
Catatan: Perhatikan bahwa parameter Full Path of Top-Level Directory harus diisi dengan absolut path ke folder di mana Anda akan menaruh kumpulan file .XML di dalamnya.
Misal:D:\data\xml
- Untuk koneksi JDBC atau JNDI silakan lakukan langkah serupa dengan masukan file XML
Catatan: Perhatikan bahwa untuk parameter yang diperlukan pada JDBC mirip dengan langkah konfigurasi Oracle BI Publisher Scheduler, yaitu: Koneksi JDBC, username dan password, serta kelas driver basis data. Jangan lupa untuk memastikan koneksi sudah berhasil dengan mengklik tombol "Test Connection" terlebih dulu. Setelah itu, silakan klik tombol "Apply".
CATATAN
Segala perubahan yang terkait dengan konfigurasi server akan bisa berjalan setelah Anda menjalankan ulang server.
INSTALASI ORACLE BI PUBLISHER DESKTOP
Setelah instalasi dan konfigurasi minimal Oracle BI Publisher Server dijalankan, maka Anda sudah bisa membangkitkan laporan dengan sumber data yang ada dari data source atau file XML tersendiri. Selain itu ada plug-in integrasi Micro$*ft Office dengan Oracle BI Publisher yang bisa Anda manfaatkan, yaitu Word Template Builder (untuk membuat template menggunakan MS Word) dan Excel Analyzer (untuk OLAP). Untuk memanfaatkannya, silakan install Oracle BI Publisher Desktop dan ExcelAnalyzer yang terdapat di folder instalasi, subfolder
manual/XMLP/Tools
.Instalasi bersifat GUI-based sehingga akan memudahkan Anda untuk memasukkan parameter yang diperlukan pada saat instalasi. Silakan ikuti langkah-langkah langsung pada saat instalasi setelah mengklik masing-masing installer tadi.
CATATAN
- Cara menggunakan Word Template Builder akan menjadi pembahasan tersendiri dan tidak di tulisan ini :D
- Oracle BI Publisher Desktop dan ExcelAnalyzer memerlukan platform .NET 2.0 untuk berjalan. Pastikan Anda sudah meng-install .NET 2.0 sebelumnya.
Demikian catatan instalasi Oracle BI Publisher dari saya. Semoga bisa membantu Anda yang memerlukan panduan tersebut. Pesan saya, tetap gunakan aplikasi legal dan jangan terjebak pada fanatisme penggunaan teknologi atau kakas tertentu. Mohon koreksi bila Anda menemui kesalahan pada tulisan di atas, atau ada bagian yang kurang lengkap. Silakan isi bagian komentar apabila Anda ingin berdiskusi dengan saya. Terima kasih dan semoga hari Anda menyenangkan selalu! :)
-KnightDNA-