Debian 9にERPNextをインストールする方法

ERPNextは、Frappeフレームワークの上にPythonで書かれた無料のオープンソースERPソフトウェアで、会計、在庫、製造、CRM、販売、購買、プロジェクト管理、人事管理などを含みます。ERPNextはシンプルで強力、使いやすいERPシステムです。中央の場所から日々のタスクを管理するために使用できる美しいウェブインターフェースが付属しています。

このチュートリアルでは、Debian 9サーバーにERPNextソフトウェアをインストールする方法を学びます。

前提条件

Debian 9を実行しているサーバー。
sudo権限を持つ非rootユーザー。

始めに

始める前に、パッケージリポジトリを最新バージョンに更新することをお勧めします。次のコマンドを実行することでこれを行うことができます：

sudo apt-get update -y  
sudo apt-get upgrade -y

次に、すべての変更を適用するためにシステムを再起動します。

依存関係のインストール

ERPNextは、正常に動作するためにPythonバージョン2.7を必要とします。次のコマンドを実行することでPythonと他の必要なパッケージをインストールできます：

sudo apt-get install python-minimal git build-essential python-setuptools python-dev libffi-dev libssl-dev curl -y

Pythonの依存関係をインストールするために、Pythonのpipツールもインストールする必要があります。次のコマンドを実行することでこれを行うことができます：

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

次に、pipコマンドを使用してansibleをインストールします：

sudo pip install ansible

Node.js、Redis、Nginxのインストール

デフォルトでは、Debian 9ではNode.jsの最新バージョンは利用できません。したがって、Node.js 8.xのためにNodesourceリポジトリを追加する必要があります。次のコマンドを実行することでこれを行うことができます：

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

次に、次のコマンドを実行してNode.js、Nginx、Redisをインストールします：

sudo apt-get install nodejs redis-server nginx -y

すべてのパッケージがインストールされたら、次のコマンドを使用してNginxとRedisサービスを開始し、ブート時に自動的に開始するように有効にします：

sudo systemctl start nginx  
sudo systemctl enable nginx  
sudo systemctl start redis-server  
sudo systemctl enable redis-server

MariaDBのインストールと設定

デフォルトでは、Debian 9リポジトリにはMariaDBの最新バージョンは利用できません。したがって、そのためにMariaDBリポジトリを追加する必要があります。

まず、次のコマンドを使用して署名キーをダウンロードしてシステムに追加します：

sudo apt-get install software-properties-common dirmngr  
sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 0xF1656F24C74CD1D8

次に、次のコマンドを使用してMariaDBリポジトリを追加します：

sudo add-apt-repository 'deb [arch=amd64,i386,ppc64el] http://ftp.utexas.edu/mariadb/repo/10.2/debian stretch main'

最後に、次のコマンドを使用してMariaDBサーバーをインストールします：

sudo apt-get update -y  
sudo apt-get install mariadb-server libmysqlclient-dev -y

次に、ERPNextデータベースを作成するためにMariaDB設定ファイルにBarracudaストレージエンジンを追加する必要があります。次のコマンドを使用してmy.cnfファイルを編集します：

sudo nano /etc/mysql/my.cnf

次の行を追加します：

[mysqld]

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

作業が完了したらファイルを保存して閉じ、次のコマンドを使用してMariaDBサービスを開始し、ブート時に自動的に開始するように有効にします：

sudo systemctl restart mysql  
sudo systemctl enable mysql

次に、mysql_secure_installationスクリプトを実行してMariaDBを保護します：

sudo mysql_secure_installation

このスクリプトは、rootパスワードを設定し、匿名ユーザーを削除し、リモートrootログインを禁止し、テストデータベースを削除し、以下のようにMariaDBを安全に保つためのアクセスを削除します：

Set root password? [Y/n] y
Remove anonymous users? [Y/n] y
Disallow root login remotely? [Y/n] y
Remove test database and access to it? [Y/n] y
Reload privilege tables now? [Y/n] y

PDFコンバーターのインストール

HTMLをQT Webkitレンダリングエンジンを使用してPDFに変換するために、wkhtmltopdfをインストールする必要があります。まず、次のコマンドを使用して必要な依存関係をインストールします：

sudo apt-get install libxext6 xfonts-75dpi xfonts-base libxrender1 -y

次に、次のコマンドを使用してwkhtmltopdfの最新バージョンをダウンロードします：

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

次に、ダウンロードしたファイルを/optディレクトリに抽出します：

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

次に、次のコマンドを使用してwkhtmltopdfのソフトリンクを作成します：

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

Benchのインストール

次に、ERPNextアプリケーションをシステムにインストールおよび管理するためにBenchをインストールする必要があります。Benchは、Nginxおよびスーパーバイザーの設定を作成および管理するためにも使用されます。

Benchをインストールする前に、Bench用のユーザーを追加する必要があります。

まず、次のコマンドを使用してBenchユーザーを作成します：

sudo adduser bench

次に、benchユーザーにsudo権限を付与します。

sudo usermod -aG sudo bench

次に、Benchユーザーでログインし、次のコマンドを使用してBenchリポジトリをクローンします：

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

最後に、pipコマンドを使用してBenchをインストールします：

sudo pip install -e bench-repo

ERPNextのインストール

次に、Frappeフレームワークがインストールされたbenchディレクトリを初期化します。

bench init erpnext

次に、erpnextにディレクトリを変更し、次のコマンドを使用して新しいFrappeサイトを作成します：

cd erpnext  
bench new-site test.example.com

上記のコマンドは、MySQLのrootパスワードを提供するように求め、管理者アカウントの新しいパスワードを設定するように求めます。管理者パスワードは、後で管理者ダッシュボードにログインするために必要です。

次に、次のコマンドを使用してGitリポジトリからERPNextインストールファイルをダウンロードします：

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

次に、新しく作成したサイトにERPNextをインストールします。

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

最後に、次のコマンドを使用してBenchアプリケーションを開始します：

bench start

アプリケーションが正常に起動すると、次の出力が表示されるはずです：

13:40:10 system           | redis_socketio.1 started (pid=2618)
13:40:10 system           | worker_long.1 started (pid=2625)
13:40:10 system           | watch.1 started (pid=2619)
13:40:10 system           | redis_queue.1 started (pid=2626)
13:40:10 redis_socketio.1 | 2630:M 24 Feb 13:40:10.939 * Increased maximum number of open files to 10032 (it was originally set to 1024).
13:40:10 system           | web.1 started (pid=2629)
13:40:11 system           | schedule.1 started (pid=2634)
13:40:10 redis_socketio.1 |                 _._                                                  
13:40:10 redis_socketio.1 |            _.-``__ ''-._                                              
13:40:10 redis_socketio.1 |       _.-``    `.  `_.  ''-._           Redis 3.0.6 (00000000/0) 64 bit
13:40:10 redis_socketio.1 |   .-`` .-```.  ```\/    _.,_ ''-._                                   
13:40:10 redis_socketio.1 |  (    '      ,       .-`  | `,    )     Running in standalone mode
13:40:10 redis_socketio.1 |  |`-._`-...-` __...-.``-._|'` _.-'|     Port: 12000
13:40:10 redis_socketio.1 |  |    `-._   `._    /     _.-'    |     PID: 2630
13:40:10 redis_socketio.1 |   `-._    `-._  `-./  _.-'    _.-'                                   
13:40:10 redis_socketio.1 |  |`-._`-._    `-.__.-'    _.-'_.-'|                                  
13:40:10 redis_socketio.1 |  |    `-._`-._        _.-'_.-'    |           http://redis.io        
13:40:10 redis_socketio.1 |   `-._    `-._`-.__.-'_.-'    _.-'                                   
13:40:10 redis_socketio.1 |  |`-._`-._    `-.__.-'    _.-'_.-'|                                  
13:40:10 redis_socketio.1 |  |    `-._`-._        _.-'_.-'    |                                  
13:40:10 redis_socketio.1 |   `-._    `-._`-.__.-'_.-'    _.-'                                   
13:40:10 redis_socketio.1 |       `-._    `-.__.-'    _.-'                                       
13:40:10 redis_socketio.1 |           `-._        _.-'                                           
13:40:10 redis_socketio.1 |               `-.__.-'                                                
13:40:10 redis_socketio.1 | 
13:40:11 system           | worker_default.1 started (pid=2639)
13:40:10 redis_socketio.1 | 2630:M 24 Feb 13:40:10.973 # WARNING: The TCP backlog setting of 511 cannot be enforced because /proc/sys/net/core/somaxconn is set to the lower value of 128.
13:40:10 redis_socketio.1 | 2630:M 24 Feb 13:40:10.974 # Server started, Redis version 3.0.6
13:40:10 redis_socketio.1 | 2630:M 24 Feb 13:40:10.974 # WARNING overcommit_memory is set to 0! Background save may fail under low memory condition. To fix this issue add 'vm.overcommit_memory = 1' to /etc/sysctl.conf and then reboot or run the command 'sysctl vm.overcommit_memory=1' for this to take effect.
13:40:10 redis_socketio.1 | 2630:M 24 Feb 13:40:10.974 # WARNING you have Transparent Huge Pages (THP) support enabled in your kernel. This will create latency and memory usage issues with Redis. To fix this issue run the command 'echo never > /sys/kernel/mm/transparent_hugepage/enabled' as root, and add it to your /etc/rc.local in order to retain the setting after a reboot. Redis must be restarted after THP is disabled.
13:40:10 redis_queue.1    | 2635:M 24 Feb 13:40:10.976 * Increased maximum number of open files to 10032 (it was originally set to 1024).
13:40:10 redis_queue.1    |                 _._                                                  
13:40:10 redis_queue.1    |            _.-``__ ''-._                                              
13:40:10 redis_queue.1    |       _.-``    `.  `_.  ''-._           Redis 3.0.6 (00000000/0) 64 bit
13:40:10 redis_queue.1    |   .-`` .-```.  ```\/    _.,_ ''-._                                   
13:40:10 redis_queue.1    |  (    '      ,       .-`  | `,    )     Running in standalone mode
13:40:10 redis_queue.1    |  |`-._`-...-` __...-.``-._|'` _.-'|     Port: 11000
13:40:10 redis_queue.1    |  |    `-._   `._    /     _.-'    |     PID: 2635
13:40:10 redis_queue.1    |   `-._    `-._  `-./  _.-'    _.-'                                   
13:40:10 redis_queue.1    |  |`-._`-._    `-.__.-'    _.-'_.-'|                                  
13:40:10 redis_queue.1    |  |    `-._`-._        _.-'_.-'    |           http://redis.io        
13:40:10 redis_queue.1    |   `-._    `-._`-.__.-'_.-'    _.-'                                   
13:40:10 redis_queue.1    |  |`-._`-._    `-.__.-'    _.-'_.-'|                                  
13:40:10 redis_queue.1    |  |    `-._`-._        _.-'_.-'    |                                  
13:40:10 redis_queue.1    |   `-._    `-._`-.__.-'_.-'    _.-'                                   
13:40:10 redis_queue.1    |       `-._    `-.__.-'    _.-'                                       
13:40:10 redis_queue.1    |           `-._        _.-'                                           
13:40:10 redis_queue.1    |               `-.__.-'                                                
13:40:10 redis_queue.1    | 
13:40:10 redis_queue.1    | 2635:M 24 Feb 13:40:10.998 # WARNING: The TCP backlog setting of 511 cannot be enforced because /proc/sys/net/core/somaxconn is set to the lower value of 128.
13:40:10 redis_queue.1    | 2635:M 24 Feb 13:40:10.999 # Server started, Redis version 3.0.6
13:40:11 redis_queue.1    | 2635:M 24 Feb 13:40:11.000 # WARNING overcommit_memory is set to 0! Background save may fail under low memory condition. To fix this issue add 'vm.overcommit_memory = 1' to /etc/sysctl.conf and then reboot or run the command 'sysctl vm.overcommit_memory=1' for this to take effect.
13:40:11 redis_socketio.1 | 2630:M 24 Feb 13:40:11.000 * The server is now ready to accept connections on port 12000
13:40:11 system           | socketio.1 started (pid=2637)
13:40:11 redis_queue.1    | 2635:M 24 Feb 13:40:11.029 # WARNING you have Transparent Huge Pages (THP) support enabled in your kernel. This will create latency and memory usage issues with Redis. To fix this issue run the command 'echo never > /sys/kernel/mm/transparent_hugepage/enabled' as root, and add it to your /etc/rc.local in order to retain the setting after a reboot. Redis must be restarted after THP is disabled.
13:40:11 redis_queue.1    | 2635:M 24 Feb 13:40:11.029 * The server is now ready to accept connections on port 11000
13:40:11 system           | redis_cache.1 started (pid=2652)
13:40:11 system           | worker_short.1 started (pid=2651)
13:40:11 redis_cache.1    | 2660:M 24 Feb 13:40:11.100 * Increased maximum number of open files to 10032 (it was originally set to 1024).
13:40:11 redis_cache.1    |                 _._                                                  
13:40:11 redis_cache.1    |            _.-``__ ''-._                                              
13:40:11 redis_cache.1    |       _.-``    `.  `_.  ''-._           Redis 3.0.6 (00000000/0) 64 bit
13:40:11 redis_cache.1    |   .-`` .-```.  ```\/    _.,_ ''-._                                   
13:40:11 redis_cache.1    |  (    '      ,       .-`  | `,    )     Running in standalone mode
13:40:11 redis_cache.1    |  |`-._`-...-` __...-.``-._|'` _.-'|     Port: 13000
13:40:11 redis_cache.1    |  |    `-._   `._    /     _.-'    |     PID: 2660
13:40:11 redis_cache.1    |   `-._    `-._  `-./  _.-'    _.-'                                   
13:40:11 redis_cache.1    |  |`-._`-._    `-.__.-'    _.-'_.-'|                                  
13:40:11 redis_cache.1    |  |    `-._`-._        _.-'_.-'    |           http://redis.io        
13:40:11 redis_cache.1    |   `-._    `-._`-.__.-'_.-'    _.-'                                   
13:40:11 redis_cache.1    |  |`-._`-._    `-.__.-'    _.-'_.-'|                                  
13:40:11 redis_cache.1    |  |    `-._`-._        _.-'_.-'    |                                  
13:40:11 redis_cache.1    |   `-._    `-._`-.__.-'_.-'    _.-'                                   
13:40:11 redis_cache.1    |       `-._    `-.__.-'    _.-'                                       
13:40:11 redis_cache.1    |           `-._        _.-'                                           
13:40:11 redis_cache.1    |               `-.__.-'                                                
13:40:11 redis_cache.1    | 
13:40:11 redis_cache.1    | 2660:M 24 Feb 13:40:11.115 # WARNING: The TCP backlog setting of 511 cannot be enforced because /proc/sys/net/core/somaxconn is set to the lower value of 128.
13:40:11 redis_cache.1    | 2660:M 24 Feb 13:40:11.115 # Server started, Redis version 3.0.6
13:40:11 redis_cache.1    | 2660:M 24 Feb 13:40:11.115 # WARNING overcommit_memory is set to 0! Background save may fail under low memory condition. To fix this issue add 'vm.overcommit_memory = 1' to /etc/sysctl.conf and then reboot or run the command 'sysctl vm.overcommit_memory=1' for this to take effect.
13:40:11 redis_cache.1    | 2660:M 24 Feb 13:40:11.116 # WARNING you have Transparent Huge Pages (THP) support enabled in your kernel. This will create latency and memory usage issues with Redis. To fix this issue run the command 'echo never > /sys/kernel/mm/transparent_hugepage/enabled' as root, and add it to your /etc/rc.local in order to retain the setting after a reboot. Redis must be restarted after THP is disabled.
13:40:11 redis_cache.1    | 2660:M 24 Feb 13:40:11.116 * The server is now ready to accept connections on port 13000
13:40:16 socketio.1       | listening on *: 9000
13:40:34 worker_long.1    | 13:40:34 RQ worker u'rq:worker:Node1.2632.long' started, version 0.10.0
13:40:34 worker_long.1    | 13:40:34 * Listening on long...
13:40:34 worker_long.1    | 13:40:34 Cleaning registries for queue: long
13:40:34 worker_default.1 | 13:40:34 RQ worker u'rq:worker:Node1.2646.default' started, version 0.10.0
13:40:34 worker_default.1 | 13:40:34 * Listening on default...
13:40:34 worker_default.1 | 13:40:34 Cleaning registries for queue: default
13:40:34 worker_short.1   | 13:40:34 RQ worker u'rq:worker:Node1.2661.short' started, version 0.10.0
13:40:34 worker_short.1   | 13:40:34 *** Listening on short...
13:40:34 worker_short.1   | 13:40:34 Cleaning registries for queue: short
13:40:34 web.1            |  * Running on http://0.0.0.0:8000/ (Press CTRL+C to quit)