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. Bijvoorbeeldhttps://<tsm_hostname>:8850
. Als er geen server is opgegeven, wordt uitgegaan vanhttps://<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.