Raspberry Pi

このガイドでは、MyEMSをRaspberry Piにデプロイします。

前提条件

Raspberry Pi 5 または Raspberry Pi 4 Model B
Raspberry Pi OS (64-bit) Debian BookwormをベースにRaspberry Pi Desktopを搭載リリース日:2024-07-04

ソースコードのクローン

sudo apt install git

sudo apt install pip

sudo apt install ufw

cd ~ && git clone https://github.com/myems/myems

ステップ1 データベース

MySQLサーバーをセットアップ

sudo apt update

sudo apt upgrade

sudo apt install mariadb-server

デフォルトでは、MySQLはパスワード設定なしでインストールされるため、認証なしでMySQLサーバーにアクセスできます。以下のコマンドを実行してMySQLのセキュリティ設定プロセスを開始します。

sudo mysql_secure_installation

現在のrootパスワードを入力してください（未設定の場合はEnterキー）：[EnterキーまたはReturnキー]
unix_socket認証に切り替えますか？[Y/n] Y
rootパスワードを変更しますか？[Y/n] Y
新しいパスワード：!MyEMS1
新しいパスワードを再入力：!MyEMS1
匿名ユーザーを削除しますか？[Y/n] Y
リモートからのrootログインを許可しませんか？[Y/n] n
テストデータベースとそのアクセスを削除しますか？[Y/n] Y
権限テーブルを今すぐリロードしますか？[Y/n] Y

MyEMS用のデータベーススキーマとスクリプトをインストール。

データベースを参照してください。

ステップ2 myems-api

myems-apiサービスをインストール：

sudo cp -r ~/myems/myems-api /myems-api

cd /myems-api

'externally-managed-environment'エラーを防ぐために、仮想環境設定フォルダを作成：

sudo python -m venv venv

仮想環境の使用を開始

source venv/bin/activate

必要なパッケージをインストール

sudo venv/bin/pip install -r requirements.txt

仮想環境を終了

deactivate

example.envに基づいて.envファイルを作成し、必要に応じて.envファイルを編集：

sudo cp /myems-api/example.env /myems-api/.env

sudo nano /myems-api/.env

myems-api.service内のgunicornパスを変更：

sudo nano /myems-api/myems-api.service

[Unit]
Description=myems-api daemon
Requires=myems-api.socket
After=network.target

[Service]
PIDFile=/run/myems-api/pid
User=root
Group=root
WorkingDirectory=/myems-api
ExecStart=/myems-api/venv/bin/gunicorn -b 0.0.0.0:8000 --pid /run/myems-api/pid --timeout 600 --workers=4 app:api
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s TERM $MAINPID
PrivateTmp=true

[Install]
WantedBy=multi-user.target

ファイアウォールにポートを追加：

sudo ufw allow 8000

systemd設定ファイルをセットアップ：

sudo cp /myems-api/myems-api.service /lib/systemd/system/

sudo cp /myems-api/myems-api.socket /lib/systemd/system/

sudo cp /myems-api/myems-api.conf /usr/lib/tmpfiles.d/

次に、サービスを有効にして起動時に自動起動するようにします：

sudo systemctl enable myems-api.socket

sudo systemctl enable myems-api.service

サービスを開始：

sudo systemctl start myems-api.socket

sudo systemctl start myems-api.service

ステップ3 myems-admin

NGINXサーバーをインストール

http://nginx.org/en/linux_packages.html#Debian を参照

sudo apt install curl gnupg2 ca-certificates lsb-release debian-archive-keyring

curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null

gpg --dry-run --quiet --no-keyring --import --import-options import-show /usr/share/keyrings/nginx-archive-keyring.gpg

echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] http://nginx.org/packages/debian `lsb_release -cs` nginx" | sudo tee /etc/apt/sources.list.d/nginx.list

echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" | sudo tee /etc/apt/preferences.d/99nginx

sudo apt update

sudo apt install nginx

NGINXを設定

sudo nano /etc/nginx/nginx.conf

'http'セクションにいくつかのディレクティブを追加：

http {
    client_header_timeout 600;
    client_max_body_size 512M;
    gzip on;
    gzip_min_length 512;
    gzip_proxied any;
    gzip_types *;
    gzip_vary on;
    proxy_buffering off;

    ...
}

'http'セクション内に、以下のディレクティブで新しい'server'セクションを追加：

  server {
      listen                 8001;
      server_name     myems-admin;
      location / {
          root    /var/www/myems-admin;
          index index.html index.htm;
      }
      ## CORS問題を回避するために、Nginxを使用してmyems-apiをパス/apiにプロキシします。
      ## 'server'内に別のlocation /apiを追加し、デモアドレス http://127.0.0.1:8000/ を実際のURLに置き換えてください。
      location /api {
          proxy_pass http://127.0.0.1:8000/;
          proxy_connect_timeout 75;
          proxy_read_timeout 600;
          send_timeout 600;
      }
  }

myems-adminをインストール：

sudo mkdir /var/www

sudo cp -r ~/myems/myems-admin  /var/www/myems-admin

sudo chmod 0755 -R /var/www/myems-admin

設定ファイルを確認し、必要に応じて変更：

sudo nano /var/www/myems-admin/app/api.js

注意

'upload'フォルダはユーザーがアップロードしたファイル用です。myems-adminをアップグレードする際に、'upload'フォルダを削除/移動/上書きしないでください。

 /var/www/myems-admin/upload

Nginxを起動：

sudo systemctl start nginx

ファイアウォールにポートを追加：

sudo ufw allow 8001

ステップ4 myems-modbus-tcp

このステップでは、myems-modbus-tcpサービスをインストールします。

sudo cp -r ~/myems/myems-modbus-tcp /myems-modbus-tcp

cd /myems-modbus-tcp

'externally-managed-environment'エラーを防ぐために、仮想環境設定フォルダを作成：

sudo python -m venv venv

仮想環境の使用を開始

source venv/bin/activate

必要なパッケージをインストール

sudo venv/bin/pip install -r requirements.txt

仮想環境を終了

deactivate

example.envファイルをコピーして.envを作成し、.envファイルを修正：

sudo cp /myems-modbus-tcp/example.env /myems-modbus-tcp/.env

sudo nano /myems-modbus-tcp/.env

myems-modbus-tcp.service内のpythonパスを変更

sudo nano myems-modbus-tcp.service

[Unit]
Description=myems-modbus-tcp daemon
After=network.target

[Service]
User=root
Group=root
ExecStart=/myems-modbus-tcp/venv/bin/python3 /myems-modbus-tcp/main.py
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s TERM $MAINPID
PrivateTmp=true
Restart=always

[Install]
WantedBy=multi-user.target

systemdサービスをセットアップ：

sudo cp myems-modbus-tcp.service /lib/systemd/system/

サービスを有効化：

sudo systemctl enable myems-modbus-tcp.service

サービスを開始：

sudo systemctl start myems-modbus-tcp.service

サービスを監視：

sudo systemctl status myems-modbus-tcp.service

ログを表示：

cat /myems-modbus-tcp.log

ステップ5 myems-cleaning

このステップでは、myems-cleaningサービスをインストールします。

sudo cp -r ~/myems/myems-cleaning /myems-cleaning

cd /myems-cleaning

'externally-managed-environment'エラーを防ぐために、仮想環境設定フォルダを作成：

sudo python -m venv venv

仮想環境の使用を開始

source venv/bin/activate

必要なパッケージをインストール

sudo venv/bin/pip install -r requirements.txt

仮想環境を終了

deactivate

example.envファイルをコピーして.envを作成し、.envファイルを修正：

sudo cp /myems-cleaning/example.env /myems-cleaning/.env

nano /myems-cleaning/.env

myems-cleaning.service内のpythonパスを変更

sudo nano myems-cleaning.service

[Unit]
Description=myems-cleaning daemon
After=network.target

[Service]
User=root
Group=root
ExecStart=/myems-cleaning/venv/bin/python3 /myems-cleaning/main.py
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s TERM $MAINPID
PrivateTmp=true
Restart=always

[Install]
WantedBy=multi-user.target

systemdサービスをセットアップ：

sudo cp /myems-cleaning/myems-cleaning.service /lib/systemd/system/

サービスを有効化：

sudo systemctl enable myems-cleaning.service

サービスを開始：

sudo systemctl start myems-cleaning.service

サービスを監視：

sudo systemctl status myems-cleaning.service

ログを表示：

cat /myems-cleaning.log

ステップ6 myems-normalization

このステップでは、myems-normalizationサービスをインストールします。

sudo cp -r ~/myems/myems-normalization /myems-normalization

cd /myems-normalization

'externally-managed-environment'エラーを防ぐために、仮想環境設定フォルダを作成：

sudo python -m venv venv

仮想環境の使用を開始

source venv/bin/activate

必要なパッケージをインストール

sudo venv/bin/pip install -r requirements.txt

仮想環境を終了

deactivate

example.envファイルをコピーして.envを作成し、.envファイルを修正：

sudo cp /myems-normalization/example.env /myems-normalization/.env

sudo nano /myems-normalization/.env

myems-normalization.service内のpythonパスを変更

sudo nano myems-normalization.service

[Unit]
Description=myems-normalization daemon
After=network.target

[Service]
User=root
Group=root
ExecStart=/myems-normalization/venv/bin/python3 /myems-normalization/main.py
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s TERM $MAINPID
PrivateTmp=true
Restart=always

[Install]
WantedBy=multi-user.target

systemdサービスをセットアップ：

sudo cp /myems-normalization/myems-normalization.service /lib/systemd/system/

サービスを有効化：

sudo systemctl enable myems-normalization.service

サービスを開始：

sudo systemctl start myems-normalization.service

サービスを監視：

sudo systemctl status myems-normalization.service

ログを表示：

cat /myems-normalization.log

ステップ7 myems-aggregation

このステップでは、myems-aggregationサービスをインストールします。

sudo cp -r ~/myems/myems-aggregation /myems-aggregation

cd /myems-aggregation

'externally-managed-environment'エラーを防ぐために、仮想環境設定フォルダを作成：

sudo python -m venv venv

仮想環境の使用を開始

source venv/bin/activate

必要なパッケージをインストール

sudo venv/bin/pip install -r requirements.txt

仮想環境を終了

deactivate

example.envファイルをコピーして.envを作成し、.envファイルを修正：

sudo cp /myems-aggregation/example.env /myems-aggregation/.env

sudo nano /myems-aggregation/.env

myems-aggregation.service内のpythonパスを変更

sudo nano myems-aggregation.service

[Unit]
Description=myems-aggregation daemon
After=network.target

[Service]
User=root
Group=root
ExecStart=/myems-aggregation/venv/bin/python3 /myems-aggregation/main.py
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s TERM $MAINPID
PrivateTmp=true
Restart=always

[Install]
WantedBy=multi-user.target

systemdサービスをセットアップ：

sudo cp /myems-aggregation/myems-aggregation.service /lib/systemd/system/

サービスを有効化：

sudo systemctl enable myems-aggregation.service

サービスを開始：

sudo systemctl start myems-aggregation.service

サービスを監視：

sudo systemctl status myems-aggregation.service

ログを表示：

cat /myems-aggregation.log

ステップ8 myems-web

このステップでは、myems-web UIサービスをインストールします。

NGINXサーバーをインストール（myems-adminですでにインストール済みの場合は無視可能） http://nginx.org/en/docs/install.html を参照
NGINXを設定

デフォルトファイルを削除：

sudo rm /etc/nginx/sites-enabled/default
sudo rm /etc/nginx/conf.d/default.conf

/etc/nginx/conf.d/ の下に新しいファイルを追加：

sudo nano /etc/nginx/conf.d/myems-web.conf

以下のディレクティブで新しい'server'セクションを追加：

server {
    listen                 80;
    server_name     myems-web;
    location / {
        root    /var/www/myems-web;
        index index.html index.htm;
        # ページを更新する際の404エラーを回避するためにtry_filesディレクティブを追加
        try_files $uri  /index.html;
    }
    ## CORS問題を回避するために、Nginxを使用してmyems-apiをパス/apiにプロキシします。
    ## 'server'内に別のlocation /apiを追加します。
    ## 注：デフォルトアドレス http://127.0.0.1:8000/ を実際のIPまたはURLに置き換えてください。
    location /api {
        proxy_pass http://127.0.0.1:8000/;
        proxy_connect_timeout 75;
        proxy_read_timeout 600;
        send_timeout 600;
    }
}

MyEMS Web UIをインストール：

NodeJSをインストール：

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash -

sudo apt-get install -y nodejs

config.jsファイルを変更：

注釈

https://mapbox.com でmapboxTokenを取得し、showOnlineMapをtrueに設定してください。オンライン地図機能をオフにしたい場合は、showOnlineMapをfalseに設定してください。

cd ~/myems/myems-web

sudo nano src/config.js

ビルドと圧縮：

sudo npm i --unsafe-perm=true --allow-root --legacy-peer-deps

sudo npm run build

インストール

sudo mv build  /var/www/myems-web

NGINXを再起動：

sudo systemctl restart nginx

ファイアウォールにポートを追加：

sudo ufw allow 80

インストール後

おめでとうございます！これでMyEMS Admin UIとWeb UIにログインできるようになりました。

デフォルトポート

MyEMS Web UI: 80

MyEMS API: 8000

MyEMS Admin UI: 8001

サーバーアドレスが192.168.1.8（実際のサーバーアドレスに置き換えてください）だと仮定します。 MyEMS Web UIは http://192.168.1.8 (80は省略可能) でアクセスできます。 MyEMS Admin UIは http://192.168.1.8:8001 でアクセスできます。

デフォルトパスワード

MyEMS Admin UI

ユーザー名：

administrator

パスワード：

!MyEMS1

MyEMS Web UI

ユーザー名：

administrator@myems.io

パスワード：

!MyEMS1

前提条件​

ソースコードのクローン​

ステップ1 データベース​

ステップ2 myems-api​

ステップ3 myems-admin​

ステップ4 myems-modbus-tcp​

ステップ5 myems-cleaning​

ステップ6 myems-normalization​

ステップ7 myems-aggregation​

ステップ8 myems-web​

インストール後​

デフォルトポート​

デフォルトパスワード​

トラブルシューティング​

前提条件

ソースコードのクローン

ステップ1 データベース

ステップ2 myems-api

ステップ3 myems-admin

ステップ4 myems-modbus-tcp

ステップ5 myems-cleaning

ステップ6 myems-normalization

ステップ7 myems-aggregation

ステップ8 myems-web

インストール後

デフォルトポート

デフォルトパスワード

トラブルシューティング