Come installare SuiteCRM su Ubuntu 20.04

SuiteCRM è un sistema CRM gratuito, open-source e di classe enterprise sviluppato da SalesAgility. È un fork della SugarCRM Community Edition. Viene fornito con tutte le funzionalità necessarie per gestire qualsiasi attività con esigenze CRM ed ERP. Offre un’ampia gamma di funzionalità tra cui marketing via email, integrazione con i social media, automazione del marketing, integrazione della chat interna, archiviazione dei documenti, promemoria, gestione delle attività e molto altro. Questo post ti mostrerà come installare SuiteCRM con Nginx e Let’s Encrypt SSL su Ubuntu 20.04.

Prerequisiti

Un server che esegue Ubuntu 20.04.
Un nome di dominio valido puntato all’IP del tuo server.
Una password di root configurata sul server.

Iniziare

Prima di iniziare, dovrai aggiornare i pacchetti del tuo sistema all’ultima versione. Puoi aggiornarli utilizzando il seguente comando:

apt-get update -y

Una volta aggiornato il tuo server, puoi procedere al passaggio successivo.

Installa Nginx, MariaDB e PHP

Prima di tutto, dovrai installare il server web Nginx, MariaDB, PHP e altre estensioni PHP sul tuo server. Puoi installarli tutti utilizzando il seguente comando:

apt-get install nginx mariadb-server php7.4 php7.4-fpm php7.4-gd php7.4-opcache php7.4-mbstring php7.4-xml php7.4-json php7.4-zip php7.4-curl php7.4-imap php-mysql unzip -y

Dopo aver installato tutti i pacchetti, modifica il file php.ini e cambia le impostazioni consigliate:

nano /etc/php/7.4/fpm/php.ini

Cambia le seguenti impostazioni:

post_max_size = 60M
upload_max_filesize = 60M
memory_limit = 256M
max_input_time = 60
max_execution_time = 5000
date.timezone = Asia/Kolkata

Salva e chiudi il file, quindi riavvia il servizio PHP-FPM per applicare le modifiche.

systemctl restart php7.4-fpm

A questo punto, il server LEMP è installato sul tuo server. Puoi ora procedere al passaggio successivo.

Crea un database per SuiteCRM

SuiteCRM richiede un database per memorizzare i propri contenuti. Prima di tutto, accedi alla shell di MariaDB utilizzando il seguente comando:

mysql

Una volta effettuato l’accesso, crea un database e un utente con il seguente comando:

MariaDB [(none)]> CREATE DATABASE suitecrm;  
MariaDB [(none)]> GRANT ALL PRIVILEGES ON suitecrm.* TO 'suitecrm'@'localhost' IDENTIFIED BY 'password';

Successivamente, dovrai svuotare i privilegi per applicare le modifiche.

MariaDB [(none)]> FLUSH PRIVILEGES;

Successivamente, esci dalla console di MariaDB con il seguente comando:

MariaDB [(none)]> EXIT;

Ora hai un database e gli utenti sono pronti per SuiteCRM. Puoi ora procedere al passaggio successivo.

Installa SuiteCRM

Prima di tutto, vai al sito ufficiale di SuiteCRM e scarica l’ultima versione di SuiteCRM utilizzando il seguente comando:

wget https://sourceforge.net/projects/suitecrm/files/SuiteCRM-7.11.19.zip

Una volta completato il download, decomprimi il file scaricato con il seguente comando:

unzip SuiteCRM-7.11.19.zip

Successivamente, sposta la directory estratta nella directory radice di Nginx con il seguente comando:

mv SuiteCRM-7.11.19 /var/www/html/suitecrm

Successivamente, imposta i permessi e la proprietà corretti per la directory suitecrm:

chown -R www-data:www-data /var/www/html/suitecrm/  
chmod 755 -R /var/www/html/suitecrm/

Una volta terminato, puoi procedere a configurare Nginx.

Configura Nginx per ospitare SuiteCRM

Successivamente, dovrai creare un file di configurazione del virtual host Nginx per ospitare SuiteCRM su Internet. Puoi crearlo con il seguente comando:

nano /etc/nginx/conf.d/suitecrm.conf

Aggiungi le seguenti righe:

server {
   listen 80;
   server_name suitecrm.example.com;

   root /var/www/html/suitecrm;
   error_log /var/log/nginx/suitecrm.error;
   access_log /var/log/nginx/suitecrm.access;
   client_max_body_size 20M;

   index index.php index.html index.htm index.nginx-debian.html;

   location / {
     # prova a servire il file direttamente, fallback a app.php
     try_files $uri /index.php$is_args$args;
   }

   location ~ \.php$ {
     include snippets/fastcgi-php.conf;
     fastcgi_pass unix:/run/php/php7.4-fpm.sock;
   }

   location ~* ^/index.php {
     # try_files $uri =404;
     fastcgi_split_path_info ^(.+\.php)(/.+)$;
     # NOTA: Dovresti avere "cgi.fix_pathinfo = 0;" in php.ini

     fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
     fastcgi_index index.php;
     fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
     include fastcgi_params;

     fastcgi_buffer_size 128k;
     fastcgi_buffers 256 16k;
     fastcgi_busy_buffers_size 256k;
     fastcgi_temp_file_write_size 256k;
   }

    # Non registrare favicon
    location = /favicon.ico {
        log_not_found off;
        access_log off;
    }

    # Non registrare robots
    location = /robots.txt  {
        access_log off;
        log_not_found off;
    }

    # Negare tutti i tentativi di accesso a file/cartelle nascosti come .htaccess, .htpasswd, .DS_Store (Mac), ecc...
    location ~ \. {
        deny all;
        access_log off;
        log_not_found off;
    }

     # Una lunga durata della cache del browser può velocizzare le visite ripetute alla tua pagina
  location ~* \.(jpg|jpeg|gif|png|webp|svg|woff|woff2|ttf|css|js|ico|xml)$ {
       access_log        off;
       log_not_found     off;
       expires           360d;
  }
}

Salva e chiudi il file quando hai finito, quindi verifica la sintassi di Nginx per eventuali errori utilizzando il seguente comando:

nginx -t

Dovresti ottenere il seguente output:

nginx: il file di configurazione /etc/nginx/nginx.conf ha una sintassi corretta
nginx: il test del file di configurazione /etc/nginx/nginx.conf è riuscito

Successivamente, riavvia il servizio Nginx per applicare le modifiche:

systemctl restart nginx

Per controllare lo stato del servizio Nginx, esegui il seguente comando:

systemctl status nginx

Dovresti ottenere il seguente output:

? nginx.service - Un server web ad alte prestazioni e un server proxy inverso
     Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
     Active: active (running) since Sat 2021-05-22 10:16:45 UTC; 4s ago
       Docs: man:nginx(8)
    Process: 18988 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
    Process: 19000 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
   Main PID: 19001 (nginx)
      Tasks: 2 (limit: 2353)
     Memory: 2.7M
     CGroup: /system.slice/nginx.service
             ??19001 nginx: processo master /usr/sbin/nginx -g daemon on; master_process on;
             ??19002 nginx: processo worker

May 22 10:16:45 ubuntu2004 systemd[1]: Starting Un server web ad alte prestazioni e un server proxy inverso...
May 22 10:16:45 ubuntu2004 systemd[1]: Started Un server web ad alte prestazioni e un server proxy inverso.

A questo punto, Nginx è configurato per servire SuiteCRM. Puoi ora procedere ad accedere a SuiteCRM.

Accedi a SuiteCRM

Ora, apri il tuo browser web e accedi a SuiteCRM utilizzando l’URL http://suitecrm.example.com. Dovresti vedere la seguente pagina:

Accetta il contratto di licenza e fai clic sul pulsante Avanti. Dovresti vedere la seguente pagina:

Assicurati che tutti i prerequisiti siano installati, quindi fai clic sul pulsante Avanti. Dovresti vedere la seguente pagina:

Fornisci il nome del tuo database, utente, password, nome utente admin, password, URL di SuiteCRM, indirizzo email e poi fai clic sul pulsante Avanti. Una volta completata l’installazione, dovresti vedere la seguente pagina:

Ora, fai clic sul pulsante Avanti. Dovresti vedere la pagina di accesso di SuiteCRM:

Fornisci il tuo nome utente admin, password e fai clic sul pulsante ACCEDI. Dovresti vedere il dashboard di SuiteCRM nella seguente pagina:

Sicurezza di SuiteCRM con Let’s Encrypt

Successivamente, dovrai installare il pacchetto client Certbot per installare e gestire il SSL di Let’s Encrypt.

Prima di tutto, installa Certbot con il seguente comando:

apt-get install certbot python3-certbot-nginx -y

Una volta completata l’installazione, esegui il seguente comando per installare il SSL di Let’s Encrypt sul tuo sito web:

certbot --nginx -d suitecrm.example.com

Ti verrà chiesto di fornire un indirizzo email valido e accettare i termini di servizio come mostrato di seguito:

Saving debug log to /var/log/letsencrypt/letsencrypt.log
Plugins selected: Authenticator nginx, Installer nginx
Enter email address (used for urgent renewal and security notices) (Enter 'c' to
cancel): [email protected]

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Please read the Terms of Service at
https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf. You must
agree in order to register with the ACME server at
https://acme-v02.api.letsencrypt.org/directory
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(A)gree/(C)ancel: A

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Would you be willing to share your email address with the Electronic Frontier
Foundation, a founding partner of the Let's Encrypt project and the non-profit
organization that develops Certbot? We'd like to send you email about our work
encrypting the web, EFF news, campaigns, and ways to support digital freedom.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y
Obtaining a new certificate
Performing the following challenges:
http-01 challenge for suitecrm.example.com
Waiting for verification...
Cleaning up challenges
Deploying Certificate to VirtualHost /etc/nginx/conf.d/suitecrm.conf

Successivamente, scegli se reindirizzare o meno il traffico HTTP su HTTPS come mostrato di seguito:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1: No redirect - Make no further changes to the webserver configuration.
2: Redirect - Make all requests redirect to secure HTTPS access. Choose this for
new sites, or if you're confident your site works on HTTPS. You can undo this
change by editing your web server's configuration.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Select the appropriate number [1-2] then [enter] (press 'c' to cancel): 2

Digita 2 e premi Invio per completare l’installazione. Dovresti vedere il seguente output:

Redirecting all traffic on port 80 to ssl in /etc/nginx/conf.d/suitecrm.conf

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Congratulations! You have successfully enabled https://suitecrm.example.com

You should test your configuration at:
https://www.ssllabs.com/ssltest/analyze.html?d=suitecrm.example.com
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

IMPORTANT NOTES:
 - Congratulations! Your certificate and chain have been saved at:
   /etc/letsencrypt/live/suitecrm.example.com/fullchain.pem
   Your key file has been saved at:
   /etc/letsencrypt/live/suitecrm.example.com/privkey.pem
   Your cert will expire on 2021-10-30. To obtain a new or tweaked
   version of this certificate in the future, simply run certbot again
   with the "certonly" option. To non-interactively renew *all* of
   your certificates, run "certbot renew"
 - Your account credentials have been saved in your Certbot
   configuration directory at /etc/letsencrypt. You should make a
   secure backup of this folder now. This configuration directory will
   also contain certificates and private keys obtained by Certbot so
   making regular backups of this folder is ideal.
 - If you like Certbot, please consider supporting our work by:

   Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate
   Donating to EFF:                    https://eff.org/donate-le

 - We were unable to subscribe you the EFF mailing list because your
   e-mail address appears to be invalid. You can try again later by
   visiting https://act.eff.org.

Ora, il tuo SuiteCRM è protetto con SSL di Let’s Encrypt. Puoi accedervi in modo sicuro utilizzando l’URL https://suitecrm.example.com

Conclusione

Questo è tutto per ora. Hai installato con successo SuiteCRM con Nginx e SSL di Let’s Encrypt su Ubuntu 20.04. Puoi ora implementare SuiteCRM nella tua organizzazione. Per ulteriori informazioni visita il manuale utente di SuiteCRM.