Як встановити OroCRM на CentOS 7

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

Передумови

• Примірник сервера Vultr CentOS 7.
• Користувач sudo .

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

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

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

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

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

sudo yum -y install nginx

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

sudo systemctl start nginx
sudo systemctl enable nginx

PHP 7 недоступний у сховищі YUM за замовчуванням, але ми можемо використовувати репозиторій Remi для отримання та встановлення останніх збірок PHP 7. Спочатку додайте та ввімкніть репозиторій 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

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

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

sudo nano /etc/php.ini

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

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

memory_limit = 512M
cgi.fix_pathinfo=0

Відредагуйте файл конфігурації PHP-FPM.

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

За замовчуванням PHP-FPM налаштований на роботу з Apache і прослуховування порту 9000. Нам потрібно буде змінити користувача і групу, а також файл сокета Unix, на якому він буде працювати. Знайдіть наступні рядки та внесіть необхідні зміни, як показано на малюнку.

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

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

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

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

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

Встановіть MariaDB

MariaDB — це форк MySQL з відкритим кодом. Встановіть MariaDB.

sudo yum -y install mariadb mariadb-server

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

sudo systemctl start mariadb
sudo systemctl enable mariadb

Установка MariaDB за замовчуванням поставляється з кількома тестовими базами даних та анонімними користувачами. Перш ніж налаштувати базу даних, вам потрібно буде спочатку захистити сервер MariaDB. Ви можете захистити його, запустивши mysql_secure_installationскрипт.

sudo mysql_secure_installation

Вас попросять ввести поточний пароль root MariaDB. За замовчуванням у новій інсталяції MariaDB немає пароля root. Натисніть Enterклавішу, щоб продовжити. Встановіть надійний пароль для користувача root вашого сервера MariaDB і дайте відповідь Yна всі інші запитання. Запитання, що задаються, зрозумілі самі собою.

Створіть базу даних для 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, який використовується для побудови інтерфейсу користувача програми. Репозиторій CentOS за замовчуванням містить застарілу версію Node.js, тому вам потрібно буде додати репозиторій Nodesource у вашу систему, щоб отримати останню версію.

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

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

sudo yum -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
php -r "unlink('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.3 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

If you have an SMTP server ready and you wish to use email sending features immediately, you can update the mailer settings as shown.

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

If you do not have a mail server ready, you can skip it for now by leaving the existing values. You can always change email configuration through the dashboard.

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 utility by running sudo yum -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 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

Створіть файл блоку сервера Nginx для обслуговування програми користувачам.

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

Заповніть файл.

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

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

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

sudo nginx -t

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

[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

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

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

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

sudo systemctl restart nginx

Якщо ви використовуєте брандмауер на своєму сервері, вам потрібно буде налаштувати брандмауер, щоб встановити виняток для служби HTTP. Дозволити Nginx підключатися поза мережею.

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

Тепер ви можете отримати доступ до програми за адресою http://crm.example.com. Увійдіть, використовуючи ім’я користувача та пароль адміністратора, які ви встановили під час інсталяції.

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

Щоб автоматично запускати заплановані завдання, ви можете додати запис завдання 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.

sudo yum -y install supervisor

Відредагуйте файл конфігурації Supervisor.

sudo nano /etc/supervisord.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=nginx
redirect_stderr=true

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

sudo systemctl start supervisord
sudo systemctl enable supervisord

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

sudo supervisorctl status

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

[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

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