共有ファイルのクリーンアップと変換

QlikView 共有ファイル クリーンアップ ツールは、システム管理者が共有ファイルを確認 (分析) および削除 (修復) するために使用するコマンド ライン ツールです。このツールはまた、異なる形式の共有ファイルを変換するためにも使用できます。「共有ファイルの変換」を参照してください。このツールを呼び出すには、QlikView Server 実行可能ファイル (QVS.exe) を特別なパラメーターで実行します。

クリーンアップ ツールで使用可能なモードは 2 つあり、それぞれ異なるコマンドライン パラメーターで指定します。

確認モード

-v パラメーターを使用して、コマンドラインで指定した共有ファイルを分析します。分析中に、クリーンアップ ツールは 1 つ以上の無効または破損したオブジェクトのエントリがあるかどうかを検出します。次に QVS は無効なエントリに関してできる限り多くの情報をログに書き込みます。

削除モード

-p パラメーターを使用して共有ファイルを確認し、次に、破損したエントリを削除して新しい共有ファイルを作成します。クリーンアップ バージョンは、オリジナルと同じフォルダーに配置されます。新しいファイルでは、サフィックス _clean.Shared または .Tshared の形式の後に使用されます。オリジナルの共有ファイルは上書きされません。この後、オリジナルの共有ファイルをクリーンアップ バージョンに置き換えることもできます。

共有ファイルの変換

共有ファイルを作成する場合は、オリジナルの形式またはトランザクション形式で保存できます。オリジナルの形式は末尾が .Shared で、トランザクション形式の共有ファイルは末尾が .TShared になっていることで識別できます。.TShared を使用したトランザクション形式の共有ファイルの方が、ネットワーク エラー、停電、ディスク容量不足などの障害の場合でも安定性が高くなります。.TShared 形式は 16 EB (エクサバイト) までのサイズをこなせるため、2 GB を超える場合にはこの形式を使用することをお勧めします。

オリジナルとトランザクションの 2 つの異なる形式は、同じサーバー上の異なるアプリケーションに同時に使用することができます。ただし、ひとつのアプリケーションの中ではどちらか一方 (.Shared または .TShared) しか使用できません。新規の共有ファイルを作成する時点で、Settings.ini ファイル内で規定してください。QlikView Server の場合、Settings.ini ファイルは C:\ProgramData\QlikTech\QlikViewServer にあります。

ファイル形式の設定:

DefaultBlobDbType=0
この設定の場合、新しい共有ファイルは .Shared 形式で作成されます。

DefaultBlobDbType=1
この設定の場合、新しい共有ファイルは .TShared 形式で作成されます。

共有ファイルの変換は、QlikView 共有ファイルのクリーンアップ コマンドでも実行できます (下のタブ、およびページ下の セクションの例 n.4 を参照してください)。

共有ファイル内容の所有者の設定および変更

QMC でサーバー オブジェクトの所有者を変更することができますが、一部のオブジェクト タイプの場合 (「DocumentContent」、「InputFieldValues」および「ObjectContent」)、この方法で所有者を変更することはできません。この場合に所有者を変更するには、クリーンアップ ツールで -so (所有者を設定) または -ro (所有者を置き換え) パラメーターを使用する必要があります。これらのパラメーターは削除モードで使用することをお勧めします。

クリーンアップ ツールのコマンドの形式

クリーンアップ ツールのコマンドの形式は次のとおりです。

"<QVS_executable_path>" -x "<Shared_file_path>" <Cleaning_tool_mode> <Output format> <Ownership> <Delete_user_entries> [-l "<Log_folder_path>"] [-rBM <BM_size>] [-o "<Shared_file_save_path>"]

次の表は、それぞれのコマンド パラメーターについて説明しています。

パラメータ 説明
QVS_executable_path QVS 実行可能ファイル (QVS.exe) を含んでいるシステム フォルダーへのフル パス。
-x -x パラメーターは、クリーンアップ ツールのみを実行するよう QVS に指示します。
Shared_file_path クリーンアップする共有ファイルへのパス。

ディレクトリへのパスまたはファイルへのパスを受け入れます。

  • フォルダーへのパスで呼び出された場合、操作はフォルダー内のすべての共有ファイルに適用されます。
  • 1 つのファイルを指定した場合、操作はこのアイテムのみに適用されます。
Cleaning_tool_mode
  • -p は削除モードに使用
  • -v は確認モードに使用
アウトプット形式

[オプション] -f (出力形式を指定) パラメータは、クリーニング ツールによる共有ファイル形式間の変換を可能にします。

形式は sameorig、または tx (例 -f tx) として指定します。

  • same 入力ファイルのファイル形式が使用されます
  • orig オリジナルの .Shared 形式が出力形式に使用されます
  • tx .TShared (トランザクション ファイル) 形式が出力形式に使用されます

形式 (-f パラメータ) を指定していない場合、既定値の same が使用されます。

Ownership
  • -so user は所有者の設定に使用
  • -ro from_user to_user は所有権の置換に使用
Delete_user_entries
  • -du0 ユーザーはユーザーから非共有エントリを削除

  • -du1 ユーザーはユーザーからすべてのエントリを削除

複数のユーザーを削除する必要がある場合、この項目ではファイルへのパスを受け入れます

  • -df0 file.txt は file.txt ファイルのリストにあるユーザーから非共有エントリを削除します
  • -df1 file.txt は file.txt ファイルのリストにあるユーザーからすべてのエントリを削除します

QlikView Server にアクセスしたことのあるユーザーのリストは、Governance Dashboard アプリケーションで取得できます。ダウンロード サイトから無償で入手できます (ここ (英語のみ)で関連ドキュメントを参照してください)。

ユーザーのリストは、Governance Dashboard の [演算/セッション] サブタブの ListBox 'Athenticated User' から 'csv' 形式でエクスポートすることによって簡単に抽出できます。その後、リストを編集し (共有ファイルから削除するユーザーのみを維持します)、クリーンアップ ツールに入力として渡すことができます。

-l Log_folder_path [オプション] 生成されたログ ファイルの場所を変更する場合は、-l を使用してログ フォルダーのパスを指定します。
-rBM BM_size [オプション] -rBM パラメーターを使用して、大きなブックマークを共有ファイルから削除します。<BM_size> (バイト単位) より大きいすべてのブックマークが削除されます。
-o Shared_file_save_path

[オプション] -o パラメーターを使用して、共有ファイルが保存されている場所へのパスを変更します。

共有ファイル クリーンアップ ツールの使用

共有ファイル クリーンアップ ツールは、管理者モードで Windows コマンド プロンプトを使用して実行します。次の手順を実行します。 

注: %ProgramData%Qliktech\Documents とは異なる (一時) フォルダーにある QVS.exe のコピーおよび共有ファイルと一緒にクリーンアップ ツールを実行するようお勧めします。%ProgramData%Qliktech\Documents folder のパスに保存されているクリーンアップ ツールを実行するには管理者権限が必要です。

このクリーンアップ プロセスでは共有ファイルが完全に再生成されます。これによりファイルの断片化に関する問題が解決するとともに、サイズとアクセス時間も縮減できる場合があります。
注: クリーニング ツールをフォルダー全体に適用するには、 -subF を使用します。削除しようとしているユーザー リストがそのフォルダー内のすべての共有ファイルで共通のものであることを必ず考慮に入れてください。
注: クリーンアップ ツール使用する前に、共有ファイルをバックアップします。
  1. QVS 実行可能ファイルのコピーを作成します。デフォルトでは、QVS.exe は C:\Program Files\QlikView\Server にインストールされています。
  2. QVS.exe のコピーが格納されているフォルダーに移動し、クリーンアップ ツールを検証モードで実行します。例:
    "C:\<Temporary_path>\QVS.exe –x “C:\ProgramData\QlikTech\Documents\FinanceAnalysis.qvw.Shared” –v
  3. CleaningTool_MACHINENAME.log 確認ファイル ログを見つけます。コマンドでログを指定しなかった場合は、デフォルトで C:\ProgramData\QlikTech\QlikViewServer に保存されます。

    共有ファイル オブジェクトが破損している場合、そのオブジェクトのそれぞれの種類がログに示されます。破損したエントリを特定できた場合は、オブジェクト ID が示されます。

  4. 破損したエントリがある場合、再度クリーンアップ ツールを削除モードで実行します。

    削除プロセスで破損したオブジェクトが削除または修正されて、新しい共有ファイルが作成されます。サフィックス _clean で識別できる新しいファイル (例:MYFILENAME.QVW.TShared_clean) は、ソース共有ファイルと同じフォルダ内に配置されます。

  5. 注: 新しいファイルは、ソース ファイルよりも大きい場合があります。
  6. 古い破損した共有ファイルを新しいファイルと置き換えます。この操作はどの QlikView Server サービスも稼働していないときに行う必要があります。

Example 1: 共有ファイルの分析

Windows コマンド プロンプトで次のコマンドを実行して共有ファイルを分析し、C:\logs フォルダー内にログ ファイルを作成します。 

QVS.exe -x "C:\ProgramData\QlikTech\Documents\TESTFILE.QVW.TShared" -v -l "C:\logs"

Example 2: ファイル所有者の設定

Windows コマンド プロンプトで次のコマンドを実行して、共有ファイル内のサーバー オブジェクトの所有者をユーザー UserX に設定します。 

QVS.exe -x "C:\ProgramData\QlikTech\Documents\TESTFILE.QVW.TShared" -p -so UserX

Example 3: ファイル所有者の置き換え

Windows コマンド プロンプトで次のコマンドを実行して、共有ファイル内のサーバー オブジェクトの所有者を UserX から UserY に置き換えます。 

QVS.exe -x "C:\ProgramData\QlikTech\Documents\TESTFILE.QVW.Shared" -p -ro UserX UserY

Example 4: 出力形式の変更

Windows コマンド プロンプトで次のコマンドを実行すると、オリジナルの共有ファイルの形式を新しい形式に変換できます。

QVS.exe -x "C:\Temp\1.QVW.Shared" -p -f tx

Example 5: 特定のユーザーからの非共有エントリの削除

Windows のコマンド プロンプトで次のコマンドを実行すると、指定したユーザー UserX に関連付けられている非共有エントリがすべて削除されます。

QVS.exe -x "C:\ProgramData\QlikTech\Documents\TESTFILE.QVW.TShared" -p -du0 UserX

Example 6: テキスト ファイルで指定されているユーザー セットからのすべてのエントリの削除

Windows のコマンド プロンプトで次のコマンドを実行すると、Users.txt 列テキスト ファイルで指定されているユーザーのリストに関連付けられているすべてのエントリ (共有エントリを含む) が削除されます。

QVS.exe -x "C:\ProgramData\QlikTech\Documents\TESTFILE.QVW.Shared" -p -df1 "C:\temp\Users.txt"

Users.txt ファイルの例:

DOMAIN\User1

DOMAIN\User2

DOMAIN\User3

DOMAIN\UserX

Example 7: テキスト ファイルで指定されているユーザー セットからのすべてのエントリの削除 (フォルダー全体から)

フォルダー内の共有ファイルのセット全体を、削除対象のユーザーの共通リストで処理するオプションもあります。

Windows のコマンド プロンプトで次のコマンドを実行すると、Users.txt 列テキスト ファイルで指定されているユーザーのリストに関連付けられているすべてのエントリ (共有エントリを含む) が削除されます。'Documents' フォルダー内のすべての共有ファイルの場合:

QVS.exe -x "C:\ProgramData\QlikTech\Documents" -p -subF -df1 "C:\temp\Users.txt"

Users.txt ファイルの例:

DOMAIN\User1

DOMAIN\User2

DOMAIN\User3

DOMAIN\UserX