運用
ローカル運用
アプライアンスをオンラインに保ちたくない場合でも、同じローカルネットワーク上のブラウザからアプライアンスの IP アドレスまたはホスト名にアクセスして利用できます。
http://<appliance-host>admin ユーザーでログインします。
- ユーザー名:
admin - パスワード: アプライアンスごとに生成された初期 admin パスワード
このパスワードは、インストールの最後に ironflock appliance install がターミナルに 1 回だけ表示します。また、アプライアンスのホスト上の /opt/ironflock/.env に APPLIANCE_ADMIN_PASSWORD として保存されています(このファイルは root のみ読み取れます)。
sudo grep '^APPLIANCE_ADMIN_PASSWORD=' /opt/ironflock/.env初回ログイン後にパスワードを変更してください。
admin パスワードを忘れた場合は、アプライアンスのホストで次のコマンドを実行して新しいパスワードを設定してください:
sudo ironflock appliance reset-admin-passwordアプライアンスが動作している必要があります。コマンドは新しいパスワードを設定し、admin のアクティブなセッションをすべて終了させます。新しいパスワードは 1 回だけ、ターミナルにだけ表示されます。ターミナルがない場合や --json を付けた場合は、代わりにパスワードの保存場所を示します。ironflock appliance reset-admin-password を参照してください。
以前のアプライアンス: インストールが admin パスワードを生成するようになる前にインストールされたアプライアンスでは、パスワードは
ironflockです。このパスワードで初めてログインすると、新しいパスワードの設定を求められます。
アプリの Web UI
接続されたデバイス上のアプリが Web インターフェースを公開すると、アプライアンスは組み込みのトンネルを通じてそれに到達できるようにします。追加設定不要で、企業 IT に依頼するものは何もありません — 各アプリの UI は、アプライアンスのアドレスの自動的に割り当てられたポート上でプレーン HTTP として公開され(http://<appliance-host>:<port>)、IronFlock UI にリンクが表示されます。アクセスは引き続きアプライアンスのログインで保護されます。
共有の企業ネットワークで信頼された https:// URL を利用するには — 自社 CA のワイルドカード証明書や、TLS を終端するリバースプロキシを使って — アプリ UI と HTTPS を参照してください。
アカウントの連携
アプライアンスのプロジェクト設定からチームメンバーをメールで招待して、ローカルユーザーアカウントを作成します。招待メールには、招待されたメンバーに必要なものがすべて含まれています。
- 個人用の接続リンク — このリンクを ironflock.com で開くと、招待されたメンバーの ironflock.com アカウントがアプライアンスに接続されます。ironflock.com アカウントをまだ持っていない場合は、まず招待されたメールアドレスを使用してアカウントを作成します(接続は 2 つのメールアドレスが一致する場合にのみ許可されます)。接続が完了すると、アプライアンスがその方の ironflock.com プロジェクトセレクターに表示され、すぐにリモートで作業を開始できます — 手動でのキー入力もローカルでのサインアップも不要です。
- ローカルサインアップ用リンク — 任意:ローカルサインアップを完了すると、さらにアプライアンス UI(
http://<appliance-host>)に直接ログインできるようになります。
いくつか知っておくべきポイントがあります。
- 既存のローカルユーザーには、プロジェクトオーナーからの新たな招待は不要です。アプライアンス UI でプロフィールを開き、ironflock.comに接続 セクションの 接続リンクをメールで送信 をクリックします。
- 再送について:同じメールアドレスをもう一度招待する(またはプロフィールのボタンを再度クリックする)と、新しい接続リンクが発行されます。有効なのは最新のメールに記載されたリンクのみです。
- アプライアンスがメールを送信できない場合 — たとえばメールリレーがブロックされる制限された企業ネットワーク上など — は、代わりに接続リンクが UI に直接表示されます。招待者がこれをコピーし、任意の手段で相手に渡してください。リンクはインターネットにアクセスできるブラウザで開く必要があります。
- 接続の解除:ユーザーは ironflock.com の プロフィール → インスタンス → 接続済みインスタンス で、いつでも接続を解除できます。最新の接続リンクをもう一度開くと、接続が復元されます。
インスタンスのオーナー — ironflock.com で Instance Key を作成したユーザー — は、自動的にインスタンスのローカル管理者アカウントに接続されます。オーナーに招待は不要です。
オンラインストアからのアプリ同期
Appliance には local App Store — ローカルネットワーク上のデバイスにアプリを提供するプライベートなアプリカタログとコンテナレジストリ — が含まれています。Appliance が同期時にインターネット接続を利用できれば、パブリックのオンライン IronFlock Store からアプリを同期してこの local App Store を構成できます。常時のインターネット接続は不要で、必要なアプリをプルするための一時的な接続で十分です。
前提条件
- パブリックの ironflock.com プラットフォーム上のアカウント。
- アプライアンスのアカウントが ironflock.com アカウントに接続されていること(アカウントの連携 を参照)。インスタンスオーナーの管理者アカウントは自動的に接続されます。
アプリ同期の仕組み
┌────────────────────┐ ┌────────────────────┐
│ Online IronFlock │ ◄──── account ─────► │ Appliance │
│ Store (cloud) │ connection │ local Store │
└────────────────────┘ └────────────────────┘
│ │
apps available to sync button shown
the connected account instead of install- local App Store を開く — Appliance が有効なインターネット接続を持っている場合、App Store には接続済みの ironflock.com アカウントがオンラインプラットフォームで利用可能なすべてのアプリが表示されます。
- 必要なアプリを同期する — 各アプリには Install ボタンの代わりに Sync ボタンが表示されます。クリックすると、コンテナイメージとメタデータを含むアプリがオンラインストアからローカルストアにダウンロードされます。
- デバイスを追加する — 同期が完了すると、アプリはローカルストアで完全に利用可能になり、通常どおりデバイスを追加できます。インターネット接続は不要です。
アップデートのワークフロー
同期済みアプリの新バージョンがオンラインストアに公開されると、そのアプリに再び Sync ボタンが表示されます。Appliance を短時間インターネットに接続して更新後のリリースを同期し、その後、標準のアプリアップグレードフローを通じてデバイスにロールアウトします。
この設計により、ネットワークに入ってくるものを完全に制御できます — 何も自動的にはダウンロードされず、インターネット接続は同期ステップの間だけ必要になります。
メール送信元のカスタマイズ(SMTP)
デフォルトでは、アカウント確認、パスワード復旧、招待、アラーム通知などすべてのプラットフォームメールは IronFlock クラウド SMTP プロキシ経由で送信され、[email protected] として表示されます。メールを御社からの送信として表示したい場合は、アプライアンスを自社の SMTP サーバーに向けることができます。
アプライアンスのホスト上で、アプライアンスの環境ファイル /opt/ironflock/.env を編集し、以下の変数を設定してください。
SMTP_CONNECTION_URI=smtps://USERNAME:[email protected]:465/
SMTP_FROM_ADDRESS=[email protected]
SMTP_FROM_NAME=Your Company- 暗黙的 TLS(通常はポート
465)の場合はsmtps://を、STARTTLS(ポート587)の場合はsmtp://を使用します。 - ユーザー名やパスワード内の特殊文字は URL エンコードしてください(例:
@→%40)。 SMTP_FROM_ADDRESSとSMTP_FROM_NAMEは、受信者が各プラットフォームメールの From ヘッダーで目にする値です。
アプライアンスを再起動して変更を反映します:
sudo ironflock appliance restart再起動後、すべての認証メール、プラットフォーム通知、アラームメールは、御社の送信者アドレスと表示名で自社の SMTP サーバー経由で送信されます。
SMTP_CONNECTION_URIが設定されていない場合、アプライアンスはライセンスキーで認証された IronFlock クラウド SMTP プロキシを引き続き使用してメールを送信します。追加の設定は不要ですが、メールには IronFlock のブランドが表示されます。
メンテナンス
アプライアンスの IronFlock システムを更新するには、新しいバージョンが利用可能になった際に、管理者がプロフィールのライセンスセクションにある更新ボタンを使用できます。アプライアンスのホスト上では、次のコマンドで同じ更新を実行できます:
sudo ironflock appliance updateアプライアンスは更新をダウンロードするためにインターネット接続が必要です。更新が完了すると、IronFlock は自動的に再起動します。
アプライアンスは有効な IronFlock の署名がある更新のみをインストールし、更新が失敗した場合は、それまで動作していたバージョンに戻ります(アップデート と ironflock appliance update を参照)。
更新ボタンも、アプライアンスのホストの /usr/local/bin にある ironflock を実行します。より新しい ironflock を必要とするリリースの場合、更新はまずそれを ironflock self-update と同じチェックを行ってインストールし、それを使って続行します(より新しい ironflock)。リリース 2.2.0 以前の ironflock にはこれができません。インストール用の 1 行を一度実行して、現在のリリースにしてください(2.2.0 以前から)。
Linux OS のアップデートはお客様ご自身で維持・管理してください。
クラウド接続
アプライアンスは ironflock.com へのアウトバウンド接続を 1 本維持しています。この接続を通じて、ironflock.com からインスタンスで作業し(ironflock.com からインスタンスにアクセスする を参照)、アプリのユーザーインターフェースやファイルをリモートで開き、アップデートやライセンスの引き渡しをクラウドから開始できます。アプライアンスに ironflock.com から到達できないようにする場合は、この接続をオフにします。
クラウド接続がオフの間は、次のようになります。
- アプライアンスに ironflock.com から到達できなくなります。ironflock.com のインスタンス一覧には クラウド接続オフ と表示されます。
- ironflock.com を経由した、アプリのユーザーインターフェースおよびファイルへのリモートアクセスは停止します。
- アプライアンスのアップデートとライセンスの引き渡しは、クラウドから開始できません。管理者は引き続きローカルでアプライアンスを更新できます(メンテナンス を参照)。
- 利用状況レポートはアプライアンス上に保持され、接続が再びオンになると送信されます。
- デバイス、ローカル運用、オンラインストアからのアプリ同期、ライセンスの検証は引き続き動作します。
この設定は、再起動後やアプライアンスのアップデート後も維持されます。
アプライアンス上で切り替える
管理者は、アプライアンス UI(http://<appliance-host>)のプロフィールにあるライセンスセクション内の クラウド接続 セクションで、クラウド接続をオン・オフします。切り替えられるのは admin アカウントのみで、ローカルでのみ可能です — ironflock.com からインスタンスで作業している間は切り替えられません。
ironflock.com からオフにする
インスタンスのオーナー — Instance Key を作成した ironflock.com アカウント — は、クラウドからクラウド接続をオフにできます。ironflock.com の プロフィール → インスタンス を開き、対象のインスタンスで クラウド接続をオフにする をクリックします。アプライアンスはオンラインである必要があります。
この操作はクラウドから元に戻せません。接続を再びオンにできるのはアプライアンスの管理者だけで、アプライアンス上でローカルに行う必要があります。
ライセンスのライフサイクル
ライセンスは 1 台の物理アプライアンスに紐付けられます。同じライセンスを、異なるハードウェア上の 2 つ目の IronFlock インスタンスで同時に稼働させることはできません。日常運用ではアプライアンスはオフラインで動作します — 本番データ、ダッシュボード、アプリ管理、エッジデバイス制御はすべてボックス上にローカルで保持されます。
アプライアンスにインターネットが必要なとき
インターネット接続が必要となるのは、以下のタイミングのみです。
- 初回インストールおよびアプライアンスの更新 — いずれにせよ IronFlock の配布サーバーからソフトウェアを取得するために必要であり、ライセンスのアクティベーションも同じステップの中で行われます。
- 定期的なライセンス再チェック — お使いのプランによって異なります。
- 月次ライセンス:30日に 1 回。
- 年次ライセンス:365日に 1 回。
- 永続ライセンス:定期的な再チェックはなし — インターネットはインストール時および更新時にのみ必要です。
- 新しいハードウェアへのライセンスの引き渡し(後述)。
- AI Multi Agent サービス — 実際に利用している間のみ。
グレースピリオドとロック
定期的な再チェックがクラウドに到達できない場合(ネットワーク障害、一時的なクラウド側のエラーなど)、アプライアンスは 7日間のグレースピリオド に入ります。グレースピリオド中、アプライアンスは通常どおり動作し続け、再チェックを自動的にリトライします。
7日間が完全に経過しても再チェックに成功しない場合、アプライアンスは自身をロックします:ほとんどの操作が拒否され、UI 上ではライセンスが無効と表示されます。復旧するには、アプライアンスのインターネット接続を回復したうえで、アプライアンス UI のプロフィールにあるライセンスパネル(ローカルの http://<appliance-host> ビュー、または ironflock.com 経由でアクセスするインスタンス)で「今すぐ再検証」をクリックしてください。
ライセンスを新しいハードウェアへ移行する(引き渡し)
ライセンスは 1 台のマシンのハードウェアフィンガープリントに紐付けられています。別のマシンに移行するには、IronFlock のクラウドプロフィールから引き渡しを開始します。
- ironflock.com の プロフィール → インスタンス を開きます。
- 移行したいインスタンスで「ハードウェアフィンガープリントをリセット」をクリックします。
引き渡しには、現在バインドされているアプライアンスがオンラインであり、そのクラウド接続がオンになっている必要があります。クラウドはそのアプライアンスに接続し直し、ローカルで自身を失効させるよう要求したうえで、はじめてクラウド側のフィンガープリントを解除します。このハンドシェイクにより、新しいアプライアンスがバインドされる間に古いアプライアンスが動作し続けることはできなくなり、同じライセンスが誤って二重利用されることを防ぎます。
ロック解除が成功したら、次の手順を行います。
- インストール の手順に従って、同じインスタンスキーを使用して新しいハードウェアをセットアップします。
- 新しいアプライアンスがライセンスを検証し、自身のフィンガープリントをバインドして、アクティブなデバイスになります。
古いハードウェアが故障またはアクセス不能な場合
以前バインドされていたアプライアンスが停止している、または何らかの理由で到達不能な場合、ハンドシェイクはタイムアウトし、クラウド UI には appliance_unreachable_contact_support と表示されます。その場合は IronFlock チームまでご連絡ください — 所有権を確認のうえ、バインディングを手動で解除いたします。
ヒント:古いハードウェアを廃棄する前に、まだオンラインのうちに引き渡しを実行してください。古いアプライアンスにまだ到達できる状態であれば、お客様にとってもサポートチームにとっても、はるかに迅速に処理できます。