tsm sites

U kunt gebruikmaken van de opdrachten tsm sites om een bestaande site te exporteren voor import naar een nieuwe site (ook wel sitemigratie genoemd) en om de nieuwe site te importeren. De opdracht unlock is beschikbaar voor het geval een fout een site vergrendelt.

De opdrachten tsm sites gebruiken uw lokale bestandsarchief om de export- en importgegevens te bewaren. Als u een Tableau-cluster met meerdere knooppunten uitvoert, moet u de opdrachten tsm sites uitvoeren op een Tableau Server waarop het data-engine-proces wordt uitgevoerd. Zie Tableau Server-processen voor informatie over het data-engine-proces en de processen die dit vereisen.

Opmerking: Bij het migreren van sites tussen instanties van Tableau Server, moet de doelsite op een versie van Tableau Server zijn die gelijk is aan of later is dan de versie van Tableau Server voor de bronsite. Zowel de bron- als de doelsite moeten afkomstig zijn van ondersteunde versies van Tableau Server.

Zie Een site exporteren of importeren voor uitgebreide stappen voor het migreren van een site.

tsm sites export

Exporteer een opgegeven Tableau Server-site naar een .zip-bestand. U kunt een site exporteren om de instellingen op een specifiek tijdstip te archiveren of om de eerste stap van een sitemigratieproces te voltooien.

Opmerking: de opdracht tsm sites import en de opdracht tsm sites export kunnen een site in een vergrendelde status achterlaten als er een fout optreedt. Als u een site wilt ontgrendelen, gebruikt u de opdracht tsm sites unlock.

Overzicht

tsm sites export --site-id <source-siteID> --file <export-file> [options] [global options]

Opties

-f,--file <export-file>

Vereist.

Geef de naam op van het bestand waarin Tableau Server alle informatie van de site opslaat.

Dit bestand wordt gegenereerd in de directory die is gedefinieerd in de TSM-variabele basefilepath.site_export.exports. Standaard:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports

Zie tsm-bestandspaden voor meer informatie over bestandspaden en hoe u deze kunt wijzigen.

-id,--site-id <source-siteID>

Vereist.

De site-ID voor de site die u exporteert. U kunt de site-ID ophalen uit de URL wanneer u via een webbrowser bent aangemeld bij de site. Zie De bron- en doelsites voorbereiden voor informatie over het lokaliseren van de site-ID.

-ow,--overwrite

Optioneel.

Overschrijf een exportbestand met dezelfde naam dat al bestaat.

--request-timeout <timeout in seconds>

Optioneel.

Wacht de opgegeven tijd totdat de opdracht is voltooid. De standaardwaarde is 43200 (720 minuten).

tsm sites import

Deze opdracht gebruikt het .zip-bestand dat u hebt gemaakt met tsm sites export om een set .csv-bestanden te genereren die laat zien hoe de geëxporteerde bronsite-instellingen worden toegewezen aan de nieuwe doelsite.

Standaard wordt het .zip-bestand gegenereerd en opgeslagen in de directory siteexports op:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports

Voordat u deze opdracht gebruikt, moet u het .zip-bestand kopiëren naar de directory waarin Tableau het verwacht. Deze locatie is gedefinieerd in de TSM-variabele basefilepath.site_import.exports. Standaard is de importdirectory:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports

Zie tsm-bestandspaden voor meer informatie over bestandspaden en hoe u deze kunt wijzigen.

Opmerking: de opdracht tsm sites import en de opdracht tsm sites export kunnen een site in een vergrendelde status achterlaten als er een fout optreedt. Als u een site wilt ontgrendelen, gebruikt u de opdracht tsm sites unlock.

Overzicht

tsm sites import --file <export-file.zip> --site-id <target-siteID> [options] [global options]

Opties

-f,--file <export-file.zip>

Vereist.

Naam van het .zip-bestand gemaakt door het proces tsm sites export die u naar de importdirectory moet kopiëren. Standaard:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports

-id,--site-id <target-siteID>

Vereist.

De site-ID voor de nieuwe site waarnaar u importeert (de doelsite). Zie De bron- en doelsites voorbereiden voor informatie over het lokaliseren van de site-ID.

-c,--continue-on-ignorable-errors

Optioneel.

Ga door met het importeren van de site als er fouten optreden die kunnen worden genegeerd. Deze fouten kunnen problemen aanduiden met het importeren van een specifieke werkmap of databron.

-k,--no-verify

Optioneel.

Sla de verificatie van toewijzingsbestanden over.

-m, --override-schedule-mapper <mapping-file.csv>

Optioneel.

Plan in dat het toewijzingsbestand de normale toewijzing op naam overschrijft.

--request-timeout <timeout in seconds>

Optioneel.

Wacht de opgegeven tijd totdat de opdracht is voltooid. De standaardwaarde is 7200 (120 minuten).

tsm sites import-verified

Geef de directory op die de .csv-toewijzingsbestanden van een geëxporteerde site bevat die u naar een nieuwe site wilt importeren. Dit is de laatste stap van een sitemigratieproces.

Overzicht

tsm sites import-verified --import-job-dir <importjob-directory> --site-id <target-siteID> [options] [global options]

Opties

-id,--site-id <target-siteID>

Vereist.

De site-ID voor de nieuwe site waarnaar u importeert (de doelsite). Zie De bron- en doelsites voorbereiden voor informatie over het lokaliseren van de site-ID.

-w, --import-job-dir <importjob-directory>

Vereist.

Het bovenliggende item van de directory mappings die de .csv-bestanden van de geëxporteerde (bron)site bevat. De naam van deze bovenliggende directory bevat de import-ID en de datum en tijd. Bijvoorbeeld:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports\working\import_ff00_20180102022014457

--request-timeout <timeout in seconds>

Optioneel.

Wacht de opgegeven tijd totdat de opdracht is voltooid. De standaardwaarde is 7200 (120 minuten).

tsm sites unlock

Gebruik deze opdracht om een site te ontgrendelen.

Opties

-id,--site-id <target-siteID>

Vereist.

De site-ID voor de site die u ontgrendelt. Zie De bron- en doelsites voorbereiden voor informatie over het lokaliseren van de site-ID.

-d, --desired-state <state to leave unlocked site in>

Optioneel.

De status waarin de site moet blijven nadat deze is ontgrendeld. Opties zijn 'actief' en 'opgeschort'. De standaard als de status niet is opgegeven, is 'actief'.

Bijvoorbeeld:

tsm sites unlock -id mysite -d suspended

--request-timeout <timeout in seconds>

Optioneel.

Wacht de opgegeven tijd totdat de opdracht is voltooid. De standaardwaarde is 300 (5 minuten).

Algemene opties

-h, --help

Optioneel.

Toon de opdracht help.

-p, --password <password>

Vereist, samen met -u of --username als er geen sessie wordt uitgevoerd.

Geef het wachtwoord op voor de gebruiker die wordt opgegeven in -u of --username.

Als het wachtwoord spaties of speciale tekens bevat, plaatst u deze tussen aanhalingstekens:

--password "my password"

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

Optioneel.

Gebruik het opgegeven adres voor Tableau Services Manager. De URL moet beginnen met https. Voeg poort 8850 toe en gebruik de servernaam en niet het IP-adres. Bijvoorbeeld https://<tsm_hostname>:8850. Als er geen server is opgegeven, wordt uitgegaan van https://<localhost | dnsname>:8850.

--trust-admin-controller-cert

Optioneel.

Gebruik deze vlag om het zelfondertekende certificaat op de TSM-controller te vertrouwen. Zie TSM-clients verbinden voor meer informatie over certificaatvertrouwen en CLI-verbindingen.

-u, --username <user>

Vereist als er geen sessie wordt uitgevoerd, samen met -p of --password.

Geef een gebruikersaccount op. Als u deze optie niet opneemt, wordt de opdracht uitgevoerd met de referenties waarmee u zich hebt aangemeld.

Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.