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 は、以下のサービスとの通信に暗号化されていないチャネル（SOAP over HTTP）を使用します。

• 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 パネル（Window's 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 options を -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 パラメーター値を確認して、変更が適用されていることを検証します。