Tableau Server klonen

Vanaf versie 2022.3 van Tableau Server kunt u met een nieuwe tsm-opdracht een kopie maken van de configuratie en topologie van een Tableau Server-implementatie en deze gebruiken om een exacte replica van de oorspronkelijke implementatie te maken. Met de opdracht tsm settings clone maakt u een set bestanden (de kloonpayload) die instellingen, geheimen, configuratie en topologie bevat, inclusief de gebruikte poorten en informatie over externe services.

Veiligheidsoverwegingen

Met de opdracht tsm settings clone genereert u een set bestanden (de kloonpayload) die alle geheimen bevatten die door Tableau Server zijn gegenereerd, evenals degene die door de serverbeheerder tijdens de configuratie zijn verstrekt, waaronder een sleutelopslag met sleutelparen en certificaten. Het is voor de beveiliging uiterst belangrijk dat u de kloonpayload en de uitvoerlocatie veilig houdt. Dit faciliteert u als volgt:

  • Als de uitvoerdirectory niet bestaat, maakt tsm er een waarvan de toegang is beperkt tot de gebruiker die de opdracht tsm settings clone uitvoert.
  • Als er een uitvoerdirectory bestaat wanneer u de opdracht uitvoert, bevestigt tsm dat deze eigendom is van de gebruiker die de opdracht uitvoert en dat de machtigingen alleen voor die gebruiker gelden. Als de directory niet de verwachte machtigingen heeft, wordt het volgende bericht weergegeven:

    The output directory '<path/to/directory>' exists, but must be restricted to owner only.

Beperkingen van de kloonpayload

  • De versie van de gekloonde Tableau Server moet overeenkomen met de versie die wordt gemaakt. U kunt geen nieuwere versie van Server installeren met behulp van een kloonpayload van een oudere versie.

Met de kloonopdracht een kopie maken van Tableau Server

Een gekloonde kopie maken van Tableau Server is een proces met meerdere stappen, waarbij dit de twee belangrijkste stappen zijn:

  1. Een kloonpayload maken van de Tableau Server-installatie die u wilt dupliceren.
  2. De kloonpayload gebruiken om een tweede implementatie van Tableau Server te installeren. U bent verantwoordelijk voor de afstemming van de topologie van de twee installaties, waarbij u extra knooppunten toevoegt die matchen met de oorspronkelijke implementatie.

De kloonpayload maken

Voor het genereren van een set bestanden (kloonpayload) die de configuratie- en topologie-instellingen voor Tableau Server bevatten, gebruikt u de opdracht tsm settings clone. De opdracht heeft één argument: de uitvoerdirectory waar de set bestanden moet worden opgeslagen:

tsm settings clone --output-directory <output_directory>

Zodra de kloonpayload is gemaakt, kunt u deze gebruiken bij het installeren van een nieuwe instantie van Tableau Server met dezelfde configuratie en topologie als de broninstallatie.

Met de kloonpayload een kopie maken van Tableau Server

  1. Installeer het Tableau Server-pakket op het eerste knooppunt. Initialiseer Tableau Server niet. Het Tableau Server-pakket installeren

  2. Voer het script initialize-tsm uit en geef het pad op naar de kloonpayload die is gemaakt met de opdracht tsm settings clone:

    sudo /opt/tableau/tableau_server/packages/scripts.<version>/initialize-tsm --accepteula --clone-artifact-dir=<path-to-clone-directory>

    Opmerking: Tableau Server wordt uitgevoerd als een Tableau-gebruiker zonder rechten. Daarom moet de beheerder ervoor zorgen dat de Tableau-gebruiker leesrechten heeft voor de kloondirectory's en -bestanden. In de meeste gevallen hebben 'anderen' zowel leesrechten nodig voor inhoud van de kloondirectory, als uitvoeringsrechten (voor doorkruising) voor alle bovenliggende directory's.

  3. (Optioneel) Installeer extra knooppunten om het aantal knooppunten op de originele (gekloonde) installatie van Tableau Server te matchen. Als de oorspronkelijke installatie extra knooppunten had, is deze stap vereist. Installeer alleen extra knooppunten om het aantal op de oorspronkelijke installatie te matchen.

    1. Genereer het bootstrapbestand op het eerste knooppunt:
    2. Installeer Tableau Server op elk extra knooppunt en voer het script initialize-tsm uit:

      Extra knooppunten installeren en configureren

  4. Voltooi de initialisatie op het eerste knooppunt:

    tsm initialize

Container

Kloonfunctionaliteit is handig bij het gebruik van Tableau Server in een container, vooral wanneer dit wordt gebruikt met een externe opslagplaats en opslag. Met de kloonopdracht kan de beheerder snel een Tableau Server-omgeving opnieuw maken en de externe services opnieuw koppelen.

Opmerking: de stappen om een Tableau Server-cluster opnieuw te maken kunnen verschillen, afhankelijk van de gebruikte containertechnologieën (bijvoorbeeld: docker, docker compose of Kubernetes).

De onderstaande informatie is specifiek voor het rechtstreeks gebruiken van Docker. Bij het opstarten van de initiële knooppuntcontainer moet u de locatie van de kloonpayload opgeven met de omgevingsvariabele CLONE_ARTIFACT_DIR.

Bijvoorbeeld:

docker run \
-v <path-to-clone-directory>:/docker/custom-clone-path \
-e CLONE_ARTIFACT_DIR=/docker/custom-clone-path \
-e LICENSE_KEY=<key> \
-p 8080:8080 -p 8800-9000:8800-9000 -p 27000-27010:27000-27010 \
--hostname=<static (internal) name of host machine> \
-d <Tableau Server in a Container image ID or tag>

Een implementatie van Tableau Server met meerdere knooppunten opnieuw maken in een container

Als uw kloonpayload afkomstig is van een Tableau Server-implementatie met meerdere knooppunten, wacht uw eerste container totdat er meer knooppunten aan het cluster worden toegevoegd.

Het instellen van extra knooppunten in het cluster bij gebruik van klonen is hetzelfde als het toevoegen van knooppunten bij een normale implementatie en vereist het volgende:

  • Volumes koppelen om het bootstrapbestand tussen de knooppunten te delen
  • De omgevingsvariabelen ALWAYS_WRITE_BOOTSTRAP_FILE en BOOTSTRAP_INSTALL opgeven

Gedetailleerde stappen voor het maken van een omgeving met meerdere knooppunten in een containerimplementatie vindt u hier: Tableau Server met meerdere knooppunten in een container.

Opmerking: de kloonpayload hoeft alleen maar te worden gekoppeld en gebruikt op het eerste knooppunt in het cluster. U hoeft de kloonpayload niet op extra knooppunten te koppelen.

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