Πώς να εγκαταστήσετε το 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

Παρέχετε την κυριότητα του αρχείου υποδοχής PHP-FPM στον χρήστη Nginx.

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

Εγκαταστήστε το MariaDB

Το MariaDB είναι ένα fork ανοιχτού κώδικα της 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. Από προεπιλογή, δεν υπάρχει κωδικός πρόσβασης root σε μια νέα εγκατάσταση του MariaDB. Πατήστε το 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 απαιτεί επίσης χρόνο εκτέλεσης JavaScript Node.js. Το 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αρχείο για να παρέχετε πληροφορίες βάσης δεδομένων και email.

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 και θέλετε να χρησιμοποιήσετε τις δυνατότητες αποστολής email αμέσως, μπορείτε να ενημερώσετε τις ρυθμίσεις του mailer όπως φαίνεται.

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

Εάν δεν έχετε έτοιμο διακομιστή αλληλογραφίας, μπορείτε να τον παραλείψετε προς το παρόν αφήνοντας τις υπάρχουσες τιμές. Μπορείτε πάντα να αλλάξετε τη διαμόρφωση email μέσω του πίνακα ελέγχου.

Ορίστε μια τυχαία συμβολοσειρά secretαντικαθιστώντας το ThisTokenIsNotSoSecretChangeIt. Απαιτείται μια τυχαία συμβολοσειρά για την κωδικοποίηση των δεδομένων συνεδρίας. Ένα παράδειγμα συμβολοσειράς θα μοιάζει με αυτό.

secret:            uxvpXHhDxCFc9yU1hV1fMwjSoyVUzGh4WBMBBBa3XEgrRUF5OuB2h8iNl9JRDqcd

Μπορείτε να δημιουργήσετε μια τυχαία συμβολοσειρά χρησιμοποιώντας το pwgenβοηθητικό πρόγραμμα. Εγκαταστήστε το pwgenβοηθητικό πρόγραμμα εκτελώντας το sudo yum -y install pwgen. Για να δημιουργήσετε μια τυχαία συμβολοσειρά, εκτελέστε το pwgen -s 64 1.

Αποθηκεύστε το αρχείο και βγείτε από το πρόγραμμα επεξεργασίας. Εγκαταστήστε τις απαιτούμενες εξαρτήσεις PHP μέσω του συνθέτη.

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 συμπιέζει τα δεδομένα πριν τα στείλει στο πρόγραμμα περιήγησης. Η ενεργοποίηση της προσωρινής αποθήκευσης του προγράμματος περιήγησης αποθηκεύει τους στατικούς πόρους στην κρυφή μνήμη web του υπολογιστή-πελάτη. Την επόμενη φορά που ο χρήστης αποκτήσει πρόσβαση στον ιστότοπο, το μεγαλύτερο μέρος του στατικού περιεχομένου φορτώνεται από την κρυφή μνήμη web του ίδιου του χρήστη. Αυτές οι δύο μέθοδοι αυξάνουν δραματικά την ταχύτητα της εφαρμογής.

Ελέγξτε το αρχείο διαμόρφωσης 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 κάθε λεπτό, έτσι ώστε οι προγραμματισμένες εργασίες, όπως οι ουρές email, να διεκπεραιώνονται νωρίτερα.

Θα χρειαστεί επίσης να ρυθμίσετε το Supervisor για να εκτελείται η υπηρεσία Message Queue. Απαιτείται τουλάχιστον μία διεργασία να εκτελείται ανά πάσα στιγμή για να επεξεργαστεί ο καταναλωτής τα μηνύματα. Ένας καταναλωτής μπορεί κανονικά να διακόψει τη διαδικασία του μηνύματος με πολλούς τρόπους. Για να διασφαλίσουμε ότι η υπηρεσία λειτουργεί συνεχώς, θα χρησιμοποιήσουμε την υπηρεσία 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, μπορείτε να επισκεφτείτε τον επίσημο ιστότοπο του .