IT部門向け情報

Altium On-Prem Enterprise Server および関連サービスのインストールと使用方法については、本ドキュメントサイト内の他ページで詳述していますが、このページの目的は、組織の IT 部門向けに単一の詳細リソースを提供することです。この技術に関してよくある質問への回答を得るための場所であり、例えば次のような内容を含みます。

• What are the hardware requirements to install the Enterprise Server?

• What is installed?

• What programs and processes are running?

• Where is the data stored?

• What ports are used?

• What protocol is used for communications?

• How is data backed up?

以降のセクションでは、これらを含む各種質問に対する詳細な回答に加え、アーキテクチャとデータフローの概要（ハイレベル）も提供します。

IIS 構成

IIS 構成の一環として、ISAPI Extensions 機能が有効化されます。この機能は、Windows Features ダイアログの \Internet Information Services\World Wide Web Services\Application Development Features セクションにあります。このダイアログは Windows の Programs and Features ウィンドウからアクセスします。

Enterprise Server のインストールにより、IIS 構成の一部である Windows の ISAPI Extensions 機能が有効になります。

HTTPS プロトコルのサポート

Enterprise Server は、データのプライバシーと完全性を保護するために、HTTPS プロトコルを使用したネットワーク上の安全な通信を提供します。

証明書の構成

新規インストールの場合、Enterprise Server は IIS で生成・構成された自己署名証明書を提供します。セキュリティ上の理由から、（標準/推奨のツールを使用して）独自の証明書を生成し、その証明書を IIS で構成することを推奨します。証明書要求を作成して VeriSign や GeoTrust などの既知の認証局（CA）に送信するか、イントラネット ドメイン内のオンライン CA から証明書を取得できます。詳細は Microsoft ドキュメントの How to Set Up SSL on IIS 7 or later ページを参照してください。

HTTPS の構成

Enterprise Server の構成およびサーバー バインディングは、Windows の Internet Information Services (IIS) Manager パネル（Administration Tools ウィンドウ（Control Panel\System and Security\Administrative Tools）から利用可能）からアクセスできます。パネルの Connections リストで「Altium On-Prem Enterprise Server」エントリを選択し、Features View タブを選びます。

Enterprise Server の構成およびサーバー バインディング設定にアクセスします。

Enterprise Server で利用可能なポートとサーバー名は、Actions ペインに選択可能なリンクとして表示されます。リンクを使用してサーバー接続プロトコルを確認・テストするか、ペインの Edit Site セクションにある Bindings リンクを選択して、現在の名前/ポートのバインディングにアクセスします。

プロトコルのポート番号を含むバインディングは、Edit ボタンから Site Bindings ダイアログで編集できます。

Site Bindings ダイアログでバインディングを構成します。

サーバー名 localhost はローカル マシンにのみ適用されるため、Enterprise Server をホストしている PC 以外の PC から接続する場合は、そのホスト マシンの実際の（サーバー）名を使用する必要があります。other

Enterprise Server がインストールされ稼働しているホスト PC の名前を確認するには、そのマシンで Control Panel\System and Security\System を開き、Computer name と Full computer name（完全修飾ドメイン名）の両方を確認してください。後者が、Enterprise Server がネットワーク上で安全な接続を行う際に使用する名前になります。

Enterprise Server のサイト バインディングを編集して既定値とは異なるポート番号を使用するようにした場合、その変更は Enterprise Server の LocalVault.ini ファイルにも反映する必要があります。これは、Altium Designer から Enterprise Server へ接続する際に、ポート参照がこのファイルから取得されるためです。LocalVault.ini ファイルは Enterprise Server インストールのルート フォルダー（通常は Program Files (x86)\Altium\Altium365）にあります。

例えば、Enterprise Server のサイト バインディングを変更して HTTPS 接続に標準の 443 ポートを使用するようにした場合、LocalVault.ini ファイル内の該当する HttpsPort=9785 行を HttpsPort=443 に更新します。

サイト バインディングを再構成する場合

Enterprise Server に新しい IIS サイト バインディングを追加した、または既存のサイト バインディング エントリを編集した（上記参照）場合、新しい構成を正しく確立するためにサーバー PC を再起動する必要があります。典型的なサイト バインディングの変更としては、ホスト エントリのポート番号の編集、またはドメイン エイリアス用の新しいバインディングの追加などがあります。

サーバー ホスト マシンの再起動が現実的でない場合の代替手順は、IIS プラットフォーム上のサーバー サービス（Manage Website 配下の Restart）を再起動し、さらに Altium DXP App Server Pinger サービス（Windows サービス）も再起動することです。

HTTPS 経由でのアクセス

Enterprise Server への安全な接続を確立するには、次のとおりです。

• Altium Designer から – HTTPS プレフィックス付きのサーバー アドレスと、構成済みの HTTPS ポートを使用します。既定では https://<computername>:9785 です（[computername] はホスト マシンのコンピューター名または完全修飾ドメイン名）。

  Altium Designer には、介入なしで Enterprise Server への HTTPS 接続を受け入れるために必要なセキュリティ サポートが含まれています。

• ブラウザーから – ホスト コンピューター名サービスのアドレス（https://<computername>:9785）を入力します。

  Enterprise Server 用に生成された自己署名の Identity Certificate を保持することを選択した場合、ブラウザーは接続が安全/プライベートではないと警告します。続行するには、ブラウザー側で受け入れることを選択できます。一部のブラウザー（例: Firefox）では、以後の操作が不要になるよう証明書を恒久的に受け入れるオプションが提供されています。

ネットワーク

既定のポート

Enterprise Server では、次の既定の通信ポート番号が使用されます。

• HTTP Port – 9780

• HTTPS Port – 9785

• LDAP Synchronisation Service Port – 9791

• Websocket Port – 4649

  /websocket/WebService.asmx は API 呼び出し用の HTTP SOAP エンドポイントであるため、他の API エンドポイントと同様に HTTPS ポート（既定では 9785）を使用します。

• Firebird Server Port – 3050

• SVN Port – 3690

• Elasticsearch Ports – 9200 および 9300

リストの最初の 3 つは、初回インストール時にインストーラーの Altium On-Prem Enterprise Server Configuration ページで構成できます。

ポートを選択する際は、他のアプリケーションで使用されている ポート と競合しないことに注意してください。ポートが現在使用中の場合、インストーラーから通知されます。

Altium Design ソフトウェアのポートおよび IP アドレス に関する情報を参照してください。

サービス間通信に使用されるプロトコル

HTTP 上の SOAP。

データ ストレージ

既定のインストール パス

Enterprise Server のインストール時に使用される既定のインストール パスは次のとおりです。

• Enterprise Server Installation Folder – \Program Files (x86)\Altium\Altium365.

• Firebird Installation Folder – \Program Files\Firebird\Firebird_3_0.

• Firebird Database – \ProgramData\Altium\Altium365Data\DXPSERVER.DAT.

• Revision Files Folder – \ProgramData\Altium\Altium365Data\Revisions.

• Search Index Data Folder – \ProgramData\Altium\Altium365Data\SearchData.

ローカル SVN デザイン リポジトリ – ストレージ

ローカル Version Control Service を通じて作成されたデザイン リポジトリは、その内部データを \ProgramData\Altium\Altium365Data\Repository フォルダー内の対応するサブフォルダーに保存します（Enterprise Server の既定インストールの場合）。

サービスアーキテクチャ – 概要

Enterprise Serverは、複数のコアサービスに加え、ブラウザベースの管理コンソール、および（同じくブラウザベースの）Explorerをインストールします。これらのサービスのいずれかにアクセスするには、ユーザーのIDが認識され、認証される必要があります。Enterprise Serverには、事前定義されたユーザーが1名含まれています（Username: admin、Password: admin）。Enterprise Server WorkspaceのブラウザベースインターフェースにあるUsersページを使用して、ユーザーの追加および管理ができます。Enterprise Serverに登録してアクセス・利用できるユーザー数に上限はありませんが、同時接続数には、必要なライセンスによって決定・適用される上限があります。

Altium Designerは、以下のサービスとの通信に暗号化されていないチャネル（HTTP上のSOAP）を使用します：

• Applications Registry Service（Network Installation Serviceを拡張機能／更新の配布元として使用している場合）

• Collaboration Service

• Comments Service

• Data Acquisition Service

• Data Storage Service (DSS)

• Identity Service (IDS)

• Notifications Service

• Part Catalog Service

• Projects Service

• Simple Lock Service (SLS)

• SVN（SVN://プロトコル経由）

• Tasks Service

• Team Configuration Service (TC2)

• Vault Service

その他のすべてのサービスは、相互に通信します。

大半のサービスは、同一のEnterprise Serverデータベースにアクセスして、各サービスに該当するデータを保存する必要があります。以下は、これらのサービスの一部が保存するデータの例です：

• Part Catalog Service – サプライヤーおよびメーカーのアイテム、価格と数量の履歴変更などを保存します...

• Identity Service – ユーザー、グループ、ライセンス設定、セッション情報を保存します。

• Vault Service – 構造（フォルダ、アイテム、リビジョン、コンテンツタイプ、ライフサイクル状態など）を保存します。

実際のドキュメントは、ファイルシステム上のRevisionsフォルダ（\ProgramData\Altium\Altium365Data\Revisions）に保存されます。

以下のブラウザベースアプリケーションは、SOAP APIを使用して該当サービスと通信します。これらはEnterprise Serverデータベースへのアクセスを必要とせず、動作に追加ファイルも不要です：

• User Management – Enterprise Server WorkspaceのブラウザインターフェースにおけるUsersページおよびサブページの背後にあるアプリケーション。

• Vault Explorer – Enterprise Server WorkspaceのブラウザインターフェースにおけるExplorerページの背後にあるアプリケーション。

• Catalog Management – Enterprise Server WorkspaceのブラウザインターフェースにおけるPart Providersページの背後にあるアプリケーション。

• Projects Management – Enterprise Server WorkspaceのブラウザインターフェースにおけるProjectsページの背後にあるアプリケーション。

• TC2 Console – Enterprise Server WorkspaceのブラウザインターフェースにおけるConfigurationsページの背後にあるアプリケーション。

運用

サーバーデータのバックアップ／復元

Enterprise Serverデータのバックアップと復元は、専用のBackup & Restore Toolを使用し、コマンドラインから自動化された形で実行します。このツール（avbackup.exe）は、（Enterprise Serverのデフォルトインストールでは）\Program Files (x86)\Altium\Altium365\Tools\BackupTool\フォルダにあります。

詳細は、 Backing up & Restoring Your Installationページを参照してください。

データ移行後のサーバーコンテンツの再インデックス

たとえばデータ移行後にEnterprise Serverコンテンツを再インデックスするには、次の手順を実行します：

1. Enterprise Serverに関連付けられているすべてのIISアプリケーションプールを停止します。

2. Elasticsearch (AltiumElasticSearch)サービスを停止します。これはWindows Servicesパネル（WindowsのAdministrative Toolsウィンドウからアクセス）で実行します。

3. 検索インデックスデータを含むSearchDataフォルダの内容を削除します（デフォルトインストールでは\ProgramData\Altium\Altium365Data\SearchData）。

4. Elasticsearch (AltiumElasticSearch)サービスを再起動します。

5. Enterprise Serverに関連付けられているIISアプリケーションプールを再起動します。

SearchDataフォルダが空であることを検出すると、Enterprise Serverは起動後にコンテンツを再インデックスします。

Javaヒープサイズの増加

Javaヒープサイズが不足すると、コンポーネント検索インデックスが破損し、Altium Designerからコンポーネントデータを利用できなくなる場合があります。検索インデックスに問題がある場合（Health Monitor Status ReportのログにSearchService Schema not found: 'vault1ex2_04エラーがある場合）、Javaヒープサイズの増加を検討してください。

現在のJava ヒープサイズは、Enterprise Serverをホストしているマシンでhttp://localhost:9200/_cat/nodes?h=heap*&vを開くことで確認できます。heap.maxの値が約1 GBであれば、以下の手順に従ってこの値を増やしてください。

1. 管理者モードでコマンドプロンプトを実行します。

2. 次のプロンプトを実行します：

   "C:\Program Files (x86)\Altium\Altium365\Services\ElasticSearch\bin\service-nexus-server.bat" manager AltiumElasticsearch

3. 開いたダイアログのJavaタブで、次の変更を行います：

   • Java Optionsフィールドで、-Xms1gを-Xms4gに更新し、-Xmx1gを-Xmx4gに更新します。

   • Initial memory poolおよびMaximum memory poolフィールドの値を4096に更新します。

   Javaヒープサイズを4 GB以外の値に増やす場合は、上記オプションをそれに応じて変更してください（例：サイズを6 GBに増やす場合、Javaオプションを-Xms6gおよび -Xmx6g に更新し、Initial memory poolおよびMaximum memory poolに対して6144を指定します）。

   

4. ダイアログでApplyとOKをクリックします。

5. Windows Servicesパネル（Windowsの Administrative Toolsウィンドウからアクセス）で、AltiumElasticsearch サービスを再起動します。

6. http://localhost:9200/_cat/nodes?h=heap*&v を開き、heap.maxパラメータ値を確認して、変更が適用されていることを検証します。