Hur man installerar OroCRM på Ubuntu 16.04

OroCRM är en gratis och öppen källkod för Customer Relationship Manager (CRM)-applikation byggd på OroPlatform. OroPlatform är helt anpassningsbar programvara med öppen källkod för affärsapplikationsplattformar. OroPlatform ger dig alla funktioner som krävs för att skapa en skräddarsydd applikation. OroCRM är byggt med PHP Symfony-ramverket och lagrar dess data i MySQL/MariaDB-databasservern. Det är en företagsklar CRM-applikation som erbjuder massor av funktioner. Den integreras också med många tredjepartsapplikationer som Magento Store, MailChimp, Zendesk och många fler. Det är flerspråkigt och har ett fullt responsivt användargränssnitt, som ger dig möjlighet att hantera det även med mobila enheter.

Förutsättningar

• En Vultr Ubuntu 16.04-serverinstans.
• icke-root sudo-användare .

I den här handledningen kommer vi att använda crm.example.comsom domännamnet pekade på servern. Ersätt alla förekomster av crm.example.commed ditt faktiska domännamn.

Uppdatera ditt bassystem med hjälp av guiden Hur man uppdaterar Ubuntu 16.04 . När ditt system har uppdaterats fortsätter du med att installera de nödvändiga beroenden.

Installera Nginx och PHP 7

OroCRM kan installeras på vilken produktionswebbserver som helst som stöder PHP. OroCRM stöder alla versioner av PHP högre än 7.0. I den här handledningen kommer vi att använda Nginx med PHP-FPM och PHP 7.1.

Installera Nginx.

sudo apt -y install nginx

Starta Nginx och låt den starta automatiskt vid uppstart.

sudo systemctl start nginx
sudo systemctl enable nginx

PHP 7.1 är inte tillgängligt i standardförvaret apt. Lägg först till PPA-förvaret för PHP.

sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php

Installera PHP 7.1 tillsammans med PHP-modulerna som krävs av OroCRM.

sudo apt update
sudo apt -y install php7.1 php7.1-fpm php7.1-common php7.1-curl php7.1-gd php7.1-intl php7.1-json php7.1-mbstring php7.1-mcrypt php7.1-mysql php7.1-xml php7.1-xml php7.1-zip php7.1-tidy php7.1-soap php7.1-opcache

Redigera den laddade PHP-konfigurationsfilen.

sudo nano /etc/php/7.1/cli/php.ini

Hitta följande rader. Avkommentera och gör ändringar som visas.

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

cgi.fix_pathinfo=0

Starta PHP-FPM och låt den starta vid uppstart.

sudo systemctl start php7.1-fpm
sudo systemctl enable php7.1-fpm

Installera MariaDB

MariaDB är en öppen källkodsgaffel av MySQL. Lägg till MariaDB 10.2-förrådet.

sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0xF1656F24C74CD1D8
sudo add-apt-repository 'deb [arch=amd64,i386,ppc64el] http://kartolo.sby.datautama.net.id/mariadb/repo/10.2/ubuntu xenial main'

Installera MariaDB.

sudo apt -y update
sudo apt -y install mariadb-server

Starta MariaDB och låt den starta automatiskt vid uppstart.

sudo systemctl start mariadb
sudo systemctl enable mariadb

Skapa databasen för OroCRM

Logga in på MySQL-skalet som rotanvändare genom att köra.

mysql -u root -p

Ange lösenordet för MariaDB root-användaren att logga in.

Kör följande frågor för att skapa en databas och en databasanvändare för OroCRM-installation.

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;

Du kan ersätta databasnamnet oro_dataoch användarnamnet oro_userenligt ditt val. Se till att byta StrongPasswordtill ett mycket starkt lösenord.

Installera Node.js och Composer

OroCRM kräver också Node.js JavaScript-runtime. Node.js kommer att användas av OroCRM för att kompilera JavaScript, som används för att bygga applikationens användargränssnitt. Standardförvaret för Ubuntu innehåller en föråldrad version av Node.js, så du måste lägga till Nodesource-förrådet till ditt system för att få den senaste versionen.

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

Installera Node.js och Git.

sudo apt -y install nodejs git

Git kommer att användas för att klona OroCRM-förvaret från internet. Du måste också installera Composer. Composer är ett beroendehanterarverktyg för PHP-applikationer. Eftersom OroCRM är skrivet i Symfony-ramverket behöver du Composer för att installera beroenden och applikationen.

Installera Composer.

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

Flytta Composer till /usr/binkatalogen så att den kan köras var som helst i systemet.

sudo mv composer.phar /usr/bin/composer

Ge exekveringstillstånd till kompositören.

sudo chmod +x /usr/bin/composer

Installera OroCRM

Det finns många sätt att ladda ner OroCRM på din server. Det lämpligaste sättet att få den mest uppdaterade versionen är att klona förvaret genom Git.

Klona OroCRM-förvaret.

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

Kopiera parametersexempelfilen till standardfilen som parametersanvänds av OroCRM.

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

Innan du kan gå vidare måste du uppdatera parameters.ymlfilen för att tillhandahålla databas- och e-postinformation.

sudo nano app/config/parameters.yml

Hitta följande rader.

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

Uppdatera ovanstående konfiguration enligt databasen du har skapat för att lagra OroCRM-data. I vårt fall ska det se ut så här.

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

Om du har en SMTP-server redo och du vill använda funktionerna för sändning av e-post omedelbart, kan du uppdatera e-postinställningarna som visas.

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

Om du inte har en e-postserver redo kan du hoppa över den tills vidare genom att lämna de befintliga värdena. Du kan alltid ändra e-postkonfiguration via instrumentpanelen.

Sätt in en slumpmässig sträng secretgenom att ersätta ThisTokenIsNotSoSecretChangeIt. En slumpmässig sträng krävs för att koda sessionsdata. En exempelsträng kommer att se ut så här.

secret:            uxvpXHhDxCFc9yU1hV1fMwjSoyVUzGh4WBMBBBa3XEgrRUF5OuB2h8iNl9JRDqcd

Du kan skapa en slumpmässig sträng med hjälp av pwgenverktyget. Installera pwgengenom att köra sudo apt -y install pwgen. För att skapa en slumpmässig sträng, kör pwgen -s 64 1.

Spara filen och avsluta redigeraren. Installera nödvändiga PHP-beroenden genom composer.

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

Att använda --no-devkommer att säkerställa att Composer endast installerar de beroenden som krävs för att köra webbservern i produktionsläge. Skriptet kommer att ta några minuter att ladda ner och installera de nödvändiga PHP-beroendena.

Installera programmet.

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

Detta kommer att bygga webbcachen och skriva databasen. Den --env=prodparameter som att installera programmet i produktionsläge. Installationen fortsätter endast om alla nödvändiga beroenden är installerade och konfigurerade.

Under installationen kommer du att få några frågor för att ställa in administratörskontot. Frågorna är följande.

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

Ge informationen. Ladda provdata för att utvärdera produkten innan du använder den för produktion.

Värm upp API-dokumentationscachen:

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

Konfigurera Nginx, brandvägg och behörigheter

Skapa en Nginx-serverblockfil för att servera applikationen till användarna.

sudo nano /etc/nginx/sites-available/orocrm

Fyll i filen.

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:/run/php/php7.1-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;
}

Se till att du ändrar crm.example.comtill ditt faktiska domännamn. Ovanstående konfiguration inkluderar också den konfiguration som krävs för GZip-komprimering och webbläsarcache. Gzip-komprimering komprimerar data innan den skickas till webbläsaren. Aktivering av webbläsarcache lagrar de statiska resurserna i klientdatorns webbcache. Nästa gång användaren går in på webbplatsen laddas det mesta av det statiska innehållet från användarens egen webbcache. Dessa två metoder ökar hastigheten på applikationen dramatiskt.

Aktivera webbplatsen.

sudo ln -s /etc/nginx/sites-available/orocrm /etc/nginx/sites-enabled/orocrm

Kontrollera Nginx-konfigurationsfilen för eventuella fel.

sudo nginx -t

Utgången ska se ut som följande.

user@vultr:/usr/share/nginx/orocrm$ sudo nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

Ge Nginx-användaren äganderätten till OroCRM-filerna.

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

Starta om Nginx för att tillämpa den nya konfigurationen.

sudo systemctl restart nginx

Du kan nu komma åt applikationen på http://crm.example.com. Logga in med administratören usernameoch passworddu har ställt in under installationen.

Konfigurera schemalagda uppgifter och bakgrundsjobb

För att automatiskt köra de schemalagda uppgifterna kan du lägga till en Cron-jobbpost. Öppna crontab.

sudo crontab -e

Lägg till följande rad i filen.

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

Detta kommer att köra cron-jobbet varje minut så att de schemalagda uppgifterna som e-postköer bearbetas tidigast.

Du måste också ställa in Supervisor för att köra tjänsten Message Queue. Det krävs att minst en process körs hela tiden för att en konsument ska kunna behandla meddelandena. En konsument kan normalt avbryta meddelandeprocessen på många sätt. För att säkerställa att tjänsten körs kontinuerligt kommer vi att använda oss av Supervisor-tjänsten. Vi kommer att konfigurera Supervisor att köra fyra processer parallellt. Om någon av de fyra processerna stoppas av någon anledning kommer Supervisor att försöka starta den igen.

Installera Supervisor.

sudo apt -y install supervisor

Skapa en ny Supervisor-konfigurationsfil.

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

Lägg till följande rader i filen.

[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=www-data
redirect_stderr=true

Starta och aktivera Supervisor för att starta automatiskt vid uppstart.

sudo systemctl restart supervisor
sudo systemctl enable supervisor

Du kan se status för processerna genom att köra följande.

sudo supervisorctl status

Du bör se att processerna körs.

user@vultr:/usr/share/nginx/orocrm$ sudo supervisorctl status
oro_message_consumer:oro_message_consumer_00   RUNNING   pid 20809, uptime 0:00:01
oro_message_consumer:oro_message_consumer_01   RUNNING   pid 20808, uptime 0:00:01
oro_message_consumer:oro_message_consumer_02   RUNNING   pid 20807, uptime 0:00:01
oro_message_consumer:oro_message_consumer_03   RUNNING   pid 20806, uptime 0:00:01

OroCRM är nu installerat på din server. Du kan nu använda applikationen för att hantera rutinuppgifterna för din organisation. För att lära dig mer om OroCRM kan du besöka dess officiella webbplats .