PETUNJUK INSTALASI

Mobile Device Management

Latest Version : PIM-V01.29092016

Doc Number : PIM01.ICO.01.2016

Prepared by : Sri Novi Fitriyani

Check out by : Devina Reviandhiny Prasetya Putri

 PETUNJUK INSTALASI MDM API SERVER

MDM API Server merupakan sebuah aplikasi middleware yang memiliki fungsi untuk meneruskan
request dari perangkat mobile ke SOAP Server dan menyediakan layanan yang diperlukan. MDM API
Server dikembangkan dengan menggunakan teknologi Java dengan JDK 8 sebagai web application yang
dapat dideploy ke dalam servlet container seperti Oracle Web Logic.

Berikut adalah langkah-langkah yang diperlukan untuk memulai instalasi mobile api server.

1. Mengunduh Software Yang Dibutuhkan

Sebelum memulai melakukan instalasi, beberapa perangkat lunak yang diperlukan antara lain :

JDK 8
Java yang digunakan adalah versi 8. Untuk mengunduh JDK 8, buka
http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html dan
pilih file download sesuai lingkungan yang digunakan.

Jika menggunakan linux Ubuntu, dapat menggunakan perintah :

sudo add-apt-repository ppa:webupd8team/java

sudo apt-get update
sudo apt-get install oracle-java8-installer

Pastikan bahwa java sudah dapat dipanggil dari terminal/command prompt.

 Gradle
Gradle merupakan salah satu tools untuk melakukan otomasi build. Dengan menggunakan gradle,
seluruh library dependency yang diperlukan dalam sebuah proyek akan langsung dapat terunduh
secara otomatis ketika proyek dijalankan, sehingga tidak perlu lagi mencari secara manual.
Download di http://gradle.org/gradle-download/.

Jika menggunakan linux Ubuntu, dapat menggunakan perintah :

sudo add-apt-repository ppa:cwchien/gradle

sudo apt-get update
sudo apt-get install gradle

Pastikan bahwa gradle dapat dipanggil melalui terminal/command prompt.

Subversion
Subversion digunakan sebagai version control system, untuk mengambil source code dari server.
Download dapat dilakukan di https://subversion.apache.org/packages.html
 Jika menggunakan linux Ubuntu, dapat menggunakan perintah :

sudo apt-get install subversion

Pastikan bahwa subversion dapat dipanggil melalui terminal/command prompt. Untuk pengguna
Windows dapat menggunakan Tortoise SVN, svn client yang terintegrasi dengan windows explorer
sehingga lebih mudah.

2. Mengambil Source Code Dari SVN

Langkah berikutnya yang perlu dilakukan adalah mengambil source code dari aplikasi. Untuk
pengguna linux dapat menggunakan perintah :

svn checkout

Untuk pengguna Windows, bisa menggunakan Tortoise SVN melalui windows explorer. Atau bisa
juga menggunakan IDE yang digunakan, yang sudah terintegrasi dengan subversion, misalnya Intellij
Idea.

3. Melakukan konfigurasi proyek

Setelah mengambil source code, file konfigurasi dapat ditemukan di
src/main/resources/alt.properties.
 Key Nilai Keterangan
# application
3ydO93Aqm3qF4xMF7y9RF1
app.id c6Q8i2EfQJ Id dari aplikasi, base64
app.port 3001 Http port yang digunakan
Mode yang digunakan, gunakan development
hanya untuk masa pengembangan. Dengan
menggunakan production, data yang dikirim
app.environment production didekripsi terlebih dahulu
u/Gu5posvwDsXUnV5Zaq4g= Key secure untuk melakukan enkripsi dan
#app.secure.key = dekripsi. Harus berupa base64 24 karakter
5D9r9ZVzEYYgha93/aUK2w= Key iv untuk melakukan enkripsi dan dekripsi.
#app.secure.iv = Harus berupa base64 24 karakter
app.staticFolder upload Path to Directory Upload
app.externalFolder upload Path to Directory Upload
app.surpressRespons
eCode FALSE Menampilkan respon kode
app.defaultRoute home/index Route default
app.sout FALSE Mode print debug
# conf for mobile
app.mdm_version 20 versi MDM
http://apps.iconpln.co.id:43
app.mdm_url 24 root download
# session
session.lifetime 3600 Lifetime dari session
session.secret alt key session
# database connection
db.default.persistent FALSE Mode Koneksi Ke Database
oracle.jdbc.pool.OracleDataS Nama library dari kelas yang digunakan untuk
db.default.class ource koneksi ke server
jdbc:oracle:thin:@192.168.1 DSN yang digunakan, lokasi database server
db.default.dsn 0.24:1521:CISQA beserta port dan nama instance
db.default.username mdm Nama user database
db.default.password mdm Password user database
#gcm config
google.projectid icon-mdm Project id dari GCM
https://gcm-
http.googleapis.com/gcm/se
google.gcmurl nd Url GCM Server
google.timeout 15 Timeout Request
AIzaSyDhxzG_3MMbkV3jWY
google.serverkey bkDSom2rvxJAhUyH0 API key dari Google Cloud Messaging
google.projectnum 255476232647 Project id dari GCM
 Konfigurasi yang penting untuk diubah adalah lokasi database server, user dan passwordnya.

4. Melakukan build dengan Gradle

Setelah melakukan konfigurasi yang diperlukan, tahapan berikutnya adalah membuat file WAR yang
diperlukan untuk dimasukkan ke dalam Oracle Web Logic. Selain WAR, gradle juga dapat membuat
file JAR. Di dalam aplikasi Mobile API Server, terdapat Jetty Web Server sehingga dapat dijalankan
secara langsung tanpa menggunakan servlet container.

Untuk melakukan build dengan gradle, jalankan perintah :

gradle build

File WAR dan JAR yang sudah dibuat terdapat di build/lib/mdm.jar dan build/lib/mdm.war.

5. Memasukkan File War Ke Dalam Oracle Web Logic

Setelah terbentuk file war yang diperlukan, buka Oracle Web Logic admin, dan upload file war yang
diperlukan. Untuk mengunggah file war dapat dilakukan melalui halaman web console admin
dengan username weblogic1 dan password weblogic.

6. Jika Diperlukan, menjalankan langsung Mobile API Server

Mobile API Server dapat langsung dijalankan tanpa menggunakan servlet container. Setelah
membuat file jar, cukup menggunakan perintah :

java -jar mdm.jar

7. MQTT Server
MQTT Server merupakan server perantara yang digunakan untuk menerima dan mengirim pesan
singkat yang dikirim dari MDM mobile aplikasi. Pesan yang singkat tersebut diantaranya : data
Hearbeat, Lokasi (GPS) dan Kuota data.

sudo apt-add-repository ppa:mosquitto-dev/mosquitto-ppa

sudo apt-get update
sudo apt-get install mosquitto
sudo apt-get install mosquitto-clients
sudo service mosquitto status
8. Telemtry MQTT Client
Telemtry MQTT Client merupakan sebuah aplikasi middleware penerima data yang ditangkap dari
MQTT Server.

cd path/to/telemtry
gradle build
java -jar launcher/build/libs/launcher.jar
 PETUNJUK INSTALASI MDM MOBILE

Untuk melakukan instalasi mobile aplikasi MDM, berikut langkah-langkahnya :

1. Petugas login ke webadmin, dengan mengetikkan username : admin, dan password : 123.

2. Selanjutnya klik menu aplikasi . Maka akan muncul halaman berikut :

3. Pada nama aplikasi PLN MDM, klik tombol Lihat. Maka akan muncul halaman berikut :
4. Pada baris File Aplikasi, klik url untuk mengunduh file apk, ikuti sampai unduh selesai.

5. Copykan file unduhan tersebut ke device (dapat menggunakan bluetooth ataupun transfer kabel
data).

6. Selanjutnya dari sisi device buka file manager, buka file tersebut. Lalu tekan tombol Install.

7. Lalu ikuti langkah sampai installasi selesai.

8. Kembali ke halaman webadmin. Klik menu Perangkat , maka device yang baru
terinstall akan bertambah di list perangkat.