Jak nainstalovat OroCRM na Ubuntu 16.04

OroCRM je bezplatná a open source aplikace Customer Relationship Manager (CRM) postavená na OroPlatform. OroPlatform je plně přizpůsobitelný software platformy podnikových aplikací s otevřeným zdrojovým kódem. OroPlatform vám poskytuje všechny funkce, které jsou nutné k vytvoření přizpůsobené aplikace. OroCRM je postaven pomocí PHP Symfony framework a ukládá svá data do databázového serveru MySQL/MariaDB. Je to podniková CRM aplikace, která poskytuje spoustu funkcí. Integruje se také s mnoha aplikacemi třetích stran, jako je Magento Store, MailChimp, Zendesk a mnoho dalších. Je vícejazyčný a má plně citlivé uživatelské rozhraní, které vám poskytuje možnost spravovat jej také pomocí mobilních zařízení.

Předpoklady

• Instance serveru Vultr Ubuntu 16.04.
• uživatel sudo bez oprávnění root .

V tomto tutoriálu použijeme crm.example.comjako název domény odkazující na server. Nahraďte všechny výskyty crm.example.comvaším skutečným názvem domény.

Aktualizujte svůj základní systém pomocí průvodce Jak aktualizovat Ubuntu 16.04 . Jakmile bude váš systém aktualizován, pokračujte v instalaci požadovaných závislostí.

Nainstalujte Nginx a PHP 7

OroCRM lze nainstalovat na jakýkoli produkční webový server podporující PHP. OroCRM podporuje všechny verze PHP vyšší než 7.0. V tomto tutoriálu budeme používat Nginx s PHP-FPM a PHP 7.1.

Nainstalujte Nginx.

sudo apt -y install nginx

Spusťte Nginx a povolte mu automatické spouštění při startu.

sudo systemctl start nginx
sudo systemctl enable nginx

PHP 7.1 není k dispozici ve výchozím aptúložišti. Nejprve přidejte úložiště PPA pro PHP.

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

Nainstalujte PHP 7.1 spolu s PHP moduly vyžadovanými 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

Upravte načtený konfigurační soubor PHP.

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

Najděte následující řádky. Odkomentujte a proveďte změny podle obrázku.

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

cgi.fix_pathinfo=0

Spusťte PHP-FPM a povolte jeho spuštění při startu.

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

Nainstalujte MariaDB

MariaDB je open source fork MySQL. Přidejte úložiště MariaDB 10.2.

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'

Nainstalujte MariaDB.

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

Spusťte MariaDB a povolte automatické spouštění při startu.

sudo systemctl start mariadb
sudo systemctl enable mariadb

Vytvořte databázi pro OroCRM

Spuštěním se přihlaste do prostředí MySQL jako uživatel root.

mysql -u root -p

Zadejte heslo pro přihlášení uživatele root MariaDB.

Spuštěním následujících dotazů vytvořte databázi a uživatele databáze pro instalaci 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;

Název databáze oro_dataa uživatelské jméno můžete nahradit oro_userpodle svého výběru. Nezapomeňte změnit StrongPasswordheslo na velmi silné.

Nainstalujte Node.js a Composer

OroCRM také vyžaduje Node.js JavaScript runtime. Node.js bude OroCRM používat ke kompilaci JavaScriptu, který se používá k sestavení uživatelského rozhraní aplikace. Výchozí úložiště Ubuntu obsahuje zastaralou verzi Node.js, takže budete muset do systému přidat úložiště Nodesource, abyste získali nejnovější verzi.

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

Nainstalujte Node.js a Git.

sudo apt -y install nodejs git

Git bude použit ke klonování úložiště OroCRM z internetu. Budete také muset nainstalovat Composer. Composer je nástroj pro správu závislostí pro aplikace PHP. Protože je OroCRM napsáno v rámci Symfony, budete k instalaci závislostí a aplikace potřebovat Composer.

Nainstalujte Composer.

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

Přesuňte Composer do /usr/binadresáře, aby jej bylo možné spustit odkudkoli v systému.

sudo mv composer.phar /usr/bin/composer

Poskytněte skladateli povolení k provedení.

sudo chmod +x /usr/bin/composer

Nainstalujte OroCRM

Existuje mnoho způsobů, jak stáhnout OroCRM na váš server. Nejvhodnějším způsobem, jak získat nejaktuálnější verzi, je naklonovat úložiště přes Git.

Klonujte úložiště OroCRM.

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

Zkopírujte ukázkový parameterssoubor do výchozího parameterssouboru používaného OroCRM.

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

Než budete moci pokračovat, budete muset parameters.ymlsoubor aktualizovat, aby poskytoval informace o databázi a e-mailu.

sudo nano app/config/parameters.yml

Najděte následující řádky.

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

Aktualizujte výše uvedenou konfiguraci podle databáze, kterou jste vytvořili pro ukládání dat OroCRM. V našem případě by to mělo vypadat takto.

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

Pokud máte připravený server SMTP a chcete okamžitě používat funkce odesílání e-mailů, můžete aktualizovat nastavení poštovního serveru, jak je uvedeno na obrázku.

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

Pokud poštovní server nemáte připravený, můžete jej prozatím přeskočit a ponechat stávající hodnoty. Konfiguraci e-mailu můžete kdykoli změnit prostřednictvím řídicího panelu.

Nastavte náhodný řetězec secretnahrazením ThisTokenIsNotSoSecretChangeIt. Ke kódování dat relace je vyžadován náhodný řetězec. Příklad řetězce bude vypadat takto.

secret:            uxvpXHhDxCFc9yU1hV1fMwjSoyVUzGh4WBMBBBa3XEgrRUF5OuB2h8iNl9JRDqcd

Pomocí pwgennástroje můžete vygenerovat náhodný řetězec . Nainstalujte pwgenspuštěním sudo apt -y install pwgen. Chcete-li vygenerovat náhodný řetězec, spusťte pwgen -s 64 1.

Uložte soubor a ukončete editor. Nainstalujte požadované závislosti PHP prostřednictvím skladatele.

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

Použití --no-devzajistí, že Composer nainstaluje pouze závislosti potřebné ke spuštění webového serveru v produkčním režimu. Skript zabere několik minut, než si stáhne a nainstaluje požadované závislosti PHP.

Nainstalujte aplikaci.

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 a 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 Org
Username (admin): 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

Create an Nginx server block file to serve the application to the users.

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

Populate the file.

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

Ujistěte se, že jste změnili crm.example.comna svůj skutečný název domény. Výše uvedená konfigurace také zahrnuje konfiguraci požadovanou pro kompresi GZip a ukládání do mezipaměti prohlížeče. Komprese Gzip komprimuje data před jejich odesláním do prohlížeče. Povolení ukládání do mezipaměti prohlížeče ukládá statické prostředky do webové mezipaměti klientského počítače. Při příštím přístupu uživatele na web se většina statického obsahu načte z vlastní webové mezipaměti uživatele. Tyto dvě metody dramaticky zvyšují rychlost aplikace.

Povolit web.

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

Zkontrolujte konfigurační soubor Nginx, zda neobsahuje nějaké chyby.

sudo nginx -t

Výstup by měl vypadat následovně.

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

Poskytněte uživateli Nginx vlastnictví souborů OroCRM.

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

Chcete-li použít novou konfiguraci, restartujte Nginx.

sudo systemctl restart nginx

Nyní máte přístup k aplikaci na adrese http://crm.example.com. Přihlaste se pomocí správce usernamea passwordmáte nastaveno při instalaci.

Nastavení naplánovaných úloh a úloh na pozadí

Chcete-li automaticky spouštět naplánované úlohy, můžete přidat záznam úlohy Cron. Otevřené crontab.

sudo crontab -e

Přidejte do souboru následující řádek.

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

To spustí úlohu cron každou minutu, takže naplánované úlohy, jako jsou e-mailové fronty, budou zpracovány co nejdříve.

Ke spuštění služby Fronta zpráv budete také muset nastavit správce. Aby spotřebitel mohl zprávy zpracovat, je nutné, aby vždy běžel alespoň jeden proces. Spotřebitel může normálně přerušit proces zpráv mnoha způsoby. Abychom zajistili nepřetržitý provoz služby, využijeme službu Dozor. Nakonfigurujeme správce tak, aby spouštěl čtyři procesy paralelně. Pokud se některý ze čtyř procesů z nějakého důvodu zastaví, supervizor se jej pokusí znovu spustit.

Instalovat správce.

sudo apt -y install supervisor

Vytvořte nový konfigurační soubor správce.

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

Přidejte do souboru následující řádky.

[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

Spusťte a povolte, aby se správce automaticky spustil při spouštění.

sudo systemctl restart supervisor
sudo systemctl enable supervisor

Stav procesů můžete zobrazit spuštěním následujícího.

sudo supervisorctl status

Měli byste vidět, že procesy běží.

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 je nyní nainstalován na vašem serveru. Nyní můžete aplikaci používat ke správě rutinních úkolů vaší organizace. Chcete-li se dozvědět více o OroCRM, můžete navštívit jeho oficiální stránky .