Pada tutorial kali ini, saya akan menunjukkan langkah demi langkah mengenai cara untuk melakukan instalasi hingga konfigurasi OSTicket pada Ubuntu 16.04. software ini akan berjalan dibawah PHP-FPM 7.0, menggunakan Nginx sebagai Web Server-nya dan menggunakan MariaDB 10.2 sebagai database-nya.

• Baca juga: Cara melakukan instalasi dan konfigurasi OS Ticket v1.10.4 pada Ubuntu Server (Apache)

Persyaratan

• Ubuntu 16.04
• Root Privileges
• Install PHP 7.0, Nginx, MariaDB-Server
• Pada MariaDB (Buat database, buat user untuk mengaksesnya dan berikan privilege untuk user tersebut mengakses database tadi).

Instalasi PHP

Apabila kalian tidak menemukan adanya paket PHP 7.0 pada repositori Ubuntu yang kalian punya, maka kalian harus menambahkan repositori lain, baru kemudian melakukan instalasi paket PHP 7.0. Caranya:

sudo add-apt-repository ppa:ondrej/php

sudo apt update

sudo apt-get install -y php7.0-cli php7.0-mysql php7.0-cgi php7.0-fpm php7.0-gd php7.0-imap php7.0-xml php7.0-mbstring php7.0-intl php-apcu

Jika sudah, masuk ke dalam direktori PHP 7.0 dan edit file php.ini:

cd /etc/php/7.0/
vi fpm/php.ini

Hapus tanda pagar pada cgi.fix_pathinfo dan ganti nilainya menjadi 0.

Simpan dan kemudian keluar dari vi editor. 

Sekarang restart PHP7.0-fpm dan buat agar PHP7.0-fpm berjalan ketika server memulai proses booting.

systemctl restart php7.0-fpm
systemctl enable php7.0-fpm

Selanjutnya, kita akan melakukan konfigurasi agar PHP7.0-fpm bekerja dengan nginx web server. Masuk ke dlam direktori virtual host yang ada di Nginx dan edit file virtual host dengan vi editor:

cd /etc/nginx/sites-available/
vi default

Buat konfigurasi PHP7.0 seperti file berikut:

location ~ \.php$ {
               include snippets/fastcgi-php.conf;
        #
        #       # With php7.0-cgi alone:
        #       fastcgi_pass 127.0.0.1:9000;
        #       # With php7.0-fpm:
               fastcgi_pass unix:/run/php/php7.0-fpm.sock;
        #
}

Simpan dan keluar, kemudain restart web server-nya:

service nginx restart

Sekarang tes PHP7.0 dan Nginx dengan membuat sebuah file phpinfo. Caranya:

cd /var/www/html/
echo '<?php phpinfo(); ?>' > info.php

Buka web browser kalian dan masukkan alamat IP dari web kalian:

http://192.168.10.131/info.php

dan kalian akan mendapatkan informasi mengenai versi dari PHP yang kalian gunakan

Buat Database dan User untuk Mengakses OSTicket

Pada tahap ini, kita akan membuat database baru dan user untuk mengakses database tersebut. User dan database inilah yang akan digunakan oleh aplikasi OSTicket. Pertama, masuk ke dalam terminal MariaDB dengan menggunakan user root.

mysql -u root -p
KETIK PASSWORD LO

buat database dengan nama ‘ticket’ dan user baru dengan nama ‘ticket’ dengan password ‘ticket’

create database ticket;
create user 'ticket'@'localhost' identified by 'ticket';

Berikan privileges untuk user tersebut ke database ‘ticket’

grant all privileges on ticket.* to 'ticket'@'localhost' identified by 'ticket';
flush privileges;

Membuat Virtual Host untuk OSTicket

Sekarang waktunya untuk membuat vhost baru untuk OSTicket. Masuk ke dalam direktori vhost milik Nginx dan buat file baru dengan nama ‘ticket.conf’:

cd /etc/nginx/sites-available/
vi ticket

paste konfigurasi di bawah:

server {
  listen 80;
        server_name ticket.cobacoba.com;
 
        root   /var/www/html/osticket/upload;
 
        access_log  /var/log/nginx/access.log;
        error_log  /var/log/nginx/error.log;
 
        index index.php;
        client_max_body_size 2000M;
        client_body_buffer_size 100M;
        client_header_buffer_size 10M;
        large_client_header_buffers 2 10M;
 
        client_body_timeout 12;
        client_header_timeout 12;
        keepalive_timeout 15;
        send_timeout 10;
 
        gzip             on;
        gzip_comp_level  2;
        gzip_min_length  1000;
        gzip_proxied     expired no-cache no-store private auth;
        gzip_types       text/plain application/x-javascript text/xml text/css application/xml;
 
        set $path_info "";
 
        location ~ /include {
            deny all;
            return 403;
        }
 
        if ($request_uri ~ "^/api(/[^\?]+)") {
            set $path_info $1;
        }
 
        location ~ ^/api/(?:tickets|tasks).*$ {
            try_files $uri $uri/ /api/http.php?$query_string;
        }
 
        if ($request_uri ~ "^/scp/.*\.php(/[^\?]+)") {
            set $path_info $1;
        }
 
        location ~ ^/scp/ajax.php/.*$ {
            try_files $uri $uri/ /scp/ajax.php?$query_string;
        }
 
        location / {
            try_files $uri $uri/ index.php;
        }
 
        location ~ \.php$ {
            fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
            include        fastcgi_params;
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php7.0-fpm.sock;
            fastcgi_param  PATH_INFO    $path_info;
        }
}

Jika kamu menggunakan HTTPS, berikut kira-kira konfigurasinya:

server {
  listen 80;
        server_name ticket.cobacoba.com;
        return 301 https://$server_name$request_uri;
}


server {
        listen 443 ssl http2;
        listen [::]:443 ssl http2;

        ssl_certificate /lokasi/file.crt;
        ssl_certificate_key /lokasi/file.key;

	# openssl dhparam 4096 -out /etc/ssl/dhparam.pem        
	ssl_dhparam /etc/ssl/dhparam.pem;
        ssl_ecdh_curve       secp384r1; # optional
        ssl_protocols TLSv1.2 TLSv1.1 TLSv1;
        ssl_prefer_server_ciphers on;

        ssl_ciphers 'ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-RSA-AES256-SHA:ECDHE-ECDSA-DES-CBC3-SHA:ECDHE-RSA-DES-CBC3-SHA:EDH-RSA-DES-CBC3-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:DES-CBC3-SHA:!DSS';

        ssl_stapling on;
        ssl_stapling_verify on;
        resolver 1.1.1.1 1.0.0.1 valid=300s;
        resolver_timeout 10s;
        ssl_trusted_certificate /lokasi/file-bundle.crt;
        ssl_session_cache shared:SSL:10m;
        ssl_session_timeout 10m;

        root   /var/www/html/osticket/upload;
        index index.php index.html index.htm index.nginx-debian.html;

        server_name ticket.cobacoba.com;

        access_log  /var/log/nginx/access.log;
	error_log /var/log/nginx/error.log;

	client_max_body_size 2000M;
	client_body_buffer_size 100M;
	client_header_buffer_size 10M;
	large_client_header_buffers 2 10M;

	client_body_timeout 12;
	client_header_timeout 12;
	keepalive_timeout 15;
	send_timeout 10;

	gzip on;
	gzip_comp_level 2;
	gzip_min_length 1000;
	gzip_proxied expired no-cache no-store private auth;
	gzip_types text/plain application/x-javascript text/xml text/css application/xml;

	set $path_info "";

	location ~ /include {
	deny all;
	return 403;
	}

	if ($request_uri ~ "^/api(/[^\?]+)") {
	set $path_info $1;
	}

	location ~ ^/api/(?:tickets|tasks).*$ {
	try_files $uri $uri/ /api/http.php?$query_string;
	}

	if ($request_uri ~ "^/scp/.*\.php(/[^\?]+)") {
	set $path_info $1;
	}

	location ~ ^/scp/ajax.php/.*$ {
	try_files $uri $uri/ /scp/ajax.php?$query_string;
        }

        location / {
            try_files $uri $uri/ index.php;
        }

        location ~ \.php$ {
            fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
            include        fastcgi_params;
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php7.0-fpm.sock;
            fastcgi_param  PATH_INFO    $path_info;
        }

        location ~ /\.ht {
                deny all;
        }

        location ~ /.well-known {
                allow all;
        }

}

Pada contoh ini kita akan menggunakan domain dengan nama ‘ticket.cobacoba.com’ dan menggunakan direktori ‘/var/www/html/osticket/upload’ sebagai root directory. Timpa nama ‘ticket.cobacoba.com’ dengan nama domain kalian.

Simpan konfigurasi tersebut kemudian keluar.

Sekarang aktifkan vhost dan uji konfigurasinya

ln -s /etc/nginx/sites-available/ticket.conf /etc/nginx/sites-enabled/
nginx -t

pastikan tidak ada error dan kemudian restart nginx.

service nginx restart

Download dan Konfigur OSTicket

Buat direktori baru untuk OSTicket dan masuk ke dalam direktori baru tersebut

mkdir -p /var/www/html/osticket/
cd /var/www/html/osticket/

Download dengan perintah berikut

wget http://osticket.com/sites/default/files/download/osTicket-v1.10.4.zip

Ekstrak file tersebut dengan perintah unzip

unzip osTicket-v1.10.4.zip

Semua konfigurasi OSTicket berada pada folder upload, masuk ke dalam direktori tersebut dan copy file config-nya

cd upload/
cp include/ost-sampleconfig.php include/ost-config.php

Sekarang ganti kepemilikan OSTicket menjadi ‘www-data’ (baik user atau grupnya)

cd /var/www/html/osticket/
chown -R www-data:www-data upload/

Instalasi OSTicket

Buka browser kalian dan masukkan domain kalian, contoh punya saya:

htttps://ticket.cobacoba.com

Pastikan semua paket yang dibutuhkan berda dalam kedaan berwarna hijau seperti gambar berikut

Tekan continue dan kalian akan diarahkan pada seksi konfigurasi OSTicket.

• Baca juga: Membuat Tutorial Penggunaan Aplikasi dengan MockuPhone

Pada bagian “System settings”, masukkan nama “helpdesk” beserta email default-nya. Pada bagian “admin user”, ketikkan konfigurasi admin kalian termasuk email admin, dan pastikan email tersebut berbeda dengan email pada default helpdesk email.

Klik “install now’ dan tunggu beberapa detik hingga instalasi selesai. Jika sudah selesai, kalian akan melihat gambar seperti gambar di bawah

cd /var/www/html/osticket/upload/

hapus atau ubah nama folder setup dan ganti permission dari OSticket config file

mv setup/ setup-sh/
chmod 0644 include/ost-config.php

Instalasi selesai

Uji Coba

Halaman Depan

Halaman admin

Setelah berhasil masuk sebagai admin

Link

http://osticket.com/wiki/Main_Page

Catatan

• Versi PHP yang disarankan adalah versi 5.6 hingga 7.0
• Versi OS Ticket 1.10.4 ini belum compatible dengan PHP versi 7.1 dan 7.2
• Hapus folder upload/setup pasca instalasi

The post Instalasi OSTicket v1.10.4 pada Ubuntu Server 16.04 (Nginx) first appeared on GoBlog.

Namun, terkadang kita lupa untuk mengubah juga URL yang ada di dalam pengaturan admin panel yang nantinya bisa berdampak pada kesalahan pengiriman link URL ke alamat email milik si user saat user tersebut mendaftarkan dirinya untuk bisa mengambil tiket.

• Baca juga: Cara Membuat Tutorial Penggunaan Aplikasi dengan Mockuphone

Mungkin bahasa yang saya gunakan sedikit ngejelimet ya, saya minta maaf untuk itu. Agar kalian tidak bingung, saya coba jelaskan dengan contoh real-nya ya.

Sebelum Mengubah Helpdesk URL

Saat ingin mengambil tiket pada aplikasi OS Ticket yang sudah kita buat, user terlebih dahulu harus mengakses alamat URL dari OS Ticket. Katakanlah alamatnya adalah https://tiket.weblo.com. Namun, sebelum bisa menambil tiket dan membuat keluhan, user terlebih dahulu harus mendaftarkan diri dengan memasukkan alamat email dan juga password + Nama lengkap dan nomor telepon.

Usai mengisi semua detil informasi dan menekan tombol Register, sebuah email yang berisi link konfirmasi akan dikirimkan ke alamat email yang sudah dimasukkan oleh user tadi. Kira-kira isinya seperti ini:

Jika user tersebut menekan link tersebut, maka hasil yang akan didapat adalah 404 not found. Hal tersebut terjadi sebab kita sudah mengubah document root pada Apache, tapi belum mengubah URL pada helpdesk. Itulh sebabnya masih ada halaman /upload setelah URL yang membuat link tersebut tidak ditemukan.

Setelah Mengubah Helpdesk URL

Yang perlu diubah agar link yang dikirim berjalan dengan lancar adalah Helpdesk URL. Caranya dengan masuk ke Admin Panel →Settings→Helpdesk URL. Hilangkanbagian /upload sehingga hanya benar-benar alamat URL (tanpa ada folder di belakangnya).

Dengan melakukan perubahan tersebut, kini link konfirmasi yang dikirim kepada user pastilah benar. Dan seharusnya ketika si user mendaftar kembali, maka proses akan berjalan seperti ini:

Itu tadi sedikit tutorial untuk mengubah link konfirmasi yang dikirimkan ke email user yang mendaftar. Semoga tutorial ini bisa berguna untuk kalian ya. Sampai jumpa di tutorial berikutnya

The post Mengubah Link URL pada Email Konfirmasi Akun di OS Ticket v1.10.4 first appeared on GoBlog.

• Baca juga: Instalasi Apache-ant-1.9.7 pada CentOS 6.10

Tanpa banyak berbasa-basi lagi, berikut ini saya bagikan cara untuk melakukan instalasi OSTicket v1.10.4 di Ubuntu Server 16.04.

Persyaratan

1. Install PHP 7.0, Apache, MariaDB-Server
2. Pada MariaDB (Buat database, buat user untuk mengaksesnya dan berikan privilege untuk user tersebut mengakses database tadi).

Instalasi PHP

Apabila kalian tidak menemukan adanya paket PHP 7.0 pada repositori Ubuntu yang kalian punya, maka kalian harus menambahkan repositori lain, baru kemudian melakukan instalasi paket PHP 7.0. Caranya:

sudo add-apt-repository ppa:ondrej/php

sudo apt update

sudo apt-get install -y php7.0-cli php7.0-mysql php7.0-cgi php7.0-fpm php7.0-gd php7.0-imap php7.0-xml php7.0-mbstring php7.0-intl php-apcu

sudo apt install python-software-properties

enable PHP 7.0 dan kemudian restart service Apache2

sudo a2enmod php7.0
sudo service apache2 restart

Pemeriksaan Versi PHP dan Pemilihan Versi Default

Setelah melakukan instalasi PHP 7.0 tadi, sekarang waktunya membuat versi tersebut menjadi versi default yang digunakan. Cara yang pertama adalah periksa versi PHP yang aktif terlebih dahulu

php -v 

Apabila PHP 7.0 belum menjadi default, ubah dengan menggunakan perintah berikut:

sudo update-alternatives --config php

Kalau sudah selesai, jalankan kembali perintah php -v untuk melihat versi terkini dari PHP yang kalian gunakan.

Buat Database dan User untuk Mengakses OSTicket

Setelah kalian melakukan instalasi MariaDB-Server, tahap selanjutnya adalah membuat database dan user untuk OSTicket dapat mengakses database tersebut. Caranya:

mysql -u root -p
create database osticket;
create user 'osticket'@'localhost' identified by 'passwordnyaapa';
grant all privileges on osticket.* to 'osticket'@'localhost';
flush privileges;
exit

Kalau sudah, sekarang waktunya untuk menguji database tersebut. Jika kalian bisa login menggunakan user yang sudah kalian buat tadi dan melihat sebuah database bernama osticket, berarti kalian sudah benar.

mysql -u root -p
show databases;

Instalasi OSTicket v1.10.4

Sebelum memulai proses instalasi, kalian harus terlebih dulu masuk ke dalam folder HTML pada sistem kalian. Caranya:

cd /var/www/html/

Dan dari sana, kalian harus mengunduh paket OSTicket yang bisa diunduh dengan menggunakan perintah berikut:

wget http://osticket.com/sites/default/files/download/osTicket-v1.10.4.zip

Setelah berhasil diunduh, ekstrak file tersebut dengan cara perintah berikut:

unzip osTicket-v1.10.4.zip -d osticket

Setelah selesai ekstrak, kalian perlu untuk mengganti kepemilikan dari direktory osticket. Caranya:

sudo chown -R www-data:www-data osticket/

Selanjutnya, kalian perlu meng-copy sebuah file dan mengubah namanya agar file tersebut bisa dijalankan. Lakukan perintah berikut:

sudo cp osticket/upload/include/ost-sampleconfig.php osticket/upload/include/ost-config.php

Ubah permission dari direktori osticket menjadi seperti berikut:

sudo chmod 755 -R osticket/

Berikutnya, kalian harus membuat virtual host untuk konfigurasi ini. Caranya:

sudo vi /etc/apache2/sites-available/osticket.conf 

dalam file tersebut, kalian harus menambahkan baris berikut:

<VirtualHost *:80>
ServerAdmin support@weblo.com
DocumentRoot /var/www/html/osticket/
ServerName tiket.weblo.com
ServerAlias www.tiket.weblo.com
Alias /tiket "/var/www/html/osticket/"


<Directory /var/www/html/osticket/>
Options FollowSymLinks
AllowOverride All
Order allow,deny
allow from all
</Directory>

RewriteEngine on
RewriteCond %{SERVER_NAME} =tiket.weblo.com [OR]
RewriteCond %{SERVER_NAME} =www.tiket.weblo.com
RewriteRule ^ https://%{SERVER_NAME}%{REQUEST_URI} [END,NE,R=permanent]


ErrorLog /var/log/apache2/tiket.weblo.com-error_log
CustomLog /var/log/apache2/tiket.weblo.com-access_log common
</VirtualHost>

Karena konfigurasi di atas memaksa agar web ini diakses lewat HTTPS, maka kalian harus membuat konfigurasi SSL-nya juga. Caranya:

sudo vi /etc/apache2/sites-available/osticket-ssl.conf 

yang isinya adalah

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin support@tiket.weblo.com
DocumentRoot /var/www/html/osticket/
ServerName tiket.weblo.com
ServerAlias www.tiket.weblo.com

Alias /tiket "/var/www/html/osticket/"

<Directory /var/www/html/ostiket/>
Options FollowSymLinks
AllowOverride All
Order allow,deny
allow from all
</Directory>

ErrorLog /var/log/apache2/tiket.weblo.com-error_log
CustomLog /var/log/apache2/tiket.weblo.com-access_log common


SSLCertificateFile /etc/letsencrypt/certificate.crt
SSLCertificateKeyFile /etc/letsencrypt/private.key
SSLCertificateChainFile /etc/letsencrypt/ca_bundle.crt

</VirtualHost>
</IfModule>

Setelah itu selesai, kalian harus mengubah sedikit konfigurasi hosts. Caranya:

sudo vi /etc/hosts

dan tambahkan baris berikut

<ip server lo> nama domain (tiket.weblo.com)

Selanjutnya, enable konfigurasi yang sudah kalian buat tadi. Caranya:

a2ensite osticket.conf
a2ensite osticket-ssl.conf
service apache2 restart

Sekarang buka browser kalian dan masukkan URL http://tiket.weblo.com/upload sebagai alamatnya. Installer OSTicket akan terbuka dan menampilkan persayratan yang harus terinstall sebelum melanjutkan ke tahap berikutnya. Pastikan semua persyaratan terpenuhi ya sebelum kalian tekan continue.

Pada tahapan selanjutnya, kalian akan diminta untuk mengisi beberapa field seperti Helpdesk Name, Default Email, Informasi Admin User dan yang paling penting adalah pengaturan koneksi ke dalam database. 

Untuk MySQL Hostname, karena saya menginstallnya satu server dengan OSTicket, maka saya mengisinya dengan localhost.

Untuk MySQL Database, masukkan nama database yang kalian buat pada tahap awal tadi. Masukkan juga username dan password yang sesuai ya. Gak lupa kan?

Selamat, instalasi kalian kini sudah berhasil.

Sebelum lanjut ke tahap berikutnya, kalian perlu menghilangkan write access pada file include/ost-config.php. Caranya:

sudo chmod 644 include/ost-config.php

Untuk mengakses halaman admin, kamu bisa mengetikkan URL http://tiket.weblo.com/upload/scp

Sedangkan untuk halaman user, URL yang perlu dimasukkan adalah http://tiket.weblo.com/upload/

Yap, kini instalasi OSTicket sudah berhasil dan silahkan kalian melakukan konfigurasi lanjutan yang kalian perlukan.

Sampai jumpa di tutorial selanjutnya

Catatan:

1. Versi PHP yang disarankan adalah versi 5.6 hingga 7.0
2. OSTicket v1.10.4 ini belum compatible dengan PHP versi 7.1 dan 7.2
3. Hapus folder upload/setup pasca instalasi
4. Ubah document root menjadi /<lokasi_folder_osticket>/upload

The post Instalasi OSTicket v1.10.4 pada Ubuntu Server 16.04 (Apache) first appeared on GoBlog.