Jak zainstalować ERPNext Open Source ERP na CentOS 7

• Wymagania wstępne
• Zainstaluj narzędzia programistyczne
• Zainstaluj MariaDB Server
• Zainstaluj Nginx, Nodejs i Redis
• Zainstaluj konwerter plików PDF
• Zainstaluj ławkę
• Zainstaluj ERPNext za pomocą Bench
• Instalator i Nginx
• Podsumowanie

ERP lub Enterprise Resource Planning to pakiet aplikacji korporacyjnych służący do zarządzania podstawowymi procesami biznesowymi. ERPNext jest darmową i otwartą aplikacją ERP napisaną w języku Python. Używa Node.js dla interfejsu użytkownika i MariaDB do przechowywania danych. ERPNext zapewnia łatwy w użyciu interfejs internetowy, który pozwala firmom zarządzać codziennymi zadaniami. Zawiera moduły do ​​księgowości, CRM, HRM, produkcji, POS, zarządzania projektami, zakupów, zarządzania sprzedażą, zarządzania magazynem i innych. ERPNext może być wykorzystywany do zarządzania różnymi branżami, takimi jak usługodawcy, producenci, sprzedawcy i szkoły.

W tym samouczku zainstalujemy ERPNext na CentOS 7.

Wymagania wstępne

• Instancja serwera Vultr CentOS 7.
• Użytkownik sudo .

W tym samouczku użyjemy erp.example.comjako nazwy domeny wskazanej na serwerze. Pamiętaj, aby zastąpić wszystkie wystąpienia erp.example.comrzeczywistą nazwą domeny.

Zaktualizuj system podstawowy, korzystając z przewodnika „ Jak zaktualizować CentOS 7 ”. Po zaktualizowaniu systemu przejdź do instalacji Pythona.

Zainstaluj narzędzia programistyczne

ERPNext potrzebuje Pythona w wersji 2.7 do działania. Python 2.7 jest instalowany domyślnie we wszystkich instancjach serwera CentOS. Możesz sprawdzić, czy zainstalowana wersja Pythona, uruchamiając:

python -V

Powinieneś otrzymać podobne wyjście.

[user@vultr ~]$ python -V
Python 2.7.5

Chociaż zainstalowana wersja Pythona nie jest najnowsza, działa bez żadnych problemów. Zmiana domyślnej wersji Pythona może spowodować uszkodzenie YUM.

Zainstaluj pakiety w Development toolsgrupie, które są wymagane do skompilowania plików instalatora.

sudo yum groupinstall -y "Development tools"

Zainstaluj jeszcze kilka zależności:

sudo yum install -y redhat-lsb-core git python-setuptools python-devel openssl-devel libffi-devel

Zainstaluj pipnarzędzie Pythona . Pip jest menedżerem zależności dla pakietów Pythona.

wget https://bootstrap.pypa.io/get-pip.py
sudo python get-pip.py

Powyższe polecenie zainstaluje Pip w twoim systemie. Aby upewnić się, że masz najnowszą wersję pipi setuptools, uruchom:

sudo pip install --upgrade pip setuptools

Zainstaluj Ansible za pomocą Pip. Ansible automatyzuje dostarczanie oprogramowania, zarządzanie konfiguracją i wdrażanie aplikacji.

sudo pip install ansible

Zainstaluj MariaDB Server

MariaDB to rozwidlenie serwera bazy danych MySQL. Zainstaluj MariaDB, uruchamiając.

sudo yum -y install mariadb mariadb-server mysql-devel

Do tworzenia baz danych ERPNext wymagany jest silnik pamięci Barracuda, dlatego konieczne będzie skonfigurowanie MariaDB do korzystania z silnika pamięci Barracuda. Edytuj domyślny plik konfiguracyjny MariaDB my.cnf.

sudo nano /etc/my.cnf

Dodaj następujące linie pod symbolic-links=0linią.

innodb-file-format=barracuda
innodb-file-per-table=1
innodb-large-prefix=1
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci

[mysql]
default-character-set = utf8mb4

Uruchom MariaDB i włącz automatyczne uruchamianie podczas uruchamiania.

sudo systemctl start mariadb.service
sudo systemctl enable mariadb.service

Przed skonfigurowaniem bazy danych musisz zabezpieczyć MariaDB. Możesz to zabezpieczyć, uruchamiając mysql_secure_installationskrypt:

sudo mysql_secure_installation

Zostaniesz poproszony o podanie bieżącego hasła roota MariaDB. Domyślnie w MariaDB nie ma ustawionego hasła roota. Naciśnij klawisz „Enter”, aby kontynuować. Ustaw silne hasło dla użytkownika root na swoim serwerze MariaDB i odpowiedz „Y” na wszystkie pozostałe pytania. Zadane pytania są oczywiste.

Zainstaluj Nginx, Nodejs i Redis

Ponieważ repozytorium EPEL jest instalowane domyślnie we wszystkich instancjach Vultr CentOS 7, możesz bezpośrednio zainstalować Redis i Nginx. Ale aby zainstalować najnowszą wersję Node.js, musisz dodać repozytorium Nodesource do swojego systemu.

Dodaj repozytorium Nodesource dla Node.js 8.x.

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

Zainstaluj Nginx, Nodejs i Redis:

sudo yum -y install nginx nodejs redis

Uruchom Nginx i włącz go w czasie uruchamiania, uruchamiając:

sudo systemctl start nginx
sudo systemctl enable nginx

Uruchom Redis i włącz uruchamianie w czasie uruchamiania, uruchamiając:

sudo systemctl start redis
sudo systemctl enable redis

Zainstaluj konwerter plików PDF

wkhtmltopdfProgram jest narzędziem wiersza poleceń, które konwertuje HTML do formatu PDF za pomocą silnika renderowania QT Webkit. Zainstaluj wymagane zależności:

sudo yum -y install libXrender libXext xorg-x11-fonts-75dpi xorg-x11-fonts-Type1

Pobierz najnowszą wersję wkhtmltopdf.

wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.4/wkhtmltox-0.12.4_linux-generic-amd64.tar.xz

Wyodrębnij archiwum, uruchamiając:

sudo tar -xf wkhtmltox-0.12.4_linux-generic-amd64.tar.xz -C /opt

Powyższe polecenie wyodrębni archiwum do /opt/wkhtmltox. Utwórz dowiązanie tak, że wkhtmltopdfi wkhtmltoimagemogą być wykonywane na całym świecie jako polecenie.

sudo ln -s /opt/wkhtmltox/bin/wkhtmltopdf /usr/bin/wkhtmltopdf
sudo ln -s /opt/wkhtmltox/bin/wkhtmltoimage /usr/bin/wkhtmltoimage

Możesz teraz uruchomić wkhtmltopdf -Vpolecenie, aby sprawdzić, czy działa, zobaczysz:

[user@vultr ~]$ wkhtmltopdf -V
wkhtmltopdf 0.12.4 (with patched qt)

W tym momencie mamy zainstalowane wszystkie wymagane zależności. Możesz teraz przejść do instalacji Bench.

Zainstaluj ławkę

Benchto narzędzie wiersza polecenia dostarczone przez Frappe do instalowania aplikacji ERPNext i zarządzania nią w systemie uniksowym, zarówno do celów programistycznych, jak i produkcyjnych. Bench może także tworzyć i zarządzać konfiguracją Nginx i superwizora.

Utwórz nowego użytkownika do uruchamiania procesów testowych w izolowanym środowisku.

sudo adduser bench -d /opt/bench

Zmień hasło użytkownika.

sudo passwd bench

Udziel sudouprawnień benchużytkownikowi.

sudo usermod -aG wheel bench

Zaloguj się jako nowo utworzony benchużytkownik:

sudo su - bench

Sklonuj repozytorium Bench w /opt/bench:

cd /opt/bench
git clone https://github.com/frappe/bench bench-repo

Zainstaluj Bench za pomocą pip.

sudo pip install -e bench-repo

Po zainstalowaniu Bench przejdź do instalacji ERPNext za pomocą Bench.

Zainstaluj ERPNext za pomocą Bench

Zainicjuj katalog bench z zainstalowanym frappe framework. Aby wszystko było uporządkowane, będziemy pracować w /opt/benchkatalogu. Ławka będzie także konfigurować regularne kopie zapasowe i automatyczne aktualizacje raz dziennie.

cd /opt/bench
bench init erpnext && cd erpnext

Utwórz nową stronę Frappe:

bench new-site erp.example.com

Powyższe polecenie wyświetli monit o podanie hasła root MySQL. Podaj hasło ustawione wcześniej dla użytkownika root MySQL. Poprosi Cię również o ustawienie nowego hasła do konta administratora. Będziesz potrzebować tego hasła później, aby zalogować się do pulpitu administratora.

Pobierz pliki instalacyjne ERPNext ze zdalnego repozytorium git za pomocą Bench.

bench get-app erpnext https://github.com/frappe/erpnext

Zainstaluj ERPNext na nowo utworzonej stronie:

bench --site erp.example.com install-app erpnext

ERPNext jest zainstalowany na twoim serwerze. Możesz natychmiast uruchomić aplikację, aby sprawdzić, czy aplikacja została pomyślnie uruchomiona:

bench start

Należy jednak zatrzymać wykonywanie i przejść dalej, aby skonfigurować aplikację do użytku produkcyjnego.

Instalator i Nginx

Domyślnie aplikacja ERPNext nasłuchuje na porcie 8000, a nie na standardowym porcie HTTP 80. Ponadto nie jest zalecane uruchamianie wbudowanego serwera WWW do celów produkcyjnych, ponieważ będziemy udostępniać go światu. Dlatego powinieneś używać produkcyjnego serwera WWW jako odwrotnego proxy, takiego jak Apache lub Nginx. W tym samouczku użyjemy Nginx jako odwrotnego proxy, ponieważ można go automatycznie skonfigurować za pomocą Bench. Ławka może automatycznie wygenerować i zainstalować konfigurację zgodnie z konfiguracją ERPNext.

Chociaż możemy uruchomić aplikację za pomocą powyższego polecenia, wykonanie ERPNext zostanie zatrzymane, gdy tylko zamkniesz terminal. Aby rozwiązać ten problem, zalecam użycie Supervisora, który jest bardzo pomocny w ciągłym uruchamianiu aplikacji w środowisku produkcyjnym. Supervisor to system kontroli procesu, który umożliwia monitorowanie i kontrolowanie wielu procesów w systemach operacyjnych Linux. Po skonfigurowaniu Supervisora, aplikacja automatycznie uruchomi się w czasie rozruchu, a także w przypadku awarii. Ławka może automatycznie skonfigurować Supervisora ​​dla aplikacji ERPNext.

Zainstaluj opiekuna:

sudo yum -y install supervisor

Uruchom Supervisora ​​i włącz automatyczne uruchamianie się podczas uruchamiania:

sudo systemctl start supervisord
sudo systemctl enable supervisord

Ławka instalacyjna do użytku produkcyjnego:

 sudo bench setup production bench

Powyższe polecenie może spowodować wyświetlenie monitu przed zastąpieniem istniejącego domyślnego pliku konfiguracyjnego Supervisor nowym plikiem. Wybierz, yaby kontynuować. Ławka dodaje wiele procesów do pliku konfiguracyjnego Supervisor. Powyższe polecenie zapyta również, czy chcesz zastąpić bieżącą konfigurację Nginx nową. Wejdź, yaby kontynuować. Po zakończeniu instalacji konfiguracji przez Bench, zapewnij innym użytkownikom wykonanie plików w twoim katalogu domowym użytkownika Bench.

chmod o+x /opt/bench/

Jeśli używasz zapory na swoim serwerze, musisz skonfigurować zaporę, aby ustawić wyjątek dla usługi HTTP. Pozwól, aby odwrotny serwer proxy Nginx łączył się spoza sieci.

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

Możesz teraz uzyskać dostęp do witryny na http://erp.example.com.

Możesz sprawdzić status procesów, uruchamiając:

sudo supervisorctl status all

Powinieneś zobaczyć następujące dane wyjściowe:

[bench@vultr ~]$ sudo supervisorctl status all
erpnext-redis:erpnext-redis-cache                 RUNNING   pid 2554, uptime 1:06:58
erpnext-redis:erpnext-redis-queue                 RUNNING   pid 2553, uptime 1:06:58
erpnext-redis:erpnext-redis-socketio              RUNNING   pid 2555, uptime 1:06:58
erpnext-web:erpnext-frappe-web                    RUNNING   pid 2559, uptime 1:06:58
erpnext-web:erpnext-node-socketio                 RUNNING   pid 2556, uptime 1:06:58
erpnext-workers:erpnext-frappe-default-worker-0   RUNNING   pid 2549, uptime 1:06:58
erpnext-workers:erpnext-frappe-long-worker-0      RUNNING   pid 2551, uptime 1:06:58
erpnext-workers:erpnext-frappe-schedule           RUNNING   pid 2550, uptime 1:06:58
erpnext-workers:erpnext-frappe-short-worker-0     RUNNING   pid 2552, uptime 1:06:58

Aby zatrzymać wszystkie procesy ERPNext, użyj:

sudo supervisorctl stop all

Aby uruchomić wszystkie procesy ERPNext, użyj:

sudo supervisorctl start all

Konfigurowanie SSL przy użyciu Let's Encrypt

Let's Encrypt zapewnia użytkownikom bezpłatne certyfikaty SSL. SSL może być zainstalowany ręcznie lub automatycznie przez Bench. Bench może automatycznie zainstalować klienta Let's Encrypt i uzyskać certyfikaty. Ponadto automatycznie aktualizuje konfigurację Nginx, aby używać certyfikatów.

Nazwa domeny, której używasz do uzyskania certyfikatów z Let's Encrypt CA, musi być skierowana w stronę serwera. Klient weryfikuje urząd domeny przed wydaniem certyfikatów.

Włącz wielodostępność DNS dla aplikacji ERPNext.

bench config dns_multitenant on

Uruchom Bench, aby skonfigurować Let's Encrypt na swojej stronie:

sudo bench setup lets-encrypt erp.example.com

Podczas wykonywania skryptu klient Let's Encrypt poprosi Cię o tymczasowe zatrzymanie serwera WWW Nginx. Automatycznie zainstaluje wymagane pakiety i klienta Let's Encrypt. Klient wyświetli monit o podanie adresu e-mail. Będziesz także musiał zaakceptować warunki. Po wygenerowaniu certyfikatów Bench wygeneruje również nową konfigurację dla Nginx, która korzysta z certyfikatów SSL. Zostaniesz zapytany przed zastąpieniem istniejącej konfiguracji. Ławka tworzy również crontabwpis, aby automatycznie odnawiać certyfikaty co miesiąc.

Na koniec włącz harmonogram, aby automatycznie uruchamiał zaplanowane zadania:

bench enable-scheduler

Powinieneś zobaczyć:

[bench@vultr erpnext]$ bench enable-scheduler
Enabled for erp.example.com

Podsumowanie

Po zakończeniu procesu możesz uzyskać dostęp do aplikacji pod adresem https://erp.example.com. Zaloguj się, podając nazwę użytkownika Administratori hasło ustawione podczas instalacji. Zostaniesz przeniesiony do biurka, gdzie będziesz musiał podać informacje, aby ustawić ERPNext ERP zgodnie z twoją firmą. Możesz teraz używać aplikacji do zarządzania firmą.

Gratulacje, masz zainstalowaną w pełni działającą aplikację ERPNext na serwerze CentOS 7.