Java Search Networkでの base port groupdocs の構成

最新のデータ集約型アプリケーションでは、configure base port groupdocs が高速で信頼性の高い検索インフラを構築する最初のステップです。数千の PDF をインデックス化する場合でも、複数サーバーに拡張する場合でも、ユニークなポートとディレクトリを割り当てることでノード間の競合を防ぎ、クラスターの健全性を保ちます。本チュートリアルでは、前提条件、インストール手順、そして GroupDocs.Search for Java を使用した完全なマルチノード構成を順を追って解説し、スケーラブルな検索ネットワークをすぐに立ち上げられるようにします。

クイック回答

  • 主な目的は何ですか？ 各検索ノードにユニークなポートとベースディレクトリを割り当て、競合を排除します。
  • ライセンスは必要ですか？ はい – 本番環境でのデプロイにはトライアルまたはフルライセンスが必要です。
  • サポートされている Java バージョンは？ Java 8 以上（Java 11+ 推奨）。
  • クラウドサーバーで実行できますか？ もちろんです – クラウドのセキュリティグループで選択したポートを開放するだけです。
  • 何ノードまで追加できますか？ 厳密な上限はありません。ハードウェアとネットワーク容量が制約となります。

“configure base port groupdocs” とは何ですか？

Configure base port groupdocs は、各検索ノードが使用する開始 TCP ポートを割り当て、以降のノードではそれをインクリメントしていくプロセスです。このシンプルな手順により、厄介な “port already in use” エラーが解消され、クリーンで水平スケーラブルな検索クラスターの基盤が整い、各ノードが異なるエンドポイントで通信できるようになります。

スケーラブルなネットワークに GroupDocs.Search を使用する理由

GroupDocs.Search は 高性能インデックス作成（標準的な 8 コアサーバーで最大 50 GB/分）を実現し、PDF、DOCX、PPTX、HTML など 50 以上のファイル形式 をサポートします。モジュラーアーキテクチャにより、インデクサ、サーチャ、シャード、エクストラクタをノード間で組み合わせることができ、ハードウェアを追加するごとに線形スケーラビリティを提供します。また、組み込みの圧縮オプションによりディスク使用量を最大 70 % 削減し、典型的なワークロードでクエリ遅延を 200 ms 未満に抑えることができます。

前提条件

  • Java Development Kit (JDK) 8 以上（Java 11+ 推奨、ガベージコレクション改善のため）。
  • IDE（IntelliJ IDEA や Eclipse など）。
  • GroupDocs.Search for Java ライブラリ（バージョン 25.4 以上）を Maven または手動ダウンロードでインストール。
  • 基本的なネットワーク知識（TCP ポート、localhost とリモートホストの違い）。
  • 有効な GroupDocs.Search ライセンス（トライアルまたはフル）。

GroupDocs.Search for Java の設定

インストール手順

Maven 設定:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/search/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-search</artifactId>
      <version>25.4</version>
   </dependency>
</dependencies>

直接ダウンロード:

代わりに、最新バージョンを GroupDocs.Search for Java のリリース からダウンロードしてください。

ライセンス取得

  • 無料トライアル – すぐにテストを開始できます。
  • 一時ライセンス – Temporary License で拡張トライアルを取得。
  • フル購入 – 本番デプロイには必須です。

基本的な初期化と設定

import com.groupdocs.search.options.*;
import com.groupdocs.search.scaling.configuring.*;

public class SearchNetworkSetup {
    public static void main(String[] args) {
        // Initialize GroupDocs.Search components here
    }
}

実装ガイド

base port groupdocs を構成する方法は？

base port を構成するには、ネットワーク設定ファイルを編集するか、プログラム上で basePort プロパティに 49100 のような高い未使用値を設定します。以降の各ノードではポート番号を 1 ずつ（または固定オフセットで）増やすことで、各ノードが固有の TCP エンドポイントにバインドし、ポート衝突エラーを防ぎ、ファイアウォールルールの設定を簡素化します。

ベースパスの設定

コードを書く前に、一貫したフォルダ構成を決めます。例えば、インデクサ用 (Indexer0)、サーチャ用 (Searcher0)、エクストラクタ用 (Extractor0) のディレクトリを別々に作成します。この構造により、各ノードはファイルを迅速に解決できます。

  • なぜ: 予測可能なディレクトリ階層により、異なるマシンでノードが起動した際の “file not found” エラーを防止します。

ベースポートの設定

一般的なサービス（HTTP 80、SSH 22 など）との衝突を避けるために、高い開始ポートを選択します。追加する各新ノードでポート番号をインクリメントします。

// If an error occurs about using a busy network port, change the value of the base port
int basePort = 49100;
  • なぜ: 高いポート（例: 49100）から開始することで、既存サービスとの衝突可能性が低減し、ファイアウォールルールの作成が簡素化されます。

ホストアドレスの定義

開発時は localhost で問題ありません。本番環境では、サーバーの IP アドレスまたは DNS 名に置き換えて、リモートノード同士が相互に到達できるようにします。

// Define the host address
dataAddress = "127.0.0.1";
  • なぜ: 実際のホストアドレスを使用することで、マシン間通信が可能になり、クラウドやオンプレミスクラスタに必須です。

ネットワーク構成の作成

NetworkConfig クラスは、ベースポート、ホスト、オプションの SSL 設定などすべてのネットワークオプションを 1 つのオブジェクトにまとめ、Search エンジンが利用できるようにします。

Configuration configuration = new Configurator()
    .setIndexSettings() // Begin setting index configurations
        .setUseStopWords(false) // Disable stop words in indexing
        .setUseCharacterReplacements(false) // Disable character replacements
        .setTextStorageSettings(true, Compression.High) // Enable high compression for text storage
        .setIndexType(IndexType.NormalIndex) // Set index type to NormalIndex
        .setSearchThreads(NumberOfThreads.Default) // Use default number of search threads
    .completeIndexSettings() // Complete setting index configurations
  • なぜ: これらのオプションを集中管理することで、設定の再利用性が向上し、複数ノード間での保守が容易になります。

ノードの追加

SearchNode は、インデックス作成や検索など特定の機能を実行する GroupDocs.Search クラスタ内の個別ノードを表します。各役割（インデクサ、サーチャ、エクストラクタ）に対して SearchNode をインスタンス化し、SearchEngine に登録します。ノード間で責務を分散させることで、並列性と耐障害性が向上します。

// Add the first node (indexer and searcher)
    .addNode(0) // Start adding node 0
        .setTcpEndpoint(dataAddress, basePort) // Set TCP endpoint for node 0
        .addLogSink() // Add log sink to node 0
        .addIndexer("YOUR_DOCUMENT_DIRECTORY/Indexer0") // Specify index path for node 0
        .addSearcher("YOUR_DOCUMENT_DIRECTORY/Searcher0") // Specify searcher path for node 0
    .completeNode() // Complete adding node 0

// Add the second node (shard and extractor)
    .addNode(1) // Start adding node 1
        .setTcpEndpoint(dataAddress, basePort + 1) // Set TCP endpoint for node 1
        .addShard("YOUR_DOCUMENT_DIRECTORY/Shard1") // Specify shard path for node 1
        .addExtractor("YOUR_DOCUMENT_DIRECTORY/Extractor1") // Specify extractor path for node 1
    .completeNode() // Complete adding node 1
  • なぜ: 専用ノードに作業を分割することで競合が減少し、各マシンが単一タスクに特化でき、全体のスループットが向上します。

設定の最終化

すべてのノードを追加したら、engine.start() を呼び出してネットワークを起動します。エンジンは各ノードを自動的に割り当てられたポートにバインドし、接続性を検証します。

.completeConfiguration(); // Finalize the configuration setup
return configuration; // Return the configured network settings

よくある問題と解決策

  • ポート競合 – 各新ノードで必ず basePort をインクリメントしてください。netstat や OS のネットワークモニタで開いているポートを確認します。
  • ディレクトリ欠如 – 各フォルダ（Indexer0、Searcher0 など）が存在し、Java プロセスに読み書き権限があることを確認してください。
  • ネットワーク到達性 – マルチマシン構成に移行する際は、127.0.0.1 を実際のホスト IP に置き換え、ファイアウォールで選択したポートを開放してください。

実用的な適用例

シナリオbase port groupdocs 設定のメリット
エンタープライズ文書管理部門間でのダウンタイムなしのシームレスなスケーリング
大規模 CMS プラットフォームインデックスが分散されるため、コンテンツ取得が高速化
法務ケース管理PDF の並列抽出により検索遅延が削減

パフォーマンス考慮事項

  • CPU/メモリの監視 – Java の JMX やプロファイリングツールでスレッド使用状況を監視します。
  • 圧縮の調整 – Compression.High はディスク容量を節約しますが CPU オーバーヘッドが増える可能性があります。High と Normal の両方をテストして最適なバランスを見つけてください。
  • 定期的なアップデート – 新しい GroupDocs.Search のリリースにはパフォーマンス向上パッチが含まれることが多いため、ライブラリを常に最新に保ちます。

結論

これで configure base port groupdocs の方法と、GroupDocs.Search for Java を使用したマルチノード検索ネットワークの設定方法を学びました。追加ノードで実験し、インデックス設定を微調整し、既存アプリケーションにネットワークを統合して、真にスケーラブルな検索ソリューションを実現してください。

よくある質問

Q: インデックス作成時にストップワードを無効化する目的は何ですか？
A: ストップワードを無効化すると、専門領域で重要になる可能性のある一般的な語句を保持でき、検索精度が向上することがあります。

Q: 複数ノードを追加する際のポート競合はどう対処すればよいですか？
A: 高い basePort（例: 49100）から開始し、以降の各ノードでインクリメントして、各ノードがユニークな TCP エンドポイントを持つようにします。

Q: この設定をクラウドベースのアプリケーションで使用できますか？
A: はい—クラウドのセキュリティグループで選択したポートを開放し、127.0.0.1 を適切なパブリックまたはプライベート IP に置き換えてください。

Q: NormalIndex と他のインデックスタイプの違いは何ですか？
A: NormalIndex は速度とメモリ使用量のバランスが取れたものです。一方、FastIndex などの特殊インデックスは特定のパフォーマンスシナリオを対象としています。

Q: 追加できるノード数に制限はありますか？
A: 技術的にはありません。制限はハードウェアリソースとネットワーク帯域幅によって決まります。

最終更新日: 2026-05-17
テスト環境: GroupDocs.Search Java 25.4
作者: GroupDocs

// Define the base paths using placeholders
dataPath = "YOUR_DOCUMENT_DIRECTORY/AdvancedUsage/Scaling/ConfiguringSearchNetwork/";

関連チュートリアル