Πώς να εγκαταστήσετε το 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 είναι ένα fork ανοιχτού κώδικα της 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 απαιτεί επίσης χρόνο εκτέλεσης JavaScript Node.js. Το 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αρχείο για να παρέχετε πληροφορίες βάσης δεδομένων και 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 apt -y install pwgen. Για να δημιουργήσετε μια τυχαία συμβολοσειρά, εκτελέστε το pwgen -s 64 1.

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

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

Η χρήση --no-devθα διασφαλίσει ότι το Composer εγκαθιστά μόνο τις εξαρτήσεις που απαιτούνται για την εκτέλεση του διακομιστή web σε λειτουργία παραγωγής. Το σενάριο θα διαρκέσει μερικά λεπτά για τη λήψη και την εγκατάσταση των απαιτούμενων εξαρτήσεων PHP.

Εγκαταστήστε την εφαρμογή.

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

Ενεργοποιήστε τον ιστότοπο.

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

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