オンプレミスエージェントの設定と管理

オンプレミスエージェントの設定と管理

お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

オンプレミスアプリケーションでワークフローの作成を開始する前に、ローカルマシンにオンプレミスエージェントをインストールする必要があります。

新しいエージェントの作成

エージェントを作成する方法は次の 2 通りあります:

Zoho Flow の設定から:

  1. Zoho Flow アカウントにログインします。
  2. 設定 セクションで Agents をクリックし、作成 をクリックします。



  3. 表示されるダイアログで、お使いのマシンのオペレーティングシステムを選択し、そのアーキテクチャに合ったダウンロードリンクをクリックします。
  4. キーを生成 をクリックして、新しいエージェント用の一意のキーを生成します。表示されるポップアップウィンドウで 承認する をクリックして続行します。



    メモ: インストールキーを作成できるのは、管理者または組織の所有者のみです。キーが作成されると、組織内の他のユーザーも利用できるようになります。
  5. 選択したオペレーティングシステム向けに表示される画面の指示に従って、エージェントをインストールして実行します。
  6. エージェントの設定が完了したら、次へ をクリックします。
  7. 完了 をクリックします。

オンプレミスアプリのトリガーまたはアクションを設定する場合:

フローを設定する際に、トリガーとしてオンプレミスアプリを選択する場合、またはオンプレミスアプリのアクションを選択する場合は、オンプレミスエージェントが必要です。
  1. すでにエージェントを作成済みの場合は、オンプレミスエージェントのドロップダウンからそのエージェントを選択します。



  2. まだエージェントを作成していない場合は、新規をクリックします。
  3. 使用しているマシンのオペレーティングシステムを選択し、そのアーキテクチャに合ったダウンロードリンクをクリックします。
  4. キーを生成をクリックして、新しいエージェント用の一意のキーを生成します。表示されるポップアップウィンドウで承認するをクリックして続行します。
  5. 選択したオペレーティングシステム向けに表示される画面の指示に従って、エージェントをインストールして実行します。
  6. エージェントの設定が完了したら、次へをクリックします。
  7. 認証をクリックします。

システムへのエージェントのインストール

Windows の場合:

Windows オペレーティングシステムには、オンプレミスエージェントをインストールする方法が 2 つあります。

グラフィカルインストーラー
  1. エージェントのダウンロード画面から、システムのアーキテクチャ(32 ビットまたは 64 ビット)に対応したエージェントインストーラーをダウンロードします。インストールキーをコピーします。
  2. ダウンロードが完了したら、インストーラーをダブルクリックしてインストールを開始します。
  3. 求められたら、インストーラーにインストールキーをコピー&ペーストします。
  4. エージェントの名前を入力し、必要に応じてプロキシの詳細を設定します。次へをクリックします。
  5. エージェントをインストールするフォルダーを選択し、次へをクリックします。
  6. インストールが完了したら、完了をクリックします。
  7. Zoho Flow のブラウザー画面に戻り、次へをクリックします。
コマンドラインインストーラー
  1. エージェントのダウンロード画面から、システムのアーキテクチャ(32 ビットまたは 64 ビット)に対応したエージェントインストーラーをダウンロードします。インストールキーをコピーします。
  2. コマンドプロンプトを開きます。
  3. エージェントがダウンロードされたフォルダーを表示するには、そのパスの後に「>dir」を付けて入力します。たとえば、エージェントが c:\Users\Administrator\Documents にダウンロードされている場合は、「c:\Users\Administrator\Documents>dir」と入力し、Enterキーを押します。
  4. もう一度 Enter キーを押し、続けて FlowAgent.exe と入力します。
  5. インストーラーが起動し、エージェントのインストールが開始されます。求められたら、Zoho Flow を実行しているブラウザー画面でコピーしたインストールキーを入力し、エージェントの名前を入力します。
  6. 次へをクリックします。
  7. エージェントをインストールするフォルダーを選択し、次へをクリックします。
  8. インストールが完了したら、「エージェントを開始」のチェックボックスをオンにして、完了をクリックします。
Notesメモ: ファイアウォールで、外向きの連携通信に対してポート 443(HTTPS プロトコル)が有効になっていることを確認してください。設定方法はこちら

MacOS の場合:

  1. エージェントのダウンロード画面から、エージェントをダウンロードします。インストールキーをコピーします。
  2. インストーラーがダウンロードされたフォルダーに移動し、「FlowAgent_mac.zip」という名前の ZIP ファイルを展開します。
  3. FlowAgent をダブルクリックします。
  4. 次のような注意メッセージが表示される場合があります。
  5. MacOS がインストールパッケージを開いて実行できるように許可する必要があります。
  6. システム環境設定 > セキュリティとプライバシー に移動します。一般タブで、「App Store と確認済みの開発元からのアプリケーションを許可」に対して許可をクリックします。
  7. MacOS Ventura を使用している場合、「FlowAgent は確認済みの開発元からのアプリではないためブロックされました」というメッセージが表示されることがあります。開く Anyway をクリックし、続けて開くをクリックして、再度インストールを試行します。
  8. 求められたら、インストーラーにインストールキーをコピー&ペーストします。エージェントの名前を入力し、次へをクリックします。
  9. エージェントをインストールするフォルダーを選択し、次へをクリックします。
  10. 必要に応じて、プロキシサーバーのポート情報と認証情報を設定します。次へをクリックします。
  11. 内容を確認し、Install をクリックします。
  12. インストールが完了したら、完了をクリックします。
  13. ターミナルを開き、<インストール先パス>/FlowAgent/bin と入力します。
  14. sh startagent.sh と入力します。
  15. Zoho Flow を実行しているブラウザー画面に戻ります。
Notes
メモ: ファイアウォールで、外向きの連携通信に対してポート 443(HTTPS プロトコル)が有効になっていることを確認してください。設定方法はこちら

Linux の場合:

グラフィカルインストーラー:

  1. エージェントのダウンロード画面から、エージェントをダウンロードします。インストールキーをコピーします。
  2. ターミナルを開きます。
  3. インストーラーがダウンロードされたパスを入力します。
  4. インストーラーに必要な権限を付与するために、chmod 755 FlowAgent.bin コマンドを入力します。
    メモ: このコマンドにより、次の権限が付与されます。
    > ディレクトリ内のファイルを削除、名前変更、追加できます。
    > ファイルの内容を変更できます。
  5. ./FlowAgent.bin と入力してインストーラーを実行します。
  6. インストーラーのコンポーネントの展開が完了すると、インストールウィンドウが表示されます。求められたら、Zoho Flow からコピーしたインストールキーを貼り付けます。
  7. インストールが完了したら、Zoho Flow に戻り、次へをクリックします。
コマンドラインインストーラー

  1. エージェントのダウンロード画面から、エージェントをダウンロードします。インストールキーをコピーします。
  2. インストーラーが保存されているパスを入力します。
  3. インストーラーに必要な権限を付与するために、chmod 755 FlowAgent.bin コマンドを入力します。
    メモ: このコマンドにより、次の権限が付与されます。
    > ディレクトリ内のファイルを削除、名前変更、追加できます。
    > ファイルの内容を変更できます。
  4. ./FlowAgent.bin と入力してインストーラーを実行します。
  5. 求められたらインストールキーを入力し、エージェントの名前を入力します。
  6. エージェントをインストールするパスを入力します。
  7. 必要に応じて、プロキシの詳細を設定します。
  8. インストール内容を確認し、Enter キーを押して続行します。
  9. インストールが完了したら、Zoho Flow に戻り、次へをクリックします。
Notes
メモ: ファイアウォールで、外向きの連携通信に対してポート 443(HTTPS プロトコル)が有効になっていることを確認してください。設定方法はこちら

ファイアウォールでポートを有効にする

ファイアウォールで、外向きの連携通信に対してポート 443(HTTPS プロトコル)が有効になっていることを確認する必要があります。

ポート 443 の有効化に関する不整合を防ぐため、次のドメインを有効にする必要があります。
flow.zoho.com
us4-dms.zoho.com
us3-dms.zoho.com
accounts.zoho.com
maven.zohodl.com
flow.zoho.eu
eu1-dms.zoho.eu
eu2-dms.zoho.eu
accounts.zoho.eu
maven.zohodl.com
flow.zoho.in
in1-dms.zoho.in
in2-dms.zoho.in
accounts.zoho.in
maven.zohodl.com
flow.zoho.com.cn
cn2-dms.zoho.com.cn
cn3-dms.zoho.com.cn
accounts.zoho.com.cn
maven.zohodl.com
flow.zoho.jp
jp1-dms.zoho.jp
jp2-dms.zoho.jp
accounts.zoho.jp
maven.zohodl.com
flow.zoho.com.au
au1-dms.zoho.com.au
au2-dms.zoho.com.au
accounts.zoho.com.au
maven.zohodl.com
flow.zoho.com.ca
ca1-dms.zohocloud.ca
ca2-dms.zohocloud.ca
accounts.zoho.com.ca
maven.zohodl.com
flow.zoho.com.sa
sa1-dms.zoho.sa
sa2-dms.zoho.sa
accounts.zoho.com.sa
maven.zohodl.com

エージェントの再起動

  1. エージェントの停止

    Windows の場合:

    エージェントを停止するには:
    コマンドプロンプトを開きます。
    <AGENT_HOME>/bin から stopagent.bat を実行します。

    または、サービスアプリで Zoho Flow Agent サービスを探し、[停止] ボタンをクリックすることもできます。



    Mac/Linux の場合:
    ターミナルを開きます。
    <AGENT_HOME>/bin に移動します。
    bash shutdownagent.sh と入力します。

    または、エージェントを実行しているターミナルウィンドウに移動し、Control+C を押してエージェントを停止することもできます。

    エージェントの再起動

    Windows の場合:
    エージェントを再起動するには:
    コマンドプロンプトで <AGENT_HOME>/bin に移動します。
    restartagent.bat と入力します。

    または、サービスアプリで Zoho Flow Agent サービスを探し、[再開] ボタンをクリックすることもできます。



    Mac/Linux の場合:
    エージェントを現在実行しているターミナルに移動します。
    Linux の場合は Ctrl+C、macOS の場合は Control+C を押してエージェントを停止します。
    macOS/Linux の場合は、bash startagent.sh と入力してエージェントを再起動します。

エージェントの更新

オンプレミスアプリのトリガーやアクションを使用するフローを常に安定して実行するために、システムにインストールしたエージェントは常に最新の状態に保つ必要があります。すべてのエージェントで自動更新オプションをオンにしておくことを推奨します。

エージェントをシステムにインストールし終えると、自動更新は初期設定でオンになっています。

エージェントの更新には、次の内容が含まれます。
  1. セキュリティの強化
  2. 新規または更新されたアプリケーションへの追加サポート
  3. バグ修正およびパッチ
自動更新を有効にするには:
  1. 設定セクションで、エージェントに移動します。
  2. 対象のエージェントの横にある詳細を表示をクリックします。



  3. 自動更新のトグルをオンに切り替えます。



エージェントの削除

エージェントを削除すると、Zoho Flow と、そのエージェントがインストールされていたマシンとの間のすべてのデータ連携が停止します。

エージェントを削除するには:
  1. 「設定」セクションで、Agentsに移動します。

  2. 削除」ボタンをクリックします。



  3. エージェントを使用しているすべての外部連携が通知されます。これらを有効のままにしておく必要がないことを確認したら、ごみ箱アイコンをクリックして削除を確定します。

エージェントは、利用不可、クラッシュ、その他の問題などの理由により、応答しない場合があります。その場合は、以下の手順に従ってエージェントを削除してください。

Windows の場合

  1. コントロール パネルを開き、プログラムのアンインストールまたは変更をクリックします。



  2. Zoho Flow On-Prem Agent」を右クリックし、アンインストールをクリックします。

  3. すべてのフォルダーを削除するかどうかを確認するポップアップが表示されます。「OK」をクリックして続行します。

Mac または Linux の場合
  1. ターミナルを開き、エージェントがインストールされているフォルダーに移動します。
  2. rm -rf FlowAgent」と入力して、エージェントを削除します。