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

  LDAP Service Port は、実際には使用されません。標準 LDAP（URL が ldap://）の場合は、この URL のポートが使用されます。セキュア LDAP（URL が ldaps://）の場合は、ポート 636 が使用されます。

• 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。

AltiumLive Identity サブシステムへの接続

AltiumLive Identity サブシステムへの接続は既定で HTTPS 経由で行われ、（既定のインストールでは C:\Program Files (x86)\Altium\Altium365 フォルダーにある）LocalVault.ini ファイル内の IdentityCloudServiceUrl エントリは、既定で https://ids.api.altium.com/ids?cls=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。

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

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 ページの背後にあるアプリケーション。

Operations

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

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 および -Xmx1g エントリを削除します。

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

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

   

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

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

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