--- schema_version: "1" id: f6e9c2a6073e4a310199b88c510e48be008c378f6963408a9f07b68bfe147f7e title: tsm maintenance collection: tableau version: current locale: ja-jp portal_url: https://docs.salesforce.com/tableau/current/ja-jp/server-linux/cli_maintenance_tsm.md canonical_url: https://help.tableau.com/current/server-linux/ja-jp/cli_maintenance_tsm.htm source_site: help.tableau.com content_type: documentation content_hash: bd376a1307da18d5628a68df167e9e1a9c21c5a89b429446b6c38f845951c428 description: Reference for tsm maintenance commands to back up and restore Tableau Server data. --- [メイン コンテンツに進む](#main-content) # tsm maintenance `tsm maintenance` コマンドを使用して、バックアップの作成や以前に作成したバックアップからの Tableau Server の復元など、サーバー メンテナンス タスクを管理できます。 - [tsm maintenance backup](#tsm) - [tsm maintenance cleanup](#cleanup) - tsm maintenance jmx - [tsm maintenance jmx disable](#jmx_disable) - [tsm maintenance jmx enable](#jmx_enable) - tsm maintenance log-levels - [tsm maintenance log-levels list](#log-levels_list) - [tsm maintenance log-levels reset](#log-levels_reset) - tsm maintenance metadata-services - [tsm maintenance metadata-services disable](#cat_disable) - [tsm maintenance metadata-services enable](#cat_enable) - [tsm maintenance metadata-services get-status](#cat_status) - [tsm maintenance reindex-search](#tsmmaintenancereindex) - [tsm maintenance reset-searchserver](#tsm_maint_reset_searchsvr) - [tsm maintenance restore](#tsm3) - [tsm maintenance send-logs](#tsmSendLogs) - tsm メンテナンス スナップショット バックアップ (外部ファイル ストア) - [tsm maintenance snapshot-backup complete](#tsm_snapshot_backup_complete) - [tsm maintenance snapshot-backup prepare](#tsm_snapshot_backup_prepare) - [tsm maintenance snapshot-backup restore](#tsm_snapshot_restore) - [tsm maintenance validate-backup-basefilepath](#tsmValidateBackupBasefilepath) - [tsm maintenance validate-resources](#tsmValidateResources) - [tsm maintenance ziplogs](#tsm4ziplogs) ## tsm maintenance backup Tableau Server によって管理されるデータのバックアップを作成します。このデータには、Tableau の PostgreSQL データベース (リポジトリ) が含まれます。これには、ワークブック、ユーザーのメタデータ、および抽出ファイル (バージョン 2024.2 以前の .hyper ファイルおよび .tde ファイル) が含まれます。このデータには、構成データは含まれません。「[Tableau Server の完全なバックアップと復元を実行します](https://help.tableau.com/current/server-linux/ja-jp/backup_restore.htm)」を参照してください。 **注:** 外部ファイル ストアを使用している Tableau Server インストールでは、このコマンドを使用しないでください。「[外部ファイル ストアによるバックアップと復元](https://help.tableau.com/current/server-linux/ja-jp/server_external_filestore_storage_backup_restore.htm)」を参照してください。 **トポロジの構成を使用した最適化:** - 管理コントローラーと同じノード上にファイル ストアを配置すると、バックアップ プロセス中にノード間でデータを転送する必要性が減少するか排除されるため、Tableau Server のバックアップにかかる時間を短縮できます。これは、組織で多数の抽出を使用している場合に特に当てはまります。 - リポジトリ (pgsql) を管理コントローラー ノードと同じ場所に配置すると、バックアップ時間は短縮できますが、ファイル ストアの場合ほど時間の節約は顕著ではありません。 最初のノードでエラーがあった場合や、コントローラーを別のノードに移動した場合を除き、管理コントローラーは通常最初のノード上にあります。 バックアップ ファイルは、データ ディレクトリの一時的な場所に集められ、TSM `basefilepath.backuprestore` 変数に定義したディレクトリに書き込まれます `` `/var/opt/tableau/tableau_server/data/tabsvc/files/backups/` ```.tsbak` バックアップ ファイルの書き込み先とその場所の変更方法の詳細については、[tsm ファイル パス](https://help.tableau.com/current/server-linux/ja-jp/cli_default_filepaths_tsm.htm)を参照してください。**注:** バックアップの場所を変更する場合でも、バックアップ プロセスではデータ ディレクトリの一時的な場所を使用してバックアップ ファイルを集めます。 ### シノプシス `tsm maintenance backup --file [options] [global options]` ### オプション \-f, --file 必須。 リポジトリ データのバックアップの詳細については、「[Tableau Server データのバックアップ](https://help.tableau.com/current/server-linux/ja-jp/db_backup.htm)」を参照してください。 \-d, --append-date オプション。 バックアップ ファイル名の末尾に現在の日付を追加します。 **注:** スケジュールを使用して作成されたバックアップには、バックアップファイル名の先頭に日付/時刻が自動的に含まれます。`-d` オプションも使用する場合、ファイル名には日付が 2 回含まれます。バックアップのスケジュール設定についての詳細は、「[バックアップのスケジュール設定と管理](https://help.tableau.com/current/server-linux/ja-jp/db_backup.htm#ScheduleBackups)」を参照してください。 \-i, --description オプション。 指定したバックアップ ファイルの説明が含まれます。 \--ignore-prompt オプション。バージョン 2020.2 での追加 ファイル ストアが管理コントローラーと同じノード (通常は初期ノード) に存在しない場合でも、プロンプトを表示せずにバックアップします。このプロンプトは、バックアップを自動化する (たとえば、スクリプトを使用して) 場合に使用します。 \-k, --skip-verification オプション。 データベースのバックアップの整合性を検証しないでください。 \--multithreaded 任意の項目です。バージョン 2021.1 での追加 Tableau Server のバックアップを作成する場合、既定では単一のスレッドが使用されます。このオプションを指定すると、複数のスレッドを使用したバックアップが作成されます。このオプションを指定すると、既定で 2 つのスレッドが使用されます。使用するスレッドの数は `[backup.zstd.thread_count](https://help.tableau.com/current/server-linux/ja-jp/cli_configuration-set_tsm.htm#backup_threads)` 構成キーを設定して変更できます。 \--override-disk-space-check オプション。 ディスク容量の低下が警告されている場合でもバックアップの作成を試行します。 \-po, --pg-only オプション。 リポジトリ バックアップのみを生成します。 **重要:** Tableau サポートからの指示がない限り、バックアップを生成するときに `pg-only` オプションを使用しないでください。このオプションはリポジトリのみをバックアップし、Server の復元には使用_できません_。主な用途はトラブルシューティングであり、必要があれば Tableau サポートから `--pg-only` バックアップを作成するように依頼されます。 \--request-timeout オプション。 コマンドが終了するまでの待機秒数既定値は 86400 (1440 分) です。 \-sd, --schedule-days オプション。バージョン 2020.4 での追加 スケジュールを実行する日数週単位のスケジュールには 1 ～ 7 (月曜日は 1、日曜日は 7)、月単位のスケジュールには 1 ～ 31 を使用します (月に指定した日が含まれていない場合は、その月の最終日を使用します)。複数の値はコンマで区切ります。 \-si, --schedule-id オプション。バージョン 2020.4 での追加 更新する既存のスケジュールの ID を指定します。 \--skip-compression オプション。 圧縮を使用せずにバックアップを作成します。バックアップ ファイルは大きくなりますが、バックアップの完了にかかる合計時間が短くできます。これをマルチノード インストールで使用している場合は、ファイル ストア インスタンスを最初のノードで構成することを強くお勧めします。 \-sn, --schedule-name オプション。バージョン 2020.4 での追加 作成または更新するスケジュールの名前を指定します。 \-sr, --schedule-recurrence オプション。バージョン 2020.4 での追加 スケジュールを繰り返す頻度有効なオプションは、"毎日"、"毎週"、"毎月".です。 \-st, --schedule-time オプション。バージョン 2020.4 での追加 スケジュールを実行する必要がある時刻 (24 時間形式: HH:MM)。 ### 例 この例では、次のように `/var/opt/tableau/tableau_server/data/tabsvc/files/backups/` ディレクトリに `ts_backup-.tsbak` というバックアップを作成します。 `tsm maintenance backup -f ts_backup -d` この例では、毎週土曜日の正午に実行する "weekly-saturday-backup" という名前の毎週定期的に行うバックアップ スケジュールを作成し、`-ts_saturday_backup.tsbak`: という名前のバックアップを作成します。 tsm maintenance backup -f ts\_saturday\_backup -sr weekly -st 12:00 -sd 6 -sn weekly-saturday-backup スケジュールされたバックアップの管理の詳細については、[バックアップのスケジュール設定と管理](https://help.tableau.com/current/server-linux/ja-jp/db_backup.htm#ScheduleBackups)を参照してください。 ## tsm maintenance cleanup 既定では、`tsm maintenance cleanup` コマンドは、1 日以上経過した一時ファイルとログ ファイルを削除します。コマンド オプションを使用して、保持期間や削除するファイルを変更できます。**注:** このコマンドでは crashdump ファイルは削除されません。 このコマンドの影響は、Tableau Server が実行中かどうかよって異なります。 - サーバーが実行されている場合、ほとんどの古いファイルと `http_requests` テーブルのエントリは削除できますが、Tableau Server プロセスの一時ディレクトリの下にあるファイルは、プロセスが実行されている場合には削除されません。すべての一時ファイルを完全に削除するには、このコマンドの実行前にサーバーを停止する必要があります。`http_requests` テーブル エントリを削除するには、`-q` オプションを使用します。 - サーバーが停止している場合、`http_requests` エントリは削除できません。 Tableau Server を分散型の展開で実行している場合は、このコマンドを管理コントローラ (_TSM コントローラ_とも呼ばれる) プロセスを実行しているノード上で実行してください。既定では、コントローラーはほとんどの場合、クラスターの初期ノード上にあります。 **注:** このコマンドは、Tableau Server バージョン 10.5.1 で追加されました。また、一部のオプションはバージョン 2018.1 で追加されました。 ### シノプシス `tsm maintenance cleanup [options] [global options]` ### オプション \-a, --all オプション。 既定の保持値を使用してすべてのクリーンアップ操作を実行します。 `-l -t -r -q -ic` オプションを指定して `cleanup` コマンドを実行する操作と同じです。 \--http-requests-table-retention <# of days> オプション。 既定: 7 日 保持するテーブル エントリの `http_requests` 日数を指定します。このオプションを `-q` と一緒に使用すると、保持するテーブル エントリの日数を指定して、既定の 7 日間を上書きすることができます。このオプションはテーブル エントリの保持期間を指定しますが、テーブル エントリの実際の削除をトリガーしません。これを `-q` オプションと一緒に使用すると、エントリの削除がトリガーされます。 \-ic, --sheet-image-cache オプション。バージョン 2019.4 での追加 イメージのキャッシュをクリアします。このキャッシュには、オフライン プレビューのイメージ、サブスクリプション メール メッセージのスナップショット、サブスクリプション PDF、およびパブリッシュされた REST API エンドポイントで要求されたすべてのイメージが含まれている可能性があります。（詳細については、[「rest\_api\_ref.htm」](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#query_view_image)を参照してください。） \-l, --log-files オプション。 1 日以上前のログ ファイルを削除します。`data/tabsvc/logs` の下にあるサブディレクトリのファイルは削除されます。 \--log-files-retention <# of days> オプション。 既定: 1 (24 時間) この日数より古いログを削除します。このオプションを使用して、既定の保持期間 (1 日) を上書きすることができます。このコマンドは、一時ファイルには適用されません。 \-q, --http-requests-table オプション。 古い `http_requests` テーブル エントリーを削除します。テーブル エントリを削除するには、Tableau Server が実行されている必要があります。Tableau Server が停止している場合、このオプションは無視されます。このオプションのみを使用して、既定の保持期間 (7 日) より古いエントリの削除を指定したり、`--http-requests-table-retention` と一緒に使用して既定以外の保持期間を指定したりできます。 **注:**`http_requests` テーブル エントリを削除すると、カスタム管理ビューで使用できるデータが完全に削除されます。このデータを削除しても、必要なカスタム ビューに影響しないことを確認してください。 \-r, --redis-cache オプション。 Redis キャッシュをクリアします。 \--request-timeout オプション。 既定: 3600 コマンドが終了するまで指定した時間待機します。 \-t, --temp-files オプション。 以下のディレクトリにあるすべてのファイルとサブディレクトリを削除します。 - `/var/opt/tableau/tableau_server/data/tabsvc/temp`: 各 Tableau Server プロセス ディレクトリの下のファイルを削除するには、コマンドを実行する前に Tableau Server を停止する必要があります。 - `/var/opt/tableau/tableau_server/data/tabsvc/httpd/temp` - `/var/opt/tableau/tableau_server/temp` ### 例 この例では、2 日を超えて経過したすべてのログ ファイルがクリーン アップされます。 `tsm maintenance cleanup -l --log-files-retention 2` ## tsm maintenance jmx disable **バージョン:** バージョン 2022.1 で追加されたコマンド Tableau Server で JMX を無効にするには、`tsm maintenance jmx disable` コマンドを使用します。 このコマンドを実行するには、TSM サービスを含む Tableau Server を再起動する必要があります。 ### シノプシス tsm maintenance jmx disable \[options\] \[global options\] ### オプション \--ignore-prompt オプション。 プロンプトを表示せずに JMX を無効にします。 \--request-timeout オプション。 コマンドが終了するまで指定した時間待機します。 ## tsm maintenance jmx enable **バージョン:** バージョン 2022.1 で追加されたコマンド Tableau Server で JMX を有効にするには、`tsm maintenance jmx enable` コマンドを使用します。 このコマンドはインタラクティブであり、コマンド ライン パラメーターとしてオプションを指定しない場合は、適用可能なオプションの入力を求めるプロンプトが表示されます。 このコマンドを実行するには、TSM サービスを含む Tableau Server を再起動する必要があります。 ### シノプシス ``` tsm maintenance jmx enable ``` ### オプション \--access オプション。 読み取り専用または読み取り/書き込みアクセスのいずれかで JMX を有効にします。既定は `readonly` です。 \--ignore-prompt オプション。 追加のセキュリティ オプションのプロンプトを表示せずに JMX を有効にします。これにより、他のコマンド オプションを含めない場合は、SSL を使用した JMX が有効になり、Tableau Server を再起動します。例: tsm maintenance jmx enable --ignore-prompt \--no-ssl オプション。 SSL なしで JMX を有効にします。 \--request-timeout オプション。 コマンドが終了するまで指定した時間待機します。 \--ssl-client-auth オプション。 SSL のクライアント認証を要求する JMX を有効にします。 \--unsecured オプション。 セキュリティ機能を有効にせずに JMX を有効にします (これは推奨されていません)。これは、2022.1 より前のバージョンで `[service.jmx_enabled](https://help.tableau.com/current/server-linux/ja-jp/cli_configuration-set_tsm.htm#service_jmx_enabled)` 構成キーを `true` に設定することと同じです。 ## tsm maintenance log-levels list **バージョン:** バージョン 2026.2 で追加されたコマンド `tsm maintenance log-levels list` コマンドを実行すると、すべてのログ レベルの構成とその値がアルファベット順に一覧表示されます。 ### シノプシス ``` tsm maintenance log-levels list [global options] ``` ### オプション このコマンドでは、グローバル オプションのみを使用します。 ## tsm maintenance log-levels reset **バージョン:** バージョン 2026.2 で追加されたコマンド `tsm maintenance log-levels reset` コマンドを使用すると、すべてのログレベル構成が既定値にリセットされます。このコマンドを実行すると、変更が `tsm pending-changes list` に追加されます。リストには変更されたログ レベルのみが表示され、Tableau Server を再起動する必要があるかどうかが示されます。 変更を適用するには `tsm pending-changes apply` を使用し、変更を破棄するには `tsm pending-changes discard` を使用します。 詳細については、「[tsm pending-changes](https://help.tableau.com/current/server-linux/ja-jp/cli_pending-changes.htm)」および「[ロギング レベルの変更](https://help.tableau.com/current/server-linux/ja-jp/logs_debug_level.htm)」参照してください。 ### シノプシス ``` tsm maintenance log-levels reset [global options] ``` ### オプション このコマンドでは、グローバル オプションのみを使用します。 ## tsm maintenance metadata-services disable **バージョン:** バージョン 2019.3 で追加されたコマンド `tsm maintenance metadata-services disable` コマンドを使用して、Tableau メタデータ API を無効にします。 メタデータ API を無効にすると、Tableau Server でコンテンツに関する情報の継続的な取り込みとインデックス化が停止し、Tableau Server およびそのコンテンツに関連付けられたアセットにパブリッシュされたコンテンツに関する情報のインデックスが削除され、メタデータ API に対するクエリと Tableau Catalog へのアクセスを行う機能の両方が無効になります。 このコマンドの実行を停止し、Tableau Server で使用するいくつかのサービスを起動します。これによって、推奨事項など一部の機能が一時的に使用できなくなります。 ### シノプシス ``` tsm maintenance metadata-services disable ``` ### オプション \--ignore-prompt オプション。 メタデータ API を無効にするときに行う確認の要求を却下します。 ## tsm maintenance metadata-services enable **バージョン:** バージョン 2019.3 で追加されたコマンド `tsm maintenance metadata-services enable` コマンドを使用して、Tableau Server の Tableau メタデータ API を有効にします。 Tableau Server が データ管理 でライセンスされている場合は、メタデータ API を有効にすると Tableau Catalog が有効になります。 メタデータ API を有効にすると、Tableau Server のコンテンツに関する情報が取り込まれ、メタデータ API ストアにインデックス化されます。メタデータ API を使用して、Tableau Server にパブリッシュされたコンテンツに関するスキーマ、系列、ユーザーが管理するメタデータをクエリできます。メタデータ API を有効にした後は、メタデータ API が無効になるまでメタデータは継続的に取り込まれ、インデックス化されます。 このコマンドを実行するときは、次の点に留意してください。 - このコマンドでは、Tableau Server で使用されているいくつかのサービスが停止してから起動します。これによって、ユーザーは推奨事項などの一部の機能を一時的に使用できなくなります。 - このコマンドを使用するたびに、メタデータの新しいインデックスが作成されて前のインデックスが置き換えられます。 Tableau Catalog の詳細については、「[Tableau Catalog について](https://help.tableau.com/current/server-linux/ja-jp/dm_catalog_overview.htm)」を参照してください。 ### シノプシス ``` tsm maintenance metadata-services enable ``` ### オプション \--ignore-prompt オプション。 メタデータ API を有効にするときに行う確認の要求を却下します。 ## tsm maintenance metadata-services get-status **バージョン:** バージョン 2019.3 で追加されたコマンド `tsm maintenance metadata-services get-status` コマンドを使用して、メタデータ サービスのステータス情報を取得します。 メタデータ サービスのステータスは、メタデータ API ストアが初期化されたかどうか、Tableau メタデータ API が実行されているかどうかを示します。 ### シノプシス ``` tsm maintenance metadata-services get-status ``` ## tsm maintenance reindex-search `tsm maintenance reindex-search` コマンドを使用して検索インデックスを再構築します。 ### シノプシス `tsm maintenance reindex-search [options] [global options]` ### オプション \--request-timeout オプション。 コマンドが終了するまで指定した時間待機します。 ## tsm maintenance reset-searchserver **バージョン:** このコマンドは 2023.3.0 で廃止 (削除) され、検索と参照 (検索サーバーとも呼ばれます) は廃止されました。検索と参照は、インデックスと検索サーバーに置き換えられました。 **注:** バージョン 2023.3.0 以降でこのコマンドを実行しても何も起こりません。 検索サーバーをクリーンな状態にリセットし、検索情報を削除して検索インデックスを再構築します。 ### シノプシス `tsm maintenance reset-searchserver [options] [global options]` ### オプション \--request-timeout オプション。 コマンドが終了するまで指定した時間待機します。 ## tsm maintenance restore 指定したバックアップ ファイルを使用して、Tableau Server を復元します。バックアップ ファイルを復元しても、構成データは復元されません。「[Tableau Server の完全なバックアップと復元を実行します](https://help.tableau.com/current/server-linux/ja-jp/backup_restore.htm)」を参照してください。 稼働中のサーバーと同じタイプのアイデンティティ ストアを持つバックアップからのみ復元可能です。たとえば、ローカル認証を使用しているサーバーからのバックアップは、ローカル認証で初期化された Tableau Server に復元可能ですが、Active Directory 認証を使用しているサーバーからのバックアップは、ローカル認証で初期化されたサーバーには復元できません。 バージョン 2022.3 以降、tabadmin を使用して作成したバックアップ (「以前の TSM バックアップ」) はサポートされていません。TSM 以前のバックアップを Tableau Server バージョン 2022.3 以降に復元することはできません。 ### シノプシス `tsm maintenance restore --file [--restart-server] [global options]` ### オプション \-f, --file 必須。 復元するバックアップ ファイルを指定します。 `restore` コマンドは、TSM の `basefilepath.backuprestore` 変数で定義したディレクトリにバックアップ ファイルがあることを前提としています。既定のディレクトリは次のとおりです。 `` `/var/opt/tableau/tableau_server/data/tabsvc/files/backups/` `` ファイル パスとその変更方法の詳細については、[tsm ファイル パス](https://help.tableau.com/current/server-linux/ja-jp/cli_default_filepaths_tsm.htm)を参照してください。 \-ak, --asset-key-file オプション。バージョン 2021.4.0 で非推奨になりました。 このオプションは、Tableau Server (バージョン 2018.1 以前) で tabadmin により作成されたアセットから復元する場合にのみ指定します。 復元元のアセット キー ファイルの名前。アセット キー ファイルは、`tabadmin assetkeys` コマンドによって作成されます。ファイルがサーバー上の事前に定義されたバックアップ/復元場所に置かれている必要があります。 \-k, --skip-identity-store-verification オプション。このオプションは、Tableau Server (バージョン 2018.1 以前) で tabadmin により作成されたバックアップ ファイルから復元する場合にのみ指定します。 元のバックアップ ファイルを作成した Tableau Server からアイデンティティ ストアのタイプを変更する場合は、このキーを使用しないでください。ID ストアを変更するには、[アイデンティティ ストアの変更](https://help.tableau.com/current/server-linux/ja-jp/reconfig_change_auth.htm) を参照してください。 \-po, --pg-only オプション。 リポジトリのみを復元します。 \-r, --restart-server オプション。 復元後にサーバーを再起動します。 \--request-timeout オプション。 コマンドが終了するまで指定した時間待機します。 ## tsm maintenance send-logs 指定したファイルを Tableau にアップロードし、サポートするケースと関連付けます。Tableau にファイルを正常にアップロードするには、Tableau Server が送信ログ サーバーと通信できる必要があります。詳細については、「[インターネットとの通信](https://help.tableau.com/current/server-linux/ja-jp/plan_network.htm)」を参照してください。 ### シノプシス `tsm maintenance send-logs --case --email --file [global options]` ### オプション \-c,--case 必須。 サポートするケースの番号。 \-e,--email 必須。 連絡先メール。 \-f, --file 必須。 送信するログ ファイル アーカイブの場所と名前を指定します。 \--request-timeout オプション。 コマンドが終了するまで指定した時間待機します。 ## tsm maintenance snapshot-backup complete **バージョン:** コマンドはバージョン 2020.1 で追加され、Tableau Server が外部ファイル ストア用に構成されている場合にのみ使用できます。 Tableau Server でスナップショット バックアップ プロセスを完了します。外部ストレージのスナップショット バックアップを作成した後、この手順を実行します。 _tsm maintenance snapshot-backup prepare_ コマンドと _tsm maintenance snapshot-backup complete_ コマンドは、外部ファイル ストアを使用して構成された Tableau Server インストール用の Tableau Server データのバックアップを作成するために使用します。詳細については、「[外部ファイル ストアによるバックアップと復元](https://help.tableau.com/current/server-linux/ja-jp/server_external_filestore_storage_backup_restore.htm)」を参照してください。 ### シノプシス `tsm maintenance snapshot-backup complete [options] [global options]` ### オプション \--request-timeout オプション。 コマンドが終了するまで指定した時間待機します。 ## tsm maintenance snapshot-backup prepare **バージョン:** コマンドはバージョン 2020.1 で追加され、Tableau Server が外部ファイル ストア用に構成されている場合にのみ使用できます。 スナップショット バックアップの準備を行います。準備手順が完了したら、ネットワーク ストレージのスナップショット バックアップを作成できます。 `tsm maintenance snapshot-backup prepare` コマンドと `tsm maintenace snapshot-backup complete` コマンドは、外部ファイル ストアを使用して構成された Tableau Server インストールを行うための Tableau Server データのバックアップを作成するために使用します。詳細については、「[外部ファイル ストアによるバックアップと復元](https://help.tableau.com/current/server-linux/ja-jp/server_external_filestore_storage_backup_restore.htm)」を参照してください。 ### シノプシス `tsm maintenance snapshot-backup prepare [options] [global options]` ### オプション \--include-pg-backup 任意の項目です。バージョン 2021.1 での追加以前のバージョンには、常に外部リポジトリのバックアップが含まれていました。 任意の項目です。 リポジトリのバックアップが作成され、ネットワーク共有にコピーされます。これは、外部リポジトリと外部ファイル ストアの両方が構成されている展開にのみ適用されます。詳細については、[外部ファイル ストアによるバックアップと復元](https://help.tableau.com/current/server-linux/ja-jp/server_external_filestore_storage_backup_restore.htm)を参照してください。 \--request-timeout オプション。 コマンドが終了するまで指定した時間待機します。 ## tsm maintenance snapshot-backup restore **バージョン:** コマンドはバージョン 2020.1 で追加され、Tableau Server が外部ファイル ストア用に構成されている場合にのみ使用できます。 ストレージ スナップショットから Tableau Server にリポジトリ バックアップを復元します。 詳細については、「[外部ファイル ストアによるバックアップと復元](https://help.tableau.com/current/server-linux/ja-jp/server_external_filestore_storage_backup_restore.htm)」を参照してください。 ### シノプシス `tsm maintenance snapshot-backup restore [options] [global options]` ### オプション \--request-timeout オプション。 コマンドが終了するまで指定した時間待機します。 ## tsm maintenance validate-backup-basefilepath **バージョン:** バージョン 2022.1 で追加されたコマンド バックアップ / 復元のベース ファイルパスの場所に、バックアップおよび復元機能が正常に動作するための正しいパーミッションがあることを確認します。バックアップと復元のベースファイルパスを設定した後、これを実行します。詳細については、[現在のベース ファイルパスの場所を変更する](https://help.tableau.com/current/server-linux/ja-jp/cli_default_filepaths_tsm.htm#ChangeBasepath)を参照してください。 ### シノプシス `tsm maintenance validate-backup-basefilepath [options][global options]` ### オプション \--request-timeout オプション。 コマンドが終了するまで指定した時間待機します。 ## tsm maintenance validate-resources サイトのワークブックおよびデータ ソースを検証します。サイトを移行する前にこのコマンドを使用して、サイトのインポートが失敗する原因となるワークブックやデータソースなどのサイトリソースに関する問題を検出します。リソースの問題の中には、ローカルソースから再発行することで解決できるものもあります。その他の問題では、Tableau サポートのサポートが必要になる場合があります。 ### シノプシス `tsm maintenance validate-resources --site-id [global options]` ### オプション \-id,--site-id 必須。 リソースの検証を行っているサイトの ID。 \-r,--repair オプション。 無効なリソースの修復を試みます。修復できないものは出力に記載されています。 \--request-timeout オプション。 コマンドが終了するまで指定した時間待機します。 ## tsm maintenance ziplogs `ziplogs` コマンドを使用して、Tableau Server ログ ファイルのアーカイブを作成します。 **注:** ziplogs コマンドを正常に実行できない場合は、Tableau Server ログを手動で圧縮できます。詳細については、「[Linux での Tableau Server のトラブルシューティング](https://help.tableau.com/current/server-linux/ja-jp/troubleshoot_linux.htm#ManuallyGatherLogs)」を参照してください。 ### シノプシス `tsm maintenance ziplogs [options] [global options]` ### オプション \-a, --all オプション。 PostgreSQL データ以外のすべてのファイルを含めます。 \-d, --with-postgresql-data オプション。 Tableau Server が停止している場合は PostgreSQL データ フォルダーを含め、Tableau Server が実行中の場合は PostgreSQL ダンプ ファイルを含めます。このフラグは、[Tableau Server 外部リポジトリ](https://help.tableau.com/current/server-linux/ja-jp/server_external_repo.htm)で実行されている展開では無視されます。 \--enddate "" オプション。時刻オプション (`H:mm`) がバージョン 2021.4.0 で追加されました。 含むべきログ ファイルの最終日付。このオプションは `--startdate` と一緒に使用する必要があり、`--minimumdate` オプションとは一緒に使用できません。このオプションを指定しない場合は、00:00 GMT (グリニッジ標準時) を開始時刻として、最大 2 日間のログが含まれます。 時刻オプションを含める場合は、日付と時刻を引用符で囲む必要があります。時間オプションは GMT を使用しますが、結果のログ ファイルは Tableau Server マシンのローカル タイム ゾーンを使用して書き込まれます。 例: Tableau Server マシンのローカル タイム ゾーンが PDT で、ログ ファイルを 2022 年 7 月 28 日の午前 7 時 (太平洋夏時間) に開始し、午後 7 時 (太平洋夏時間) に終了する場合は、次を使用します。 ``` tsm maintenance ziplogs -f logs.zip --startdate "07/28/2022 14:00" --enddate "07/29/2022 02:00" ``` \-f, --file オプション。 zip 形式で圧縮されたアーカイブ ファイルの名前を指定します。名前が指定されていない場合は logs.zip となります。ファイルは `basefilepath.log_archive` 変数で TSM に定義したディレクトリに書き込まれます。既定のディレクトリは次のとおりです。 `/var/opt/tableau/tableau_server/data/tabsvc/files/log-archives/` ファイル パスとその変更方法の詳細については、[tsm ファイル パス](https://help.tableau.com/current/server-linux/ja-jp/cli_default_filepaths_tsm.htm)を参照してください。 \-i, --description オプション。 指定したアーカイブ ファイルの説明が含まれます。 \-l, --with-latest-dump オプション。 いずれかのサービスがクラッシュすると、Tableau Server がダンプ ファイルを生成します。このオプションを設定すると、最新のサービス クラッシュ ダンプ ファイルが追加されます。このオプションを設定しない場合、結果として生成される ziplog にはダンプ ファイルが追加されません。 \-m, --minimumdate オプション。 ログ ファイルを最初に含めた日付。指定しない場合は、ログ ファイルの中から最大で 2 日間が含まれます。日付形式は`mm/dd/yyyy` で指定する必要があります。.このオプションは、`--startdate` および `--enddate` または `--all` と一緒に使用することはできません。 \--nodes 任意の項目です。バージョン 2020.3 での追加 ziplog ファイルを作成するノードを指定します。指定しない場合、すべてのノードで ziplog ファイルが作成され、初期ノードに保存されます。ノードはコンマで区切ります。たとえば、ノード 2 と 4 のログを収集するには、次の手順を実行します。 tsm maintenance ziplogs --nodes node2,node4 \-o、--overwrite オプション。 既存の ziplog ファイルの上書き。同じ名前のファイルが既に存在していてこのオプションが使用されていない場合、ziplog コマンドは失敗します。 既定では、ファイルは次のように書き込まれます。 `/var/opt/tableau/tableau_server/data/tabsvc/files/log-archives/` ファイル パスとその変更方法の詳細については、[tsm ファイル パス](https://help.tableau.com/current/server-linux/ja-jp/cli_default_filepaths_tsm.htm)を参照してください。 \--request-timeout 任意の項目です。 コマンドが終了するまでの待機秒数既定値は 7200 (120 分) です。 \--startdate "" オプション。時刻オプション (`H:mm`) がバージョン 2021.4.0 で追加されました。 含むべきログ ファイルの最終日付。このオプションは `--enddate` と一緒に使用する必要があり、`--minimumdate` オプションとは一緒に使用できません。このオプションを指定しない場合は、00:00 GMT (グリニッジ標準時) を開始時刻として、最大 2 日間のログが含まれます。 時刻オプションを含める場合は、日付と時刻を引用符で囲む必要があります。時間オプションは GMT を使用しますが、結果のログ ファイルは Tableau Server マシンのローカル タイム ゾーンを使用して書き込まれます。 例: Tableau Server マシンのローカル タイム ゾーンが PDT で、ログ ファイルを 2022 年 7 月 28 日の午前 7 時 (太平洋夏時間) に開始し、午後 7 時 (太平洋夏時間) に終了する場合は、次を使用します。 ``` tsm maintenance ziplogs -f logs.zip --startdate "07/28/2022 14:00" --enddate "07/29/2022 02:00" ``` ## グローバル オプション \-h, --help オプション。 コマンドのヘルプを表示します。 \-p, --password アクティブなセッションがない場合は、必要に応じて `-u` または `--username` と一緒に使用します。 `-u` または `--username` で指定されたユーザーのパスワードを指定します。 パスワードにスペースや特殊文字が含まれる場合、パスワードを引用符で囲みます。 `--password 'my password'` \-s, --server https://:8850 オプション。 Tableau Services Manager で指定したアドレスを使用します。URL は `https` で始まる必要があります。また、ポート 8850 を含めるとともに、IP アドレスではなくサーバー名を使用します。例: `https://:8850`。サーバーが指定されていない場合は、仮に `https://:8850` とします。 \--trust-admin-controller-cert オプション。 このフラグは、TSM コントローラーで自己署名証明書を信頼するために使用します。証明書の信頼および CLI 接続の詳細については、[TSM クライアントの接続](https://help.tableau.com/current/server-linux/ja-jp/tsm_overview.htm#Connecti)を参照してください。 \-u, --username アクティブなセッションがない場合は、必要に応じて `-p` または `--password` と一緒に使用します。 ユーザー アカウントを指定します。このオプションが含まれていない場合は、コマンドがサインインに使用した認証資格情報を使用して実行されています。