ドキュメントルートフォルダについて

ドキュメントルートフォルダは、FileBlogで公開するファイルサーバーのフォルダのことです。

FileBlogをインストールすると標準のドキュメントルートフォルダが自動的に設定されるので、利用環境に応じて設定変更してください。

FileBlogのインストール後は、まず標準のドキュメントルートフォルダにファイルを入れて動作確認することをおすすめします。

ドキュメントルートフォルダの対象

次の条件に適合するファイルサーバーのフォルダをドキュメントルートフォルダに指定できます。

FileBlogサーバーとファイルサーバーがCIFS/SMBで接続できることが基本要件です。

  • FileBlogサーバーのローカルフォルダ

  • FileBlogサーバーと同一ドメイン・信頼関係のあるドメインにあるファイルサーバー

  • FileBlogサーバーとワークグループ関係にあるファイルサーバー

対象のファイルサーバー

  • Windowsファイルサーバー（推奨）：FileBlogの全機能が有効です

  • Linuxファイルサーバー：Sambaが必要です。FileBlog機能の一部が無効になる場合もあります。

  • NAS：製品によってはFileBlog機能の一部が無効になる場合もあります。

製品評価時の注意

  • 評価環境においてはFileBlogサーバーのマシン性能に応じた検索対象文書数のフォルダをドキュメントルートに設定してください。

  • マシン性能を超える検索対象文書数をインデックス構築するとマシン負荷が過大になり期待する動作になりません。

ドキュメントルートを設定する

  1. ［管理ツール > 設定全般 > DocumentRoot］を選択します。

    ../../../_images/20241022-142915-193.png

  2. ［追加］を選択します。

    ../../../_images/20241004-162827-074.png

    • 標準のドキュメントルートフォルダ%FILEBLOG5_APP_DATA%\DocRootが既定されています。

    • %FILEBLOG5_APP_DATA%は[AppData]フォルダの変数です。

  3. 各項目に適切な情報を入力します。

    ドキュメントルートフォルダ：Path

    ../../../_images/dr003.png

    • FileBlogの接続対象にするフォルダを指定します。

    • UNCパスまたはドライブパスで指定します。（\\ServerName\Share, D:\Support など）

    プレビュー保存フォルダ：TpiRoot

    ../../../_images/dr005.png

    • サムネイル/プレビュー画像や抽出テキスト情報を保存する場所を指定します。

    • 標準既定の%FILEBLOG5_APP_DATA%\Preview（[AppData]\Preview）がおすすめです。

    • ドキュメントルートフォルダが複数ある場合は全て同一フォルダを指定します。エイリアス名のサブフォルダが自動的に作成されます。

    • SYSTEM（ローカルシステムアカウント）のアクセス権限（変更権限）が必要です。

    • ドメイン環境にて本フォルダをネットワークドライブに配置する場合、当該フォルダに対してFileBlogサーバーのSYSYTEMアカウントのアクセス権限が必要です。一般的に「各コンピューターのSYSTEMアカウント＝コンピューターアカウント」という関係なので、「DomainName\ComputerName$」というユーザーアカウントがドメインコントローラーに登録されています。アクセス権設定の際にオブジェクトの種類で［コンピューター］を選択するとアカウントを検索できます。

    エイリアス：Alias

    ../../../_images/dr006.png

    • 半角英数の文字列で指定します。

    • FileBlogのURLやファイルパスとして使用されます。

    表示名：Caption

    ../../../_images/dr007.png

    • FileBlogで表示されるドキュメントルートフォルダの名称を指定します。

    • 全角・半角文字が使用でき、省略するとエイリアスが表示名として使用されます。

    フォルダ変更検知：Watch

    ../../../_images/dr008.png

    • Windowsファイルサーバーからの変更通知を受信する設定です

    • OFF（チェックを入れない）にするとインデックスデータの即時更新がされません。

    変更検知のシンボリックリンクフォルダ探索階層数：WatchSymLinkTraverseLevel

    ../../../_images/dr009.png

    • DFS名前空間上のフォルダをドキュメントルートに指定した場合に設定します。（DFS名前空間上のフォルダを指定しない限り変更しません）

    • 1以上を指定するとドキュメントルートフォルダから指定値の階層分のサブフォルダでシンボリックリンク属性のフォルダを探します。

    • 見つかったシンボリックリンク属性のフォルダを個別に監視します。

    隠しフォルダ：Hidden

    ../../../_images/20231020-132432-702.png

    • ドキュメントルートフォルダを隠しフォルダにする設定です。

    • フォルダが非表示になります。

    • パスの入力時やURLへの接続時、検索結果にはサブフォルダやファイルが表示されます。

    パスパターン：Patterns

    ../../../_images/dr010.png

    • ドキュメントルートフォルダのパターン設定ですが通常は設定しません。

    • 例えば［直接開く］の実行時に、ドキュメントルートフォルダがドライブレターパスT:\shareで指定されているとき、PatternsにUNCパス\\server\shareを登録しておくことでクライアントPCがファイルに接続できるようになります。

    • 複数のパスを登録すした場合、1行目のパスが［直接開く］の実行時に評価され、2行目以降のパスはショートカットファイルのリンク先として評価されます。

  4. 入力が終わったら［保存］を選択します。

  5. ［今すぐ再起動］を選択してサービスを再起動すると設定が反映されます。

    ../../../_images/dr004.png

複数のドキュメントルートを設定する

同一ファイルサーバーや別ファイルサーバーの複数のフォルダをドキュメントルートフォルダに指定することができます。

  1. ［管理ツール > 設定全般 > DocumentRoot > 追加］を選択します。

../../../_images/20241004-162827-074.png

  1. 設定方法は1つ目のドキュメントルートの設定と同じです。

  2. 各ドキュメントルートは互いに独立したフォルダ階層でなければなりません。ドキュメントルートに含まれるフォルダを別のドキュメントルートフォルダとして設定することはできません。

  3. ［エイリアス］の値は各ドキュメントルートで重複しないようにします。

  4. 仮想の親フォルダ［トップ］の配下に各ドキュメントルートフォルダが表示されます。

ドキュメントルートの変更・削除

  1. ドキュメントルートフォルダの削除は、ごみ箱ボタンを選択して保存後にサービス再起動を実施してください。

    ../../../_images/20260324-143947-080.png

    SolrCloud設定で運用している場合にはコレクションも削除します。

    ../../../_images/20260324-144033-921.png

  2. ドキュメントルートフォルダの変更は、既存設定を書き換えるか、新規登録して既存設定を削除してください。

    • パスが1文字でも変わると変更となって新規ドキュメントルートフォルダとして認識されます。

    • たとえば、\\192.168.10.10\ShareDataが設定されていて、同一フォルダを指す\\FSV01\ShareDataに書き換えても新規設定となります。

  3. 変更・削除の実施後は、次のインデックス処理を行ってください。

    Tip

    インデックス処理を行うことで適正なインデックスデータにて運用できます。削除されずに残ってしまった不要なインデックスデータは、カウント数とインデックス登録数とに大きな乖離が生じさてたり、データサイズを無駄に大きなままにしたり、検索性能を低下させたりします。