ハイブリッドエージェント統合
ハイブリッド統合は、Altium 365 を使用している企業が、自社ネットワーク内のオンプレミス環境でホストされている PLM システム（パブリック IP アドレスを持たず、インターネットに公開されていない）と Workspace を統合したい場合に適用されます。
これを実現するために、Hybrid Agent と呼ばれる小さなプログラムを企業ネットワーク内で実行します。このプログラムは Altium 365 と通信し、Altium 365 Workspace と閉域ネットワーク内の PLM システムの間で情報を中継します。Hybrid Agent との通信は HTTPS 経由で行われ、インターネットからの受信トラフィックのためにネットワークポートを開放する必要はありません。必要なのは送信トラフィック用の標準 HTTPS ポート 443 のみです。
Hybrid Integration のセットアップ
Agent アーカイブ（
）をダウンロードし、その内容を既知の場所に展開します。これには Java アプリケーション（hybrid-agent.jar）が含まれており、オンプレミスの PLM システムと Altium 365 の両方に到達可能な企業ネットワーク内のマシンで実行する必要があります。
そのマシンはnot インターネットからパブリックにアクセス可能である必要はありませんが、会社で使用している Altium 365 環境に接続できる必要があります。
Hybrid Agent には、バージョン 11 以上の Java Development Kit（JDK）が必要です。
Installing JDK
Oracle JDK または OpenJDK のいずれも使用できます。Oracle JDK を使用する場合は、有効なライセンスを保有していることを確認してください。
JDK をインストーラー実行ファイルではなくプレーンなアーカイブからインストールする場合は、そのパス環境変数を追加する必要があります。Windows マシン/VM では通常、次のとおりです。
-
PATH– インストール先のbinフォルダーを指します。 -
JAVA_HOME– インストールフォルダー自体を指します。
Java -version コマンドを実行して、Java 実行ファイルにアクセスできることを確認します。
Hybrid Agent アプリケーションを配置したら、次を実行します。
-
Altium 365 Workspace の Hybrid Agent ページ（
）で API キーを生成します。
-
値として API キーを設定した
HYBRID_AGENT_API_KEY環境変数を作成します。 -
次のコマンドコンテキストを使用して
agent.batを実行します。URL パラメーター引数には、使用している Altium 365 Workspace の URL を指定してください。
agent.bat https://acme.365.altium.com
アクティブになると、Hybrid Agent はアプリケーションの hybrid-agent\logs フォルダーにログファイルを生成します。
本番環境では、Hybrid Agent をターミナルから直接実行するのではなく、Windows service として実行することを強く推奨します。ただし、後者はテスト目的で使用できます。
NSSM サービスマネージャーを使用して Hybrid Agent を Windows サービスとして実行する方法の一例を示します。
-
コマンド
nssm install HybridAgentを実行します。 -
NSSM ダイアログウィンドウの Application タブで、Path フィールドに
agent.batファイルパスを、Arguments フィールドに Workspace URL を入力し、Install service をクリックします。-
NSSM ダイアログの Details タブにある Startup type オプションで、サービスの起動動作を設定できます。必要に応じて、変更を行うために
nssm edit HybridAgentを実行してください。 -
Java 用の標準的な
PATHおよびJAVA_HOME環境変数を作成する代わりに、それらを NSSM の Environment タブで追加することもできます。この方法では、変数はHybridAgentサービスの実行中のみ有効になります。 -
同様に、
HYBRID_AGENT_API_KEY変数も NSSM の環境設定に移動でき、サービス実行中に有効になります。
-
NSSM ダイアログの Details タブにある Startup type オプションで、サービスの起動動作を設定できます。必要に応じて、変更を行うために
-
Windows の Services 管理ツール、または NSSM コマンド
nssm start HybridAgentを使用してHybridAgentサービスを開始します。サービスが自動起動に設定されている場合は、PC 再起動後にこれは不要です。 -
Windows の Services 管理ツール、または NSSM コマンド
nssm status HybridAgentを使用して、HybridAgentサービスが実行中であることを確認します。
Hybrid Agent が Altium 365 Workspace に接続したら（状態を確認するにはブラウザーウィンドウを更新してください）、Altium 365 Workspace で PLM Integration の設定に進むことができます。Add Configuration ページで Hybrid Agent 接続オプションを有効にし、URL フィールドに、閉域ネットワーク内から見たオンプレミス PLM の URL を入力します。
AI で翻訳