tsm ファイルパス

特定の tsm コマンドで、既定の場所に対してファイルの読み書きを行います。これらの既定の場所は、コマンドごとに定義される basefilepath 構成キーによって決まります。tsm を使用して、このキーの現在の値を表示し、場所を変更することができます。

NetworkService システムアカウント

一部の組織には、NetworkService アカウントなどのシステムアカウントからのファイルアクセスを制限するセキュリティポリシーが実装されています。tsm ファイルパスを変更する場合は、NetworkService システムアカウントに結果となるパスへの完全なパーミッション（パーミッション継承を有効化）があることを確認する必要があります。また、*\data\tabsvc\* パスにもともとあったファイルパスを変更する場合は、元のパスに対する NetworkService のパーミッションを維持する必要があります。NetworkService システムアカウントは、Tableau Server 管理コントローラー、Tableau Server クライアントファイルサービス、および Tableau Server 調整サービスによる操作を処理するため、このパーミッションを維持する必要があります。

バックアップ/復元ファイルの場所のパーミッション

バックアップ/復元ファイルの場所に必要な権限:

NetworkService: 読み取り/書き込み/実行のパーミッション

実行サービスアカウント: 読み取り/書き込み/実行のパーミッション

ファイルの既定の場所

tsm maintenance backup、restore、send-logs、ziplogs プロセスおよび tsm sites export、sites import プロセスの実行中、Tableau Server はこれらのコマンドが作成および使用するファイル用に既定の場所を使用します。

Tableau Server のバックアップに必要なディスク空き容量の詳細については、バックアップのディスク容量使用率を参照してください。

既定のディレクトリは次のとおりです。

tsm maintenance コマンド:
- backup— バックアップ用の .tsbak ファイルが初期ノードのデータディレクトリにある一時的な場所で作成された後、次の場所に保存されます。
  <install drive>:<install\path>\data\tabsvc\files\backups
  既定では、次になります。
  C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\
  しかし、Tableau を既定ではない場所にインストールした場合には異なります。たとえば、D:\Tableau Server にインストールした場合、バックアップは次の場所に保存されます。
  D:\Tableau Server\data\tabsvc\files\backups
  注: tsm maintenance backup コマンドは、バックアップファイルが書き込まれる場所へのパスとしての "ネットワークパス" (例: \\<コンピューター名>\<フォルダー>\<ファイル名>) としても知られる、Microsoft Windows UNC (汎用命名規則) のファイルパスをサポートしていません。代わりにローカルファイルシステムパス (例: <ドライブ文字>:\<フォルダー名>\<ファイル名>) を使用します。
- restore— 復元プロセスで復元するバックアップファイルの場所:
  <install drive>:<install\path>\data\tabsvc\files\backups
  既定では、次になります。
  C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\
  しかし、Tableau を既定ではない場所にインストールした場合には異なります。たとえば、D:\Tableau Server にインストールした場合、復元プロセスは次の場所にあるバックアップを使用します。
  D:\Tableau Server\data\tabsvc\files\backups
- send-logs— ログ送信で送信するログファイルの場所:
  <install drive>:<install\path>\data\tabsvc\files\backups
  既定では、次になります。
  C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\
  しかし、Tableau を既定ではない場所にインストールした場合には異なります。たとえば、D:\Tableau Server にインストールした場合、send-logs プロセスは次の場所からログファイルを送信します。
  D:\Tableau Server\data\tabsvc\files\backups
- ziplogs—ziplog ファイルの生成場所:
  <install drive>:<install\path>\data\tabsvc\files\log-archives
  既定では、次になります。
  C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\log-archives
  しかし、Tableau を既定ではない場所にインストールした場合には異なります。たとえば、D:\Tableau Server にインストールした場合、ziplogs ファイルは次の場所に生成されます。
  D:\Tableau Server\data\tabsvc\files\log-archives
tsm sites
- export—エクスポートする .zip ファイルの生成場所:
  <install drive>:<install\path>\data\tabsvc\files\siteexports
  既定では、次になります。
  C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports
  しかし、Tableau を既定ではない場所にインストールした場合には異なります。たとえば、D:\Tableau Server にインストールした場合、エクスポートする .zip ファイルは次の場所に生成されます。
  D:\Tableau Server\data\tabsvc\files\siteexports
- import—インポートプロセス中に Tableau Server がファイルを検索する場所:
  <install drive>:<install\path>\data\tabsvc\files\siteimports
  既定では、次になります。
  C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports
  しかし、Tableau を既定ではない場所にインストールした場合には異なります。たとえば、D:\Tableau Server にインストールした場合、復元プロセスは次の場所にあるバックアップを使用します。
  D:\Tableau Server\data\tabsvc\files\siteimports

現在のファイルの場所を取得する

特定のコマンドの現在のファイルの場所を表示するには、tsm configuration get を使用します。

tsm maintenance コマンド:
- backup、restore、send-logs:
  tsm configuration get -k basefilepath.backuprestore
- ziplogs:
  tsm configuration get -k basefilepath.log_archive
tsm sites コマンド:
- export
  tsm configuration get -k basefilepath.site_export.exports
- import
  tsm configuration get -k basefilepath.site_import.exports

現在のファイルの場所を変更する

tsm configuration set コマンドを使用して想定するファイルの場所を変更し、basefilepath 変数を更新できます。具体的なベースファイルパスの詳細については、tsm configuration set のオプションを参照してください。

basefilepath 変数を変更しても、既存のファイルは元のディレクトリから新しいディレクトリに移動しません。既存の backup、restore、log ファイルまたは site export/import ファイルを指定した新しいディレクトリに配置するには、それらのファイルを手動で移動する必要があります。新しい場所の作成と適切なパーミッションの設定を行って、配置されるファイルおよびこれらのファイルが含まれるディレクトリ構造に対する tsm のアクセスを許可する必要があります。バックアップ / 復元のベースファイルパスを変更する場合は、tsm maintenance validate-backup-basefilepath コマンド (バージョン 2022.1 以降で使用可能) を実行して、パーミッションが正しく設定されていることを確認する必要があります。

tsm maintenance backup コマンドを実行すると、データディレクトリ内の一時的な場所でバックアップファイルが構成された後、 basefilepath.backuprestore 変数で指定された場所に保存されます。ベースファイルパスを変更しても、tsm maintenance backup コマンドがバックアップファイルを構成する場所には影響しません。

basefilepath.backuprestore の位置をドライブのルートに指定することはできません。これはフォルダー内に含める必要があります。

tsm maintenance コマンド:
- backup、restore、または send-logs ディレクトリを変更するには、次のコマンドを実行します。
  tsm configuration set -k basefilepath.backuprestore -v "<drive>:\new\directory\path"
- ziplogs ディレクトリを変更するには、次のコマンドを実行します。
  tsm configuration set -k basefilepath.log_archive -v "<drive>:\new\directory\path"
tsm sites コマンド:
- sites export ディレクトリを変更するには、次のコマンドを実行します。
  tsm configuration set -k basefilepath.site_export.exports -v "<drive>:\new\directory\path"
- sites import ディレクトリを変更するには、次のコマンドを実行します。
  tsm configuration set -k basefilepath.site_import.exports -v "<drive>:\new\directory\path"

ファイルの既定の場所を変更した後に、次の操作を実行する必要があります。

保留中の変更を適用します。
tsm pending-changes apply
保留中の変更にサーバーの再起動が必要な場合は、pending-changes apply コマンドの実行時に、再起動が行われることを知らせるメッセージが表示されます。このメッセージはサーバーが停止していても表示されますが、その場合には再起動は行われません。--ignore-prompt オプションを使用してメッセージが表示されないようにできますが、そのようにしても再起動に関する動作が変わることはありません。変更に再起動が必要ない場合は、メッセージなしで変更が適用されます。詳細については、tsm pending-changes applyを参照してください。
Tableau Server を停止します。
tsm stop
TSM コントローラーを再起動します。
net stop tabadmincontroller_0
net start tabadmincontroller_0
コントローラーが再起動するまで数分間待機します。次のコマンドを指定してコントローラーが再起動したことを確認できます。
tsm status -v
このコマンドを実行すると、Tableau Server 管理コントローラーにコントローラーが再起動したことを示す 'running' と表示されます。
Tableau Server を起動します。
tsm start

一番上に戻る

フィードバックをお送りいただき、ありがとうございます。

フィードバックは正常に送信されました。ありがとうございます!

Tableau Server on Windows ヘルプ