FreeBSD

このガイドでは、FreeBSDサーバー上でMyEMSをデプロイします。

前提条件

このガイドでは、FreeBSD 13.2にMyEMSをインストールする方法を説明します。ハードウェア要件は、選択するデータベースとシステムに接続するデバイスの数によって異なります。MyEMSとMySQLを単一マシンで実行するには、少なくとも8GBのRAMが必要です。

システムを更新し、ツールをインストール：

pkg install git

pkg install python3

pkg install py39-pip-22.3.1

pkg install nginx

pkg install monit

ソースコードをクローン：

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

ステップ1 データベース

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

ステップ2 myems-api

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

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

cd /myems-api

pip install -r requirements.txt

ヒント

'Failed building wheel for pillow'エラーが発生した場合、Pillowのインストールが必要です。

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

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

nano /myems-api/.env

monit監視サービスを使用し、monit設定ファイルを編集：

nano /etc/monit.d/myems-api
check process mymes-api with pidfile /var/run/myems-api/pid
start program = "/usr/local/bin/gunicorn -b 0.0.0.0:8000 --pid /var/run/myems-api/pid --timeout 600 --workers=4 app:api &"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

サービスを開始：

monit restart

ステップ3 myems-admin

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

http://nginx.org/en/docs/install.html を参照してください。

nginxサービスを有効化：

service nginx enable

NGINXを設定

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;
    ...

}

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

nano /etc/nginx/conf.d/myems-admin.conf

以下のディレクティブで書き込みます。myems-apiサービスが別のサーバーでホストされている場合は、デフォルトのmyems-api URL http://127.0.0.1:8000/ を実際のURLに置き換えてください。

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を追加します。
    ## myems-apiサービスが別のサーバーでホストされている場合は、デフォルトのmyems-api URL 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をインストール：サーバーがインターネットに接続できない場合、myems/myems-adminフォルダを圧縮してサーバーにアップロードし、~/myems/myems-adminに展開してください。

mkdir /var/www

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

chmod 0755 /var/www/myems-admin

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

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

注意

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

 /var/www/myems-admin/upload

nginxサービスを再起動：

service nginx restart

ステップ4 myems-modbus-tcp

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

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

cd /myems-modbus-tcp

pip install -r requirements.txt

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

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

nano /myems-modbus-tcp/.env

monit監視サービスを使用し、monit設定ファイルを編集：

nano /etc/monit.d/myems-modbus-tcp
check file myems-modbus-tcp path /myems-modbus-tcp/main.py
start program = "/usr/local/bin/python3 /myems-modbus-tcp/main.py"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

サービスを開始：

monit restart

ステップ5 myems-cleaning

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

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

cd /myems-cleaning

pip install -r requirements.txt

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

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

nano /myems-cleaning/.env

monit監視サービスを使用し、monit設定ファイルを編集：

nano /etc/monit.d/myems-cleaning
check file myems-cleaning path /myems-cleaning/main.py
start program = "/usr/local/bin/python3 /myems-cleaning/main.py"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

サービスを開始：

monit restart

ステップ6 myems-normalization

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

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

cd /myems-normalization

pip install -r requirements.txt

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

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

nano /myems-normalization/.env

monit監視サービスを使用し、monit設定ファイルを編集：

nano /etc/monit.d/myems-normalization
check file myems-normalization path /myems-normalization/main.py
start program = "/usr/local/bin/python3 /myems-normalization/main.py"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

サービスを開始：

monit restart

ステップ7 myems-aggregation

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

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

cd /myems-aggregation

pip install -r requirements.txt

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

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

nano /myems-aggregation/.env

monit監視サービスを使用し、monit設定ファイルを編集：

nano /etc/monit.d/myems-aggregation
check file myems-aggregation path /myems-aggregation/main.py
start program = "/usr/local/bin/python3 /myems-aggregation/main.py"
stop program = "/bin/kill -s TERM $MAINPID"
if 3 restarts within 5 cycles then unmonitor

サービスを開始：

monit restart

ステップ8 myems-web

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

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

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を追加します。
    ## myems-apiサービスが別のサーバーでホストされている場合は、デフォルトのmyems-api URL 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 Web UIをインストール：

NodeJSをセットアップ：

pkg install node-18.16.0

config.jsファイルを変更：

注釈

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

cd ~/myems/myems-web

nano src/config.js

ビルド：

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

npm run build

インストール：以下のパスは、nginx.confで設定されたパスと同じである必要があります。

rm -r /var/www/myems-web

mv build  /var/www/myems-web

nginxサービスを再起動：

service nginx restart

インストール後

おめでとうございます！これで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

インストール後

デフォルトポート

デフォルトパスワード

トラブルシューティング