Як встановити OroCRM на Ubuntu 16.04

OroCRM — це безкоштовна програма з відкритим кодом Customer Relationship Manager (CRM), створена на OroPlatform. OroPlatform — це повністю настроюване програмне забезпечення платформи бізнес-додатків з відкритим вихідним кодом. OroPlatform надає вам усі функції, необхідні для створення спеціальної програми. OroCRM побудовано з використанням PHP Symfony фреймворку і зберігає сво�� дані на сервері баз даних MySQL/MariaDB. Це CRM-додаток, готовий до підприємства, який надає безліч функцій. Він також інтегрується з багатьма сторонніми програмами, такими як Magento Store, MailChimp, Zendesk та багатьма іншими. Він багатомовний і має повністю чутливий користувальницький інтерфейс, що надає вам можливість керувати ним також за допомогою мобільних пристроїв.

Передумови

• Примірник сервера Vultr Ubuntu 16.04.
• некорневий користувач sudo .

У цьому підручнику ми будемо використовувати crm.example.comяк доменне ім’я, яке вказує на сервер. Замініть усі входження на crm.example.comваше фактичне доменне ім’я.

Оновіть свою базову систему за допомогою посібника Як оновити Ubuntu 16.04 . Після оновлення системи перейдіть до встановлення необхідних залежностей.

Встановіть Nginx і PHP 7

OroCRM можна встановити на будь-якому робочому веб-сервері, який підтримує PHP. OroCRM підтримує всі версії PHP вище 7.0. У цьому підручнику ми будемо використовувати Nginx з PHP-FPM і PHP 7.1.

Встановіть Nginx.

sudo apt -y install nginx

Запустіть Nginx і ввімкніть його автоматичний запуск під час завантаження.

sudo systemctl start nginx
sudo systemctl enable nginx

PHP 7.1 недоступний у aptсховищі за замовчуванням . Спочатку додайте репозиторій PPA для PHP.

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

Встановіть PHP 7.1 разом із модулями PHP, необхідними для 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

Відредагуйте завантажений файл конфігурації PHP.

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

Знайдіть наступні рядки. Розкоментуйте та внесіть зміни, як показано.

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

cgi.fix_pathinfo=0

Запустіть PHP-FPM і ввімкніть його запуск під час завантаження.

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

Встановіть MariaDB

MariaDB — це форк MySQL з відкритим кодом. Додайте репозиторій 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'

Встановіть MariaDB.

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

Запустіть MariaDB і ввімкніть її автоматичний запуск під час завантаження.

sudo systemctl start mariadb
sudo systemctl enable mariadb

Створіть базу даних для OroCRM

Увійдіть до оболонки MySQL як користувач root, запустивши.

mysql -u root -p

Надайте пароль для користувача root MariaDB для входу.

Виконайте такі запити, щоб створити базу даних і користувача бази даних для встановлення 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;

Ви можете замінити ім’я бази даних oro_dataта ім’я користувача oro_userна свій вибір. Обов’язково змініть StrongPasswordпароль на дуже надійний.

Встановіть Node.js і Composer

OroCRM також вимагає середовища виконання Node.js JavaScript. Node.js буде використовуватися OroCRM для компіляції JavaScript, який використовується для побудови інтерфейсу користувача програми. Репозиторій Ubuntu за замовчуванням містить застарілу версію Node.js, тому вам потрібно буде додати репозиторій Nodesource у вашу систему, щоб отримати останню версію.

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

Встановіть Node.js і Git.

sudo apt -y install nodejs git

Git буде використовуватися для клонування сховища OroCRM з Інтернету. Вам також потрібно буде встановити Composer. Composer — це інструмент керування залежностями для PHP-додатків. Оскільки OroCRM написаний на фреймворку Symfony, вам знадобиться Composer для встановлення залежностей і програми.

Встановіть Composer.

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

Перемістіть Composer до /usr/binкаталогу, щоб його можна було запустити з будь-якої точки системи.

sudo mv composer.phar /usr/bin/composer

Надати дозвіл на виконання Композитору.

sudo chmod +x /usr/bin/composer

Встановіть OroCRM

Існує багато способів завантажити OroCRM на свій сервер. Найкращий спосіб отримати найоновленішу версію – клонувати репозиторій через Git.

Клонуйте репозиторій OroCRM.

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

Скопіюйте parametersфайл прикладу до файлу за замовчуванням, parametersякий використовується OroCRM.

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

Перш ніж ви зможете продовжити, вам потрібно буде оновити parameters.ymlфайл, щоб надати інформацію про базу даних та електронну пошту.

sudo nano app/config/parameters.yml

Знайдіть наступні рядки.

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

Оновіть наведену вище конфігурацію відповідно до створеної вами бази даних для зберігання даних OroCRM. У нашому випадку це має виглядати так.

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

Якщо у вас є готовий SMTP-сервер і ви хочете негайно використовувати функції надсилання електронної пошти, ви можете оновити параметри розсилки, як показано на малюнку.

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

Якщо у вас немає готового поштового сервера, ви можете пропустити його, залишивши наявні значення. Ви завжди можете змінити конфігурацію електронної пошти через інформаційну панель.

Set a random string in secret by replacing ThisTokenIsNotSoSecretChangeIt. A random string is required to encode the session data. An example string will look like this.

secret:            uxvpXHhDxCFc9yU1hV1fMwjSoyVUzGh4WBMBBBa3XEgrRUF5OuB2h8iNl9JRDqcd

You can generate a random string using the pwgen utility. Install pwgen by running sudo apt -y install pwgen. To generate a random string, run pwgen -s 64 1.

Save the file and exit from the editor. Install the required PHP dependencies through composer.

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

Using --no-dev will ensure that 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 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;
}

Переконайтеся, що ви змінили crm.example.comім’я домену на фактичне ім’я домену. Наведена вище конфігурація також включає конфігурацію, необхідну для стиснення GZip і кешування браузера. Стиснення Gzip стискає дані перед відправленням у браузер. Увімкнення кешування браузера зберігає статичні ресурси у веб-кеші клієнтського комп’ютера. Наступного разу, коли користувач отримує доступ до сайту, більшість статичного вмісту завантажується з власного веб-кешу користувача. Ці два способи значно збільшують швидкість програми.

Увімкніть сайт.

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

Перевірте файл конфігурації Nginx на наявність помилок.

sudo nginx -t

Висновок має виглядати наступним чином.

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

Надайте право власності на файли OroCRM користувачеві Nginx.

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

Перезапустіть Nginx, щоб застосувати нову конфігурацію.

sudo systemctl restart nginx

Тепер ви можете отримати доступ до програми за адресою http://crm.example.com. Ввійти з допомогою адміністратора usernameі passwordви під час установки.

Налаштуйте заплановані завдання та фонові завдання

Щоб автоматично запускати заплановані завдання, ви можете додати запис завдання Cron. Відкрити crontab.

sudo crontab -e

Додайте наступний рядок до файлу.

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

Це запускатиме завдання cron щохвилини, щоб заплановані завдання, такі як черги електронної пошти, оброблялися якомога раніше.

Вам також потрібно буде налаштувати Supervisor для запуску служби черги повідомлень. Щоб споживач міг обробити повідомлення, потрібно, щоб принаймні один процес завжди виконувався. Споживач зазвичай може переривати процес повідомлення багатьма способами. Щоб забезпечити безперервну роботу служби, ми будемо використовувати службу Supervisor. Ми налаштуємо Supervisor на запуск чотирьох процесів паралельно. Якщо будь-який із чотирьох процесів зупинено з будь-якої причини, Supervisor спробує запустити його знову.

Встановити Supervisor.

sudo apt -y install supervisor

Створіть новий конфігураційний файл Supervisor.

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

Додайте наступні рядки до файлу.

[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

Запустіть і ввімкніть Supervisor для автоматичного запуску під час завантаження.

sudo systemctl restart supervisor
sudo systemctl enable supervisor

Ви можете переглянути стан процесів, виконавши наступне.

sudo supervisorctl status

Ви повинні побачити, що процеси запущені.

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 встановлено на вашому сервері. Тепер ви можете використовувати програму для керування рутинними завданнями вашої організації. Щоб дізнатися більше про OroCRM, ви можете відвідати його офіційний веб-сайт .