Sådan installeres OroCRM på Ubuntu 16.04

OroCRM er en gratis og open source Customer Relationship Manager (CRM) applikation bygget på OroPlatform. OroPlatform er fuldt tilpasselig open source-software til forretningsapplikationsplatforme. OroPlatform giver dig alle de funktioner, der kræves for at skabe en tilpasset applikation. OroCRM er bygget ved hjælp af PHP Symfony framework og gemmer sine data i MySQL/MariaDB databaseserveren. Det er en virksomhedsklar CRM-applikation, der tilbyder tonsvis af funktioner. Det integreres også med mange tredjepartsapplikationer såsom Magento Store, MailChimp, Zendesk og mange flere. Den er flersproget og har en fuldt responsiv brugergrænseflade, som giver dig mulighed for at administrere den også ved hjælp af mobile enheder.

Forudsætninger

• En Vultr Ubuntu 16.04-serverinstans.
• ikke-root sudo-bruger .

I denne vejledning vil vi bruge crm.example.comsom domænenavnet pegede på serveren. Erstat alle forekomster af crm.example.commed dit faktiske domænenavn.

Opdater dit basissystem ved hjælp af vejledningen Sådan opdaterer du Ubuntu 16.04 . Når dit system er blevet opdateret, skal du fortsætte med at installere de nødvendige afhængigheder.

Installer Nginx og PHP 7

OroCRM kan installeres på enhver produktionswebserver, der understøtter PHP. OroCRM understøtter alle versioner af PHP større end 7.0. I denne tutorial vil vi bruge Nginx med PHP-FPM og PHP 7.1.

Installer Nginx.

sudo apt -y install nginx

Start Nginx og aktiver den til automatisk at starte ved opstart.

sudo systemctl start nginx
sudo systemctl enable nginx

PHP 7.1 er ikke tilgængelig i standardlageret apt. Tilføj først PPA-depotet til PHP.

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

Installer PHP 7.1 sammen med de PHP-moduler, der kræves af 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

Rediger den indlæste PHP-konfigurationsfil.

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

Find følgende linjer. Fjern kommentarer og foretag ændringer som vist.

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

cgi.fix_pathinfo=0

Start PHP-FPM og aktiver det til at starte ved opstart.

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

Installer MariaDB

MariaDB er en open source fork af MySQL. Tilføj MariaDB 10.2 repository.

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'

Installer MariaDB.

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

Start MariaDB og aktiver den til automatisk at starte ved opstart.

sudo systemctl start mariadb
sudo systemctl enable mariadb

Opret databasen til OroCRM

Log ind på MySQL-skallen som root-brugeren ved at køre.

mysql -u root -p

Angiv adgangskoden til MariaDB root-brugeren for at logge ind.

Kør følgende forespørgsler for at oprette en database og en databasebruger til 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 erstatte databasenavnet oro_dataog brugernavnet oro_userefter dit valg. Sørg for at skifte StrongPasswordtil en meget stærk adgangskode.

Installer Node.js og Composer

OroCRM kræver også Node.js JavaScript runtime. Node.js vil blive brugt af OroCRM til at kompilere JavaScript, som bruges til at bygge applikationens brugergrænseflade. Standardlageret for Ubuntu indeholder en forældet version af Node.js, så du bliver nødt til at tilføje Nodesource-lageret til dit system for at få den seneste version.

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

Installer Node.js og Git.

sudo apt -y install nodejs git

Git vil blive brugt til at klone OroCRM-lageret fra internettet. Du skal også installere Composer. Composer er et afhængighedshåndteringsværktøj til PHP-applikationer. Fordi OroCRM er skrevet i Symfony framework, skal du bruge Composer til at installere afhængighederne og applikationen.

Installer Composer.

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

Flyt Composer til /usr/binbiblioteket, så det kan udføres fra hvor som helst i systemet.

sudo mv composer.phar /usr/bin/composer

Giv udførelsestilladelse til komponisten.

sudo chmod +x /usr/bin/composer

Installer OroCRM

Der er mange måder at downloade OroCRM på din server. Den mest passende måde at få den mest opdaterede version på er at klone depotet gennem Git.

Klon OroCRM-lageret.

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

Kopier eksempelfilen parameterstil standardfilen parameters, der bruges af OroCRM.

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

Før du kan gå videre, skal du opdatere parameters.ymlfilen for at give database- og e-mail-oplysninger.

sudo nano app/config/parameters.yml

Find følgende linjer.

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

Opdater ovenstående konfiguration i henhold til den database, du har oprettet for at gemme OroCRM-data. I vores tilfælde skal det se sådan ud.

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

Hvis du har en SMTP-server klar, og du ønsker at bruge funktionerne til afsendelse af e-mail med det samme, kan du opdatere mailer-indstillingerne som vist.

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

Hvis du ikke har en mailserver klar, kan du springe den over indtil videre ved at forlade de eksisterende værdier. Du kan altid ændre e-mail-konfiguration via dashboardet.

Indstil en tilfældig streng secretved at erstatte ThisTokenIsNotSoSecretChangeIt. En tilfældig streng er påkrævet for at kode sessionsdataene. En eksempelstreng vil se sådan ud.

secret:            uxvpXHhDxCFc9yU1hV1fMwjSoyVUzGh4WBMBBBa3XEgrRUF5OuB2h8iNl9JRDqcd

Du kan generere en tilfældig streng ved hjælp af pwgenhjælpeprogrammet. Installer pwgenved at køre sudo apt -y install pwgen. Kør for at generere en tilfældig streng pwgen -s 64 1.

Gem filen og afslut editoren. Installer de nødvendige PHP-afhængigheder gennem composer.

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

Brug --no-devvil sikre, at Composer kun installerer de afhængigheder, der kræves for at køre webserveren i produktionstilstand. Scriptet vil tage et par minutter at downloade og installere de nødvendige PHP-afhængigheder.

Installer applikationen.

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

Dette vil bygge webcachen og skrive databasen. Den --env=prodparameter er forudsat at installere programmet i produktion tilstand. Installationen fortsætter kun, hvis alle de nødvendige afhængigheder er installeret og konfigureret.

Under installationen vil du blive stillet et par spørgsmål til opsætning af administratorkontoen. Spørgsmålene er som følger.

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

Giv oplysningerne. Indlæs prøvedataene for at evaluere produktet, før det bruges til produktion.

Varm API-dokumentationscachen op:

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

Konfiguration af Nginx, Firewall og tilladelser

Opret en Nginx-serverblokfil for at servere applikationen til brugerne.

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

Udfyld 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;
}

Sørg for at ændre crm.example.comtil dit faktiske domænenavn. Ovenstående konfiguration inkluderer også den konfiguration, der kræves til GZip-komprimering og browsercache. Gzip-komprimering komprimerer dataene, før de sendes til browseren. Aktivering af browsercaching gemmer de statiske ressourcer i webcachen på klientcomputeren. Næste gang brugeren tilgår webstedet, indlæses det meste af det statiske indhold fra brugerens egen webcache. Disse to metoder øger hastigheden af ​​applikationen dramatisk.

Aktiver webstedet.

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

Tjek Nginx-konfigurationsfilen for eventuelle fejl.

sudo nginx -t

Outputtet skal se ud som følgende.

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

Giv ejerskabet af OroCRM-filerne til Nginx-brugeren.

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

Genstart Nginx for at anvende den nye konfiguration.

sudo systemctl restart nginx

Du kan nu få adgang til applikationen på http://crm.example.com. Log ind med administratoren, usernameog passworddu har indstillet under installationen.

Konfigurer planlagte opgaver og baggrundsjob

For automatisk at køre de planlagte opgaver kan du tilføje en Cron-jobpost. Åben crontab.

sudo crontab -e

Tilføj følgende linje til filen.

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

Dette vil køre cron-jobbet hvert minut, så de planlagte opgaver, såsom e-mail-køer, behandles tidligst.

Du skal også konfigurere Supervisor til at køre Message Queue-tjenesten. Det kræves, at der til enhver tid kører mindst én proces, for at en forbruger kan behandle beskederne. En forbruger kan normalt afbryde meddelelsesprocessen på mange måder. For at sikre, at tjenesten kører kontinuerligt, vil vi bruge Supervisor-tjenesten. Vi vil konfigurere Supervisor til at køre fire processer parallelt. Hvis en af ​​de fire processer stoppes af en eller anden grund, vil Supervisor forsøge at starte den igen.

Installer Supervisor.

sudo apt -y install supervisor

Opret en ny Supervisor-konfigurationsfil.

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

Tilføj følgende linjer til 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

Start og aktiver Supervisor til automatisk at starte ved opstart.

sudo systemctl restart supervisor
sudo systemctl enable supervisor

Du kan se status for processerne ved at køre følgende.

sudo supervisorctl status

Du skal se, at processerne kører.

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 er nu installeret på din server. Du kan nu bruge applikationen til at administrere din organisations rutineopgaver. For at lære mere om OroCRM, kan du besøge dets officielle hjemmeside .