ハイブリッド エージェント PLM と Altium 365 ワークスペースの統合

親ページ: PLM統合

ハイブリッド統合は、Altium 365を使用している企業が、公開IPアドレスを持たず、インターネットに露出していない企業のネットワーク内にホストされているPLMシステムとのワークスペースを統合したい場合に適用されます。

これを実現するために、企業のネットワーク内でHybrid Agentと呼ばれる小さなプログラムが実行されます。このプログラムはAltium 365と通信し、閉じたネットワーク内のAltium 365ワークスペースとPLMシステム間の情報を中継します。ハイブリッドエージェントとの通信はHTTPSを通じて行われ、インターネットからの受信トラフィックのためにネットワークポートを開く必要はありません。アウトバウンドトラフィックのみに標準のHTTPSポート443が必要です。

注意:

  • ハイブリッド統合を使用するには、特別なAltium Workspaceライセンスが必要です。

  • Siemens Teamcenter® PLMとの統合を設定している場合(ハイブリッドエージェントが必要です)、まずSiemens Teamcenterページの追加インストールと設定を参照してください。

ハイブリッド統合の設定

ハイブリッドエージェントのインストールパッケージは、Altium 365 WorkspaceのHybrid Agenページから入手できます。このページは、(新しい)PLM Managementの上部にあるHybrid Agentタブオプションから開けます(Admin – PLM Integration)。

エージェントのアーカイブをダウンロードし()、その内容を既知の場所に解凍してください。それにはJavaアプリケーション(hybrid-agent.jar)が含まれており、社内ネットワーク内のPCで実行する必要があります。そのPCから、オンプレミスのPLMシステムとAltium 365にアクセスできる必要があります。

そのPCはインターネットから公開アクセス可能である必要はありませんが、お使いの会社が使用しているAltium 365環境に接続できる必要があります。

  • ハイブリッドエージェントはPLMシステムをホストしているPC上で実行する必要はありませんが、そのようなセットアップが問題を引き起こすことはありません。

  • ハイブリッドエージェントアプリケーションには、Linuxベースのシステム用の同等のシェルスクリプトファイル(例:agent.sh)が含まれています。下記のエージェントセットアップ手順でWindowsの*.batファイルの代わりに使用してください。

ハイブリッドエージェントは、Java Development Kit(JDK)をバージョン11以上で必要とします。

Hybrid Agentアプリケーションが配置されたら:

  1. Altium 365 WorkspaceのHybrid AgentページでAPIキーを生成します(APIキー生成ボタン)。
  2. HYBRID_AGENT_API_KEY環境変数を作成し、その値としてAPIキーを設定します。
  3. 以下のコマンドコンテキストを使用してagent.batを実行します。URLパラメータ引数はあなたのAltium 365 Workspaceのものであるべきです:
    agent.bat https://acme.365.altium.com

アクティブな場合、Hybrid Agentはアプリケーションのhybrid-agent\logsフォルダにログファイルを生成します。

ワークスペースには、いつでも有効なAPIキーが1つだけ存在し、Hybrid Agentも1インスタンスのみ実行可能であることに注意してください。エージェントは、両方のPLMシステムが同じクローズドネットワーク内にホストされている場合、複数のPLM設定インスタンスをサポートできます。

 

本番環境では、Hybrid Agentをターミナルで直接実行するのではなく、Windowsサービスとして実行することを強く推奨しますが、後者はテスト用に使用できます。

WindowsサービスとしてHybrid Agentを実行する一例として、NSSMサービスマネージャーを使用する方法があります:

  1. コマンドを実行します:nssm install HybridAgent

  2. NSSMダイアログウィンドウ(Applicationタブの下)で、Pathフィールドにagent.batファイルのパスを入力し、ArgumentsフィールドにワークスペースのURLを入力して、Install serviceをクリックします。

    1. NSSMダイアログのDetailsタブの下にあるStartup typeオプションでサービスのスタートアップ動作を設定できます。必要に応じて、nssm edit HybridAgentを実行してそのような変更を行います。

    2. Javaの標準的なPATHおよびJAVA_HOME環境変数を作成する代わりに、NSSMのEnvironmenタブの下に追加することができます。このアプローチを使用すると、変数はHybridAgentサービスが実行されているときにのみアクティブになります。

    3. 上記と同様に、HYBRID_AGENT_API_KEY変数もNSSM環境設定に移動できるので、サービスが実行されているときにアクティブになります。

     

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

  4. WindowsのServices管理ツールでHybridAgentサービスが実行中であることを確認するか、NSSMコマンド:nssm status HybridAgentで確認します。

Hybrid AgentがAltium 365 Workspaceに接続したら(ブラウザウィンドウを更新してその状態を確認してください)、Altium 365 WorkspaceでPLMインテグレーションを設定できます。設定の追加ページで、Hybrid Agent接続オプションを有効にし、閉じたネットワーク内で見られるように、オンプレミスPLMのURLをURLフィールドに入力してください。

ハイブリッドエージェント設定1

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

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

If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.

Source URL: https://www.altium365.com/documentation/hybrid-agent-plm-integration