SuiteCRM, cabang dari SugarCRM, adalah platform Manajemen Hubungan Pelanggan (CRM) sumber terbuka perusahaan yang ditulis dalam bahasa pemrograman PHP yang dapat digunakan untuk membuat strategi, tindakan, dan keputusan bisnis.
Tutorial ini menjelaskan semua langkah yang diperlukan untuk menginstal platform SuiteCRM versi terbaru pada Debian 9, untuk menerapkan platform online yang andal untuk bisnis Anda. Aplikasi CRM akan digunakan di Debian Linux di bawah server HTTP Apache, PHP dan mesin database MariaDB.
Persyaratan
- Server bare-metal atau server pribadi virtual dengan RAM minimal 2 Gb dan instalasi minimal server Debian 9.
- Akses ke root akun melalui konsol mesin atau jarak jauh melalui SSH. Selain akun root, Anda juga dapat menggunakan akun dengan hak akses root melalui sudo perintah.
- Antarmuka jaringan eksternal yang dikonfigurasi dengan alamat IP statis atau server DHCP yang dikonfigurasi untuk menyewakan alamat IP statis untuk antarmuka ini.
- Nama domain publik yang terdaftar untuk mengakses aplikasi dari internet. Jika aplikasi di-deploy di intranet, Anda dapat melakukan proses instalasi dan mengakses situs web melalui alamat IP server Anda.
- Server email yang dikonfigurasi di tempat Anda untuk menggunakan pendaftaran situs web atau fitur aplikasi lainnya. Anda juga dapat menggunakan layanan email publik, seperti Gmail atau Yahoo!, Microsoft Exchange, atau lainnya untuk mengirim dan menerima email.
Siapkan server
Pada langkah pertama, login ke konsol server Anda dengan akun root atau pengguna dengan hak akses root yang diperoleh melalui sudo dan atur nama sistem Anda dengan perintah di bawah ini. Pastikan Anda mengganti nama host mesin yang digunakan dalam contoh ini.
hostnamectl set-hostname www.mycrm.org
Setelah Anda mengubah nama host sistem, jalankan perintah di bawah ini untuk memverifikasi apakah nama mesin telah diterapkan dengan benar.
hostnamectl
cat /etc/hostname
hostname –s
hostname –f
Selanjutnya, pastikan Anda memperbarui repositori sistem, paket perangkat lunak, dan kernel Anda, dengan mengeluarkan perintah di bawah ini.
apt update
apt upgrade
Terakhir, setelah proses pembaruan selesai, reboot mesin untuk menerapkan perubahan nama host dan pembaruan kernel, dengan menjalankan perintah di bawah ini.
systemctl reboot
Setelah mesin reboot, masuk kembali ke konsol server dan jalankan perintah di bawah ini untuk menginstal beberapa utilitas baris perintah, seperti wget, curl dan zip, yang nantinya akan digunakan untuk mengunduh perangkat lunak melalui internet dan mengekstrak file arsip zip.
apt install wget curl zip unzip
Instal Apache dan PHP
Aplikasi SuiteCRM akan disebarkan di Debian di atas tumpukan LAMP. Komponen pertama dari LAMP stack yang akan kita instal adalah Apache HTTP server dan PHP dynamic programming language interpreter. Jalankan perintah di bawah ini untuk menginstal server web Apache dan semua modul PHP yang diperlukan di sistem 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
Instal database MariaDB
Komponen berikutnya dari bundel perangkat lunak LAMP yang akan kita pasang di server Debian adalah mesin database MariaDB. Basis data RDBMS diperlukan oleh aplikasi untuk menyimpan konfigurasi platform yang berbeda, seperti pengguna, sesi, kontak, produk, katalog, dan lainnya. Untuk menginstal mesin database MariaDB dan modul PHP yang diperlukan untuk mengakses database, jalankan perintah di bawah ini di konsol mesin Anda.
apt install mariadb-server php7.0-mysql mariadb-client
Setelah semua komponen LAMP diinstal, periksa apakah server web Apache dan daemon MariaDB aktif dan berjalan dan dengarkan koneksi jaringan pada port 80 dan 3306 TCP dengan mengeluarkan salah satu perintah berikut.
netstat –tlpn
ss- tulpn
Utilitas Netstat tidak ada secara default di sistem Debian 9. Untuk memasang netstat utilitas di server Debian Stretch, jalankan perintah di bawah ini.
apt install net-tools
Saya n untuk mengakses situs web CRM dengan aman melalui protokol HTTPS yang akan mengamankan lalu lintas antara browser server dan klien, pastikan Anda juga mengaktifkan modul Apache TLS dan file konfigurasi situs SSL, dengan mengeluarkan perintah di bawah ini.
a2enmod ssl
a2ensite default-ssl.conf
Selanjutnya, aktifkan modul Apache rewrite dengan mengeluarkan perintah di bawah ini. Modul rewrite diperlukan jika Anda ingin mengubah konfigurasi server web secara on-fly melalui .htaccess file yang ditempatkan di root web domain Anda.
a2enmod rewrite
systemctl restart apache2
Selanjutnya, aktifkan modul rewrite dengan menempatkan aturan yang diperlukan di file konfigurasi Apache. Pertama, kami akan menerapkan aturan penulisan ulang di file konfigurasi default Apache. Jadi, buka /etc/apache2/sites-enabled/000-default.conf file untuk diedit dengan editor teks dan masukkan aturan penulisan ulang URL di bawah ini setelah DocumentRoot pernyataan tersebut, seperti terlihat pada kutipan berikut.
nano /etc/apache2/sites-enabled/000-default.conf
000-default.conf kutipan file:
<Directory /var/www/html>
Options +FollowSymlinks
AllowOverride All
Require all granted
</Directory>
Tutup 000-default.conf dengan CTRL+o, lalu Ctrl+x dan buka file konfigurasi situs SSL default Apache dan masukkan aturan penulisan ulang URL dengan menambahkan baris kode berikut setelah direktif DocumentRoot, seperti yang ditunjukkan pada contoh di bawah ini:
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>
Terakhir, setelah Anda melakukan semua perubahan di atas, mulai ulang daemon Apache untuk mengambil semua aturan baru yang dikonfigurasi sejauh ini.
systemctl restart apache2
Sekarang, Anda harus mengunjungi domain Anda atau alamat IP server melalui protokol HTTP dari mesin desktop jarak jauh. Halaman web Debian default harus ditampilkan di browser Anda.
http://domainanda.tld
Konfigurasi Firewall
Jika Anda tidak dapat melihat halaman web, verifikasi apakah aplikasi firewall UFW diaktifkan di server Debian. Jika demikian, Anda harus memasukkan aturan di bawah ini untuk mengizinkan lalu lintas HTTP dan HTTPS melewati firewall.
ufw allow 'WWW Full'
atau
ufw allow 80/tcp
ufw allow 443/tcp
iptables aturan baku firewall untuk mengizinkan lalu lintas masuk TCP port 80 dan 443 melewati firewall dijelaskan di bawah ini.
apt-get install -y iptables-persistent
iptables -I INPUT -p tcp --destination-port 80 -j ACCEPT
iptables -I INPUT -p tcp --destination-port 443 -j ACCEPT
netfilter-persistent save
systemctl restart netfilter-persistent
systemctl status netfilter-persistent
systemctl enable netfilter-persistent.service
Terakhir, setelah Anda menambahkan aturan firewall yang diperlukan, uji apakah halaman web default server web Apache dapat ditampilkan di browser jarak jauh dengan mengunjungi nama domain atau alamat IP server Anda melalui protokol HTTPS. Jalankan perintah ifconfig atau ip a untuk menampilkan alamat IP server Anda.
http://domainanda.tld
Karena Anda menggunakan sertifikat yang ditandatangani sendiri secara otomatis yang dikeluarkan oleh Apache saat penginstalan, sertifikat yang tidak dipercaya oleh browser, peringatan yang mengatakan bahwa "Koneksi Anda tidak aman" harus ditampilkan di browser. Terima sertifikat tidak tepercaya untuk melewati kesalahan dan diarahkan ke halaman web default Apache, seperti yang diilustrasikan pada gambar di bawah ini.
Konfigurasi MariaDB dan PHP
Sekarang, set mulai mengamankan akun root MariaDB. Masuk ke konsol MySQL, jalankan perintah di bawah ini untuk memperbarui root plugin akun.
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 skrip mysql_secure_installation menyediakan repositori peregangan Debian untuk lebih mengamankan database MariaDB. Skrip akan menanyakan pertanyaan berikut kepada Anda: ubah sandi root MySQL, hapus pengguna anonim, nonaktifkan login root jarak jauh, dan hapus database pengujian. Jawab dengan ya untuk semua pertanyaan, seperti yang diilustrasikan dalam contoh keluaran skrip 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!
Uji apakah semua tindakan keamanan telah diterapkan dengan mencoba masuk ke konsol MySQL dengan akun root dan tidak ada kata sandi yang diberikan. 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 konsol MySQL dengan akun root dan kata sandi, seperti yang ditunjukkan pada contoh di bawah ini. Anda harus dapat masuk ke konsol MySQL. Ketik keluar untuk meninggalkan database MySQL.
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
Pada langkah selanjutnya, ubah variabel PHP berikut di php.ini file konfigurasi seperti yang dijelaskan di bawah ini. Buka /etc/php/7.0/Apache2/php.ini file untuk mengedit dan memodifikasi baris berikut. Pertama, pastikan Anda membuat cadangan file konfigurasi PHP awal.
cp /etc/php/7.0/apache2/php.ini{,.backup} nano /etc/php/7.0/apache2/php.ini
Cari, edit, dan ubah variabel berikut di php.ini file konfigurasi:
file_uploads = On
default_charset = UTF-8
memory_limit = 128M
post_max_size = 60M
upload_max_filesize = 60M
memory_limit = 256M
max_input_time = 60
max_execution_time = 6000
date.timezone = Europe/London
Ganti zona waktu variabel dalam file konfigurasi PHP sesuai dengan lokasi geografis server Anda. Daftar zona waktu PHP dapat ditemukan di tautan berikut http://php.net/manual/en/timezones.php
Untuk meningkatkan kecepatan memuat halaman situs web Anda, aktifkan plugin OPCache yang tersedia untuk PHP7. Sisipkan baris OPCache berikut di bagian bawah file konfigurasi interpreter PHP, setelah [opcache] pernyataan, seperti terlihat pada kutipan berikut:
[opcache]
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
Terakhir, tutup php.ini file konfigurasi dan restart daemon Apache untuk menerapkan perubahan dengan mengeluarkan perintah di bawah ini.
systemctl restart apache2
Untuk menampilkan semua pengaturan PHP di browser, buat file info PHP di jalur webroot domain Anda dengan menjalankan perintah berikut.
echo '<?php phpinfo(); ?>'| tee /var/www/html/info.php
Kunjungi file skrip info PHP dari browser jarak jauh di URL berikut. Gulir ke bawah ke tanggal pengaturan untuk memverifikasi apakah konfigurasi zona waktu PHP dan pengaturan lainnya telah berhasil diterapkan.
https://domain.tld/info.php
Instal SuiteCRM
Setelah kami mengonfigurasi semua pengaturan LAMP yang diperlukan untuk menginstal aplikasi SuiteCRM, kunjungi halaman unduhan resmi SuiteCRM di https://suitecrm.com/download/ dan ambil arsip file zip terbaru di sistem Anda dengan mengeluarkan perintah di bawah ini. Saat menulis panduan ini, versi terbaru SuiteCRM yang dirilis adalah file SuiteCRM-7.9.9.zip.
wget https://suitecrm.com/files/158/SuiteCRM-7.9/178/SuiteCRM-7.9.9.zip
ls
Setelah pengunduhan arsip file zip SuiteCRM selesai, ekstrak file arsip zip ke direktori kerja Anda saat ini dan daftar file yang diekstrak dengan mengeluarkan perintah di bawah ini.
unzip SuiteCRM-7.9.9.zip
ls
ls –al SuiteCRM-7.9.9
Sebelum menyalin file instalasi ke webroot domain Anda, pastikan Anda menghapus file index.html default yang diinstal oleh paket Apache ke jalur root dokumen server web dan juga menghapus file info.php yang dibuat sebelumnya.
rm /var/www/html/index.html
rm /var/www/html/info.php
File instalasi aplikasi SuiteCRM terletak di direktori kerja Anda saat ini di bawah SuiteCRM-7.9.9/ direktori. Masalah ls perintah untuk membuat daftar file direktori ini. Salin semua konten SuiteCRM-7.9.9/ direktori ke jalur root dokumen server web Anda dengan mengeluarkan perintah berikut.
cp -rf SuiteCRM-7.9.9/* /var/www/html/
Selanjutnya, berikan Apache runtime user (www-data) dengan izin menulis penuh ke jalur root dokumen Apache, dengan mengeluarkan perintah di bawah ini. Jalankan ls perintah untuk membuat daftar izin untuk file yang diinstal yang terletak di bawah 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 SuiteCRM. Pilih nama untuk database ini dan pengguna dengan kata sandi yang kuat untuk mengelola database aplikasi, dengan mengeluarkan perintah berikut. Pastikan Anda mengubah nama database, pengguna, dan kata sandi yang digunakan dalam tutorial ini dengan pengaturan Anda sendiri.
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 mycrm_db;
Query OK, 1 row affected (0.00 sec)
MariaDB [(none)]> berikan semua hak istimewa di mycrm_db.* ke '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, mari kita mulai proses instalasi aplikasi SuiteCRM. Buka browser dan navigasikan alamat IP atau nama domain server Anda melalui protokol HTTPS.
http://domainanda.tld
Pada layar penginstalan pertama, penginstal SuiteCRM akan menampilkan perjanjian lisensi. Centang ‘Saya Setuju ’ kotak centang untuk menyetujui persyaratan dan ketentuan lisensi, pilih bahasa untuk menginstal aplikasi dan tekan tombol Berikutnya untuk memulai proses instalasi, seperti yang diilustrasikan pada tangkapan layar di bawah.
Di layar penginstalan berikutnya, penginstal SuiteCRM akan memeriksa persyaratan lingkungan sistem Anda dan akan menampilkan pesan OK jika semua konfigurasi PHP dan server dilewati. Untuk melanjutkan proses instalasi, tekan tombol Next, seperti yang ditunjukkan pada gambar di bawah.
Selanjutnya installer akan menampilkan halaman pengaturan Database Connection dan Site Configuration. Di panel kiri, pilih MySQL dengan Ekstensi MySQLi sebagai tipe basis data dan berikan nama basis data MySQL yang dibuat untuk menginstal aplikasi SuiteCRM, alamat host server basis data, nama pengguna basis data dan kata sandi yang diperlukan untuk mengakses basis data SuiteCRM. Juga, pilih "Same as Admin user" di "SuiteCRM Database user /". Di bidang kanan, tambahkan nama pengguna administrator aplikasi dan atur kata sandi yang kuat untuk akun admin. Periksa alamat URL instans SuiteCRM untuk mencocokkan nama domain Anda melalui protokol HTTPS, pada port 443 dan tambahkan alamat email akun admin. Gunakan gambar berikut sebagai panduan untuk mengonfigurasi langkah ini.
Selanjutnya, di layar instalasi yang sama, tekan data "Choose Demo" dari menu "More options", dan pilih untuk tidak mengisi database SuiteCRM dengan data demo. Kemudian, klik menu Pilihan Skenario dan pilih untuk mengaktifkan modul SuiteCRM berikut:Penjualan, Pemasaran, Keuangan, Layanan, dan Manajemen proyek. Jika Anda tidak memerlukan modul saat menginstal aplikasi, Anda dapat membiarkannya tidak dicentang dan mengaktifkannya setelah proses instalasi selesai menggunakan halaman administrasi aplikasi.
Selanjutnya, gulir ke bawah dan tekan menu Spesifikasi Server SMTP untuk mengaktifkan opsi email SuiteCRM. Tambahkan nama dan alamat email yang ingin Anda tampilkan di header email “Dari”. Kemudian, pilih penyedia layanan email Anda dan tentukan pengaturan server email. Dalam panduan ini, kami akan menggunakan penyedia layanan Gmail untuk mengirim email, dan pengaturan server email dapat ditemukan diilustrasikan pada tangkapan layar di bawah ini. Setelah Anda menyelesaikan pengaturan yang diperlukan untuk mengaktifkan penyedia layanan email Anda, tekan menu Branding dan tambahkan nama untuk ditampilkan di bilah judul browser untuk aplikasi SuiteCRM dan unggah gambar logo situs web Anda sendiri.
Selanjutnya, gulir ke bawah lagi dan tekan menu System Locale Settings dan tentukan bagaimana format waktu, zona waktu dan pengaturan mata uang akan ditampilkan di aplikasi SuiteCRM. Terakhir, biarkan opsi Keamanan Situs tidak dicentang untuk saat ini dan tekan tombol Berikutnya untuk menyelesaikan proses instalasi. Anda dapat menggunakan gambar di bawah ini untuk menyelesaikan langkah ini.
Setelah proses instalasi selesai, Anda akan diarahkan ke halaman login SuiteCRM. Untuk mengakses panel admin aplikasi, masuk ke SuiteCRM dengan kredensial akun admin yang dikonfigurasi selama proses penginstalan, seperti yang ditunjukkan pada gambar di bawah.
Sebelum masuk ke panel admin SuiteCRM, pertama-tama, kembali ke konsol server dan jalankan perintah berikut untuk menghapus direktori instal yang tidak lagi diperlukan dan dapat menunjukkan pelanggaran keamanan.
rm -rf /var/www/html/install/
Anda juga dapat mengunjungi dasbor SuiteCRM dengan menavigasi ke alamat IP server atau nama domain Anda melalui protokol HTTPS. Tampilan dasbor admin SuiteCRM disajikan pada tangkapan layar di bawah ini.
http://domainanda.tld
Terakhir, untuk secara otomatis mengarahkan pengunjung ke HTTPS, sehingga mereka dapat mengakses antarmuka SuiteCRM dengan aman dari browser mereka, kembali ke terminal server Anda dan edit .htaccess yang dibuat secara otomatis. file yang terletak di jalur root dokumen domain Anda, dengan mengeluarkan perintah di bawah ini.
nano /var/www/html/.htaccess
Di file .htaccess, cari
.htaccess kutipan file:
# Redirect to HTTPS
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule (.*) https://%{SERVER_NAME}/$1 [R,L]
Di bagian bawah file, Anda dapat mengubah pengaturan server PHP asli server web dengan menambahkan baris lain dengan pengaturan untuk mencerminkan sumber daya dan konfigurasi server Anda sendiri.
# 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
Untuk menjalankan Penjadwal SuiteCRM, edit file crontab akun runtime server web Anda dengan perintah di bawah ini dan tambahkan tugas cron berikut untuk dijalankan setiap menit.
crontab -e -u www-data
contoh file crontab:
* * * * * /usr/bin/php7.0 -f /var/www/html/cron.php > /dev/null 2>&1
Jika Anda ingin menghindari peringatan browser yang dibuat setiap kali klien mengunjungi aplikasi Anda, Anda harus mempertimbangkan untuk membeli sertifikat yang dikeluarkan oleh Otoritas Sertifikat tepercaya atau menerbitkan sertifikat gratis dari Let's Encrypt CA.
Itu saja! Aplikasi web SuiteCRM telah berhasil diinstal dan dikonfigurasi di server Debian 9 di atas tumpukan LAMP.
Untuk menyesuaikan lebih lanjut platform SuiteCRM, pastikan Anda mengunjungi halaman wiki aplikasi di alamat berikut:https://suitecrm.com/wiki/index.php/Main_Page