Instalasi dan Konfigurasi Oracle BI Publisher pada Apache Tomcat

Halo semuanya,

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
  1. Periksa folder installer BI publisher
    Pastikan terdapat 4 folder utama: doc/, install/, manual/, stage/, dan Translations/
  2. Silakan masuk ke Tomcat Web Application Manager
  3. Pilih bagian deploy (WAR file to deploy)
  4. Sebarkan (deploy) file bernama xmlpserver.war yang berada di folder manual/generic
  5. 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,
  1. Salin (copy) folder XMLP/ dari manual/ 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 di D:\apps\Tomcat6\, silakan sesuaikan dengan tempat Anda melakukan instalasi Apache Tomcat.
  2. Silakan modifikasi file xmlp-server-config.xml yang berada di <direktori_apache_tomcat>/WEB-INF/
    Akan muncul skema XML sebagai berikut
    
    
    
    
    
    
    
  3. Gantilah atribut path pada tag file dengan path tempat Anda menyalin folder XMLP/ pada nomor 1
    Misal:
    
    
  4. 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
  5. Jalankan ulang (restart) server Anda
  6. Sekarang silakan jalankan BI Publisher Server dengan membuka http://<hostname>:<port>/xmlpserver
  7. Masuk log dengan akun "Administrator" dan sandi (password) "Administrator"
  8. 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
  1. 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, dan DELETE record.
    • Kelas driver basis data (misal: oracle.jdbc.driver.OracleDriver untuk DBMS Oracle)

  2. Untuk menguji apakah koneksi ke basis data berhasil, silakan uji dengan mengklik tombol "Test Connection"
  3. Apabila sudah berhasil, silakan tambah skema untuk scheduler tadi dengan mengklik tombol "Install Schema"

Konfigurasi Oracle BI Publisher Data Source
  1. 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.
  2. Untuk file, yang didukung adalah file XML, dan untuk menambahkannya silakan klik "Add Data Source".
  3. 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
  4. 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
  1. Cara menggunakan Word Template Builder akan menjadi pembahasan tersendiri dan tidak di tulisan ini :D
  2. 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-

Say Hello to Oracle BI Publisher

Halo semuanya,

Di awal Juli ini saya akan menulis artikel tentang Oracle BI Publisher. Mohon maaf, janji saya pada post sebelumnya tentang data warehouse belum bisa saya penuhi sekarang karena tulisan tentang data warehouse sifatnya sangat konseptual dan rupanya cukup njelimet (rumit) dan malas juga untuk menyusun tulisan tentang data warehouse agar mudah dibaca dan dipahami oleh pembaca, :D . Baik, kali ini saya akan langsung membahas tentang salah satu bagian dari pembangunan data warehouse, yaitu reporting system, utamanya tentang kakas (tool) yang saya gunakan pada saat kerja praktek ini yaitu Oracle BI Publisher.

Sebaiknya, Anda mengetahui dulu keterkaitan antara data warehouse dan reporting system. Kalau Anda sudah tahu, silakan lewatkan (skip) paragraf ini untuk beralih ke paragraf berikutnya :D . Data warehouse (bagian yang lebih detail dan teknis ada di post yang lain :P ) dibuat dengan tujuan untuk melakukan analisis terhadap data historis yang dimiliki oleh suatu organisasi (umumnya korporat), dan analisis ini digunakan sebagai penunjang keputusan atau kebijakan yang akan diambil oleh perusahaan. Nah, hasil akhir dari analisis data historis tadi bisa berupa berbagai laporan yang ditujukan untuk kalangan eksekutif perusahaan (umunya top level management). Contoh: Laporan hasil penjualan produk XXX (jangan ngeres dulu ya... :D ) di seluruh Indonesia yang akan ditujukan untuk manajer pemasaran PT XYZ. Laporan ini nantinya bisa dilihat lebih detail per provinsi (misalnya), atau per kabupaten, sehingga sang manajer pemasaran bisa tahu tren pasar secara hierarkis (dari nasional ke aras/level di bawahnya) dari laporan tersebut. Dari situ akhirnya sang manajer bisa memutuskan langkah perusahaan ke depan terkait dengan strategi pemasaran produk tersebut. Got the point? ;)

Oracle BI Publisher


Salah satu kakas (tool) yang cukup andal dalam masalah enterprise reporting system ini adalah Oracle BI Publisher (dulu bernama XML Publisher, karena data mentah keluarannya berformat XML, bahkan hingga saat ini). Ada beberapa kelebihan tentang kakas ini, yaitu:

  1. Terintegrasi dengan Micro$*ft Word, jadi, pengguna enterprise reporting system bisa melakukan pembangunan template laporan menggunakan kakas dokumen produksi Micro$*ft yang mudah dipakai dan mahal ini. Yang perlu Anda catat, Word Template Builder ini perlu platform .NET 2.0 agar bisa digunakan.

  2. Mampu mendukung pengiriman lebih dari satu channel (web, FTP, e-mail, faks, printer).

  3. Mampu mendukung format keluaran yang bermacam-macam (XML/mentah, HTML, MHTML, PDF, CSV, PPT).

  4. Menyediakan fasilitas penjadwalan untuk pengiriman laporan (sepertinya ini merupakan standar dari suatu enterprise reporting system).

  5. Menyediakan layanan web service, sehingga fasilitas pembangkitan laporan bisa dipanggil melalui aplikasi lain.

  6. Mampu mendukung template animasi Flash, jadi laporan yang dibuat bisa menjadi laporan yang menarik dan interaktif.

  7. Mampu mendukung berbagai sistem manajemen basis data (RDBMS); tidak terbatas keluarga Oracle saja. Anda juga bisa mengambil data yang berada pada RDBMS MySQL, dan RDBMS lain asalkan didukung oleh Java Database Connectivity (JDBC) :D . Satu lagi, Anda bisa langsung menjadikan file XML sebagai sumber data, asalkan skemanya sesuai. Pembahasan tentang skema XML ini masuk ke bagian teknis, dan tidak akan dibahas di sini.


Baru 7 hal tersebut kelebihan Oracle BI Publisher yang saya ketahui sejauh ini. Saya belum pernah membandingkan aplikasi enterprise reporting system yang lain, jadi pendapat di atas masih kurang objektif. Harap maklum saja, sebelumnya saya hanya mendapatkan teori dan konsep saja pada saat kuliah :D .

Sementara itu, beberapa hal yang menurut saya "kurang" dari kakas ini adalah tentu saja dari segi harga :( . Yup, Oracle BI Publisher memang termasuk golongan aplikasi proprietary yang biasa dipakai kalangan korporat. Tapi tentu saja kocek dan kemampuan menurut saya sudah cukup sebanding. Hehe, beruntung juga saya bisa mencoba satu contoh kakas mahal secara legal.

Apabila Anda tertarik untuk melihat aplikasi Oracle BI Publisher, silakan kunjungi halaman resminya, dan apabila Anda ingin tahu lebih banyak tentang cara penggunaannya, silakan kunjungi blog Oracle BI Publisher.

Sampai di sini dulu tulisan pengantar dari saya tentang Oracle BI Publisher. Sampai jumpa di tulisan selanjutnya tentang langkah instalasi dan konfigurasi Oracle BI Publisher. Saya berencana untuk mempublikasikan banyak artikel seputar kerja saya di sini, termasuk tentang Oracle BI Publisher :D . Terakhir, mohon koreksi apabila Anda menemui kesalahan.

-KnightDNA-