SimralWiki

<h1>Instalasi Aplikasi SIMRAL</h1>
<div class="level1">

</div>

<h2>Kebutuhan teknis aplikasi</h2>
<div class="level2">

<p>
Untuk instalasi aplikasi SIMRAL diperlukan spesifikasi minimum sebagai berikut:
</p>
<ul>
<li class="level1"> Webserver Apache minimal versi 2.2</li>
<li class="level1"> PHP minimal versi 5.5</li>
<li class="level1"> Database MySQL minimal versi 5.6 atau MariaDB</li>
<li class="level1"> Java Runtime Environment (JRE) minimal versi 7</li>
<li class="level1"> Sistem Operasi Linux atau Microsoft Windows</li>
</ul>

<p>
Aplikasi SIMRAL bisa diinstal dengan menggunakan 2 metode:
</p>
<ul>
<li class="level1"> Instalasi secara manual</li>
<li class="level1"> Instalasi menggunakan Docker</li>
</ul>

<p>
Metode instalasi dengan menggunakan Docker lebih disarankan karena jauh lebih mudah dan bisa menggunakan sistem operasi apapun dengan syarat telah terinstal Docker Engine.
</p>

</div>

<h2>Instalasi secara manual</h2>
<div class="level2">

</div>

<h3>Persiapan instalasi pada sistem operasi Linux</h3>
<div class="level3">

<p>
Untuk penggunaan versi production disarankan menggunakan sistem operasi Linux distribusi Ubuntu 14.04 atau Debian 8.2.
</p>

<p>
Berikut langkah-langkah instalasi yang harus dilakukan:
</p>

</div>

<h4>Instalasi Apache</h4>
<div class="level4">

<p>
Lakukan perintah-perintah pada terminal berikut ini untuk melakukan instalasi apache:
</p>
<pre class="code">sudo apt-get update
sudo apt-get install apache2

</pre><p> </p>

<p>
Untuk mengecek apakah instalasi telah berhasil dan webserver apache telah berfungsi, buka alamat berikut pada browser:
</p>
<pre class="code">http://server_IP_address

</pre><p> </p>

<p>
Maka akan muncul halaman default untuk Apache Ubuntu 14.04:
</p>

</div>

<h4>Instalasi MySQL</h4>
<div class="level4">

<p>
Gunakan perintah berikut untuk melakukan instalasi aplikasi database MySQL:
</p>
<pre class="code">sudo apt-get install mysql-server php5-mysql

</pre><p> </p>

</div>

<h4>Instalasi PHP</h4>
<div class="level4">

<p>
Perintah apt dibawah ini untuk instalasi PHP dan modul PHP untuk Apache:
</p>
<pre class="code">sudo apt-get install php5 libapache2-mod-php5 php5-mcrypt

</pre><p> </p>

<p>
Untuk keperluan aplikasi SIMRAL, modul-modul PHP berikut harus diinstal:
</p>
<ul>
<li class="level1"> xml</li>
<li class="level1"> bcmath</li>
<li class="level1"> dom</li>
<li class="level1"> mbstring</li>
<li class="level1"> fileinfo</li>
<li class="level1"> gd</li>
<li class="level1"> gettext</li>
<li class="level1"> mcrypt</li>
<li class="level1"> mysql</li>
<li class="level1"> mysqli</li>
<li class="level1"> pdo_mysql</li>
<li class="level1"> SimpleXML</li>
<li class="level1"> sockets</li>
<li class="level1"> xmlreader</li>
<li class="level1"> xmlwriter</li>
<li class="level1"> zip</li>
</ul>

<p>
Untuk melihat daftar modul PHP yang bisa diinstal gunakan perintah berikut:
</p>
<pre class="code">apt-cache search php5-

</pre><p> </p>

<p>
Selanjutnya lakukan instalasi masing-masing modul php dengan perintah:
</p>
<pre class="code">sudo apt-get install &lt;nama-modul-php&gt;

</pre><p> </p>

<p>
Setelah melakukan instalasi semua modul PHP yang diperlukan, lakukan restart Apache dengan perintah berikut ini:
</p>
<pre class="code">sudo service apache2 restart

</pre><p> </p>

</div>

<h4>Instalasi JRE (Java Runtime Environment)</h4>
<div class="level4">

<p>
Untuk keperluan report pada aplikasi SIMRAL diperlukan JRE untuk menjalankan Jasper Report Engine. Perintah berikut digunakan untuk melakukan instalasi JRE:
</p>
<pre class="code">sudo apt-get install default-jre

</pre><p> </p>

</div>

<h3>Instalasi SIMRAL</h3>
<div class="level3">

</div>

<h4>Copy source code SIMRAL</h4>
<div class="level4">

<p>
Copy-kan semua file source code SIMRAL kedalam folder <code>/var/www/html/simral</code>
</p>

</div>

<h4>Restore Database SIMRAL</h4>
<div class="level4">

<p>
Untuk setiap tahun anggaran, aplikasi SIMRAL memiliki 3 skema database:
</p>
<ul>
<li class="level1"> <b>lived_sikd_kabkota_xxxx</b>  : database framework aplikasi</li>
<li class="level1"> <b>sikd_kabkota_xxxx</b>  : database SIMRAL</li>
<li class="level1"> <b>sikd_kabkota_xxxx_log</b>  : database log SIMRAL</li>
</ul>

<p>
Setiap skema diatas tersedia dalam dalam bentuk mysql-dump dalam paket source code SIMRAL. Untuk restore setiap skema database bisa dilakukan melalui terminal mysql dengan perintah berikut, dengan terlebih dahulu masuk ke folder tempat file-file tersebut diatas:
</p>
<pre class="code">cd &lt;folder_tempat_file_mysql-dump&gt;
mysql -u root -p

</pre><p> </p>

<p>
Setelah muncul terminal mysql, gunakan perintah berikut untuk me-restore database (sebagai contoh untuk tahun anggaran 2020):
</p>
<pre class="code">CREATE DATABASE lived_sikd_kabkota_2020;
USE lived_sikd_kabkota_2020;
source lived_sikd_kabkota_xxxx.sql

</pre><p> </p>
<pre class="code">CREATE DATABASE sikd_kabkota_2020;
USE sikd_kabkota_2020;
source sikd_kabkota_xxxx.sql

</pre><p> </p>
<pre class="code">CREATE DATABASE sikd_kabkota_2020_log;
USE sikd_kabkota_2020_log;
source sikd_kabkota_xxxx_log.sql

</pre><p> </p>

</div>

<h4>Konfigurasi SIMRAL</h4>
<div class="level4">

<p>
Terdapat 2 file yang perlu dikonfigurasi atau dibuat, yaitu:
</p>
<ul>
<li class="level1"> <b>cfg/config_map.xml</b>  : File mapping antara tahun anggaran dan file konfigurasi</li>
<li class="level1"> <b>cfg/appl_config_xxxx.php</b>  : File konfigurasi tahun anggaran</li>
</ul>

<p>
Berikut adalah contoh file <code>cfg/config_map.xml</code>  :
</p>
<pre class="code">&lt;?xml version="1.0" encoding="iso-8859-1" ?&gt;
&lt;config_map&gt;
    &lt;item&gt;
        &lt;title&gt;2020&lt;/title&gt;
        &lt;cfg_file&gt;appl_config_2020.php&lt;/cfg_file&gt;
        &lt;default&gt;1&lt;/default&gt;
    &lt;/item&gt;
&lt;/config_map&gt;

</pre><p> </p>

<p>
Sedangkan contoh file <code>cfg/appl_config_xxxx.php</code>  seperti berikut :
</p>
<pre class="code">&lt;?php
/**
 * LIVED Configuration File
 *
 * @file         appl_config.php
 * @modul        LIVED PHP Application Framework Configuration
 * @author       Agus
 * @version      LIVED V.1.0
 * @license      Copyright (c) 2007 BPPT-Kominfo
 * @description  Variabel-variabel konfigurasi dasar LIVED-Application Framework
 */

# Konfigurasi ADODB koneksi ke database application framework

// ADODB Database Driver
  $db_type     = "mysql";

// ADODB Database Host
  $db_host     = "simralweb-db";

// ADODB Database User
  $db_user     = "root";

// ADODB Database Password
  $db_pswd     = "simral@d0ck3R";

// Application Framework Database
  $db_appl     = "lived_sikd_2020";

# Setting directory

// Direktori instalasi LIVED-Application Framework
// Contoh untuk sistem operasi linux:
// $base_path = "/var/www/html/lived";
// Contoh untuk sistem operasi microsoft windows: (gunakan DOUBLE backslash untuk pemisahan direktori)
  $base_path = "/var/www/html/simral";

// URL LIVED-Application Framework, alamat url untuk mengakses LIVED
  $web_path = "http://localhost/simral";

// Direktori data database mysql untuk keperluan backup
// $mysql_data_path = "/var/lib/mysql/";
//  $mysql_data_path = "D:\\AppServ\\MySQL\\data";

// Logo aplikasi di sebelah kiri (logo institusi)
// Sebaiknya berformat GIF dengan transparansi, ukuran maksimal sekitar tinggi 80 pixel, lebar 80 pixel
  $header_logo_left = "images/logo.gif";

// Titel aplikasi
  $header_application_title = "Sistem Informasi Perencanaan, Penganggaran dan Pelaporan";

// Nama institusi 1
  $header_title = "Pemerintah Kabupaten/Kota";

// Nama institusi 2, dibawah nama institusi 1, dengan huruf yang lebih kecil
  $header_subtitle = "Version 2.0 2014-2016";

// Cakupan wilayah aplikasi
  $kode_wilayah = "3510";

// Jumlah record/baris untuk tampilan form list
  $record_per_page = 20;

// Jasper Report Server
  $jasper_server_address = "simralweb-report";
  $jasper_server_port = 9999;
  $jasper_dir = $base_path."\\modul\\sikd_2018";

// Awalan phrase object id (harus angka!)
  $object_model_pre_id = "9829";

$default_latitude = "-6.752847";
  $default_longitude = "111.040011";

$enable_obj_log = true;
  $log_db_type = "mysql";
  $log_db_host = "simralweb-db";
  $log_db_user = "root";
  $log_db_pswd = "simral@d0ck3R";
  $log_db_name = "sikd_2020_log";
?&gt;

</pre><p> </p>

</div>

<h4>Test Aplikasi SIMRAL</h4>
<div class="level4">

<p>
Gunakan browser untuk membuka aplikasi SIMRAL dengan alamat
</p>
<pre class="code">http://&lt;server_ip&gt;/simral

</pre><p> </p>

<p>
Pada halaman login masukan user: <code>admin</code>  dan password: <code>#s1mr@lbppt</code>. Apabila berhasil akan muncul halaman awal aplikasi SIMRAL.
</p>

</div>

<h4>Konfigurasi Modul Aplikasi</h4>
<div class="level4">

<p>
Aplikasi SIMRAL didesain agar tiap modul bisa memiliki koneksi database masing-masing. Untuk itu perlu dilakukan konfigurasi koneksi pada tiap-tiap modul dengan cara melalui modul Administrator, menu Setup Aplikasi –> Modul
</p>

<p>
Kemudian klik pada nama salah modul, setelah muncul tampilan view modul, klik pada tombol edit pada toolbar sehingga muncul tampilan berikut:
</p>

<p>
Sesuaikan nama database host, user dan password, kemudian klik tombol simpan. Lakukan prosedur tersebut untuk semua modul.
</p>

</div>

<h4>Jasper Report Server</h4>
<div class="level4">

<p>
Pastikan file lib/jasper_report/run_jasperserver memiliki attribute executable, jika belum gunakan perintah berikut:
</p>
<pre class="code">sudo chmod +x /var/www/html/simral/lib/jasper_report/run_jasperserver

</pre><p> </p>

<p>
Untuk menjalankan Jasper Report Server gunakan perintah berikut:
</p>
<pre class="code">cd /var/www/html/simral/lib/jasper_report
./run_jasperserver

</pre><p> </p>

<p>
Jasperserver akan berhenti bila terminal ditutup. Untuk menjalankan jasperserver setiap kali sever di restart, isikan perintah diatas pada file <code>/etc/rc.local</code>
</p>

</div>

<h2>Instalasi menggunakan Docker</h2>
<div class="level2">

<p>
Kebutuhan teknis untuk instalasi SIMRAL dengan metode Docker adalah:
</p>
<ul>
<li class="level1"> Docker Engine minimal versi 18.06</li>
<li class="level1"> Docker Compose</li>
</ul>

<p>
Sebelum melakukan instalasi, perlu dipersiapkan folder-folder tempat menyimpan data aplikasi SIMRAL agar bersifat persistent. Perintah berikut dengan asumsi pengguna memiliki home direktori <code>/home/simral</code>.
</p>
<pre class="code">cd ~
mkdir docker-simral-web
mkdir docker-simral-web/simral-data
mkdir docker-simral-web/simral-data/cfg
mkdir docker-simral-web/simral-data/images
mkdir docker-simral-web/simral-data/mysql

</pre><p> </p>

<p>
Setelah folder-folder tersebut tersedia gunakan perintah berikut untuk instalasi SIMRAL:
</p>
<pre class="code">cd docker-simral-web
curl -sSL https://simral.bppt.go.id/docker-simral-web/docker-compose.yaml&gt; docker-compose.yaml
docker-compose up -d

</pre><p> </p>

<p>
Pastikan semua container berjalan dengan perintah berikut:
</p>
<pre class="code">docker ps

</pre><p> </p>

<p>
yang akan menampilkan daftar container yang berjalan
</p>
<pre class="code">CONTAINER ID        IMAGE                                                    COMMAND                  CREATED             STATUS              PORTS                    NAMES
4d95f45fa7e0        repo.ptik.bppt.go.id:5000/ptik/simral-web-app:1.0.0      "docker-php-entrypoi…"   22 hours ago        Up 22 hours         0.0.0.0:82-&gt;80/tcp       simralweb-app_1
77119d1811b5        phpmyadmin/phpmyadmin                                    "/docker-entrypoint.…"   22 hours ago        Up 22 hours         0.0.0.0:83-&gt;80/tcp       simralweb-phpmyadmin_1
9dd15726854f        repo.ptik.bppt.go.id:5000/ptik/simral-web-jasper:1.0.0   "/usr/bin/supervisord"   22 hours ago        Up 22 hours         9999/tcp                 simralweb-report_1
cb296af123e6        mysql:5.6                                                "docker-entrypoint.s…"   22 hours ago        Up 22 hours         3306/tcp                 simralweb-db_1

</pre><p> </p>

</div>

Enable Complex Tables Editor Height px Turn supplementary image paste support on

Edit summary: Minor changes

Please fill all the letters into the box to prove you're human.

Please keep this field empty:

SimralWiki

User Tools

Site Tools

Page Tools