---
schema_version: "1"
id: 25919df47dd269684d31e7e2a55ea99a7ea1bd53cd3065cb7d5a93b375391d61
title: tsm topology
collection: tableau
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/tableau/current/ja-jp/server/cli_topology_tsm.md
canonical_url: https://help.tableau.com/current/server/ja-jp/cli_topology_tsm.htm
source_site: help.tableau.com
content_type: documentation
content_hash: ff9d5449c4b90a35761f900dfa4e4171a511935be69fa1634a9429f1e10ae44e
description: Reference for tsm topology commands to manage nodes, repository failover, and external services.
---
[メイン コンテンツに進む](#main-content)

# tsm topology

`tsm topology` コマンドを使用してファイル ストア ノードを安全に取り外す準備をするか、読み取り/書き込みモードに戻します。また、リポジトリのフェールオーバー開始、ノードまたはポートのリスト取得、クラスタにノードを追加するために必要な bootstrap 構成ファイルの取得、ノードの削除、外部リポジトリと外部ファイル ストアの構成も実行できます。

**重要:** トポロジに変更を加える場合、変更を有効にするには、保留中の変更を適用する必要があります。詳細については、[tsm pending-changes](https://help.tableau.com/current/server/ja-jp/cli_pending-changes.htm)を参照してください。

- [cleanup-coordination-service](#TSMCleanupCoordination)
- [deploy-coordination-service](#TSMDeployCoordination)
- external-services
    - gateway
        - [gateway disable](#TSMIndependentGatewayDisable)
        - [gateway enable](#TSMIndependentGatewayEnable)
        - [gateway update](#TSMIndependentGatewayUpdate)
    - [list](#tsmExteranalServicesList)
    - repository
        - [disable](#TSMExternalRepoDisable)
        - [enable](#TSMExternalRepoEnable)
        - [replace-host](#tsmExternalRepoReplaceHost)
    - storage (filestore)
        - [storage disable](#TSMExternalStorageDisable)
        - [storage enable](#TSMExternalStorageEnable)
        - [storage switch-share](#TSMExternalStorageSwitchShare)
- [failover-repository](#TSMFailoverRepository)
- filestore
    - [decommission](#TSMDecommission)
    - [recommission](#topology-recommission)
- [list-nodes](#TSMListNodes)
- [list-ports](#TSMListPorts)
- node-nickname
    - [list](#TSMNodeNicknameList)
    - [remove](#TSMNodeNicknameRemove)
    - [set](#TSMNodeNicknameSet)
- nodes
    - [get-bootstrap-file](#TSMGetBootstrap)
- [remove-nodes](#TSMRemoveNodes)
- [set-node-role](#TSMSetNodeRole)
- [set-ports](#TSMSetPorts)
- [set-process](#TSMSetProcess)
- [toggle-coordination-service](#TSMToggleCoordination)

## tsm topology cleanup-coordination-service

**注:** バージョン 2020.1.0 以降、すべての調整サービス アンサンブルのコマンドでは、サーバーの再起動が行われることを確認する「y/n」プロンプトの入力が必要になります。入力せずにこれらのコマンドを実行するには、`--ignore-prompt` オプションを含めます。

`tsm topology cleanup-coordination-service` コマンドを使用して、新しいアンサンブルを展開した後に稼働中でない Tableau Server 調整サービス アンサンブルを削除します。このコマンドによって、稼働中でない調整サービス アンサンブルのすべてのノードで古い調整サービス インスタンスを削除します。また、このコマンドは新しい調整サービス アンサンブルを展開した後で必要となります。調整サービス アンサンブルについての詳細は、[調整サービス アンサンブルの展開](https://help.tableau.com/current/server/ja-jp/distrib_ha_zk.htm)を参照してください。

バージョン 2020.1.0 以降では、`tsm topology deploy-coordination-service` コマンドにより古いアンサンブルも削除されます。展開が失敗しない限り、このコマンドを個別に実行する必要はありません。

### シノプシス

`tsm topology cleanup-coordination-service [option] [global options]`

### オプション

\--request-timeout <timeout in seconds>

オプション。

コマンドが終了するまで指定した時間待機します。既定値は 2700 (45 分) です。

## tsm topology deploy-coordination-service

**注:** バージョン 2020.1.0 以降、すべての調整サービス アンサンブルのコマンドでは、サーバーの再起動が行われることを確認する「y/n」プロンプトの入力が必要になります。入力せずにこれらのコマンドを実行するには、`--ignore-prompt` オプションを含めます。

`tsm topology deploy-coordination-service` コマンドを使用して、Tableau Server 調整サービス アンサンブルを展開できます。このコマンドは、サーバー クラスタの指定ノード上で実行される調整サービス インスタンス セットである調整サービス アンサンブルを展開します。クラスタ内で何台のノードに調整サービス インスタンスを含めるかなど、調整サービス アンサンブルの詳細については、[調整サービス アンサンブルの展開](https://help.tableau.com/current/server/ja-jp/distrib_ha_zk.htm)を参照してください。

バージョン 2020.1.0 以降では、`tsm topology deploy-coordination-service` コマンドにより古いアンサンブルも削除されます。`cleanup-coordination-service` コマンドを個別に実行する必要はありません。

### シノプシス

`tsm topology deploy-coordination-service --nodes <nodeID,nodeID,...> [option] [global-options]`

### オプション

\-n, --nodes <nodeID,nodeID,...>

必須。

新しい調整サービス アンサンブル内に含まれるノードのコンマで区切られたノード ID。クラスタ内の合計ノード数により、1、3 または 5 台の調整サービス ノードを指定できます。詳細については、[調整サービス クォーラム](https://help.tableau.com/current/server/ja-jp/distrib_ha_zk.htm#ZKquorum)を参照してください。

\--request-timeout <timeout in seconds>

オプション。

コマンドが終了するまで指定した時間待機します。既定値は 2700 (45 分) です。

## tsm topology external-services gateway disable

Tableau Server 上の独立したゲートウェイのすべてのインスタンスを無効にします。

### シノプシス

tsm topology external-services gateway disable \[options\] \[global options\]

### オプション

\--request-timeout <timeout in seconds>

オプション。

コマンドが終了するまで指定した時間待機します。既定値は 2700 (45 分) です。

## tsm topology external-services gateway enable

Tableau Server 上の独立したゲートウェイのインスタンスを有効にします。

### シノプシス

tsm topology external-services gateway enable \[options\] \[global options\]

### オプション

\-c, --config <configuration-file>

必須

独立したゲートウェイのすべてのインスタンスの構成詳細を含む JSON ファイルの名前を指定します。

## tsm topology external-services gateway update

このコマンドを使用して、Tableau Server の独立したゲートウェイの構成を更新します。独立したゲートウェイのインスタンスを追加または削除する場合、または独立したゲートウェイをアップグレードする場合は、これを行う必要があります。このコマンドを実行する前に、独立したゲートウェイのコンピューター上の変更を収集し、構成ファイルを更新してください。

### シノプシス

tsm topology external-services gateway update \[option\] \[global options\]

### オプション

\-c, --config <configuration-file>

必須

独立したゲートウェイのすべてのインスタンスの構成詳細を含む JSON ファイルの名前を指定します。

## tsm topology external-services list

tsm topology external-service-list コマンドは、Tableau Server 外部リポジトリ用に使用されるサービスを取得するのに使用します。たとえば、Amazon RDS を使用するように Tableau Server を構成している場合、次のメッセージが表示されます。

これらの外部で構成されたサービスは Tableau Server によって現在使用されています。

\- pgsql

### シノプシス

tsm topology external-service list \[global options\]

### オプション

このコマンドにはオプションはありません。

## tsm topology external-services repository disable -n nodeN

tsm topology external-services repository disable コマンドは、外部リポジトリの使用を停止し、ローカル リポジトリを使用するようにインストールを再構成するのに使用します。これにより、データがローカル リポジトリに移行され、ローカル リポジトリを使用するように Tableau Server が構成されます。

### シノプシス

tsm topology external-services repository disable -n nodeN

### オプション

\-n, --node-name <nodeID>

必須。

リポジトリを移動する必要があるノードのノード ID を指定します。

> [!IMPORTANT]
> 
> **重要:** これにより RDS インスタンスが停止したり削除されたりすることはありません。RDS インスタンスを削除する方法の詳細については、AWS の Web サイトで[「DB インスタンスを削除する」](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DeleteInstance.html#USER_DeleteInstance.NoSnapshot)を参照してください。

## tsm topology external-services repository enable

tsm topology external-services repository enable コマンドは、外部リポジトリを使用するように Tableau Server を構成するのに使用します。このコマンドは、新しい Tableau Server のインストール時に外部リポジトリを構成するために使用できます。このコマンドを既に存在する実行中の Tableau Server で実行する場合、データがローカル ノードから外部リポジトリに移行され、移行完了後は外部リポジトリを使用するように Tableau Server を構成します。

### シノプシス

tsm topology external-services repository enable -f <filename>.json -c <ssl certificate file>.pem

### オプション

\--f <file name>

必須。

構成ファイルを保存するフル パスとファイル名。詳細については、[Tableau Server リポジトリの再構成](https://help.tableau.com/current/server/ja-jp/server_external_repo_reconfigure.htm)を参照してください。

\--c <ssl certificate file>

バージョン 2021.2 および 2021.2.1 に必要です。バージョン 2021.2.2 以降ではオプションです。

SSL 構成の場合は、このオプションで使用できるように、証明書ファイルをダウンロードして、このファイルを指定します。

1. **Amazon RDS:** [「SSL を使用して DB インスタンスへの接続を暗号化する」](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts.General.SSL)を参照してください。
2. **Azure Database:** [「PostgreSQL 用 Azure Database の TLS 接続の構成」](https://docs.microsoft.com/ja-jp/azure/postgresql/concepts-ssl-connection-security)を参照してください。
3. **スタンドアロン PostgreSQL インスタンス:** 「[SSL の構成](https://help.tableau.com/current/server/ja-jp/server_external_repo_configure_standalone.htm#configure-ssl)」を参照してください。

\--no-ssl

オプション。このオプションは、2021.2.2 以降のバージョンで使用することができます。

つまり、外部リポジトリに接続するときに SSL は必要ありません。暗号化された接続を使用する必要がない場合は、暗号化されていない接続を許可するように外部リポジトリも構成する必要があります。このオプションを使用すると、外部リポジトリが TLS / SSL 接続をサポートするように構成されている場合、接続は暗号化されます。それ以外の場合、Tableau Server は暗号化されていない接続を使用します。

Tableau Server で使用するために外部リポジトリがすでに構成されているかどうかを確認するためのチェックをスキップします。このオプションでは、複数の Tableau Server インストールで同じリポジトリが使用され、エラーが発生する可能性があるため、通常はお勧めしません。このオプションは、テストまたは災害復旧の目的で役立つ場合があります。

\--skip-state-check

オプション。このオプションは、2022.3.0 以降のバージョンで使用することができます。

Tableau Server で使用するために外部リポジトリがすでに構成されているかどうかを確認するためのチェックをスキップします。このオプションでは、テストまたは災害復旧の目的で役立つ場合がありますが、複数の Tableau Server インストールで同じリポジトリが使用される可能性があるため、通常の使用にはお勧めしません。

## tsm topology external-services repository replace-host

このコマンドを使用して、指定された外部リポジトリを使用するように Tableau Server の構成設定を更新します。tsm topology external-services repository replace-host コマンドを使用して、現在の外部リポジトリからデータを移動することなく、新しい外部リポジトリを直ちに使用するように Tableau Server を再構成します。データを手動で移行する必要が生じる場合があります。この操作は、データ損失の可能性を十分に評価し、その影響を理解したうえで行う必要があります。

このコマンドは、次のシナリオで使用できます。

- RDS インスタンスで使用する SSL 証明書の予定される有効期限: RDS インスタンスを新しい証明書で更新する必要があります。また、新しい証明書ファイルを使用して RDS インスタンスに接続するように Tableau Server を構成する必要があります。
- 災害復旧: 災害復旧シナリオで新しい RDS インスタンスに接続します。詳細については、[AWS Relational Database Service (RDS) での PostgreSQL DB インスタンスの作成](https://help.tableau.com/current/server/ja-jp/server_external_repo_configure_RDS.htm#disaster-recovery-postgreSQL_DB)を参照してください。

### シノプシス

tsm topology external-services repository replace-host -f <filename>.json -c <ssl certificate file>.pem

### オプション

\-f <file name>

必須。

構成ファイルを保存するフル パスとファイル名。詳細については、[Tableau Server リポジトリの再構成](https://help.tableau.com/current/server/ja-jp/server_external_repo_reconfigure.htm)を参照してください。

\-c <ssl certificate file>

オプション。

証明書ファイルは、インスタンスへの接続を許可するためにインポートされる証明書です。RDS の場合、これは、インスタンスの証明書に署名するために使用される CA 証明書です。これは通常、最新のルート証明書である **rds-ca-XXXX-root.pem** ファイルとなります。RDS インスタンスで証明書が変更された場合は、このパラメーターを使用して Tableu Server を更新します。

詳細については、[「SSL/TLS を使用した DB インスタンスへの接続の暗号化」](https://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html "SSL/TLS を使用した DB インスタンスへの接続の暗号化")を参照してください。

.pem ファイルの取得方法の詳細については、[「SSL を使用して DB への接続を暗号化する」](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts.General.SSL)を参照してください。

\--ignore-prompt

オプション。

プロンプトを表示せずにこのコマンドを実行します。

## tsm topology external-services storage disable

ファイル ストアをローカルで実行するように Tableau Server を構成します。このコマンドを使用すると外部ファイル ストアが無効になり、ファイル ストア データが Tableau Server に移動します。

### シノプシス

tsm topology external-services storage disable \[options\] \[global options\]

### オプション

\-fsn <nodeID, nodeID,...>

必須

ファイル ストアを構成するノードを指定します。複数のノードを指定できます。データはリストの最初のノードに移行されてから他のノードにレプリケートされます。

詳細については、[ファイル ストアを再構成する](https://help.tableau.com/current/server/ja-jp/server_external_filestore_storage_reconfigure.htm)を参照してください。

## tsm topology external-services storage enable

外部ファイル ストアを使用して Tableau Server を構成します。外部ファイル ストアでは、ファイル ストア データが SAN または NAS に保存されます。

### シノプシス

tsm topology external-services storage enable \[options\] \[global options\]

### オプション

\--network-share <network share path>

必須

外部ファイル ストアに使用するネットワーク共有の名前とパスを指定します。

詳細については、[ファイル ストアを再構成する](https://help.tableau.com/current/server/ja-jp/server_external_filestore_storage_reconfigure.htm)を参照してください。

## tsm topology external-services storage switch-share

このコマンドを使用して、外部サービスを別のネットワーク共有に移動します。たとえば、現在のネットワーク接続ストレージの寿命が来たため、新しいハードウェアが搭載されている新しいネットワーク接続ストレージを使用する必要がある場合などです。詳細については、[ファイル ストアを再構成する](https://help.tableau.com/current/server/ja-jp/server_external_filestore_storage_reconfigure.htm)を参照してください。

### シノプシス

tsm topology external-services storage switch-share \[option\] \[global options\]

### オプション

\--network-share <network share path>

必須

切り替え先の新しいネットワーク共有へのパスを指定します。

## tsm topology failover-repository

`tsm topology failover-repository` コマンドを使用して、現在のアクティブなリポジトリから第二の、パッシブなリポジトリへのリポジトリのフェールオーバーを手動で開始できます。

`tsm topology failover-repository` コマンドは永続的です。フェールオーバー リポジトリは、このコマンドを再度発行するか、Tableau Server がそのように構成されている場合は自動フェールオーバーが発生するまでアクティブなリポジトリであり続けます。優先されるアクティブなリポジトリを構成済みの場合、`--preferred` オプションを使用してそのリポジトリへ切り替えます。優先するアクティブなリポジトリを構成する方法の詳細については、[Tableau Server リポジトリ](https://help.tableau.com/current/server/ja-jp/server_process_repository.htm)を参照してください。Tableau Server が高可用性用に設定されている場合、必要時のリポジトリのフェールオーバーは自動です。リポジトリを手動でフェールオーバーするには、failover-repository コマンドを使用してください。

### シノプシス

`tsm topology failover-repository --preferred | --target <node_id> [global options]`

### オプション

\-r, --preferred

\-t または --target が使用されていない場合は必須。

リポジトリ フェールオーバーのターゲットとして、構成され優先ノードを使用します。

\--request-timeout <timeout in seconds>

オプション。

コマンドが終了するまで指定した時間待機します。既定値は 1800 (30 分) です。

\-t, --target <node\_id>

\-r または --preferred が使用されていない場合は必須。

フェールオーバーが発生するターゲット ノードのノード ID。`tsm topology list-nodes` コマンドを使用してノード ID を検索します。

## tsm topology filestore decommission

`tsm topology filestore decommission` コマンドを使用して、ファイル ストア ノードを安全に取り外す準備をする必要があります。このコマンドは指定ノードを読み取り専用モードにして、指定ノード上に固有のコンテンツがないようにします。

コミッション解除の結果としてファイル ストア ノードが 1 台だけになってしまう場合、`--override` オプションを使用しないとコミッション解除が失敗します。

### シノプシス

`tsm topology filestore decommission --nodes <nodeID,nodeID,...> [options] [global options]`

### オプション

\-n, --nodes <nodeID,nodeID,...>

必須。

コンマで区切られたノード ID で指定されたコミッション解除する 1 台以上のノードのリスト。

\--delete-filestore

オプション。

コミッション解除されていない場合でも、強制的にファイル ストアを削除します。このオプションを使用するのは、ファイル ストアがあるノードがエラー状態で、コミッション解除を行えない場合のみにしてください。ノード上の一意のファイルが完全に削除されます。

\-o, --override

オプション。

対象のファイル ストア ノードを削除すると、ファイル ストア ノードが 1 台になってしまう場合に通常発生する警告または失敗を上書きします。このオプションは、`--delete-filestore` と一緒に使用することはできません。

\--request-timeout <timeout in seconds>

オプション。

コマンドが終了するまで指定した時間待機します。既定値は 1800 (30 分) です。

## tsm topology filestore recommission

`tsm topology filestore recommission` コマンドを使用してコミッション解除されたノードをすべて読み取り・書き込みモードに戻します。

### シノプシス

`tsm topology filestore recommission --nodes <nodeID,nodeID,...> [global options]`

### オプション

\-n, --nodes <nodeID,nodeID,...>

必須。

コンマで区切られたノード ID で指定された再コミッションする 1 台以上のノードのリスト。

## tsm topology list-nodes

クラスター内のノードを表示し、(オプションで) 各ノードのサービスを表示します。

### シノプシス

tsm topology list-nodes \[options\] \[global options\]

### オプション

\-v, --verbose

オプション。

各ノードの ID、ノードの役割 (詳細については、以下の「`set-node-role`」を参照)、ノードのアドレス、各ノードでのプロセスを表示します。

## tsm topology list-ports

クラスター内のポートを表示します。

### シノプシス

tsm topology list-ports \[options\] \[global options\]

### オプション

\--node-name <nodeID>

オプション。

ポートをリストするノードを指定します。

\--service-name

オプション。

ポートをリストするサービスを指定します。

## tsm topology node-nickname list

クラスタ内のノードのニックネームを表示します。

### シノプシス

tsm topology node-nickname list \[options\] \[global options\]

### オプション

\--nodes <nodeID,nodeID,...>

任意の項目です。

ニックネーム付きで一覧表示するノードのノード ID を指定します。

## tsm topology node-nickname remove

指定されたノードからニックネームを削除します。

### シノプシス

tsm topology node-nickname remove \[options\] \[global options\]

### オプション

\--all

\--nodes が指定されていない場合は必須です。

クラスタ内のすべてのノードからニックネームを削除します。

\--nodes <nodeID,nodeID,...>

\--all が指定されていない場合は必須です。

ニックネームを削除するノードのノード ID を指定します。

## tsm topology node-nickname set

指定したノードのニックネームを設定します。

### シノプシス

tsm topology node-nickname set \[options\] \[global options\]

### オプション

\-id, --node <nodeID>

必須。

ニックネームを設定するノードを指定します。

\-nn, --nickname <name>

必須。

指定したノードのニックネームです。

## tsm topology nodes get-bootstrap-file

`tsm topology nodes get-bootstrap-file` コマンドを使用して、クラスタへの新しいノードの追加に必要な bootstrap ファイルを取得できます。

**重要:** bootstrap ファイルには、構成シークレットの暗号化に使用されるマスター キーストア ファイルのコピーが含まれています。また、このファイルには事前定義された時間で有効となる埋め込み認証資格情報も含まれており ([tabadmincontroller.auth.expiration.minutes](https://help.tableau.com/current/server/ja-jp/cli_configuration-set_tsm.htm#tabadminctrlrauthexpire) を参照)、セッション Cookie として機能します。booststrap ファイルを保護するために追加措置を講じること強くお勧めします。

### シノプシス

tsm topology nodes get-bootstrap-file --file <path\\file>.json \[global options\]

### オプション

\-f,--file <file>

必須。

構成ファイルを保存するフル パスとファイル名。重複ファイルがある場合は上書きされます。

\-nec,--no-embedded-credential

オプション。

バージョン 2019.3 での追加

既定では埋め込みの認証資格情報は bootstrap ファイルに含まれています。このオプションは、bootstrap ファイルに認証資格情報を含めない場合に使用します。埋め込みの認証資格情報は一時的なもので、`[tabadmincontroller.auth.expiration.minutes](https://help.tableau.com/current/server/ja-jp/cli_configuration-set_tsm.htm#tabadminctrlrauthexpire)` 構成キーの値に基づいて有効期限が切れますが、既定では 120 分間です。

**注:** 埋め込みの認証資格情報をサーバー レベルで含める機能は、構成オプションを使用して無効にすることができます。詳細については、[features.PasswordlessBootstrapInit](https://help.tableau.com/current/server/ja-jp/cli_configuration-set_tsm.htm#pwdlessbootstrap)を参照してください。

## tsm topology remove-nodes

クラスターからノードを削除します。

ノードの削除を完了するには、`tsm pending-changes apply` コマンドも実行する必要があります。一部のシナリオでは、ノードを削除する前にプロセスを移動または再展開する必要があります。[ノードの削除](https://help.tableau.com/current/server/ja-jp/distrib_worker_remove.htm#top)を参照してください。

ノードを削除してクラスタに再追加する場合は、まず obliterate スクリプトを実行して Tableau を完全に削除し、その後、新しいノードを追加する通常のプロセスでノードを再インストールする必要があります。詳細については、[コンピュータから Tableau Server を削除する](https://help.tableau.com/current/server/ja-jp/remove_tableau.htm)および[追加のノードのインストールと構成](https://help.tableau.com/current/server/ja-jp/install_additional_nodes.htm)を参照してください。

**注**: クラスタからノードを削除する際は、過去のどこかの時点でそのノード上にプロセスが構成されていたはずです。プロセスを構成していないノードを削除しようとしている場合、まずプロセスを追加して、`[tsm pending-changes apply](https://help.tableau.com/current/server/ja-jp/cli_pending-changes.htm#pending-changes-apply)` を実行してから、ノードを削除しなくてはなりません。

### シノプシス

tsm topology remove-nodes --nodes <nodeID,nodeID,...> \[global options\]

### オプション

\-n, --nodes <nodeID,nodeID,...>

必須。

削除するノードを 1 つ以上指定します。複数のノードを指定する場合は、ノード ID の間をコンマで区切ります。

## tsm topology set-node-role

バックグラウンダーおよび抽出クエリ ノードの役割を設定します。これにより、ノード上で実行されるタスクのタイプが決まります。次のノードの役割は、マルチノード クラスタがある場合に役立ちます。異なるノードの役割には、Advanced Management と データ管理 のライセンスのいずれか、またはその両方が必要な場合があります。ライセンス要件の詳細については、[ノード ロールによるワークロード管理](https://help.tableau.com/current/server/ja-jp/server_node_roles.htm)を参照してください。

**注:** ノードの役割を構成するには、サーバーを再起動する必要があり、いくらかのダウンタイムが必要になります。詳細については、[tsm pending-changes](https://help.tableau.com/current/server/ja-jp/cli_pending-changes.htm)を参照してください。

### シノプシス

tsm topology set-node-role \[options\] \[global options\]

### オプション

\-n, --nodes <nodeID,nodeID,...>

必須。

ノード ID で指定され、コンマで区切られたノードの役割を設定する 1 台以上のノードのリスト。ノード間にスペースはありません。

\-r --role <all-jobs,flows,no-flows,extract-refreshes,subscriptions,extract-refreshes-and-subscriptions,no-extract-refreshes,no-subscriptions,no-extract-refreshes-and-subscriptions,extract-queries,extract-queries-interactive>

必須

指定されたノードの役割を設定します。このオプションの有効な値は次のとおりです。

- all-jobs: バックグラウンダーはすべてのタイプのジョブを実行します。
- flows: バックグラウンダーはフロー実行ジョブのみを実行します。
- no-flows: バックグラウンダーはフロー実行ジョブを実行しません。
- extract-refreshes: バックグラウンダーは抽出更新ジョブのみを実行します。これには、フロー出力が生成する抽出を含めすべての抽出における増分更新、完全更新、暗号化、復号化が含まれます。
- subscriptions: バックグラウンダーはサブスクリプション ジョブのみを実行します。
- extract-refreshes-and-subscriptions: バックグラウンダーは、フロー出力が作成する抽出を含めすべての抽出における extract-refreshes、暗号化、復号化のほか、サブスクリプション ジョブを実行します。
- no-extract-refreshes: バックグラウンダーは、フロー出力から作成された抽出を含め extract-refreshes、抽出の暗号化と復号化を除くすべてのジョブを実行します。
- no-subscriptions: バックグラウンダーは、サブスクリプションを除くすべてのジョブを実行します。
- no-extract-refreshes-and-subscriptions: バックグラウンダーは、フロー出力が作成した抽出を含めすべての抽出における extract-refreshes、暗号化、および復号化を除くすべてのジョブのほか、サブスクリプションを実行します。
- extract-queries: 選択されたノードは all-jobs として実行され、抽出クエリの処理を優先して実行します。
- Extract-queries-interactive: 選択したノードは、すべてのジョブとして実行され、インタラクティブな抽出クエリの処理に優先順位を付けます。このクエリは、ユーザーが画面を見て抽出ベースのダッシュボードの読み込みを待機しているときに実行されるものです。これは高度な設定であるため、クラスターのサブスクリプションおよびアラート ジョブのワークロードの負荷が大きく、スケジュールされたロードと同じ時間に実行される Viz の読み込み時間のパフォーマンスが低下する場合にのみ使用してください。
- system: バックグラウンダーは、クラッシュしたジョブのクリーニング、データベース イベントの取得、Active Directory の同期など、他の Tableau Server プロセスと相互に作用するシステム メンテナンス ジョブのみを実行します。
- no-system: バックグラウンダーは、システム メンテナンス ジョブを除くすべてのジョブを実行します。

## tsm topology set-ports

サービス インスタンスのポートを設定します。

### シノプシス

tsm topology set-ports --node-name <nodeID> --port-name <port\_name> --port-value <port\_value> \[options\] \[global options\]

### オプション

\-i, --instance <instance\_id>

オプション。

サービスのインスタンス ID を指定します。指定しない場合は既定で 0 (ゼロ) に設定されます。

\-n, --node-name <nodeID>

必須。

ノードのノード ID を指定します。

\-pn, --port-name <port\_name>

必須。

設定するポートの名前。`service_name:port_type`の形式にする必要があります。ポートのタイプを指定しない場合、プライマリ ポートが使用されます。ポート名構文に関しては、[動的マッピングされたポート](https://help.tableau.com/current/server/ja-jp/ports.htm#Dynamica)を参照してください。

\-pv, --port-value <port\_value>

必須。

設定するポート。

\-r, --restart

オプション。

必要に応じて、Tableau Server の再起動を要求するプロンプトが表示されないようにします。

## tsm topology set-process

ノードのプロセスのインスタンス数を設定します。ノードに指定されたプロセスがすでにある場合は、指定されたカウントに一致するようにこの数が更新されます。

- 一度に 1 つのプロセスしか設定できません。複数のプロセスを指定した場合、最初のプロセス以外のプロセスは、通知なく無視されます。
- プロセスは、各ノードで一度に 1 つずつ設定する必要があります。複数のノードを指定すると、コマンドは "invalid node name (無効なノード名)" エラーを表示します。

ノード上のプロセス数を更新したら、保留中の変更も適用する必要があります。ほとんどの場合、ここでサーバーの再起動が必要となります (メッセージが表示されます) が、サーバーを再起動せずに動的なトポロジの変更を実行できる特殊なケースもあります。詳細については、[Tableau Server の動的トポロジの変更](https://help.tableau.com/current/server/ja-jp/server_process_hot_topo.htm)を参照してください。

**注:** プロセス名の完全なリストについては、[Tableau Server プロセス](https://help.tableau.com/current/server/ja-jp/processes.htm)を参照してください。

### シノプシス

tsm topology set-process --count <process\_count> --node <nodeID> --process <process\_name> \[global options\]

### オプション

\-c, --count <process\_count>

必須。

設定するプロセスのカウント (インスタンス数)。

\-n, --node <nodeID>

必須。

プロセスを設定するノードのノード ID を指定します。`<nodeID>` では大文字と小文字が区別されます。大文字と小文字を正しく区別しないと、コマンドが失敗したり、システム エラーが発生したりする可能性があります。

\-pr, --process <process\_name>

必須。

設定するプロセスの名前。

## tsm topology toggle-coordination-service

**注:** バージョン 2020.1.0 以降、すべての調整サービス アンサンブルのコマンドでは、サーバーの再起動が行われることを確認する「y/n」プロンプトの入力が必要になります。入力せずにこれらのコマンドを実行するには、`--ignore-prompt` オプションを含めます。

`tsm topology toggle-coordination-service`コマンドを使用して、調整サービス アンサンブル間を切り替えられます。調整サービス アンサンブルについての詳細は、[調整サービス アンサンブルの展開](https://help.tableau.com/current/server/ja-jp/distrib_ha_zk.htm)を参照してください。

バージョン 2020.1.0 以降では、`tsm topology deploy-coordination-service` コマンドにより新しいアンサンブルにも切り替わります。このコマンドを個別に実行する必要はありません。

### シノプシス

tsm topology toggle-coordination-service \[option\] \[global options\]

### オプション

\--request-timeout <timeout in seconds>

オプション。

コマンドが終了するまで指定した時間待機します。既定値は 1800 (30 分) です。

## グローバル オプション

\-h, --help

オプション。

コマンドのヘルプを表示します。

\-p, --password <password>

アクティブなセッションがない場合は、必要に応じて `-u` または `--username` と一緒に使用します。

`-u` または `--username` で指定されたユーザーのパスワードを指定します。

パスワードにスペースや特殊文字が含まれる場合、パスワードを引用符で囲みます。

`--password "my password"`

\-s, --server https://<hostname>:8850

オプション。

Tableau Services Manager で指定したアドレスを使用します。URL は `https` で始まる必要があります。また、ポート 8850 を含めるとともに、IP アドレスではなくサーバー名を使用します。例: `https://<tsm_hostname>:8850`。サーバーが指定されていない場合は、仮に `https://<localhost | dnsname>:8850` とします。

\--trust-admin-controller-cert

オプション。

このフラグは、TSM コントローラーで自己署名証明書を信頼するために使用します。証明書の信頼および CLI 接続の詳細については、[TSM クライアントの接続](https://help.tableau.com/current/server/ja-jp/tsm_overview.htm#Connecti)を参照してください。

\-u, --username <user>

アクティブなセッションがない場合は、必要に応じて `-p` または `--password` と一緒に使用します。

ユーザー アカウントを指定します。このオプションが含まれていない場合は、コマンドがサインインに使用した認証資格情報を使用して実行されています。