Com instal·lar OroCRM a CentOS 7

OroCRM és una aplicació gratuïta i de codi obert Customer Relationship Manager (CRM) construïda a OroPlatform. OroPlatform és un programari de plataforma d'aplicacions empresarials de codi obert totalment personalitzable. OroPlatform us ofereix totes les funcions necessàries per crear una aplicació personalitzada. OroCRM es construeix utilitzant el framework PHP Symfony i emmagatzema les seves dades al servidor de bases de dades MySQL/MariaDB. És una aplicació CRM preparada per a empreses que ofereix un munt de funcions. També s'integra amb moltes aplicacions de tercers, com ara Magento Store, MailChimp, Zendesk, etc. És multilingüe i té una interfície d'usuari totalment sensible, que us ofereix la possibilitat de gestionar-la mitjançant dispositius mòbils.

Requisits previs

• Una instància del servidor Vultr CentOS 7.
• Un usuari de sudo .

En aquest tutorial, utilitzarem crm.example.comcom a nom de domini apuntat al servidor. Substituïu totes les ocurrències de crm.example.compel vostre nom de domini real.

Actualitzeu el vostre sistema base mitjançant la guia Com actualitzar CentOS 7 . Un cop actualitzat el vostre sistema, procediu a instal·lar les dependències necessàries.

Instal·leu Nginx i PHP 7

OroCRM es pot instal·lar a qualsevol servidor web de producció que admeti PHP. OroCRM és compatible amb totes les versions de PHP superiors a 7.0. En aquest tutorial, utilitzarem Nginx amb PHP-FPM i PHP 7.1.

Instal·leu Nginx.

sudo yum -y install nginx

Inicieu Nginx i activeu-lo perquè s'iniciï automàticament a l'arrencada.

sudo systemctl start nginx
sudo systemctl enable nginx

PHP 7 no està disponible al repositori YUM predeterminat, però podem utilitzar el repositori Remi per obtenir i instal·lar les últimes versions de PHP 7. Primer, afegiu i activeu el repositori Remi.

sudo rpm -Uvh http://rpms.remirepo.net/enterprise/remi-release-7.rpm
sudo yum -y install yum-utils
sudo yum-config-manager --enable remi-php71

Instal·leu la darrera versió de PHP 7 juntament amb els mòduls PHP requerits per OroCRM.

sudo yum -y install php php-fpm php-ctype php-curl php-fileinfo php-gd php-intl php-json php-mbstring php-mcrypt php-mysql php-pcre php-simplexml php-tokenizer php-xml php-zip php-tidy php-soap php-opcache php-posix

Editeu el fitxer de configuració PHP predeterminat.

sudo nano /etc/php.ini

Busca les línies següents. Deixa de comentar i fes canvis tal com es mostra.

date.timezone = Asia/Kolkata
;Replace "Asia/Kolkata" with your appropriate timezone

memory_limit = 512M
cgi.fix_pathinfo=0

Editeu el fitxer de configuració PHP-FPM.

sudo nano /etc/php-fpm.d/www.conf

Per defecte, PHP-FPM està configurat per executar-se amb Apache i per escoltar el port 9000. Haurem de canviar l'usuari i el grup, així com el fitxer de socket Unix en què s'executarà. Cerqueu les línies següents i feu els canvis necessaris tal com es mostra.

user = nginx
group = nginx

;listen = 127.0.0.1:9000
;Comment out or remove the above line and add the following line.
listen = /var/run/php-fpm/php-fpm.sock

listen.owner = nobody
listen.group = nobody

Inicieu PHP-FPM i activeu-lo perquè s'iniciï a l'arrencada.

sudo systemctl start php-fpm
sudo systemctl enable php-fpm

Proporcioneu la propietat del fitxer de socket PHP-FPM a l'usuari de Nginx.

sudo chown nginx:nginx /var/run/php-fpm/php-fpm.sock

Instal·leu MariaDB

MariaDB és una bifurcació de codi obert de MySQL. Instal·leu MariaDB.

sudo yum -y install mariadb mariadb-server

Inicieu MariaDB i activeu-lo perquè s'iniciï automàticament a l'arrencada.

sudo systemctl start mariadb
sudo systemctl enable mariadb

La instal·lació predeterminada de MariaDB inclou algunes bases de dades de prova i usuaris anònims. Abans de configurar la base de dades, primer haureu de protegir el servidor MariaDB. Podeu assegurar-lo executant l' mysql_secure_installationscript.

sudo mysql_secure_installation

Se us demanarà la contrasenya d'arrel actual de MariaDB. De manera predeterminada, no hi ha cap contrasenya d'arrel en una nova instal·lació de MariaDB. Premeu la Entertecla per continuar. Establiu una contrasenya segura per a l'usuari root del vostre servidor MariaDB i responeu Ya totes les altres preguntes. Les preguntes que es fan són autoexplicatives.

Creeu la base de dades per a OroCRM

Inicieu sessió a l'intèrpret d'ordres de MySQL com a usuari root mitjançant l'execució.

mysql -u root -p

Proporcioneu la contrasenya perquè l'usuari root de MariaDB iniciï sessió.

Executeu les consultes següents per crear una base de dades i un usuari de base de dades per a la instal·lació d'OroCRM.

CREATE DATABASE oro_data;
CREATE USER 'oro_user'@'localhost' IDENTIFIED BY 'StrongPassword';
GRANT ALL PRIVILEGES ON oro_data.* TO 'oro_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Podeu substituir el nom de la base de dades oro_datai el nom d'usuari oro_usersegons la vostra elecció. Assegureu-vos de canviar StrongPassworda una contrasenya molt segura .

Instal·leu Node.js i Composer

OroCRM també requereix temps d'execució JavaScript de Node.js. Node.js serà utilitzat per OroCRM per compilar el JavaScript, que s'utilitza per crear la interfície d'usuari de l'aplicació. El dipòsit predeterminat de CentOS conté una versió obsoleta de Node.js, per tant, haureu d'afegir el dipòsit de Nodesource al vostre sistema per obtenir la darrera versió.

sudo curl --silent --location https://rpm.nodesource.com/setup_8.x | sudo bash -

Instal·leu Node.js i Git.

sudo yum -y install nodejs git

Git s'utilitzarà per clonar el repositori OroCRM des d'Internet. També haureu d'instal·lar Composer. Composer és una eina de gestió de dependències per a aplicacions PHP. Com que OroCRM està escrit en el marc de Symfony, necessitareu Composer per instal·lar les dependències i l'aplicació.

Instal·leu Composer.

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"

Mou Composer al /usr/bindirectori perquè es pugui executar des de qualsevol lloc del sistema.

sudo mv composer.phar /usr/bin/composer

Proporcioneu permís d'execució al compositor.

sudo chmod +x /usr/bin/composer

Instal·leu OroCRM

Hi ha moltes maneres de descarregar OroCRM al vostre servidor. La manera més adequada d'aconseguir la versió més actualitzada és clonar el repositori mitjançant Git.

Clonar el repositori OroCRM.

cd /usr/share/nginx/
sudo git clone -b 2.3 https://github.com/oroinc/crm-application.git orocrm

Copieu el parametersfitxer d' exemple al fitxer predeterminat parametersutilitzat per OroCRM.

cd orocrm
sudo cp app/config/parameters.yml.dist  app/config/parameters.yml

Abans de continuar, haureu d'actualitzar el parameters.ymlfitxer per proporcionar informació de la base de dades i del correu electrònic.

sudo nano app/config/parameters.yml

Busca les línies següents.

database_driver:   pdo_mysql
database_host:     127.0.0.1
database_port:     ~
database_name:     oro_crm
database_user:     root
database_password: ~

Actualitzeu la configuració anterior segons la base de dades que heu creat per emmagatzemar les dades d'OroCRM. En el nostre cas, hauria de ser així.

database_driver:   pdo_mysql
database_host:     127.0.0.1
database_port:     3306
database_name:     oro_data
database_user:     oro_user
database_password: StrongPassword

Si teniu un servidor SMTP preparat i voleu utilitzar immediatament les funcions d'enviament de correu electrònic, podeu actualitzar la configuració del correu tal com es mostra.

mailer_transport:  smtp
mailer_host:       mail.example.com
mailer_port:       456
mailer_encryption: ssl
mailer_user:       [email protected]
mailer_password:   EMailPassword

Si no teniu un servidor de correu preparat, podeu saltar-lo de moment deixant els valors existents. Sempre podeu canviar la configuració del correu electrònic a través del tauler.

Establiu una cadena aleatòria secretsubstituint ThisTokenIsNotSoSecretChangeIt. Es requereix una cadena aleatòria per codificar les dades de la sessió. Una cadena d'exemple tindrà aquest aspecte.

secret:            uxvpXHhDxCFc9yU1hV1fMwjSoyVUzGh4WBMBBBa3XEgrRUF5OuB2h8iNl9JRDqcd

Podeu generar una cadena aleatòria mitjançant la pwgenutilitat. Instal·leu la pwgenutilitat executant sudo yum -y install pwgen. Per generar una cadena aleatòria, executeu pwgen -s 64 1.

Deseu el fitxer i sortiu de l'editor. Instal·leu les dependències PHP necessàries mitjançant el compositor.

sudo composer install --prefer-dist --no-dev

Using --no-dev will ensure that the Composer only installs the dependencies required to run the web server in production mode. The script will take a few minutes to download and install the required PHP dependencies.

Install the application.

sudo php app/console oro:install --env=prod

This will build the web cache and write the database. The --env=prod parameter is provided to install the application in production mode. The installation will only proceed if all the required dependencies are installed and configured.

During the installation, you will be asked few questions for setting up the administrator account. The questions are as follows.

Administration setup.
Application URL (http://localhost): http://crm.example.com
Organization name (OroCRM): My Organization
Username (admin):
Email: [email protected]
First name: John
Last name: Doe
Password:
Load sample data (y/n): y

Provide the information. Load the sample data to evaluate the product before using it for production.

Warm up the API documentation cache:

sudo php app/console oro:api:doc:cache:clear

Configuring Nginx, Firewall and Permissions

Creeu un fitxer de bloqueig del servidor Nginx per servir l'aplicació als usuaris.

sudo nano /etc/nginx/conf.d/orocrm.conf

Omple el fitxer.

server {
    server_name crm.example.com;
    root  /usr/share/nginx/orocrm/web;

    location / {
        # try to serve file directly, fallback to app.php
        try_files $uri /app.php$is_args$args;
    }

    location ~ ^/(app|app_dev|config|install)\.php(/|$) {
        fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock;
        fastcgi_split_path_info ^(.+\.php)(/.*)$;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param HTTPS off;
    }

    # Enable Gzip compression
    gzip on;
    gzip_buffers 16 8k;
    gzip_comp_level 5;
    gzip_disable "msie6";
    gzip_min_length 1000;
    gzip_http_version 1.0;
    gzip_proxied any;
    gzip_types text/plain application/javascript application/x-javascript text/javascript text/xml text/css image/svg+xml;
    gzip_vary on;    

    # Enable browser caching
    # One week for javascript and css
     location ~* \.(?:css|js) {
       expires 1w;
       access_log off;
       add_header Cache-Control public;
     }

     # Three weeks for media: images, fonts, icons, video, audio etc.
     location ~* \.(?:jpg|jpeg|gif|png|ico|tiff|woff|eot|ttf|svg|svgz|mp4|ogg|ogv|webm|swf|flv)$ {
       expires 3w;
       access_log off;
       add_header Cache-Control public;
     }

    error_log /var/log/nginx/orocrm_error.log;
    access_log /var/log/nginx/orocrm_access.log;
}

Assegureu-vos que canvieu crm.example.comamb el vostre nom de domini real. La configuració anterior també inclou la configuració necessària per a la compressió GZip i la memòria cau del navegador. La compressió Gzip comprimeix les dades abans d'enviar-les al navegador. L'activació de la memòria cau del navegador emmagatzema els recursos estàtics a la memòria cau web de l'ordinador client. La propera vegada que l'usuari accedeixi al lloc, la major part del contingut estàtic es carrega des de la memòria cau web de l'usuari. Aquests dos mètodes augmenten la velocitat de l'aplicació de manera espectacular.

Comproveu si hi ha errors al fitxer de configuració de Nginx.

sudo nginx -t

La sortida hauria de semblar a la següent.

[user@vultr ~]$ sudo nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

Proporcioneu la propietat dels fitxers OrOCRM a l'usuari de Nginx.

sudo chown -R nginx:nginx /usr/share/nginx/orocrm

Reinicieu Nginx per aplicar la nova configuració.

sudo systemctl restart nginx

Si esteu executant un tallafoc al vostre servidor, haureu de configurar el tallafoc per establir una excepció per al servei HTTP. Permet que Nginx es connecti des de fora de la xarxa.

sudo firewall-cmd --zone=public --permanent --add-service=http
sudo firewall-cmd --zone=public --permanent --add-service=https
sudo firewall-cmd --reload

Ara podeu accedir a l'aplicació a http://crm.example.com. Inicieu sessió amb el nom d'usuari i la contrasenya de l'administrador que heu establert durant la instal·lació.

Configura les tasques programades i les tasques de fons

Per executar automàticament les tasques programades, podeu afegir una entrada de treball Cron. Obert crontab.

sudo crontab -e

Afegiu la línia següent al fitxer.

*/1 * * * * /usr/bin/php /usr/share/nginx/orocrm/app/console oro:cron --env=prod > /dev/null

Això executarà el treball cron cada minut perquè les tasques programades, com ara les cues de correu electrònic, es processin el més aviat possible.

També haureu de configurar Supervisor per executar el servei de cua de missatges. És necessari que almenys un procés estigui en execució en tot moment perquè un consumidor processi els missatges. Normalment, un consumidor pot interrompre el procés del missatge de moltes maneres. Per garantir que el servei funcioni de manera continuada, utilitzarem el servei de Supervisor. Configurarem Supervisor perquè executi quatre processos en paral·lel. Si algun dels quatre processos s'atura per qualsevol motiu, el Supervisor intentarà tornar-lo a iniciar.

Instal·leu Supervisor.

sudo yum -y install supervisor

Editeu el fitxer de configuració del supervisor.

sudo nano /etc/supervisord.conf

Afegiu les línies següents al final del fitxer.

[program:oro_message_consumer]
command=/usr/bin/php /usr/share/nginx/orocrm/app/console --env=prod --no-debug oro:message-queue:consume
process_name=%(program_name)s_%(process_num)02d
numprocs=4
autostart=true
autorestart=true
startsecs=0
user=nginx
redirect_stderr=true

Inicieu i habiliteu el Supervisor perquè s'iniciï automàticament en el moment de l'arrencada.

sudo systemctl start supervisord
sudo systemctl enable supervisord

Podeu veure l'estat dels processos executant el següent.

sudo supervisorctl status

Hauríeu de veure que els processos s'estan executant.

[user@vultr ~]$ sudo supervisorctl status
oro_message_consumer:oro_message_consumer_00   RUNNING   pid 13596, uptime 0:02:13
oro_message_consumer:oro_message_consumer_01   RUNNING   pid 13595, uptime 0:02:13
oro_message_consumer:oro_message_consumer_02   RUNNING   pid 13594, uptime 0:02:13
oro_message_consumer:oro_message_consumer_03   RUNNING   pid 13593, uptime 0:02:13

Ara OroCRM està instal·lat al vostre servidor. Ara podeu utilitzar l'aplicació per gestionar les tasques rutinàries de la vostra organització. Per obtenir més informació sobre OroCRM, podeu visitar el seu lloc web oficial .