IT部門向け情報

Parent page: 高度なトピック

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?

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

ハードウェア要件

Enterprise Server は、以下の公式サポート対象OSのいずれかを実行しているPCにインストールする必要があります。

• Windows Server 2022 Standard Edition (64-bit)
• Windows Server 2019 Standard Edition (64-bit)
• Windows Server 2016 Standard Edition (64-bit)

Altium Designer  要件

インストール & その他のソフトウェア

アンチウイルスソフトの予測不能な挙動が確認されているため、Enterprise Server のインストール中は当該ソフトウェアを無効化することを推奨します。

コンピューターで Microsoft Exchange Server も稼働している場合、初回ログイン時に HTTP Error 503 が発生することがあります。Exchange Server のインストールにより、Internet Information Services（IIS）の構成が Enterprise Server と競合する形で変更される場合があります。これを解決するには、applicationHost.config ファイルに対して次の変更を行う必要があります。

<handlers accessPolicy="Read, Script">
...

<add name="kerbauth" image="C:\Program Files\Microsoft\Exchange Server\V15\Bin\kerbauth.dll" preCondition="bitness64" />
<add name="WSMan" image="C:\Windows\system32\wsmsvc.dll" preCondition="bitness64" />
<add name="exppw" image="C:\Program Files\Microsoft\Exchange Server\V15\ClientAccess\Owa\auth\exppw.dll" preCondition="bitness64" />
<add name="cafe_exppw" image="C:\Program Files\Microsoft\Exchange Server\V15\FrontEnd\HttpProxy\bin\exppw.dll" preCondition="bitness64" />

...
</handlers>

追加でインストールまたは構成されるソフトウェア

• Internet Information Services（IIS）。正しく動作させるため、Enterprise Server には少なくともバージョン 8.0（IIS 8.0）のインストールが必要です。Enterprise Server のインストールでは、OSにネイティブな IIS バージョンがそのままインストールされます。
  • IIS 10.0 – Windows Server 2022 Standard Edition (64-bit)、Windows Server 2019 Standard Edition (64-bit)、Windows Server 2016 Standard Edition (64-bit)、Windows 10 (64-bit)
  • IIS 8.5 – Windows 8.1 (64-bit)
• Firebird 3.0 データベースエンジン（Firebird データベースを使用してインストールするオプションを選択した場合）。IPv4 のネットワークアドレッシングが有効になっていることを確認してください。アクティブな IPv4 アドレスを確認するには、コマンドプロンプトで ipconfig /all  を実行します。
• Microsoft .NET 6 ソフトウェアプラットフォーム（.NET Runtime、.NET Server Hosting、ASP.NET Framework コンポーネントを含む）。

IIS 構成

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

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

既定のインストールパス

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

• Enterprise Server Installation Folder – \Program Files (x86)\Altium\Altium365.
• Firebird Installation Folder – \Program Files (x86)\Firebird\Firebird_3_0.
• Firebird Database – \ProgramData\Altium\Altium365Data\DXPSERVER.DAT.
• Revision Files Folder – \Altium\Altium365Data\Revisions. \ProgramData
• Search Index Data Folder – \Altium\Altium365Data\SearchData. \ProgramData

既定のポート

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

• HTTP Port – 9780
• HTTPS Port – 9785
• LDAP Service Port – 9791

• Websocket Port – 4649
• Firebird Server Port – 3050
• SVN Port – 3690

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

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

► Altium Design software のポートとIPアドレス に関する情報を参照してください。

HTTPS プロトコルのサポート

Enterprise Server とのデータ交換に追加のセキュリティ層が必要な場合、Enterprise Server は 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 リンクを選択して、現在の名前/ポートのバインディングにアクセスします。

プロトコルのポート番号を含む Binding は、Edit button により 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 へのセキュア接続を確立するには:

• Altium Designer から – HTTPS プレフィックス付きのサーバーアドレスと、設定された HTTPS ポートを使用します。デフォルトでは、Enterprise Server をホストしている PC からは https://localhost:9785、リモート接続では https://<computername>:9785 です（[computername] はホストマシンのコンピューター名または完全修飾ドメイン名）。

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

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

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

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

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

HTTP 上の SOAP。

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

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 フォルダー（\Altium\Altium365Data\Revisions）に保存されます。 \ProgramData

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

• User Management – Enterprise Server Workspace のブラウザーインターフェースにおける Users ページおよびサブページの背後にあるアプリケーション。
• Vault Explorer – Enterprise Server Workspace のブラウザーインターフェースにおける Explorer ページの背後にあるアプリケーション。
• Catalog Management – Enterprise Server Workspace のブラウザーインターフェースにおける Part Providers page の背後にあるアプリケーション。
• Projects Management – Enterprise Server Workspace のブラウザーインターフェースにおける Projects ページの背後にあるアプリケーション。
• TC2 Console – Enterprise Server Workspace のブラウザーインターフェースにおける Configurations ページの背後にあるアプリケーション。

ライセンス ファイル

Related page: ライセンス

Enterprise Server のライセンスは、基本的に次の 2 つのコンポーネントで構成され、これらが 2 層のライセンスシステムを形成します:

• Server License – このライセンスにより、Enterprise Server インストールの機能とサービスが組織で利用可能になります。
• Client Access License – このライセンスにより、組織内のユーザーが組織の Enterprise Server にアクセスできるようになります。

Enterprise Server のライセンスは、クラウド経由、またはライセンスファイル（*.alf）を用いてローカルで扱うことができます。後者の取得は Company Dashboard から行います（Altium サイト右上の AltiumLive アカウントメニューにある Company Dashboard エントリからアクセス）。Licenses タブで、該当するライセンス（Server Applications のライセンス グルーピング内）を見つけ、詳細なライセンス管理ページへ進みます。そこで Activate ボタンをクリックして、関連するライセンスファイルを生成・ダウンロードします。

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

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

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

データ移行後などに Enterprise Server のコンテンツを再インデックスするには、次の手順を実行します。

1. Enterprise Server に関連付けられている IIS アプリケーションプールをすべて停止します。
2. Elasticsearch (AltiumElasticSearch) サービスを停止します。これは Windows Services パネル（Windows の Administrative Tools ウィンドウからアクセス）で実行します。
3. 検索インデックスデータを含む SearchData フォルダーの内容を削除します（既定のインストールでは \Altium\Altium365Data\SearchData）。 \ProgramData
4. Elasticsearch (AltiumElasticSearch) サービスを再起動します。
5. Enterprise Server に関連付けられている IIS アプリケーションプールを再起動します。

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

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

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

Enterprise Server データベースに Oracle を使用する

Related page: Oracle バックエンドの Enterprise Server

Enterprise Server のインストール時に Oracle データベースタイプを選択すると、既存システムのバックエンドとしてこの種のデータベースをすでに利用している組織において、Enterprise Server をより簡便に導入できます。既存インフラ上で Enterprise Server をホストすることで、インストールおよび管理の複雑さを低減できます。

Oracle をバックエンドデータベースとして Enterprise Server をインストールして稼働させる手順は、基本的に次の2段階です。

1. Oracle データベースのセットアップ
2. Enterprise Server のセットアップ

Enterprise Server の準備

Enterprise Server を正常にインストールして稼働させるには、OCI クライアントだけでなく、関連する .Net コネクターも必要です。使用している Oracle のバージョンに合わせて、Oracle Developer Tools for Visual Studio を含む該当の 32-bit Oracle Data Access Components (ODAC) をインストールすることを推奨します。Enterprise Server を収容する専用マシンには、最低限として ODAC 12c Release 1 and Oracle Developer Tools for Visual Studio (12.1.0.1.0) のダウンロードをインストールすることが推奨されます。