Tutorial Cara Install dan Upgrade Unifi Controller Pada Windows dan Linux

tutorial install UniFi controller dan cara Upgrade UniFi Controller Linux dan Windows

Download Paket Installasi UniFi Controller

Ubiquiti Network telah menyediakan halaman download (https://www.ubnt.com/download/unifi) yang berisi firmware,manual dan software UniFi Controller. Kamu tinggal pilih package sesuai dengan OS yang kamu gunakan(MacOS ,Windows dan Debian/Ubuntu Linux).
halaman official download unifi controller

Cara Download Binnary package untuk non Debian dan Ubuntu Family (RedHat,Arch dkk)

Khusus untuk distro linux selain Debian Family / Ubuntu maka kamu perlu mendownload versi binnary file. Sebagai contoh CentOS adalah linux berbasis  RHEL (Red Hat Enterprise Linux), sedangkan package yang disediakan di website ubiquiti adalah debian package. Dengan kata lain kita tidak bisa menginstall debian package pada Redhat Linux atau Arch Base linux, Oleh karena itu kita perlu mendownload Package binnary file.

  1. Buka Halaman download UniFi (https://www.ubnt.com/download/unifi) dan lihat versi  UniFi Controller  pada link download untuk Debian/Ubuntu Linux
  2. http://dl.ubnt.com/unifi/versi/UniFi.unix.zip ||Ganti versi dengan versi unifi controller yang tertera pada download page UniFi lalu lakukan download dengan mengakses URL yang telah kita modifikasi tadi. Sebagai contoh ,berdasar gambar diatas versi unifi controller adalah 5.4.11 maka URL untuk mendownload nya adalah http://dl.ubnt.com/unifi/5.4.11/UniFi.unix.zip
    download binnary linux unifi controller

Cara Backup dan Restore UniFi Setting 

Sebelum Melakukan Upgrade UniFi Controller baiknya kita melakukan Backup agar konfigurasi /setting pada controller tidak hilang setelah melakukan upgrade , untuk mengembalikan nya kita cukup lakukan restore

  1. Login dan masuk ke menu Settings > Maintenance > pada bagian backup klik Download Backup
  2. Untuk restore tinggal klik Choose File pada bagian Restore dan pilih file yang kamu simpan saat backup tadi.
    cara backup dan restore config setting unifi controller

Atau bisa juga dengan membackup  folder \data yang ada pada lokasi installasi UniFi Controller dan untuk merestore nya tinggal kopi dan timpa folder data dengan folder data yang kita backup tadi. Untuk windows lokasi installasi UniFi controller biasanya ada di C:\Users\namauser\Ubiquiti UniFi ,nama user adalah nama user yang digunakan untuk login komputer.

Windows OS

Silakan download Unifi Controller untuk windows pada official site UniFi,Walau Unifi Controller ditulis dengan Java tapi kamu tidak perlu mendonload /install java secara terpisah,karena di dalam package installasi telah disediakan JRE (Java Runtime Environment).

Cara Install UniFi Controller pada Windows

  1. Jalankan package installasi (file master) yang telah kamu download dengan double klik atau klik lalu tekan enter > ikuti prosedur installasi seperti biasa.
    cara install unifi controller windows
  2. Setelah selesai install,jalankan UniFi Controller .
    Akses UniFi controller lewat web interface dengan mengetikan https://ip-server-unifi-controller:8443 pada address bar browser dan lakukan setup untuk pertama kalinya.
    Jika Ip server UniFi Controller mu adalah 192.168.1.5 maka untuk mengakses lewat browser kamu harus mengetikan https://192.168.1.5:8443 atau klik “launch a browser to manage wireless network” pada aplikasi desktop Unifi Controller
    cara menjalankan UniFi Controller Service Windows
  3. Setelah berhasil membuka Unifi Controller via web interface  untuk pertama kali kamu akan diminta setup mulai dari negara,timezone,dan membua tusername password untuk admin.
  4. Jika disuruh pilih negara dan timezone silakan isi sesuai lokasi mu (indonesia , GMT+7) dan jika muncul scan .manage device pilih skip saja.
  5. Jika sampai pada tahap akhir silakan isikan username dan password sesuai dengan yang kamu inginkan dan jangan sampai lupa,karena ini digunakan untuk login ke web interface UniFi controller
    cara setup unifi controller via web interface saat pertama kali selesai diinstall

Cara Upgrade UniFi Controller pada Windows

  1. Stop/Exit/Close Unifi Controller dan Lakukan backup terlebih dahulu sebalum melakukan Upgrade.
  2. Download versi UniFi controller terbaru di website official UniFi dan lakukan prosedur upgrade dengan menjalankan package(UniFi Controller installer) yang kamu download .
    cara upgrade unifi controller windows
  3. Jika telah selesai proses Upgrade lakukan Restore dan jalankan Unifi Controller kembali

Linux OS

Linux OS mempunyai beberapa base(Redhat,Slakware,Debian,Arch) distro yang dipakai oleh distro anakan/tururan , jadi sebelum mendownload kamu baiknya tau base distro apa yang kamu gunakan, sebagai contoh untuk Ubuntu adalah turunan dari Debian ,CentOS turunan dari RedHat,Antergos Turunan dari ArchLinux .Lengkapnya silakan cek  Linux Family Tree

Cara Install UniFi Controller Pada Debian LinuX Family

Untuk debian family(ubuntu,linuxmint,) ,package installasi bisa langsung didownload pada official website UniFi

  1. Download Paket installasi dengan perintah wget <url> contoh : wget http://dl.ubnt.com/unifi/5.4.11/unifi_sysvinit_all.deb
  2. install dengan perintah sudo dpkg -i unifi_sysvinit_all.deb (atau dengan root privilage)
    install unifi controller pada debian ubuntu linux
  3. Jika terjadi error saat install karena Java, mongoDB atau package lain  belum diinstall maka jalankan perintah berikut untuk memperbaikinya  sudo apt-get -f install
    install dependency unifi controller debian ubuntu linux
  4. Setelah semua terinstall maka unifi akan dijalankan secara otomatis atau kamu bisa mengeceknya dengan perintah service unifi status
  5. Akses UniFi controller lewat web interface dengan mengetikan https://ip-server-unifi-controller:8443 pada address bar browser dan lakukan setup untuk pertama kalinya.
    Jika Ip server UniFi Controller mu adalah 192.168.1.5 maka untuk mengakses lewat browser kamu harus mengetikan https://192.168.1.5:8443
    setup wizard saat pertama unifi controller selesai diinstall

Cara Upgrade UniFi Controller pada Debian Linux Family

Sebelum melakukan kamu wajib Backup UniFi Controller Mu untuk menghindari jika terjadi Error

  1. Download versi terbaru UniFi Controller pada Official Website UniFi
  2. Setelah backup dilakukan jalankan perintah sudo dpkg -i <nama package> contoh : sudo dpkg -i unifi_sysvinit_all.deb
    upgrade Unifi Controller pada debian Ubuntu Linux
  3. Setelah perintah dijalankan UniFi akan stop dan melakukan Upgrade lalu start service secara otomatis, semua config/setting sebelumnya akan utuh,Jika terjadi perbedaan silakan lakukan Restore

Cara Install UniFi Controller Pada Redhat,Arch & other LinuX Family

Download UniFi Controller Binnary File ,jangan download yang debian /ubuntu linux karena tidak akan bisa dijalankan di RedHat,Arch atau linux selain debian family.

” Pastikan kamu sudah menginstall Java dan MongoDB , kalau belum silakan install dari official repository menggunakan package manager distro linux masing-masing “

  1. Extract UniFi controller yang telah kita download tadi ke directory /opt dengan perintah  sudo unzip UniFi.unix.zip -d /opt/
  2. Buat file service dengan perintah  sudo nano /etc/systemd/system/unifi.service  dan isikan text berikut
    [Unit]
    Description=UniFi AP Web Controller
    After=syslog.target network.target
    
    [Service]
    Type=simple
    User=ubnt
    WorkingDirectory=/opt/UniFi
    ExecStart=/usr/bin/java -Xmx1024M -jar /opt/UniFi/lib/ace.jar start
    ExecStop=/usr/bin/java -jar /opt/UniFi/lib/ace.jar stop
    SuccessExitStatus=143
    
    [Install]
    WantedBy=multi-user.target 
    
  3. Enable Service dengan perintah sudo  systemctl enable unifi.service
  4. Jalankan service dengan perintah sudo systemctl start unifi.service
  5. Cek status service dengan perintah systemctl status unifi.service
  6. Setelah service berjalan ,Akses UniFi controller lewat web interface dengan mengetikan https://ip-server-unifi-controller:8443 pada address bar browser dan lakukan setup untuk pertama kalinya.
    Jika Ip server UniFi Controller mu adalah 192.168.1.5 maka untuk mengakses lewat browser kamu harus mengetikan https://192.168.1.5:8443
    setup wizard unifi controller pertama kali dijalankan

Cara Upgrade UniFi Controller Pada Redhat,Arch & other LinuX Family

Sebelum Upgrade seperti biasa lakukan Backup melalui Web isnterface atau dengan menyalin folder /data pada directory UniFi

  1. Stop UniFi Service Dengan perintah sudo systemctl stop unifi.service
  2. Download binnary UniFi Controller terbaru di website official
  3. Extract UniFi controller yang telah kita download tadi ke directory /opt dengan perintah  sudo unzip UniFi.unix.zip -d /opt/
  4. Jalankan service dengan perintah sudo systemctl start unifi.service
  5. Cek status service dengan perintah systemctl status unifi.service
  6. Jika kamu melakukan backup dengan cara kopi folder /data silakan timpa folder /data dengan hasil backupan sebelum nya

Kurang jelas? Silakan Bertanya