Dalam panduan ini kami akan menunjukkan cara menginstal dan mengonfigurasi versi terbaru perangkat lunak EspoCRM pada Debian 9 di atas tumpukan LAMP, untuk membuat platform Manajemen Hubungan Pelanggan online gratis untuk perusahaan Anda.
EspoCRM adalah platform manajemen hubungan pelanggan (CRM) open source yang fleksibel dan mudah digunakan yang dirancang agar cepat, sederhana, dan dapat disesuaikan. Perangkat lunak ini terutama ditulis dalam bahasa pemrograman PHP dan dapat dengan mudah digunakan di Linux di atas server web Apache atau Nginx, bahasa pemrograman PHP dan sistem manajemen basis data MySQL atau MariaDB. EspoCRM mendukung beragam bahasa dan dapat digunakan di pusat panggilan, bank, pendidikan, perawatan kesehatan, pariwisata, ritel, real estat, atau bisnis e-niaga.
Persyaratan
- Instalasi minimal pada mesin virtual atau server fisik sistem operasi Debian 9
- Hak istimewa akun root atau akun dengan hak akses root melalui perintah sudo (akses lokal melalui konsol atau akses jarak jauh melalui SSH)
- Salah satu NIC server yang dikonfigurasi dengan alamat IP statis
- Nama domain terdaftar publik sehingga Anda melakukan penginstalan melalui antarmuka web dan mengakses situs web aplikasi. Di intranet, Anda dapat mengakses aplikasi melalui domain lokal atau melalui alamat IP server Anda
- Server email yang dikonfigurasi di tempat Anda atau akses ke layanan email publik, seperti Gmail, Outlook, Yahoo!
Pra-Persyaratan
Pertama, masuk ke konsol server Debian Anda dan pastikan Anda memperbarui repositori sistem, kernel, dan paket perangkat lunak dengan mengeluarkan perintah berikut.
apt update
apt upgrade
Selanjutnya, konfigurasikan nama host mesin dengan menjalankan perintah berikut. Pastikan Anda mengganti nilai hostname yang digunakan dalam topik ini dengan notasi Anda sendiri.
hostnamectl set-hostname www.mycrm.org
Berikan perintah di bawah ini untuk memeriksa apakah nama host mesin telah dikonfigurasi dengan benar.
hostnamectl
cat /etc/hostname
hostname –s
hostname –f
Terakhir, reboot server Debian untuk menerapkan pembaruan kernel dan nama host berubah dengan benar.
systemctl reboot
Selanjutnya, Anda harus menginstal bundel perangkat lunak LAMP di sistem Debian. Pada langkah pertama, instal server web Apache dan interpreter gateway pemrosesan PHP bersama dengan semua modul PHP yang diperlukan oleh aplikasi untuk berjalan dengan benar dengan menjalankan perintah berikut di konsol server Anda.
apt install apache2 libapache2-mod-php7.0 php7.0 php7.0-gd php7.0-opcache php7.0-mbstring php7.0-xml php7.0-json php7.0-zip php7.0-curl php7.0-imap php7.0-soap php7.0-mcrypt php-mailparse
Selanjutnya, instal backend database RDBMS. Dalam panduan ini, kami akan mengonfigurasi aplikasi EspoCRM untuk menggunakan database MariaDB sebagai backend. Berikan perintah berikut untuk menginstal database MariaDB dan modul PHP yang diperlukan untuk mengakses database MySQL.
apt install mariadb-server php7.0-mysql mariadb-client
Setelah Apache, database MySQL dan PHP terinstal, buka file konfigurasi default PHP untuk mengedit dan memodifikasi variabel PHP berikut seperti yang dijelaskan di bawah ini. Pastikan bahwa pada awalnya, Anda membuat cadangan file konfigurasi PHP.
cp /etc/php/7.0/apache2/php.ini{,.backup} nano /etc/php/7.0/apache2/php.ini
Telusuri, edit, dan ubah variabel berikut di php.ini file konfigurasi:
file_uploads = On
default_charset = UTF-8
memory_limit = 256M
post_max_size = 50M
upload_max_filesize = 50M
memory_limit = 256M
max_input_time = 180
max_execution_time = 180
zend.assertions = 0
date.timezone = Europe/London
Ganti zona waktu variabel sesuai dengan waktu fisik Anda dengan melihat daftar zona waktu yang disediakan oleh PHP docs di link berikut http://php.net/manual/en/timezones.php
Untuk meningkatkan kecepatan memuat halaman aplikasi Anda melalui plugin OPCache yang tersedia di PHP7, masukkan baris kode OPCache berikut di bagian bawah file konfigurasi interpreter PHP, di bawah [opcache] pernyataan, seperti yang dijelaskan di bawah ini:
opcache.enable=1
opcache.enable_cli=1
opcache.interned_strings_buffer=8
opcache.max_accelerated_files=10000
opcache.memory_consumption=128
opcache.save_comments=1
opcache.revalidate_freq=1
Tutup php.ini file konfigurasi dan periksa apakah variabel telah ditambahkan dengan benar, sesuatu yang dapat Anda lakukan dengan mengeluarkan perintah di bawah ini.
grep opcache /etc/php/7.0/apache2/php.ini| grep -v ";"
Selanjutnya, tambahkan aturan aplikasi firewall UFW berikut di sistem Anda, untuk mengizinkan traffic HTTP melewati firewall, dengan mengeluarkan perintah berikut.
ufw allow WWW
atau
ufw allow 80/tcp
Beberapa sysadmin lebih memilih iptables aturan mentah untuk mengelola aturan Firewall di server Debian. Dalam kasus iptables, jalankan perintah di bawah ini untuk menginstal firewall dan tambahkan aturan berikut untuk mengizinkan lalu lintas masuk port 80 dan 22 (untuk koneksi jarak jauh SSH) sehingga Anda dapat mengakses sistem dan menjelajahi aplikasi melalui browser web.
apt-get install -y iptables-persistent
iptables -I INPUT -p tcp --destination-port 80 -j ACCEPT
iptables -I INPUT -p tcp --destination-port 22 -j ACCEPT
netfilter-persistent save
systemctl restart netfilter-persistent
systemctl status netfilter-persistent
systemctl enable netfilter-persistent.service
Terakhir, buka browser dan kunjungi alamat IP mesin Debian Anda atau nama domain Anda melalui protokol HTTP. Jika Anda tidak mengetahui alamat IP mesin Anda, jalankan ifconfig atau ip a perintah untuk mendapatkan alamat IP server Anda. Jika koneksi ke server web dibuat, Anda seharusnya dapat melihat halaman web default server web Apache di browser Anda.
http://domain_anda.tld
Pada langkah berikutnya, aktifkan Apache rewrite, dan deflate modul SSL yang diperlukan oleh EspoCRM agar berjalan dengan benar, dengan mengeluarkan perintah di bawah ini.
a2enmod rewrite deflate ssl
Modul SSL mengharuskan Anda juga mengaktifkan file konfigurasi SSL default untuk mengunjungi aplikasi melalui protokol HTTPS. Protokol HTTPS digunakan untuk mengamankan lalu lintas antara server dan klien. Jalankan perintah berikut untuk mengaktifkan file konfigurasi situs SSL Apache.
a2ensite default-ssl.conf
Setelah itu, buka file konfigurasi situs SSL default Apache dengan editor teks dan masukkan baris kode berikut setelah DocumentRoot direktif, seperti yang ditunjukkan pada contoh di bawah, untuk mengaktifkan aturan yang ditempatkan di file .htaccess. File .htaccess biasanya terletak di atas webroot domain Anda.
nano /etc/apache2/sites-enabled/default-ssl.conf
Kutipan file konfigurasi situs SSL:
<Directory /var/www/html>
Options +FollowSymlinks
AllowOverride All
Require all granted
</Directory>
Anda juga harus membuka /etc/apache2/sites-enabled/000-default.conf file untuk mengedit dan menambahkan aturan penulisan ulang URL yang sama seperti yang dimasukkan dalam file konfigurasi SSL. Tambahkan baris kode setelah DocumentRoot pernyataan seperti yang ditunjukkan pada contoh di bawah ini.
<Directory /var/www/html>
Options +FollowSymlinks
AllowOverride All
Require all granted
</Directory>
Terakhir, mulai ulang daemon Apache untuk menerapkan semua aturan yang dikonfigurasi sejauh ini dan kunjungi domain Anda melalui protokol HTTPS. Karena Anda menggunakan pasangan sertifikat yang ditandatangani sendiri secara otomatis yang dikeluarkan oleh Apache saat penginstalan, sertifikat yang tidak dipercaya oleh browser, peringatan kesalahan koneksi tidak aman harus ditampilkan di browser. Terima peringatan untuk menerima sertifikat yang tidak dipercaya dan terus diarahkan ke halaman web default Apache.
systemctl restart apache2
https://domainanda.tld
Jika Anda berencana untuk mengekspos platform EspoCRM Anda untuk produksi di internet, Anda harus mempertimbangkan untuk membeli sertifikat yang dikeluarkan oleh Otoritas Sertifikat tepercaya atau mendapatkan pasangan sertifikat gratis dari Let's Encrypt CA, sehingga klien dapat mengunjungi aplikasi tanpa kesalahan yang ditampilkan di browser mereka .
Jika aplikasi firewall UFW memblokir koneksi jaringan yang masuk ke port HTTPS, Anda harus menambahkan aturan baru untuk mengizinkan lalu lintas HTTPS melewati firewall dengan mengeluarkan perintah berikut.
ufw allow HTTPS
atau
ufw allow 443/tcp
Untuk firewall iptables, tambahkan aturan berikut untuk mengizinkan lalu lintas masuk port 443 di firewall sehingga Anda dapat menelusuri nama domain. Simpan dan mulai ulang layanan iptables untuk menerapkan aturan setelah sistem di-boot ulang.
iptables -I INPUT -p tcp --destination-port 443 -j ACCEPT
netfilter-persistent save
systemctl restart netfilter-persistent
systemctl status netfilter-persistent
Terakhir, buat file info PHP di jalur root web domain Anda dengan menjalankan perintah berikut.
echo '<?php phpinfo(); ?>'| tee /var/www/html/info.php
Periksa pengaturan PHP dan konfigurasi zona waktu dengan mengunjungi file skrip info PHP dari browser di URL berikut, seperti yang diilustrasikan pada gambar di bawah ini. Gulir ke bawah ke tanggal pengaturan untuk memeriksa konfigurasi zona waktu PHP.
https://domain.tld/info.php
Pada langkah selanjutnya, masuk ke konsol server MySQL dan amankan akun root MariaDB dengan menjalankan perintah di bawah ini. Ketik keluar untuk meninggalkan konsol basis data.
mysql -h localhost
Welcome to the MariaDB monitor. Commands end with ; or \g.
Your MariaDB connection id is 2
Server version: 10.1.26-MariaDB-0+deb9u1 Debian 9.1
Copyright (c) 2000, 2017, Oracle, MariaDB Corporation Ab and others.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
MariaDB [(none)]> gunakan mysql;
Reading table information for completion of table and column names
You can turn off this feature to get a quicker startup with -A
Database changed
MariaDB [mysql]> perbarui set pengguna plugin='' where user='root';
Query OK, 1 row affected (0.00 sec)
Rows matched: 1 Changed: 1 Warnings: 0
MariaDB [mysql]> hak istimewa flush;
Query OK, 0 rows affected (0.00 sec)
MariaDB [mysql]> exit
Bye
Juga, jalankan mysql_secure_installation skrip untuk lebih mengamankan daemon MariaDB. Saat menjalankan skrip, Anda akan ditanya serangkaian pertanyaan yang dirancang untuk mengamankan database MariaDB, seperti:mengubah kata sandi root MySQL, menghapus pengguna anonim, menonaktifkan login root jarak jauh, dan menghapus database pengujian. Ketik “ya” untuk semua pertanyaan yang diajukan, seperti yang diilustrasikan dalam kutipan di bawah ini.
mysql_secure_installation
NOTE: RUNNING ALL PARTS OF THIS SCRIPT IS RECOMMENDED FOR ALL MariaDB
SERVERS IN PRODUCTION USE! PLEASE READ EACH STEP CAREFULLY!
In order to log into MariaDB to secure it, we'll need the current
password for the root user. If you've just installed MariaDB, and
you haven't set the root password yet, the password will be blank,
so you should just press enter here.
Enter current password for root (enter for none):
OK, successfully used password, moving on...
Setting the root password ensures that nobody can log into the MariaDB
root user without the proper authorisation.
You already have a root password set, so you can safely answer 'n'.
Change the root password? [Y/n] y
New password:
Re-enter new password:
Password updated successfully!
Reloading privilege tables..
... Success!
By default, a MariaDB installation has an anonymous user, allowing anyone
to log into MariaDB without having to have a user account created for
them. This is intended only for testing, and to make the installation
go a bit smoother. You should remove them before moving into a
production environment.
Remove anonymous users? [Y/n] y
... Success!
Normally, root should only be allowed to connect from 'localhost'. This
ensures that someone cannot guess at the root password from the network.
Disallow root login remotely? [Y/n] y
... Success!
By default, MariaDB comes with a database named 'test' that anyone can
access. This is also intended only for testing, and should be removed
before moving into a production environment.
Remove test database and access to it? [Y/n] y
- Dropping test database...
... Success!
- Removing privileges on test database...
... Success!
Reloading the privilege tables will ensure that all changes made so far
will take effect immediately.
Reload privilege tables now? [Y/n] y
... Success!
Cleaning up...
All done! If you've completed all of the above steps, your MariaDB
installation should now be secure.
Thanks for using MariaDB!
Verifikasi masalah keamanan server MariaDB dengan mencoba masuk ke database melalui konsol tanpa kata sandi root. Akses ke database harus ditolak jika tidak ada kata sandi yang diberikan untuk akun root, seperti yang diilustrasikan dalam kutipan perintah di bawah ini:
mysql -h localhost -u root
ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: NO)
Sekarang, coba masuk ke database dengan kata sandi root. Anda seharusnya dapat mengakses konsol MySQL, seperti yang ditunjukkan pada contoh perintah di bawah ini:
mysql -h localhost -u root -p
Enter password:
Welcome to the MariaDB monitor. Commands end with ; or \g.
Your MariaDB connection id is 15
Server version: 10.1.26-MariaDB-0+deb9u1 Debian 9.1
Copyright (c) 2000, 2017, Oracle, MariaDB Corporation Ab and others.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
MariaDB [(none)]> exit
Bye
Instal EspoCRM
Setelah server HTTP Apache, daemon MariaDB dan interpreter PHP telah dikonfigurasi dengan benar untuk menginstal aplikasi EspoCRM di sistem Debian Anda. Jalankan perintah berikut untuk menginstal utilitas baris perintah yang disebutkan di dalamnya.
apt install wget bash-completion zip unzip curl
Pada langkah selanjutnya, kunjungi halaman unduhan resmi EspoCRM di https://www.espocrm.com/download/ dan ambil arsip terkompresi paket zip terbaru di sistem Anda melalui utilitas wget. Rilis EspoCRM saat ini pada saat tutorial ini ditulis adalah EspoCRM-5.0.3
wget https://www.espocrm.com/downloads/EspoCRM-5.0.3.zip
ls
Setelah pengunduhan arsip zip selesai, ekstrak file arsip zip ke direktori kerja Anda saat ini dan daftarkan file yang diekstraksi dengan mengeluarkan perintah di bawah ini. File instalasi aplikasi berada di EspoCRM-5.0.3 direktori.
unzip EspoCRM-5.0.3.zip
ls
ls -al EspoCRM-5.0.3
Selanjutnya, pastikan untuk menghapus file index.html dan info.php dari direktori webroot:
rm /var/www/html/index.html
rm /var/www/html/info.php
Salin semua file yang terletak di direktori yang diekstraksi ke jalur root dokumen server web Anda dengan mengeluarkan perintah berikut. Juga, pastikan Anda menyalin file tersembunyi .htaccess ke jalur webroot.
cp -rf EspoCRM-5.0.3/* /var/www/html/
cp EspoCRM-5.0.3/.htaccess /var/www/html/
Selanjutnya, jalankan perintah di bawah ini untuk memberikan Apache www-data akun dengan izin menulis penuh ke jalur root web. Gunakan ls perintah untuk membuat daftar izin untuk file yang diinstal EspoCRM yang terletak di direktori /var/www/html/.
chown -R www-data:www-data /var/www/html/
ls –al /var/www/html/
Selanjutnya, masuk ke konsol database MariaDB dan buat database EspoCRM. Gunakan nama deskriptif untuk database dan buat pengguna dengan kata sandi yang kuat untuk mengelola database ini. Ganti nama database, pengguna dan kata sandi yang digunakan dalam contoh ini dengan nilai Anda sendiri. Perintah yang digunakan untuk langkah ini ditunjukkan pada kutipan di bawah ini.
mysql –u root -p
Welcome to the MariaDB monitor. Commands end with ; or \g.
Your MariaDB connection id is 2
Server version: 10.1.26-MariaDB-0+deb9u1 Debian 9.1
Copyright (c) 2000, 2017, Oracle, MariaDB Corporation Ab and others.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
MariaDB [(none)]> buat database espocrm_db;
Query OK, 1 row affected (0.00 sec)
MariaDB [(none)]> berikan semua hak istimewa di espocrm_db.* kepada 'crm_user'@'localhost' yang diidentifikasi oleh 'password1234';
Query OK, 0 rows affected (0.00 sec)
MariaDB [(none)]> hak istimewa flush;
Query OK, 0 rows affected (0.00 sec)
MariaDB [(none)]> exit
Bye
Sekarang, buka browser dan navigasikan alamat IP atau nama domain server Anda melalui protokol HTTPS untuk melanjutkan proses instalasi platform EspoCRM. Pada layar penginstalan pertama, penginstal EspoCRM akan menampilkan pesan selamat datang dan daftar dari mana Anda dapat memilih bahasa penginstalan. Pilih bahasa yang sesuai dari daftar yang disajikan dan tekan tombol Start untuk memulai proses instalasi, seperti yang diilustrasikan pada gambar di bawah.
https://domainanda.tld
Di layar berikutnya, baca pernyataan perjanjian lisensi dan centang "Saya menerima perjanjian t" centang kotak dan tekan tombol Berikutnya untuk pindah ke langkah berikutnya.
Di layar instalasi berikutnya, atur pengaturan koneksi database MySQL. Berikan alamat host database MySQL (127.0.0.1 atau localhost), nama database, nama pengguna, dan kata sandi yang dikonfigurasi untuk aplikasi EspoCRM. Setelah menyelesaikan semua bidang database yang diperlukan, tekan tombol Next untuk pindah ke langkah instalasi berikutnya. Gunakan tangkapan layar di bawah ini sebagai panduan untuk menyelesaikan langkah ini.
Di layar berikutnya, penginstal EspoCRM akan memeriksa konfigurasi lingkungan server Anda untuk menentukan apakah semua variabel MySQL dan modul serta pengaturan PHP yang direkomendasikan telah dikonfigurasi dengan benar. Jika semua konfigurasi berhasil, tekan tombol Install untuk memulai proses instalasi EspoCRM.
Pada langkah berikutnya, tambahkan akun administrator untuk EspoCRM dan atur kata sandi yang kuat untuk akun admin ini. Setelah selesai, tekan tombol Berikutnya untuk melanjutkan proses instalasi lebih lanjut.
Selanjutnya, atur pengaturan sistem EspoCRM dengan memilih Format Tanggal dan Format Waktu yang sesuai. Juga, pilih pengaturan Zona Waktu yang sesuai dengan aplikasi Anda dengan memilih Benua/Kota terdekat dari daftar zona waktu yang disediakan. Siapkan hari pertama dalam seminggu, mata uang default aplikasi, tanda pemisah ribuan dan desimal, serta bahasa sistem. Ketika semua pengaturan di atas telah dikonfigurasi, tekan tombol Next untuk melanjutkan proses instalasi.
Pada langkah selanjutnya, konfigurasikan pengaturan surat keluar EspoCRM. Tambahkan nama untuk header email "Dari Nama" dan alamat kontak email dari akun admin. Alamat ini akan digunakan untuk mengirim email ke klien luar. Juga, pastikan Anda menambahkan alamat server email, nomor port server email dan centang kotak Auth dan berikan kredensial otentikasi server dan tingkat keamanan, jika itu masalahnya. Ketika Anda selesai menyelesaikan langkah ini, tekan tombol berikutnya untuk menyelesaikan proses instalasi.
Setelah struktur database diimpor dan semua pengaturan platform ditulis ke file konfigurasi aplikasi, proses instalasi akan selesai. Penginstal akan menampilkan pemberitahuan bahwa penginstalan telah berhasil diselesaikan dan akan menampilkan catatan tentang tugas terjadwal EspoCRM yang perlu Anda tambahkan ke file crontab server Anda.
Untuk mengakses dan mengelola aplikasi CRM Anda, buka browser dan navigasikan ke alamat IP server atau nama domain Anda melalui HTTPS. Gunakan kredensial yang dikonfigurasi selama proses instalasi untuk masuk ke panel backend EspoCRM, seperti yang ditunjukkan pada tangkapan layar di bawah.
https://domainanda.tld
Dasbor EspoCRM default seharusnya tidak berisi data sejauh ini. Pratinjau di dasbor awal EspoCRM diilustrasikan pada tangkapan layar di bawah ini.
Untuk mengonfigurasi pengaturan platform EspoCRM lebih lanjut, tekan ikon kanan atas dengan tiga garis horizontal dan tekan tautan Administrasi dari menu atas-bawah, seperti yang ditunjukkan pada gambar di bawah.
Untuk memaksa pengunjung mengakses antarmuka backend EspoCRM dengan aman melalui protokol HTTPS yang mengenkripsi lalu lintas antara server dan browser klien, kembali ke terminal server Anda dan edit .htaccess file yang terletak di jalur root dokumen situs web Anda, dengan mengeluarkan perintah di bawah ini.
nano /var/www/html/.htaccess
Di file .htaccess, cari
# Redirect to HTTPS
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule (.*) https://%{SERVER_NAME}/$1 [R,L]
Di bagian atas, file Anda dapat mengubah pengaturan server PHP asli, seperti peningkatan nilai untuk upload_max_filesize dan post_max_size Variabel PHP, untuk mendukung upload file besar ke penyimpanan aplikasi. Ubah pengaturan PHP ini dengan sangat hati-hati. Pastikan variabel ini cocok dengan sumber daya dan konfigurasi server Anda.
# Modify PHP settings
php_value session.use_trans_sid 0
php_value register_globals 1
php_value upload_max_filesize 100M
php_value post_max_size 100M
Selanjutnya, uji pekerjaan yang dijadwalkan sebelum menambahkannya untuk dijalankan ke file daemon crontab, dengan mengeluarkan perintah di bawah ini. Pekerjaan crontask harus dijalankan dengan hak istimewa akun runtime server Apache HTTP.
sudo -u www-data /usr/bin/php7.0 -f /var/www/html/cron.php
Terakhir, tambahkan tugas crontab berikut yang dimiliki oleh Apache www-data akun, dengan mengeluarkan perintah di bawah ini.
crontab -u www-data –e
Kutipan file crontab:
* * * * * /usr/bin/php7.0 -f /var/www/html/cron.php > /dev/null 2>&1
Itu saja! Anda telah berhasil menginstal dan mengonfigurasi platform EspoCRM di Debian 9. Untuk pengaturan lain terkait platform EspoCRM, kunjungi halaman dokumentasi di alamat berikut: https://www.espocrm.com/documentation/