Skip to content

server-setup.md

Latest commit

 

History

History
301 lines (240 loc) · 6.81 KB

server-setup.md

File metadata and controls

301 lines (240 loc) · 6.81 KB

KidsPOS-Server 現場展開ガイド

概要

KidsPOS-Serverを実際の現場環境で展開するための詳細手順です。

事前準備

システム要件

  • ハードウェア: Raspberry Pi 4 (4GB RAM推奨)
  • OS: Raspberry Pi OS (64-bit推奨) または Ubuntu 20.04 LTS for ARM
  • CPU: ARM Cortex-A72 (Raspberry Pi 4)
  • メモリ: 4GB以上推奨
  • ストレージ: 32GB以上のmicroSDカード (Class 10以上)
  • ネットワーク: 無線LAN（イントラネット構成・インターネット接続不要）

必要なソフトウェア

  • Java 11以上 (OpenJDK推奨)
  • Spring Boot アプリケーション
  • SQLite データベース (組み込み)
  • Git

インストール手順

1. Raspberry Pi のセットアップ

# システムの更新
sudo apt update && sudo apt upgrade -y

# 必要なパッケージのインストール
sudo apt install -y git vim curl wget

2. Java のインストール

# OpenJDK 11のインストール
sudo apt install -y openjdk-11-jdk

# バージョン確認
java -version
javac -version

# JAVA_HOME環境変数の設定
echo 'export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-arm64' >> ~/.bashrc
source ~/.bashrc

3. KidsPOS-Server のクローンとビルド

cd /opt
sudo git clone https://github.com/KidsPOSProject/KidsPOS-Server.git
sudo chown -R $USER:$USER KidsPOS-Server
cd KidsPOS-Server

# Gradleでビルド（Gradleが含まれている場合）
./gradlew build

# または、Mavenでビルド（pom.xmlがある場合）
mvn clean package

4. 設定ファイルの設定

# application.propertiesまたはapplication.ymlを編集
cp src/main/resources/application.properties.example src/main/resources/application.properties

application.properties ファイルを編集：

# サーバー設定
server.port=8080
server.address=0.0.0.0

# データベース設定（SQLite組み込みデータベース）
spring.datasource.url=jdbc:sqlite:./kidspos.db
spring.datasource.driver-class-name=org.sqlite.JDBC
spring.jpa.hibernate.ddl-auto=update
spring.jpa.database-platform=org.hibernate.dialect.SQLiteDialect

# ログ設定
logging.level.root=INFO
logging.file.name=logs/kidspos.log

5. サービス化設定

# systemdサービスファイルを作成
sudo tee /etc/systemd/system/kidspos-server.service << 'EOF'
[Unit]
Description=KidsPOS Server
After=network.target

[Service]
Type=simple
User=pi
WorkingDirectory=/opt/KidsPOS-Server
ExecStart=/usr/bin/java -jar target/kidspos-server-*.jar
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

# サービス有効化
sudo systemctl daemon-reload
sudo systemctl enable kidspos-server

現場展開時の確認事項

ネットワーク設定

# 無線LAN設定確認
iwconfig wlan0
ip addr show wlan0

# ポート確認（必要に応じて）
sudo netstat -tlnp | grep :8080

周辺機器設定

# レシートプリンター設定（有線LAN接続）
# プリンターのIPアドレスを確認
nmap -sn 192.168.1.0/24

# CUPS設定（必要に応じて）
sudo apt install -y cups
sudo systemctl enable cups
sudo systemctl start cups

データベース初期化

# SQLiteデータベースファイルは自動で作成される
# データベースファイルの権限確認
ls -la /opt/KidsPOS-Server/kidspos.db

# 必要に応じて権限設定
sudo chown pi:pi /opt/KidsPOS-Server/kidspos.db

起動と動作確認

1. サーバー起動

# systemdサービスで起動
sudo systemctl start kidspos-server

# 自動起動設定
sudo systemctl enable kidspos-server

# 状態確認
sudo systemctl status kidspos-server

2. 動作確認

# プロセス確認
ps aux | grep java

# ログ確認
sudo journalctl -u kidspos-server -f

# ヘルスチェック
curl http://localhost:8080/actuator/health

3. API動作テスト

# 基本APIテスト
curl -X GET http://localhost:8080/api/status
curl -X GET http://localhost:8080/api/version

運用監視

ログ管理

# systemdログの確認
sudo journalctl -u kidspos-server --since "1 hour ago"

# アプリケーションログの確認
tail -f /opt/KidsPOS-Server/logs/kidspos.log

# ログローテーション設定
sudo tee /etc/logrotate.d/kidspos << 'EOF'
/opt/KidsPOS-Server/logs/*.log {
    daily
    rotate 30
    compress
    delaycompress
    missingok
    notifempty
    copytruncate
}
EOF

システム監視

# リソース使用量確認
htop
df -h
free -h

# Raspberry Pi固有の監視
vcgencmd measure_temp  # CPU温度
vcgencmd get_throttled # スロットリング状態

トラブルシューティング

よくある問題

  1. ポート8080が使用中

    sudo lsof -i :8080
# プロセスを確認して必要に応じて停止

  2. Java OutOfMemoryError

    # JVMメモリ設定を調整
# /etc/systemd/system/kidspos-server.service の ExecStart に追加:
# -Xmx1g -Xms512m

  3. データベース接続エラー

    # SQLiteデータベースファイルの権限確認
ls -la /opt/KidsPOS-Server/kidspos.db
sudo chown -R pi:pi /opt/KidsPOS-Server/

  4. 無線LAN接続不安定

    # WiFi省電力モード無効化
sudo tee /etc/systemd/system/wifi-powersave-off.service << 'EOF'

[Unit] Description=Turn off WiFi power saving After=multi-user.target

[Service] Type=oneshot ExecStart=/sbin/iw dev wlan0 set power_save off

[Install] WantedBy=multi-user.target EOF sudo systemctl enable wifi-powersave-off


### ログ確認コマンド
```bash
# アプリケーションログ
tail -f /opt/KidsPOS-Server/logs/kidspos.log

# システムログ
sudo journalctl -u kidspos-server -f
sudo dmesg | tail

緊急時対応

サービス再起動

sudo systemctl restart kidspos-server
sudo systemctl restart networking

バックアップ

# データベースバックアップ（SQLiteの場合）
cp /opt/KidsPOS-Server/kidspos.db /backup/kidspos-$(date +%Y%m%d).db

# アプリケーションコードバックアップ
tar -czf /backup/kidspos-server-$(date +%Y%m%d).tar.gz /opt/KidsPOS-Server

チェックリスト

現場展開時の確認事項：

  • Raspberry Pi 4の動作確認
  • Java 11インストール完了
  • KidsPOS-Serverビルド成功
  • 設定ファイル設定完了
  • 無線LAN接続確認
  • レシートプリンター接続確認
  • ファイアウォール設定
  • サーバー起動確認
  • API動作確認
  • ログ出力確認
  • 監視設定完了
  • バックアップ設定完了
  • 緊急時手順書準備

注意: 本手順はRaspberry Pi + SpringBootを前提としています。実際の現場環境に応じて適宜調整してください。