ハイブリッドエージェントの統合

概略

オンプレミスのPLMシステムをインターネットに公開したり、受信トラフィック用のポートを開放したりすることなく、Altium 365 Workspaceに接続できます。この記事では、Hybrid Agentが送信HTTPS通信を介して情報を中継する仕組みを説明し、要件、インストール、設定から、エージェントをWindowsサービスとして実行する方法までを順を追って解説します。ハイブリッドPLM連携の構築に向けた次のステップとして、ぜひお読みください。

- Hybrid Agentのライセンス、Java、ネットワークの要件を把握できます。
- APIキーの生成、エージェントの起動、WorkspaceでのPLM接続の設定方法を学べます。
- エージェントをWindowsサービスとして実行する方法や、新しいAPIキーを使用するための更新手順を確認できます。
AIでさらに深掘り:

ハイブリッド統合は、Altium 365を使用している企業が、社内ネットワーク内のオンプレミス環境でホストされているPLMシステムとWorkspaceを統合する場合に適用されます。このPLMシステムにはパブリックIPアドレスがなく、インターネットには公開されていません。

これを実現するために、Hybrid Agentという小さなプログラムを社内ネットワーク内で実行します。このプログラムはAltium 365と通信し、Altium 365 Workspaceと閉域ネットワーク内のPLMシステムとの間で情報を中継します。Hybrid Agentとの通信にはHTTPSを使用するため、インターネットからの受信トラフィック用にネットワークポートを開放する必要はありません。標準のHTTPSポート443は、送信トラフィックにのみ必要です。

Note:

ハイブリッド統合のセットアップ

エージェントのアーカイブ()をダウンロードし、その内容を任意の場所に展開します。このアーカイブにはJavaアプリケーション(hybrid-agent.jar)が含まれています。このアプリケーションは、社内ネットワーク内にあり、オンプレミスのPLMシステムとAltium 365の両方にアクセスできるマシン上で実行する必要があります。

このマシンは、インターネットからパブリックにアクセスできる必要はnot ありませんが、会社が使用しているAltium 365環境には接続できる必要があります。

  • Hybrid Agentは、PLMシステムをホストしているマシン上で実行する必要はnotありません。ただし、そのような構成でも問題はありません。
  • Hybrid Agentアプリケーションには、Linuxベースのシステム向けに同等のシェルスクリプトファイル(agent.shなど)が含まれています。以下のエージェントのセットアップ手順では、Windows用の*.batファイルの代わりにこれらを使用してください。

Hybrid Agentのバージョン5以前では、Java Development Kit(JDK)バージョン11以降が必要です。バージョン6(2026年7月6日リリース)以降では、Hybrid AgentにJDKバージョン17以降が必要です。

Altium 365 Workspaceは、Hybrid Agentのバージョン5と6の両方をサポートしています。そのため、Hybrid Agentのバージョン5がすでにインストールされている場合、バージョン6にアップグレードする必要はありません。

Hybrid Agentアプリケーションを配置したら、次の手順を実行します。

  1. Altium 365 WorkspaceのHybrid Agentページ()でAPIキーを生成します。
  2. APIキーを値とするHYBRID_AGENT_API_KEY環境変数を作成します。
  3. 次のコマンド形式でagent.batを実行します。URLパラメーターの引数には、Altium 365 WorkspaceのURLを指定してください。
    agent.bat https://acme.365.altium.com

Hybrid Agentは、稼働中にアプリケーションのhybrid-agent\logsフォルダー内にログファイルを生成します。

Workspaceで同時に有効にできるAPIキーは1つだけであり、実行できるHybrid Agentのインスタンスも1つだけです。両方のPLMシステムが同じ閉域ネットワーク内でホストされている場合、エージェントは複数のPLM構成インスタンスをサポートします。

本番環境では、Hybrid Agentをターミナルで直接実行するのではなく、Windowsサービスとして実行することを強くお勧めします。ただし、テストではターミナルで直接実行してもかまいません。

NSSMサービスマネージャーを使用して、Hybrid AgentをWindowsサービスとして実行する手順の例を以下に示します。

  1. 次のコマンドを実行します:nssm install HybridAgent。
  2. NSSMダイアログウィンドウのApplicationタブで、agent.batファイルのパスをPathフィールドに、WorkspaceのURLをArgumentsフィールドに入力し、Install serviceをクリックします。
    1. NSSMダイアログのDetailsタブにあるStartup typeオプションで、サービスの起動動作を設定できます。必要に応じて、nssm edit HybridAgentを実行して変更してください。
    2. Java用の標準のPATHおよびJAVA_HOME環境変数を作成する代わりに、NSSMのEnvironmentタブで追加することもできます。この方法では、HybridAgentサービスの実行中にのみ変数が有効になります。
    3. 同様に、HYBRID_AGENT_API_KEY変数もNSSMの環境設定に移して、サービスの実行中に有効になるようにできます。

  3. WindowsのServices管理ツール、またはNSSMコマンド:nssm start HybridAgentを使用して、HybridAgentサービスを開始します。サービスが自動起動に設定されている場合は、PCの再起動後にこの操作を行う必要はありません。
  4. WindowsのServices管理ツール、またはNSSMコマンド:nssm status HybridAgentを使用して、HybridAgentサービスが実行されていることを確認します。

Hybrid AgentがAltium 365 Workspaceに接続されたら(ブラウザーウィンドウを更新してステータスを確認してください)、Altium 365 WorkspaceでPLM統合の設定に進むことができます。Add ConfigurationページでHybrid Agent接続オプションを有効にし、URLフィールドに、閉域ネットワーク内からアクセスする際のオンプレミスPLMのURLを入力します。

 

現在のAPIキーは、対応するRevokeコマンドを使用して無効にできます。その場合は、新しいAPIキーを生成し、HYBRID_AGENT_API_KEY環境変数を新しいキーの値で更新する必要があります。

新しいキーを使用するには、Hybrid Agentを再起動します。NSSMではnssm restart HybridAgentコマンドを使用するか、WindowsのServicesでHybridAgentサービスを停止してから開始してください。

AI-LocalizedAI で翻訳
問題が見つかった場合、文字/画像を選択し、Ctrl + Enter キーを押してフィードバックをお送りください。
Contents
機能の提供状況

ご利用可能な機能は、お使いのAltiumソリューション(Altium Develop、Altium Agile Teams、Altium Agile Enterprise、または有効な契約期間中のAltium Designer)によって異なります。

実際にお使いのソフトウェアに文書化されている機能が表示されない場合は、詳細についてAltium Sales までお問い合わせください。