Driftsätta Data Connect

Gäller för: Tableau Cloud

Kontrollera att du har uppfyllt kraven innan du driftsätter Data Connect i din organisation:

Steg 1: Konfigurera klustret

Kontrollera följande anslutningar och åtkomst:

  • Data Connect-infrastruktur, kluster och behållare kräver nätverksåtkomst till orkestreringsleverantörens tjänster (nr 2 i bilden ovan) och till Tableau Cloud (endast utgående, nr 5).

  • Data Connect-infrastruktur, kluster, behållare och agent kräver nätverksåtkomst till din databas (nr 6).

Se Nätverksspecifikationer.

Driftsätta och konfigurera

Kör följande procedur på varje dator i organisationen där du vill köra Kubernetes-klustret.

  1. Kontrollera att din sekundära volym är oformaterad. Kör följande kommando på Linux-noden:

    lsblk -f

    Följande bild visar ett exempel där den extra volymen nvme1n1 på en klusternod är oformaterad och FSTYPE är tom:

  2. På fliken Data Connect klickar du på Ny pool under Pooler. I fönstret Ny pool anger du ett poolnamn och klickar sedan på Skapa.

  3. På fliken Data Connect klickar du på Nytt kluster under Kluster och noder. I fönstret Nytt kluster anger du ett klusternamn och klickar sedan på Skapa.

  4. I klustret du just skapade klickar du på kolumnen Åtgärder och sedan på Ny nod. I fönstret Lägg till ny nod klickar du på Ladda ner fil.

    En cluster.tar-fil laddas ner till mappen Nedladdningar. Den här filen innehåller de bootstrapping-skript som du kommer att köra på noden.

  5. Kopiera cluster.tar-filen till datorn. Följande exempel visar hur du kopierar tar-filen, extraherar filerna, ändrar skriptet till en körbar fil och sedan kör skriptet. I exemplet visas detta för AWS. Ändra filsökvägarna till de som gäller din miljö.

    Kör följande kommandon som root- eller sudo-användare och ersätt <key-name> och <IP-address> med dina värden:

    > scp -i <key-name>.pem /Downloads/cluster.tar ec2-user@ip-<IP-address>.us-west-2compute.internal:~/

    > ssh -i <key-name>.pem ex2-user@ip-<IP-address>.us-west-2compute.internal

    > tar -xvf cluster.tar

    > chmod +x onboard_node.sh preflight_check.sh

    > ./onboard_node.sh

    Obs! bzip2 installeras inte med Ubuntu som standard. Installera det genom att köra apt install bzip2 -y.

    När skriptet har körts visas Successfully performed all operations i terminalfönstret och Tableau-teamet inleder provisioneringsprocessen.

    Om du stöter på ett fel ska du kontrollera att driftsättningen uppfyller de lägsta maskinvarukraven och nätverksspecifikationerna som beskrivs i Planera din Data Connect-driftsättning.

  6. Gå till fliken Data Connect för din plats och leta upp den pool du skapade i steg 2. Under kolumnen Åtgärder klickar du på Tilldela kluster och väljer sedan det kluster du skapade i steg 3.

  7. Klicka på sparren (⌄) på klustret för att visa värdnamnet och de tillgängliga åtgärderna. Om den här informationen inte visas kan du behöva läsa in sidan igen. När du har bekräftat att värdnamnet är målnoden klickar du på Acceptera nod och sedan på Bekräfta.

    Klusternoden övergår då till provisioneringsstatus. Det kan ta en timme eller längre att provisionera noden.

  8. När statusen på noden ändras till Tillgänglig går du till den pool som du tilldelade klustret till och klickar på åtgärdsknappen (...) och sedan på Uppdatera token. Kontrollera att du uppdaterar token för rätt pool och klicka sedan på Bekräfta.

  9. Vänta tills tokenuppdateringen har slutförts. När det är klart ställs poolens status in på Tillgänglig. Gå tillbaka till klustret och klicka på sparren (⌄) för att komprimera avsnittet med klusternamn. Klicka på åtgärdsknappen för klustret (...) och klicka sedan på Hämta registerinformation för behållaren.

    • Om du råkar ut för ett felmeddelande när du försöker utföra det här steget har registret inte driftsatts än och provisioneringen håller fortfarande på att slutföras. Vänta några minuter och försök sedan igen.
    • När registerinformationen (servernamn, användarnamn och lösenord) visas kopierar du den till nästa steg.

Steg 2: Bygg en basavbildning och publicera

I det här steget bygger du basavbildningen med de drivrutiner du behöver och publicerar sedan avbildningen i Docker-behållarregistret. Innan du börjar:

  • Kontrollera att du har registerinformationen för Docker-behållaren från det föregående steget.

  • Varje pool kan ha sin egen unika basavbildning och uppsättning drivrutiner.

  • Om du planerar att ansluta med hjälp av en TDC-fil måste du inkludera den filen i din basavbildning. Systemanvändaren, tableau, måste ha läsbehörighet för den här filen. Mer information om hur du skapar och lagrar den här filen finns i Tableau Desktop-hjälpämnet Anpassa och ställa in en anslutning(Länken öppnas i ett nytt fönster).

Bygga behållaren

Följande procedur är ett exempel på att bygga en behållare. Du kan behöva installera pakethanterarverktyg eller andra verktyg som är specifika för driftsättningen. Observera att Docker-avbildningen du bygger måste komma från Red Hat eftersom installationsprogrammet för Tableau Bridge är ett Red Hat-installationsprogram (*.rpm-fil).

  1. Logga in på valfri nod i Data Connect-klustret. Kopiera cluster.tar-filen till datorn. Följande exempel visar hur du kopierar tar-filen, extraherar filerna, ändrar skriptet till en körbar fil och sedan kör skriptet. I exemplet visas detta för AWS. Ändra filsökvägarna till de som gäller din miljö.

    Kör följande kommandon som root- eller sudo-användare och ersätt <key-name> och <IP-address> med dina värden:

    scp -i <key-name>.pem /Downloads/cluster.tar ec2-user@ip-<IP-address>.us-west-2compute.internal:~/
ssh -i <key-name>.pem ec2-user@ip-<IP-address>.us-west-2compute.internal
tar -xvf clustertar.tar
chmod +x onboard_node.sh preflight_check.sh
./onboard_node.sh

  2. Installera Docker och stödverktyg efter behov:

    #RedHat
sudo dnf install -y container-tools podman-docker
#Ubuntu
sudo apt-get update -y
sudo apt-get install -y docker.io

  3. Skapa Docker-filen:

    touch Dockerfile

  4. Uppdatera Docker-filen så att den inkluderar de drivrutiner som behövs för anslutningarna. De kommandon som anges i den här Docker-filen körs under tiden basavbildningen skapas. Exempel:

    # example base 
FROM registry.access.redhat.com/ubi8
RUN yum -y update
WORKDIR /
# Go to https://tableau.com/support/drivers
# Follow the instructions to install your drivers for linux
CMD [“/bin/bash”]

    Målkatalogen för drivrutinsfilerna varierar. Läs mer på Tableaus sida för nedladdning av drivrutiner(Länken öppnas i ett nytt fönster).

    Obs! Data Connect har stöd för Exchange-kopplingar som har en Linux-drivrutin och är märkta med ”Fungerar med Tableau Cloud via Bridge”. Mer information finns i Tableau Exchange-kopplingar(Länken öppnas i ett nytt fönster).

    Exempel på rader i en Docker-fil för en offentlig JDBC-drivrutin, med curl-kommando för att ladda ner drivrutinen:

    RUN mkdir -p /opt/tableau/tableau_driver/jdbc
RUN curl --location --output /opt/tableau/tableau_driver/jdbc/<file> <URL>

    Exempel på rader i en Docker-fil för en icke-offentlig JDBC-drivrutin, med kopiering:

    RUN mkdir -p /opt/tableau/tableau_driver/jdbc
COPY  <file> /opt/tableau/tableau_driver/jdbc

    Exempel på rader i en Docker-fil för en taco-drivrutin, med kopiering:

    RUN mkdir -p /home/tableau/Documents/My_Tableau_Bridge_Repository/Connectors
COPY  <file> /home/tableau/Documents/My_Tableau_Bridge_Repository/Connectors

  5. Medan du fortfarande är inloggad på Kubernetes-klusternoden ställer du in variabeln POOL_ID med värdet på ditt pool-ID. Du kan visa pool-ID-värdet genom att öppna fliken Data Connect och klicka på poolens namn.

    • Ställ in registervärdet som du kopierade till respektive värden.

      REGISTRY_HOSTNAME=registry_host_name_you_copied
REGISTRY_USERNAME=registry_user_name_you_copied
REGISTRY_PASSWORD=registry_password_you_copied

    • Ställ in pool-ID-värdet:

      POOL_ID=<pool_id_value>

  6. Bygg behållaren som används som din basavbildning.

    docker build -f <path_to_dockerfile> -t $REGISTRY_HOSTNAME/bridge-base:$POOL_ID .

  7. Logga in på din befintliga Kubernetes-nod och skicka avbildningen till det lokala behållarregistret.

    docker login --username $REGISTRY_USERNAME $REGISTRY_HOSTNAME
docker push $REGISTRY_HOSTNAME/bridge-base:$POOL_ID

  8. Under den pool du konfigurerar klickar du på åtgärdsknappen (...) och sedan på Uppdatera basavbildning. Den här åtgärden initierar en driftsättning med basavbildningen och kan ta upp till 10 minuter.

    Obs! När en ny basavbildning skapas och uppdateras skapas en ny driftsättning. Den Bridge-agent som används för den föregående basavbildningen finns kvar som en otilldelad resurs. Ta inte bort otilldelade Bridge-agenter.

Steg 3: Mappa en domän till en pool

De domännamn som du anger i godkännandelistan är de servernamn som används för datakällsanslutningen.

  1. I avsnittet för pooler och godkännandelistan för privata nätverk på fliken Data Connect väljer du den pool du har tilldelat och klickar på Ny domän i kolumnen Åtgärder.

  2. Ange domänens URI i textrutan Domän med hjälp av informationen i Regler för register över tillåtna. Den domän-URI som du anger begränsas till enbart den pool du konfigurerar.

  3. Kontrollera att alternativknappen Tillåt är markerad under Domänbehörigheter.

  4. Klicka på Spara när du är klar.

Felsöka anslutningsfel

Du måste konfigurera nätverkets infrastruktur så att Data Connect kan nå alla de datakällor som du vill ansluta till. Kontrollera att Data Connect kan nå alla datakällor genom att köra följande curl-kommando från de noder där Data Connect kommer att köras:

$ curl -v $DB_HOSTNAME:$DB_PORT

Om du har konfigurerat anslutningen utan fel bör det visas ett antal svar. Några exempel visas här:

  • Host $DB_HOSTNAME:$DB_PORT was resolved: Bekräftar att DNS-servrarna har matchat värdnamnet.

  • Connected to $DB_HOSTNAME: Bekräftar att noden har en nätverksanslutning.

  • Empty reply from server. Closing connection: Detta är väntat, eftersom curl inte är en databasklient.

  • Could not resolve host: $DB_HOSTNAME: Det finns ett problem med DNS-matchningen.

  • Trying $DB_IP_ADDRESS:$DB_PORT: När det här meddelandet följs av ett resultat som låst sig finns det ett nätverksproblem.

Om du använder en extern leverantör för dataanslutningens infrastruktur ser du till att nätverkslogiken inte störs av den externa leverantören.

(Valfritt) Steg 4: Dela kluster mellan platser

Som standard används Data Connect-kluster och deras motsvarande noder endast av platsen där de ursprungligen skapades. Data Connect-kluster kan dock delas mellan alla platser inom din Tableau Cloud Manager-klient. Genom att dela kluster kan frågor på olika platser inom klienten använda samma nodinfrastruktur.

För att säkerställa datasekretess på alla platser är inga data om ditt delade kluster tillgängliga för andra platser i din klient.

Obs! Att dela ett kluster är en permanent åtgärd. Om du skulle vilja ta bort delningen av ett kluster måste du ta bort och installera om klustret.

Kluster kan bara delas efter att de har godkänts på den ursprungliga platsen där de skapades.

Så här delar du ett Data Connect-kluster:

  • Navigera till klustret du vill dela, klicka på åtgärdsknappen (...) och klicka sedan på Dela.

När du har delat klustret kommer platsadministratörer på andra platser inom din klient att kunna använda klustret med alla pooler som de skapar på sina platser.

(Valfritt) Steg 5: Skapa en pool i ett delat kluster som klustermottagare

Kontrollera följande innan du skapar din pool som mottagare i ett delat kluster:

  • Det delade klustret har nätverksanslutning till databaserna som används av din plats

  • Alla databasdrivrutiner som databasen på din plats kräver måste vara installerade i klustret

För att börja använda ett delat kluster som klustermottagare måste du kommunicera med klusterägaren för att få din pools basavbildning tillagd i klustret:

  1. På fliken Data Connect klickar du på Ny pool under Pooler.

  2. I fönstret Ny pool anger du ett poolnamn och klickar sedan på Skapa.

  3. I den nya poolen klickar du på Tilldela kluster, väljer det delade klustret, klickar på åtgärdsknappen (...) och klickar sedan på Uppdatera token.

  4. Kontrollera att du uppdaterar token för rätt pool och klicka sedan på Bekräfta.

  5. När poolstatusen är inställd på Tillgänglig kopierar du pool-ID:t för din pool. Klicka på poolnamnet för att visa pool-ID-värdet.

  6. Lägg till en basavbildning för din plats. Se Steg 2: Bygg en basavbildning och publicera ovan.

    Administratören med åtkomst till klustret måste bygga en ny behållare med Pool_ID-värdet som en del av tilläggandet av basavbildningen. Du behöver även registervärdena för platsen som ursprungligen skapade klustret, vilka kan tillhandahållas av klustrets ägare.

  7. Efter att basavbildningen har publicerats till det lokala behållarregistret navigerar du till poolen på delningsplatsen och klickar sedan på Uppdatera basavbildning.

  8. För att slutföra installationen, se Steg 3: Mappa en domän till en pool ovan.

Lägga till en nod från ett befintligt kluster

  1. Navigera till klustret och klicka på Ny nod.

  2. Följ steg 4, 5, 7, 8, 9 i proceduren under Steg 1: Konfigurera klustret ovan. Hoppa över steg 6 eftersom du inte behöver tilldela klustret.

  3. När steget för tokenuppdatering är klart går du till poolen som är associerad med klustret och klickar på Uppdatera basavbildning.

Obs! När en ny basavbildning skapas och uppdateras skapas en ny driftsättning. Bridge-klienten som användes för den föregående basavbildningen finns kvar som en otilldelad resurs. Ta inte bort otilldelade Bridge-klienter.

Ta bort en nod från ett befintligt kluster

Efter att en nod har tagits bort från ett kluster kommer Bridge-klienten inte längre att vara tillgänglig för Tableau Cloud. Alla jobb som körs på Data Connect samtidigt som noden tas bort kommer att misslyckas. Inga ytterligare jobb kommer dock att dirigeras till dessa Bridge-klienter.

Om du vill ta bort en nod navigerar du till klustret, klickar på åtgärdsknappen (...) och väljer Ta bort.

Uppdatera basavbildningar för befintliga pooler

Om du vill använda en ny databas eller uppdatera en drivrutin som ditt Data Connect-kluster kommer att använda kan du göra ändringar i befintliga basavbildningar för att anpassa dem efter dessa förändringar. För att göra det uppdaterar du behållarfilen med ändringarna på det sätt som förklaras i Steg 2: Bygg en basavbildning och publicera. När du har uppdaterat behållarfilen klickar du på Uppdatera basavbildning. Det kan ta upp till 15 minuter att driftsätta den nya basavbildningen. Din tidigare basavbildning kommer att användas tills den nya basavbildningen har driftsatts.

Felsöka databasanslutningen

Börja med att verifiera att dina domäner följer reglerna för register över tillåtna. Läs mer i Konfigurera pooler.

Därefter bekräftar du att du har konfigurerat nätverkets infrastruktur så att Data Connect kan nå alla datakällor som du vill ansluta till. Kontrollera att Data Connect kan nå alla datakällor genom att köra följande curl-kommando från de noder där Data Connect kommer att köras:

$ curl -v $DB_HOSTNAME:$DB_PORT

Om du har konfigurerat anslutningen utan fel bör det visas ett antal svar. Några exempel visas här:

  • Host $DB_HOSTNAME:$DB_PORT was resolved: Bekräftar att DNS-servrarna har matchat värdnamnet.

  • Connected to $DB_HOSTNAME: Bekräftar att noden har en nätverksanslutning.

  • Empty reply from server. Closing connection: Detta är väntat, eftersom curl inte är en databasklient.

  • Could not resolve host: $DB_HOSTNAME: Det finns ett problem med DNS-matchningen.

  • Trying $DB_IP_ADDRESS:$DB_PORT: När det här meddelandet följs av ett resultat som låst sig finns det ett nätverksproblem.

Om du använder en extern leverantör för dataanslutningens infrastruktur ser du till att nätverkslogiken inte störs av den externa leverantören.

Tillbaka till toppen