Een site exporteren of importeren

Opmerking: Zie onze Gids voor handmatige migratie naar Tableau Cloud(Link wordt in een nieuw venster geopend) voor gedetailleerde informatie over het migreren van sites van Tableau Server naar Tableau Cloud.

U kunt een nieuwe Tableau Server-site inrichten door informatie van een andere site te importeren (migreren). U doet dit door de informatie van de bestaande site (de bronsite) naar een bestand te exporteren. Vervolgens doorloopt u de stappen om die informatie te verifiëren en te importeren naar de doelsite.

Opties voor sitemigratie

U kunt een site op een van de volgende manieren migreren:

  • Naar een andere site op dezelfde Tableau Server-instantie.

  • Naar een site op een aparte Tableau Server-instantie.

  • Van Tableau Server op Windows naar Tableau Server op Linux of andersom.

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.

Beperkingen voor sitemigratie

Welke informatie wordt bewaard in een site-export?

  • Het exportbestand dat u maakt, behoudt werkmappen, projecten, databronnen en gebruikers. Hieronder vallen onder meer machtigingen voor inhoud, favorietenlijsten van gebruikers en sitequota's.

  • De aangepaste weergaven van gebruikers blijven behouden. Afhankelijk van het type sitemigratie kunnen de URL's van aangepaste weergaven echter zodanig worden gewijzigd dat de bladwijzers van gebruikers naar hun weergaven worden verbroken.

  • Wanneer u een site op Tableau Server exporteert om deze naar een andere Tableau Server-site te importeren, blijven de planningen voor abonnementen en extractvernieuwingen behouden.

Welke informatie wordt niet bewaard in een site-export?

  • Gebruiksdata die in de beheerweergaven van de site worden weergegeven, worden niet bewaard. Bijvoorbeeld weergave- en databronaantallen, gebruikersacties en prestatiedata.

  • Backgrounder-taken die in uitvoering zijn terwijl een site wordt geëxporteerd, worden niet geëxporteerd en worden niet getoond op de nieuwe site nadat de import is voltooid.

  • OAuth-toegangstokens die zijn ingebed in dataverbindingen worden gereset. Voor deze databronnen moet u de verbindingen bewerken en opnieuw verifiëren bij de onderliggende data.

  • Voorbereidingsflows en flowplanningen zijn niet inbegrepen. Deze moeten handmatig worden gemigreerd.

  • Inhoud die is opgeslagen in de persoonlijke ruimte van gebruikers, is niet inbegrepen.

De bron- en doelsites voorbereiden

Voordat u een site exporteert, moet u de volgende checklist doorlopen om beide omgevingen voor te bereiden. Sommige van deze instructies zijn afhankelijk van de vraag of beide sites zich op dezelfde serverinstantie bevinden of op afzonderlijke servers.

Verouderde inhoud verwijderen

Zorg ervoor dat de bronsite alleen datgene bevat wat u naar de nieuwe site wilt importeren. Als best practice wordt aangeraden om alles van uw bronsite te verwijderen dat u niet in uw nieuwe site wilt opnemen. Dit geldt ongeacht of deze zaken worden opgenomen in een export/import of handmatig moeten worden gemigreerd. Verwijder niet-gebruikte werkmappen, databronnen of projecten. Als u voorbereidingsflows of flowplanningen hebt die u niet meer gebruikt, verwijder deze dan ook.

Verouderde gebruikers verwijderen

Controleer of alle servergebruikers over een licentie beschikken en verwijder accounts die niet meer in gebruik zijn. U kunt geen gebruikers verwijderen tijdens het importproces. Als de twee sites zich op dezelfde serverinstantie bevinden, worden alle gebruikers die u van de bronsite exporteert, geïmporteerd naar de doelsite.

De doelsite maken of identificeren

U moet een sitebestand importeren naar een site die al bestaat op de doelinstantie Tableau Server. We raden u aan om naar een lege site te importeren, omdat bij het importeren alles van de doelsite wordt verwijderd dat niet in het importbestand is opgenomen. Zie Sites toevoegen of bewerken voor meer informatie.

Als uw bronsite werkmappen heeft die gebruikmaken van gepubliceerde databronnen, blijven de dataverbindingen in deze werkmappen verwijzen naar de naam van de bronsite. Om die verbindingen te behouden zonder de werkmappen opnieuw te hoeven publiceren, moet u ervoor zorgen dat de namen op de doel- en bronsite overeenkomen.

Site-ID’s vinden

De tsm-opdracht die u gebruikt om een ​​site te exporteren of importeren, vereist een parameter die de site-ID accepteert. U kunt de site-ID ophalen uit de URL wanneer u via een webbrowser bent aangemeld bij de site.

Als er maar één site op de server aanwezig is, krijgt die site de naam Standaard. Wanneer u bent aangemeld bij de standaardsite, ziet de URL van de browser er ongeveer zo uit:

https://server-name/#/projects

In de URL geeft de afwezigheid van de parameter /site aan dat het de standaardsite is. De site-ID voor de standaardsite is Standaard zonder de aanhalingstekens.

Bij een Tableau Server-implementatie op meerdere sites bevat de browser-URL #/site/ gevolgd door de site-ID. De volgende URL verschijnt als u naar de pagina Weergaven gaat op een site waarvan de site-ID finance is:

https://localhost/#/site/finance/views

Het identiteitenarchief controleren

U kunt exporteren van en importeren naar sites die niet hetzelfde type identiteitenarchief voor gebruikers gebruiken, maar u moet dan wel de toewijzingsbestanden wijzigen die voor de import worden gebruikt. Deze stap is ingebouwd in het importproces en wordt beschreven in Stap 3: Controleren of de site-instellingen correct zijn toegewezen.

Indien nodig gebruikers maken op de doelserver

Tijdens het importproces van de site worden gebruikers aan de doelsite toegewezen. Als de bronsite is op een andere Tableau Server-instantie dan de doelsite, moet u gebruikers op de doelserver maken voordat u de import kunt uitvoeren. Als de twee sites zich op dezelfde Tableau Server-instantie bevinden, heeft de doelsite toegang tot de bestaande gebruikers en kunt u deze stap overslaan.

De doelserver configureren om abonnementen te leveren

Abonnementen worden geïmporteerd, maar u moet de server configureren om ze te leveren. Zie Een site voor abonnementen instellen voor meer informatie.

Planningen controleren

Op de pagina Planningen worden de bestaande planningen voor extractvernieuwingen en abonnementen weergegeven.

Bij migraties van één Tableau Server-site naar een andere worden vernieuwingen en abonnementen die zijn toegewezen aan standaardplanningen op de bronsite toegewezen aan dezelfde planningen op de doelsite. Als de bronsite planningen heeft die niet op de doelsite staan ​​en de doelsite zich op een andere Tableau Server-instantie bevindt, moet u op de doelsite de planningen maken waaraan u de bronplanningen wilt toewijzen. U kunt de toewijzingsbestanden bewerken om er zeker van te zijn dat dit gebeurt zoals u verwacht.

Tips voor het importeren naar een doel met minder gebruikers of planningen

Wanneer een doelsite minder gebruikers of planningen heeft dan de bronsite, wordt veel-op-één importeren niet ondersteund. Hoe u dit kunt aanpakken, is afhankelijk van of de bron- en doelsites zich op dezelfde Tableau Server-instantie bevinden.

U kunt een van de volgende benaderingen gebruiken die van toepassing zijn op uw gebruikscases voor sitemigratie:

  • Verwijder extra gebruikers of planningen van de bronsite voordat u gaat exporteren. Dit is de voorkeursoptie als de twee sites zich op dezelfde serverinstantie bevinden.

  • Voeg ontbrekende gebruikers of planningen toe aan de doelsite voordat u met importeren begint. Dit is vereist als de doelsite zich op een andere serverinstantie bevindt.

  • Voeg de ontbrekende gebruikers of planningen halverwege het importproces toe aan de doelsite en werk de toewijzingsbestanden handmatig bij. Deze optie is alleen beschikbaar als de sites zich op dezelfde instantie bevinden.

  • U kunt de gebruikers of planningen handmatig toewijzen aan verschillende gebruikers en planningen op de doelsite tijdens het importproces. Dit is vereist als een gebruikersnaam tussen de servers verschilt. Bijvoorbeeld, de geëxporteerde gebruiker met de naam adavis@company.com is op de doelsite gedefinieerd als davisa.

Een site migreren

U moet de tsm sites-opdrachten gebruiken om het sitemigratieproces te voltooien. Met behulp van de onderstaande stappen wordt u begeleid bij het exporteren van informatie van de bronsite, het toewijzen van site-instellingen en het importeren van de toegewezen bestanden naar de doelsite.

Stap 1: Een site exporteren

Typ de volgende opdracht op de broncomputer Tableau Server:

tsm sites export --site-id <source-siteID> --file <filename>

Tableau Server moet actief zijn wanneer u de opdracht export uitvoert. Tijdens het exportproces vergrendelt Tableau Server de site die u exporteert.

Om bijvoorbeeld een site met site-ID weersgegevens te exporteren naar het bestand export-bestand.zip, typt u het volgende:

tsm sites export --site-id weather-data --file export-file

Standaard slaat Tableau Server <export-file>.zip op in /var/opt/tableau/tableau_server/data/tabsvc/files/siteexports. Zie tsm-bestandspaden voor meer informatie.

Stap 2: De toewijzingsbestanden voor importeren genereren

Om importbestanden voor de doelsite te genereren, hebt u het .zip-bestand nodig dat u hebt gemaakt toen u de stappen in Stap 1: Een site exporteren voltooide.

Opmerking: Het geëxporteerde bestand geeft "Anderen" standaard geen leesrechten. Afhankelijk van wie het bestand importeert, moet u mogelijk de machtigingen voor het bestand aanpassen, zodat iemand die geen eigenaar is het bestand kan lezen.

  1. Kopieer het geëxporteerde .zip-bestand op de doelcomputer van Tableau Server naar de directory waar Tableau Server verwacht de bestanden te vinden die geïmporteerd moeten worden. Bijvoorbeeld:

    /var/opt/tableau/tableau_server/data/tabsvc/files/siteimports

  2. Controleer of de doelsite al bestaat op Tableau Server, omdat het importproces geen nieuwe site maakt. Zie De bron- en doelsites voorbereiden voor meer informatie.

  3. Voer de volgende opdracht uit op de Tableau Server-doelcomputer (Tableau Server moet actief zijn):

    tsm sites import --site-id <target-siteID> --file <export-file.zip>

    Met deze opdracht wordt een set .csv-bestanden gegenereerd die laten zien hoe de instellingen van de bronsite worden toegewezen aan de doelsite. In de stappen die in de volgende sectie van dit artikel worden beschreven, bevestigt u deze toewijzingen en past u ze waar nodig aan.

    Standaard worden deze .csv-bestanden gegenereerd in een mappings-directory gemaakt onder siteimports. Bijvoorbeeld:

    /var/opt/tableau/tableau_server/data/tabsvc/files/siteimports/working/import_<id>_<date-time>/mappings

    Zie tsm-bestandspaden voor meer informatie.

Stap 3: Controleren of de site-instellingen correct zijn toegewezen

De .csv-bestanden die u in de vorige sectie hebt gegenereerd, beschrijven hoe de bronnen van de bronsite aan de doelsite worden toegewezen wanneer het importeren is voltooid. Items in de bestanden die Tableau Server niet kon toewijzen en die u moet bewerken, worden aangegeven met een reeks vraagtekens (???). Voordat u het importproces kunt voltooien, moet u de vraagtekens op de doelsite vervangen door geldige toewijzingen.

Belangrijk: Er gelden bepaalde vereisten voor het toewijzen van gebruikers, planningen en gepubliceerde inhoudsbronnen, vooral wanneer de bron- en doelsites zich op afzonderlijke Tableau Server-instanties bevinden. Zie De bron- en doelsites voorbereiden eerder in dit artikel voor meer informatie.

Toewijzingsbestanden verifiëren

  1. Ga naar de directory met de .csv-kaartbestanden die zijn gegenereerd door de opdracht tsm sites import. Standaard:

    /var/opt/tableau/tableau_server/data/tabsvc/files/siteimports/working/import_<id>_<date-time>/mappings

  2. Gebruik uw favoriete teksteditor om een ​​van de .csv-bestanden in de directory mappings te openen en doe het volgende.

    1. Controleer of de toewijzingen correct zijn.

    2. Als een invoer een reeks vraagtekens (???) bevat, vervangt u deze door een geldige waarde.

      Gebruik de tabellen in Referentie voor inhoud van toewijzingsbestand verderop in dit artikel voor beschrijvingen van de instellingen in elk van deze bestanden.

    3. Sla de wijzigingen op en behoud de opmaak van het CSV-bestand.

    Herhaal dit proces voor de overige .csv-bestanden.

Stap 4: De correct toegewezen bestanden naar de doelsite importeren

Nadat u de sitetoewijzingen in de .csv-bestanden hebt gecontroleerd, kunt u de instellingen naar de nieuwe site importeren om het migratieproces te voltooien.

  1. Voer de volgende opdracht uit op de Tableau Server-doelcomputer:

    tsm sites import-verified --import-job-dir <import-id-directory> --site-id <target-siteID>

    Bijvoorbeeld:

    tsm sites import-verified --import-job-dir /var/opt/tableau/tableau_server/data/tabsvc/files/siteimports/working/import_ff00_20180102022014457
    --site-id new-site

  2. Wanneer het succesbericht verschijnt, meldt u zich aan bij de nieuwe site en controleert u of alles is geïmporteerd zoals u verwachtte.

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.

Referentie voor inhoud van toewijzingsbestand

In de volgende tabellen worden de kolommen in elk van de toewijzingsbestanden weergegeven die worden gemaakt wanneer u de opdracht tsm site import uitvoert.

CSV-bestandsnaam: mappingsDomainMapperForGroups

Kolomtitel

Kan dit bewerkt worden?

Beschrijving

source_name

Nee

De naam van een gebruikersgroep op de bronsite.

source_domain_name

Nee

Het type identiteitenarchief op de bronsite: ofwel lokaal (voor lokaal identiteitenarchief) of een domeinnaam (voor Active Directory of extern LDAP-identiteitenarchief).

target_domain_name

Ja*

Het type identiteitenarchief op de doelsite: ofwel lokaal voor lokaal identiteitenarchief of een domeinnaam (zoals example.com of example.lan) voor Active Directory of extern LDAP-identiteitenarchief.

*Voor de groep Alle gebruikers moet u de waarde target_domain_name instellen op lokaal, zelfs als uw doelserver is geconfigureerd voor Active Directory-identiteitenarchief. De groep Alle gebruikers is een speciale standaardgebruikersgroep die op elke Tableau Server moet bestaan.

CSV-bestandsnaam: mappingsScheduleMapper

Kolomtitel

Kan dit bewerkt worden?

Beschrijving

source_name

Nee

De namen van aangepaste en standaard extract- of abonnementsplanningen op de bronsite.

source_scheduled_action_type

Nee

Het type planning, ofwel Extract vernieuwen voor extractvernieuwingen of Abonnementen voor het leveren van abonnementen op de bronsite.

target_name

Ja

De namen van aangepaste planningen op de doelsite. U kunt deze waarde bewerken. Als de planning op de bronsite bijvoorbeeld de naam Vrijdag updaten heeft, kunt u deze op de doelsite de naam Vrijdag vernieuwen geven.

target_scheduled_action_type

Nee*

Het type planning, Extract vernieuwen voor extractvernieuwingen of Abonnementen voor het leveren van abonnementen op de doelsite.

*In het zeldzame geval dat u vraagtekens (???) in deze kolom ziet, vervangt u deze door Extract vernieuwen or Abonnementen, zodat deze overeenkomen met de invoer die u ziet onder source_scheduled_action_type.

CSV-bestandsnaam: mappingsSiteMapper

Kolomtitel

Kan dit bewerkt worden?

Beschrijving

source_url_namespace

Nee

De site-ID van de bronsite.

target_url_namespace

Nee

De site-ID van de doelsite.

CSV-bestandsnaam: mappingsSystemUserNameMapper

Kolomtitel

Kan dit bewerkt worden?

Beschrijving

source_name

Nee

Het gebruikersnaamkenmerk van een gebruiker op de bronsite.

source_domain_name

Nee

Het type identiteitenarchief op de bronsite: ofwel lokaal (voor lokaal identiteitenarchief) of een domeinnaam (voor Active Directory of LDAP-identiteitenarchief) of extern.

target_name

Ja

Het gebruikersnaamkenmerk voor gebruikers die bij het importeren aan de doelsite worden toegewezen.

Controleer of alle gebruikersnamen in de lijst op de doelserver bestaan ​​en vervang de vraagtekens (???) door gebruikersnamen die op de doelserver bestaan.

U kunt geen gebruikersnamen maken door rijen toe te voegen aan het CSV-bestand. U kunt gebruikersnamen ook niet verwijderen door rijen te verwijderen.

U kunt een gebruikersnaam bewerken in de kolom target_name, zodat deze verschilt van de gebruikersnaam van de bron, zolang de gebruiker al met die naam op de doelserver bestaat.

Een gebruiker kan bijvoorbeeld een waarde voor de source_name van agarcia@company.com en een waarde voor de target_name van ashleygarcia@company.com hebben.

U kunt een gebruiker op de bronsite slechts aan één gebruikersnaam op de doelsite toewijzen.

target_domain_name

Ja

Het type identiteitenarchief op de doelsite: ofwel lokaal (voor lokaal identiteitenarchief) of een domeinnaam (voor Active Directory of extern LDAP-identiteitenarchief).

CSV-bestandsnaam: MappingsScheduleRecurrenceMapperWithAutoCreation

Dit bestand hoeft niet bijgewerkt te worden.

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