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-
blog comments powered by Disqus