デバイスの接続

IronFlock は、ハードウェアやオペレーティングシステムに応じて、複数のデバイス接続方法をサポートしています。手元にハードウェアがない場合でも、数分でラップトップ上でデバイスをシミュレートできます。

前提条件

デバイスを接続する前に、以下を確認してください：

IronFlock 上にプロジェクトが作成されていること
プロジェクト内にデバイスエントリが作成されていること（プロジェクトの Settings -> Devices パネルで NEW DEVICE をクリック）
デバイス設定ファイル（.flock）がダウンロード済みであること

制限のある企業ネットワーク上のデバイスですか？ 企業のファイアウォールは、インストール直後の OS に同梱された公開の時刻サーバーを通常ブロックするため、デバイスのクロックは気づかないうちにずれていきます。社内の NTP サーバーを設定してください。時刻同期（NTP）を参照してください。

まずはテスト：ラップトップでデバイスをシミュレート

IronFlock を試すために物理的なハードウェアは必要ありません。FlockFlasher アプリは IronFlock エージェントをラップトップ上で直接実行できるため、ラップトップがプロジェクト内で実際のデバイスになりすまします。実機に展開する前にアプリやダッシュボードをテストするのに最適です。

Docker Desktop（Linux の場合は Docker Engine）をインストールし、起動していることを確認します。
お使いの OS 用の FlockFlasher アプリをダウンロードしてインストールします。
ダウンロード済みのデバイスの .flock ファイルをダブルクリックします。FlockFlasher が開き、デバイスがリストに表示されます。（または、FlockFlasher を開いて + ボタンからファイルを追加することもできます。）
デバイスエントリの Test Device（▶）ボタンをクリックします。FlockFlasher は初回使用時に IronFlock エージェントを自動的にダウンロードし、お使いのデバイス設定で起動します。

これで、ラップトップは IronFlock プロジェクト内でこのデバイスとして動作します。デバイスはオンラインとして表示され、実際のデバイスとまったく同じようにアプリをインストールして実行できます。アプリはラップトップ上で Docker コンテナとして実行されます。

テストが終わったら、FlockFlasher でテストを停止してください。同じ .flock ファイルは、後で実機のプロビジョニングにも使用できます。ただし、同じデバイス設定を実行するマシンは、常に 1 台のみにしてください。

方法1：SD カードのフラッシュ

SD カードからブートする Raspberry Pi やその他の ARM デバイスに最適です。

お使いの OS 用の FlockFlasher アプリをダウンロードします。
SD カード（最低 16 GB）をコンピュータに挿入します。
FlockFlasher を開き、+ ボタンをクリックして .flock ファイルを読み込みます。
SD カードドライブを選択します（FlockFlasher は外部ドライブを自動検出します）。
デバイスに適したイメージを選択します（Raspberry Pi 3/4、Zero など）。
必要に応じて WiFi を設定し、設置先でデバイスが接続できるようにします。
Flash をクリックし、書き込み、検証、設定の完了を待ちます。
SD カードをデバイスに挿入して電源を入れます。

デバイスは 20分以内にオンラインになるはずです。

警告：フラッシュ処理により、選択したドライブのすべてのデータが消去されます。FlockFlasher はデフォルトで内蔵ドライブを非表示にしますが、選択内容を必ず確認してください。

方法2：産業用 PC 向け USB インストーラー

EFI ブート対応の AMD64 デバイス（例：Siemens SIMATIC Box IPC）向け。

USB スティック（最低 16 GB）を挿入し、FlockFlasher を開きます。
.flock ファイルを読み込み、USB ドライブを選択します。
Industrial PC x86_64 (EFI) イメージを選択します。
Flash をクリックし、完了を待ちます。
必要に応じて、デバイスの BIOS でブート順序を USB ブートに変更します。
USB スティックを挿入してデバイスの電源を入れます。

デバイスは 60分以内にオンラインになるはずです。

方法3：カスタムインストール

既存の Linux OS を維持するデバイス向け。NVIDIA Jetson やカスタムハードウェアに最適です。

注意：この手動インストール方法は、産業用 PC、ゲートウェイ、組み込みデバイスなどの実際の本番ハードウェアを対象としており、ラップトップ向けではありません。ラップトップで IronFlock を試したいだけの場合は、代わりにまずはテスト：ラップトップでデバイスをシミュレートに従ってください。手動でのエージェントインストールは不要です。

Linux / Unix デバイス

デバイスに SSH 接続します。
セットアップバイナリをダウンロードします：
```
curl -sSL https://instance-registry.ironflock.com/dl/reswarmify/install.sh | bash
```
IronFlock アプライアンスをお使いですか？ 新しいデバイス ダイアログに表示されるコマンドを使用してください — それらは instance-registry.ironflock.com ではなくアプライアンスを指しています。
.flock ファイルをコンピュータからデバイスにコピーします：
```
scp mydevice.flock user@device-ip:/home/user/
```
エージェントを実行します：
```
sudo ./ironflock-init -c mydevice.flock
```

企業プロキシの背後で運用していますか？ ステップ 2 の前にプロキシをエクスポートしてダウンロードが成功するようにし、ステップ 4 では ironflock-init に --http-proxy / --https-proxy を渡して、Docker エンジンの設定を自動で行わせてください。完全なコマンドと企業 CA の手順については、企業プロキシの背後でを参照してください。

Windows デバイス

デバイスに Docker Desktop をインストールし、Docker Desktop の設定で Start Docker Desktop when you sign in を有効にします。無人運用のデバイスでは、再起動後に誰もサインインしなくても Docker が利用できるよう、Windows の自動サインインも設定してください。
reagent.exe をダウンロードします。
.flock ファイルをデバイスにコピーします。
管理者権限のコマンドプロンプトから、エージェントを Windows サービスとしてインストールして起動します：
```
reagent.exe service install -config path\to\config.flock
```
サービスはすぐに開始され、以降はシステム起動時にも自動的に開始されます。障害時には自動的に再起動し、エージェントを常に最新の状態に保ちます。起動せずにインストールするには -noStart を追加してください。状態はいつでも reagent.exe service status で確認できます。

企業プロキシの背後にいる場合は？ service install コマンドに -proxy http://proxy.example.com:3128 を追加し、Docker Desktop のプロキシは Settings → Resources → Proxies で設定してください。詳細と企業 CA の手順は企業プロキシの背後でをご覧ください。

時刻同期（NTP）

デバイスエージェントには正確なクロックが必要です。プラットフォームとの TLS ハンドシェイク、イメージの取得を認可するトークン、そしてデバイスが publish するすべてのデータポイントのタイムスタンプが、これに依存します。クロックが 15 分以上ずれているデバイスは、ファイルストレージからも CLOCK_SKEW で拒否されます。

企業ネットワークでは、これは当たり前に整っているものではなく、セットアップの一手順です。UDP ポート 123 の外向き NTP はしばしばブロックされており、OS に同梱された公開の時刻サーバーには到達できず、クロックは目に見えるエラーもないままずれていきます。社内の時刻サーバーを情報システム部門に確認してデバイスに設定するか、デバイス用ネットワークについて外向きの UDP 123 を許可してもらってください。

Linux

systemd-timesyncd の場合（Debian と Ubuntu の既定）:


sudo mkdir -p /etc/systemd/timesyncd.conf.d
sudo tee /etc/systemd/timesyncd.conf.d/corporate.conf > /dev/null <<'EOF'
[Time]
NTP=ntp.your-company.com
EOF
sudo systemctl restart systemd-timesyncd
timedatectl status

chrony の場合:


echo "server ntp.your-company.com iburst" | sudo tee -a /etc/chrony/chrony.conf
sudo systemctl restart chrony
chronyc sources

timedatectl status が System clock synchronized: yes と表示する必要があります。

Windows

管理者権限のプロンプトから:


w32tm /config /manualpeerlist:"ntp.your-company.com" /syncfromflags:manual /update
w32tm /resync
w32tm /query /status

出来合いの IronFlock イメージで書き込んだデバイス（方法1 と方法2）は、既定で公開の時刻サーバーと同期します。それがブロックされているネットワークでは、デバイスのサブネットに対して外向きの UDP 123 を許可するか、初回起動後に SSH で上記の Linux と同じ手順で社内の時刻サーバーを設定してください。

接続の確認

接続後、プロジェクトでデバイスのステータスを確認します：

緑のインジケーター — デバイスはオンラインで、IronFlock と通信中です。
赤のインジケーター — デバイスはオフラインです。ネットワーク接続を確認し、エージェントが実行中であることを確認してください。

デバイスマップビューには、プロジェクト内のすべてのデバイスの地理的な位置が表示されます。