Ako nainštalovať OroCRM na CentOS 7

OroCRM je bezplatná a open source aplikácia Customer Relationship Manager (CRM) postavená na platforme OroPlatform. OroPlatform je plne prispôsobiteľný softvér platformy podnikových aplikácií s otvoreným zdrojom. OroPlatform vám poskytuje všetky funkcie, ktoré sú potrebné na vytvorenie prispôsobenej aplikácie. OroCRM je vytvorený pomocou PHP Symfony frameworku a ukladá svoje dáta do databázového servera MySQL/MariaDB. Je to podniková CRM aplikácia, ktorá poskytuje množstvo funkcií. Tiež sa integruje s mnohými aplikáciami tretích strán, ako je Magento Store, MailChimp, Zendesk atď. Je viacjazyčný a má plne citlivé používateľské rozhranie, ktoré vám poskytuje možnosť spravovať ho aj pomocou mobilných zariadení.

Predpoklady

• Inštancia servera Vultr CentOS 7.
• Sudo používateľ .

V tomto návode použijeme crm.example.comnázov domény nasmerovaný na server. Nahraďte všetky výskyty crm.example.comsvojho skutočného názvu domény.

Aktualizujte svoj základný systém pomocou príručky Ako aktualizovať CentOS 7 . Po aktualizácii systému pokračujte v inštalácii požadovaných závislostí.

Nainštalujte Nginx a PHP 7

OroCRM je možné nainštalovať na akýkoľvek produkčný webový server podporujúci PHP. OroCRM podporuje všetky verzie PHP vyššie ako 7.0. V tomto návode budeme používať Nginx s PHP-FPM a PHP 7.1.

Nainštalujte Nginx.

sudo yum -y install nginx

Spustite Nginx a povoľte jej automatické spustenie pri štarte.

sudo systemctl start nginx
sudo systemctl enable nginx

PHP 7 nie je dostupné v predvolenom úložisku YUM, ale môžeme použiť úložisko Remi na získanie a inštaláciu najnovších verzií PHP 7. Najprv pridajte a povoľte úložisko 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

Nainštalujte si najnovšiu verziu PHP 7 spolu s PHP modulmi vyžadovanými 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

Upravte predvolený konfiguračný súbor PHP.

sudo nano /etc/php.ini

Nájdite nasledujúce riadky. Zrušte komentár a vykonajte zmeny podľa obrázka.

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

memory_limit = 512M
cgi.fix_pathinfo=0

Upravte konfiguračný súbor PHP-FPM.

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

Štandardne je PHP-FPM nakonfigurované na spustenie s Apache a na počúvanie portu 9000. Budeme musieť zmeniť používateľa a skupinu, ako aj súbor soketu Unix, na ktorom bude bežať. Nájdite nasledujúce riadky a vykonajte potrebné zmeny, ako je znázornené.

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

Spustite PHP-FPM a povoľte jeho spustenie pri štarte.

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

Poskytnite vlastníctvo súboru soketu PHP-FPM používateľovi Nginx.

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

Nainštalujte MariaDB

MariaDB je open source fork MySQL. Nainštalujte MariaDB.

sudo yum -y install mariadb mariadb-server

Spustite MariaDB a povoľte jej automatické spustenie pri štarte.

sudo systemctl start mariadb
sudo systemctl enable mariadb

Predvolená inštalácia MariaDB prichádza s niekoľkými testovacími databázami a anonymnými používateľmi. Pred konfiguráciou databázy budete musieť najskôr zabezpečiť server MariaDB. Môžete to zabezpečiť spustením mysql_secure_installationskriptu.

sudo mysql_secure_installation

Budete vyzvaní na zadanie aktuálneho root hesla MariaDB. V predvolenom nastavení nie je v novej inštalácii MariaDB žiadne heslo root. EnterPokračujte stlačením klávesu. Nastavte silné heslo pre užívateľa root vášho servera MariaDB a odpovedzte Yna všetky ďalšie otázky. Položené otázky sú samovysvetľujúce.

Vytvorte databázu pre OroCRM

Prihláste sa do shellu MySQL ako užívateľ root spustením.

mysql -u root -p

Zadajte heslo pre používateľa root MariaDB na prihlásenie.

Spustite nasledujúce dotazy na vytvorenie databázy a databázového užívateľa pre inštaláciu 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ázov databázy oro_dataa používateľské meno môžete nahradiť oro_userpodľa vlastného výberu. Nezabudnite zmeniť StrongPasswordheslo na veľmi silné.

Nainštalujte Node.js a Composer

OroCRM tiež vyžaduje runtime JavaScript Node.js. Node.js použije OroCRM na kompiláciu JavaScriptu, ktorý sa používa na zostavenie používateľského rozhrania aplikácie. Predvolené úložisko CentOS obsahuje zastaranú verziu Node.js, takže na získanie najnovšej verzie budete musieť pridať úložisko Nodesource do vášho systému.

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

Nainštalujte Node.js a Git.

sudo yum -y install nodejs git

Git sa použije na klonovanie úložiska OroCRM z internetu. Budete tiež musieť nainštalovať Composer. Composer je nástroj na správu závislostí pre aplikácie PHP. Pretože OroCRM je napísaný v rámci Symfony, na inštaláciu závislostí a aplikácie budete potrebovať Composer.

Nainštalujte Composer.

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

Move Composer to the /usr/bin directory so that it can be executed from anywhere in the system.

sudo mv composer.phar /usr/bin/composer

Provide execution permission to the Composer.

sudo chmod +x /usr/bin/composer

Install OroCRM

There are many ways to download OroCRM on your server. The most appropriate way to get the most updated version is to clone the repository through Git.

Clone the OroCRM repository.

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

Copy the example parameters file to the default parameters file used by OroCRM.

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

Before you can proceed further, you will need to update the parameters.yml file to provide database and email information.

sudo nano app/config/parameters.yml

Find the following lines.

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

Update the above configuration according to the database you have created to store OroCRM data. In our case, it should look like this.

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

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

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

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

Make sure that you change the crm.example.com with your actual domain name. The above configuration also includes the configuration required for GZip compression and browser caching. Gzip compression compresses the data before sending it to the browser. Enabling browser caching stores the static resources to the web cache of the client computer. The next time the user accesses the site, most of the static content is loaded from the user's own web cache. These two methods increase the speed of the application dramatically.

Check the Nginx configuration file for any errors.

sudo nginx -t

The output should look like the following.

[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

Provide the ownership of the OrOCRM files to the Nginx user.

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

Restart Nginx to apply the new configuration.

sudo systemctl restart nginx

Ak na svojom serveri používate bránu firewall, budete ju musieť nakonfigurovať tak, aby nastavila výnimku pre službu HTTP. Umožnite Nginxu pripojiť sa mimo siete.

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

Teraz máte prístup k aplikácii na adrese http://crm.example.com. Prihláste sa pomocou používateľského mena a hesla správcu, ktoré ste nastavili počas inštalácie.

Nastavte naplánované úlohy a úlohy na pozadí

Ak chcete automaticky spúšťať naplánované úlohy, môžete pridať záznam úlohy Cron. Otvoriť crontab.

sudo crontab -e

Pridajte nasledujúci riadok do súboru.

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

Toto spustí úlohu cron každú minútu, takže naplánované úlohy, ako napríklad e-mailové fronty, budú spracované čo najskôr.

Na spustenie služby frontu správ budete tiež musieť nastaviť správcu. Vyžaduje sa, aby vždy bežal aspoň jeden proces, aby spotrebiteľ mohol spracovať správy. Spotrebiteľ môže normálne prerušiť proces správy mnohými spôsobmi. Aby sme zabezpečili nepretržitý chod služby, budeme využívať službu Dohľad. Nakonfigurujeme správcu na paralelné spustenie štyroch procesov. Ak sa niektorý zo štyroch procesov z akéhokoľvek dôvodu zastaví, supervízor sa ho pokúsi spustiť znova.

Inštalovať správcu.

sudo yum -y install supervisor

Upravte konfiguračný súbor správcu.

sudo nano /etc/supervisord.conf

Pridajte nasledujúce riadky na koniec súboru.

[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

Spustite a povoľte supervízorovi, aby sa automaticky spustil pri štarte.

sudo systemctl start supervisord
sudo systemctl enable supervisord

Stav procesov môžete zobraziť spustením nasledujúceho.

sudo supervisorctl status

Mali by ste vidieť, že procesy bežia.

[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 je teraz nainštalovaný na vašom serveri. Teraz môžete aplikáciu používať na správu rutinných úloh vašej organizácie. Ak sa chcete dozvedieť viac o OroCRM, môžete navštíviť jeho oficiálnu webovú stránku .