親ページ: PLM統合
ハイブリッド統合は、Altium 365を使用している企業が、公開IPアドレスを持たず、インターネットに露出していない企業のネットワーク内にホストされているPLMシステムとのワークスペースを統合したい場合に適用されます。
これを実現するために、企業のネットワーク内でHybrid Agentと呼ばれる小さなプログラムが実行されます。このプログラムはAltium 365と通信し、閉じたネットワーク内のAltium 365ワークスペースとPLMシステム間の情報を中継します。ハイブリッドエージェントとの通信はHTTPSを通じて行われ、インターネットからの受信トラフィックのためにネットワークポートを開く必要はありません。アウトバウンドトラフィックのみに標準のHTTPSポート443が必要です。
ハイブリッド統合の設定
ハイブリッドエージェントのインストールパッケージは、Altium 365 WorkspaceのHybrid Agenページから入手できます。このページは、(新しい)PLM Managementの上部にあるHybrid Agentタブオプションから開けます(Admin – PLM Integration)。
エージェントのアーカイブをダウンロードし()、その内容を既知の場所に解凍してください。それにはJavaアプリケーション(hybrid-agent.jar
)が含まれており、社内ネットワーク内のPCで実行する必要があります。そのPCから、オンプレミスのPLMシステムとAltium 365にアクセスできる必要があります。
そのPCはインターネットから公開アクセス可能である必要はありませんが、お使いの会社が使用しているAltium 365環境に接続できる必要があります。
ハイブリッドエージェントは、Java Development Kit(JDK)をバージョン11以上で必要とします。
JDKのインストール
Oracle JDKまたはOpenJDKのどちらかを使用できます。Oracle JDKを使用する場合は、有効なライセンスを持っていることを確認してください。 インストーラー実行ファイルではなく、単純なアーカイブからJDKをインストールする場合、そのパス環境変数を追加する必要があります。Windowsマシン/VMの場合、これらは通常以下の通りです:
-
PATH
– インストールのbin
フォルダを指します。
-
JAVA_HOME
– インストールフォルダ自体を指します。
Java -version
コマンドを実行して、Java実行ファイルへのアクセスをテストします。
Hybrid Agentアプリケーションが配置されたら:
-
Altium 365 WorkspaceのHybrid AgentページでAPIキーを生成します()。
-
HYBRID_AGENT_API_KEY
環境変数を作成し、その値としてAPIキーを設定します。
-
以下のコマンドコンテキストを使用して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サービスマネージャーを使用する方法があります:
-
コマンドを実行します:nssm install HybridAgent
。
-
NSSMダイアログウィンドウ(Applicationタブの下)で、Pathフィールドにagent.bat
ファイルのパスを入力し、ArgumentsフィールドにワークスペースのURLを入力して、Install serviceをクリックします。
-
NSSMダイアログのDetailsタブの下にあるStartup typeオプションでサービスのスタートアップ動作を設定できます。必要に応じて、nssm edit HybridAgent
を実行してそのような変更を行います。
-
Javaの標準的なPATH
およびJAVA_HOME
環境変数を作成する代わりに、NSSMのEnvironmenタブの下に追加することができます。このアプローチを使用すると、変数はHybridAgent
サービスが実行されているときにのみアクティブになります。
-
上記と同様に、HYBRID_AGENT_API_KEY
変数もNSSM環境設定に移動できるので、サービスが実行されているときにアクティブになります。
-
WindowsのServices管理ツールでHybridAgent
サービスを開始するか、NSSMコマンド:nssm start HybridAgent
で開始します。サービスが自動起動に設定されている場合、PCを再起動した後でこれを行う必要はありません。
-
WindowsのServices管理ツールでHybridAgent
サービスが実行中であることを確認するか、NSSMコマンド:nssm status HybridAgent
で確認します。
Hybrid AgentがAltium 365 Workspaceに接続したら(ブラウザウィンドウを更新してその状態を確認してください)、Altium 365 WorkspaceでPLMインテグレーションを設定できます。設定の追加ページで、Hybrid Agent接続オプションを有効にし、閉じたネットワーク内で見られるように、オンプレミスPLMのURLをURLフィールドに入力してください。
現在のAPIキーは、関連するRevokeコマンドを使用してキャンセルできます。その場合、新しいAPIキーを生成し、HYBRID_AGENT_API_KEY
環境変数を新しいキー値で更新する必要があります。
新しいキーを使用するには、Hybrid Agentを再起動してください。NSSMを使用する場合は、nssm restart HybridAgent
コマンドを使用し、またはWindowsのサービスでHybridAgent
サービスを停止/開始してください。