--- schema_version: "1" id: 00afb74fa8823c8ba01b7fd2ac60feaccf39c7292e685e0f29fb1398e36762a2 title: Bridge voor Linux voor containers installeren collection: tableau version: current locale: nl-nl portal_url: https://docs.salesforce.com/tableau/current/nl-nl/online/to_bridge_linux_install.md canonical_url: https://help.tableau.com/current/online/nl-nl/to_bridge_linux_install.htm source_site: help.tableau.com content_type: documentation content_hash: a63f0e374dc7a7fe21c42440bc54b016961214c535ff6a2680f1fa794539a48f description: Install Tableau Bridge for Linux in a Docker container. --- [Doorgaan naar hoofdinhoud](#main-content) # Bridge voor Linux voor containers installeren Bridge voor Linux biedt de schaalbaarheid en gestroomlijnde beheermogelijkheden van gecontaineriseerde workloads. Met de volgende instructies kunt u eenvoudig Bridge voor Linux uitvoeren. Hierbij wordt ervan uitgegaan dat u basiskennis hebt van Docker en de belangrijkste termen die in het ecosysteem worden gehanteerd. ## Bridge installeren en uitvoeren vanuit een Docker-container Om Bridge op Linux te gebruiken, moet u een aangepaste Docker-image maken, het RPM-pakket installeren en vervolgens Bridge uitvoeren vanuit de containerimage. Opmerkingen bij de installatie: - U kunt meerdere Bridge op Linux-containers op één computer implementeren. - Serverloze oplossingen met dynamische IP-adressen worden niet ondersteund. - Oudere Bridge-planningen worden niet ondersteund. Zien [Migreren van Bridge (verouderd) naar online planningen](https://help.tableau.com/current/online/nl-nl/to_sync_schedule.htm) voor meer informatie. ### Vereisten - Docker-engine geïnstalleerd. Voor de basisimage van de docker-container wordt Bridge op Linux ondersteund op: - Amazon Linux 2023 - Red Hat Enterprise Linux 8 - Red Hat Enterprise Linux 9 **Opmerking**: CentOS wordt niet ondersteund. - Het nieuwste Tableau Bridge RPM-pakket van de pagina [Downloads](https://www.tableau.nl/support/releases/bridge) op de Tableau-website. - Ervaring met het Linux-besturingssysteem. - Shell-basisscripting. - Docker-ervaring. - [Persoonlijk toegangstoken](https://help.tableau.com/current/online/nl-nl/security_personal_access_tokens.htm) (PAT) of [Uniform toegangstoken](https://help.tableau.com/current/api/cloud-manager/nl-nl/docs/unified_access_tokens.html) (UAT) voor Tableau-sitebeheerder. U moet voor elke Bridge-client een eigen PAT of UAT gebruiken. Tableau biedt ondersteuning voor 104 PAT's per gebruiker. - Als uw Bridge-host verbinding gaat maken met een externe share, moet u een sectie voor UNC-toewijzing in uw Docker-bestand opnemen. Zie [Verbinding maken met bestanden zonder opmaak en op bestanden gebaseerde extracten](https://help.tableau.com/current/online/nl-nl/to_sync_local_data.htm#remote-share). - Bridge voor Linux biedt geen ondersteuning voor Bridge (oudere planningen). Zie [Migreren van Bridge (verouderd) naar online planningen](https://help.tableau.com/current/online/nl-nl/%3Chttps://help.tableau.com/current/online/nl-nl/to_sync_schedule.htm#Migreren van Bridge \(verouderd\) naar online planningen>). ### Stap 1: Maak een Bridge-containerimage De volgende stappen zijn de basisinstructies om een Bridge op een Linux-basisimage te maken. Zie [Docker-overzicht](https://docs.docker.com/get-started/overview/) voor meer informatie.[](https://docs.docker.com/get-started/overview/) Wanneer Docker is geïnstalleerd, is root de enige gebruiker die opdrachten mag uitvoeren. U kunt Docker-opdrachten uitvoeren met `sudo` of een gebruiker die lid is van de Docker-groep. **Belangrijk:** basisimages variëren afhankelijk van de verschillende stuurprogramma's en platforms. De volgende voorbeelden zijn bedoeld om het proces voor het bouwen van een basisimage te illustreren. U moet het bouwproces aanpassen aan uw specifieke omgeving. 1. Download het Bridge`.rpm`\-pakket op de pagina [Downloads](https://www.tableau.nl/support/releases/bridge) op de Tableau-website. 2. (Optioneel) U kunt de configuratie-instellingen bewerken om te wijzigen hoe de client wordt uitgevoerd. Zie [De Bridge-clientinstellingen wijzigen](https://help.tableau.com/current/online/nl-nl/to_sync_change_computer_site.htm) voor meer informatie. 3. Maak een werkmap en verplaats het `.rpm`\-pakket naar de directory. `cd ~` `$ mkdir Docker` `$ cd Docker` `$ mv .rpm .` 4. Maak een Docker-bestand in de werkdirectory. Bijvoorbeeld: `$ touch Dockerfile` 5. Bewerk het Docker-bestand en voeg de opdrachten toe om `yum update.` uit te voeren. **Red Hat-voorbeeld** Voor Red Hat 8: `FROM registry.access.redhat.com/ubi8/ubi:latest` `RUN yum -y update` 6. Bewerk het Docker-bestand en voer vervolgens de opdrachten in om het Bridge RPM-pakket uit de image te kopiëren, installeren en verwijderen: - **Optie 1**: gebruik `--mount`, bijvoorbeeld: FROM registry.access.redhat.com/ubi8/ubi:latest RUN --mount=type=bind,source=.rpm,target=/tmp/bridge.rpm \\ set -eux; \\ yum -y update; \\ ACCEPT\_EULA=y yum install -y /tmp/bridge.rpm; \\ yum -y clean all; \\ rm -rf /var/cache/yum - **Optie 2**: download het RPM-bestand direct, bijvoorbeeld: FROM registry.access.redhat.com/ubi8/ubi:latest RUN set -eux; \\ yum -y update; \\ curl -fsSL https://repo.example.com/bridge.rpm -o /tmp/bridge.rpm; \\ ACCEPT\_EULA=y yum install -y /tmp/bridge.rpm; \\ rm -f /tmp/bridge.rpm; \\ yum -y clean all; \\ rm -rf /var/cache/yum 7. Bouw een nieuwe containerimage met de bouwopdracht `docker`. Met de volgende opdracht wordt er een image in de huidige directory gemaakt en voorzien van de woorden `​"bridge_base"`. `docker buildx build --platform=linux/amd64 -t bridge_base .` 8. Controleer of de basisimage die u hebt gemaakt, wordt weergegeven in de lijst met images: `docker images | grep bridge` ### Stap 2: Installeer de stuurprogramma's De Bridge-client heeft stuurprogramma's nodig om de connectiviteit tussen privénetwerkdata en Tableau Cloud mogelijk te maken. Ga voor stuurprogramma's naar [Stuurprogramma downloaden](https://www.tableau.com/nl-nl/support/drivers), selecteer de databron en selecteer vervolgens Linux als besturingssysteem. 1. De installatie kan interactief worden uitgevoerd nadat de basisimage is gestart, of er kunnen aparte Docker-bestanden als laag bovenop de basisimage worden weggeschreven. **Voorbeeld** Met de RPM van het MySQL-stuurprogramma dat naar de directory is gekopieerd, kunt u een aparte werkdirectory maken om MySQL-stuurprogramma's te stapelen met behulp van het volgende Docker-bestand: `# Using previously built bridge_base image` `FROM bridge_base` `COPY mysql-connector-odbc-8.0.26-1.el8.x86_64.rpm` `RUN yum install -y mysql-connector-odbc-8.0.26-1.el8.x86_64.rpm` **Opmerking:** Voor MySQL- en Amazon Aurora MySQL-stuurprogramma's is het noodzakelijk om de landinstellingen te configureren en taalpakketten in de installatiekopie te installeren. Voorbeeld: `RUN yum install -y glibc-langpack-en` `ENV LANG=en_US.UTF-8 LANGUAGE=en_US:en LC_ALL=en_US.UTF-8` **Voorbeeld** Installeer een Postgres JDBC-stuurprogramma. Dit kan ook in een apart Docker-bestand worden gedaan. `# Using previously built bridge_base image` `FROM bridge_base` `COPY postgresql-42.3.3.jar /opt/tableau/tableau_driver/jdbc/` **Voorbeeld** Installeer het Amazon Redshift-stuurprogramma. `# Using previously built bridge_base image` `FROM bridge_base` `yum install -y unixODBC` `yum --nogpgcheck localinstall -y` `AmazonRedshiftODBC-64-bit-2.1.7.0.x86_64.rpm` `odbcinst -i -d -f /opt/amazon/redshiftodbcx64/odbcinst.ini` 2. Een nieuwe image maken `docker image build -t bridge_final .` De `bridge_final`\-image gebruikt de in cache geplaatste image uit de vorige stap en automatiseert de installatie van het stuurprogramma voor al uw Bridge-instanties. Als u over een opslagplaats met images beschikt, kunt u de image in de opslagplaats publiceren en naar alle computers distribueren waarop u Bridge wilt uitvoeren. ### Stap 3: Installeer de taalpakketten en stel de landinstellingen in Docker in 1. Installeer taalpakketten in uw Docker-containers: `RUN yum install -y glibc-langpack-en` 2. Stel de landinstelling in Docker in met behulp van `ENV LC_ALL en_US.UTF-8`. U kunt de landinstellingen ook instellen door het volgende toe te voegen aan het `/etc/profile`\-bestand. `export LANG="en_US.utf8"` `export LANGUAGE="en_US.utf8"` `export LC_ALL="en_US.utf8"` ### Stap 4: Voer de Bridge-container uit Nu u een basisimage hebt gemaakt, kunt u deze op verschillende manieren implementeren. De basisstappen zijn: 1. Tokens maken 2. Start de instantie van de Bridge-container. 3. Wijs de agent toe aan een pool. #### Tokens maken Voordat u begint met het implementeren van de container, moet u een [Persoonlijk toegangstoken](https://help.tableau.com/current/online/nl-nl/security_personal_access_tokens.htm) (PAT) of een [Uniform toegangstoken](https://help.tableau.com/current/api/cloud-manager/nl-nl/docs/unified_access_tokens.html) (UAT) maken. Een PAT is vereist om te kunnen inloggen bij de agent. **Overwegingen en vereisten**: - Tableau Cloud ondersteunt 104 PAT's per gebruiker. We raden aan om per client één PAT of UAT te gebruiken. - De volgende tokennamen moeten overeenkomen: de `patTokenId` of `jwTokenFile` (gebruikt bij het uitvoeren van de opdracht `run-bridge.sh`), de tokennaam in het JSON-bestand en de tokennaam die u bij het genereren van de token opgeeft. - Als u een UAT gebruikt, moet u de vereiste OAuth-scopes opnemen: `"tableau:remote_agents:*"`, `"tableau: jobs:read"`, `"tableau:file_uploads:*"`, `"tableau:datasources:*"` #### Instantie starten De interactieve methode in deze procedure geeft aan welke stappen nodig zijn om de worker te starten. Zodra u afsluit, wordt het uitvoeren van de container gestopt. - Voer de volgende opdracht uit om als `root` naar de shell-prompt voor de container te gaan: `docker container run -it bridge_final /bin/bash` De overige opdrachten worden uitgevoerd in de context van deze interactieve sessie van de container. 1. Voeg de PAT of UAT toe aan een bestand zonder opmaak in JSON-indeling. Bijvoorbeeld: `/home/jSmith/Documents/MyTokenFile.txt` 2. Voorbeeld van token-syntaxis: `{"MyToken" : "uLICC7e8SUS8ZNGe8RIFn4u==:lRihmYHI0XBKle7e8S4uSORXGqAkAl4"}` 3. Wijzig de bestandsmachtigingen om de toegang tot de huidige gebruiker te beperken. Bijvoorbeeld: `chmod 600 MyTokenFile.txt` 4. Start een instantie van de Bridge-container door de opdracht `run-bridge.sh` uit te voeren. Het proces varieert afhankelijk van het type token dat u gebruikt: **Voorbeeld van een PAT-opdracht** /opt/tableau/tableau\_bridge/bin/run-bridge.sh -e --patTokenId="Mytoken" --userEmail="admin@tableau.com" --client="myBridgeAgent" --site="mySite" --patTokenFile="/home/jSmith/Documents/MyTokenFile.txt" --poolId="1091bfe4-604d-402a-b41c-29ae4b85ec94" **Voorbeeld van een UAT-opdracht** /opt/tableau/tableau\_bridge/bin/run-bridge.sh -e --userEmail="admin@tableau.com" --client="myBridgeAgent" --site="mySite" --jwTokenFile="jwTokenFile.txt" --poolId="1091bfe4-604d-402a-b41c-29ae4b85ec94" run-bridge.sh-parameters
Algemene parameters
--client(Vereist) De naam die u aan de worker wilt geven.
--site(Vereist) De sitenaam zoals deze in de URI wordt weergegeven. Voeg het URI-pad niet toe.
--userEmail(Vereist) Het e-mailadres van de gebruiker dat aan de token is gekoppeld.
-e(Optioneel) Standaard wordt de Bridge-clientworker als achtergrondservice uitgevoerd. Om de worker op de voorgrond uit te voeren, voegt u het argument -e toe.
--poolId(Optioneel) Pool-ID die aan de client is toegewezen. Zie Een pool-ID gebruiken.
PAT: vereiste parameters
--patTokenIdDe ID van het PAT. Zie Persoonlijke toegangstokens voor meer informatie.
--patTokenFileBestandsnaam en pad naar het PAT-tekstbestand.
UAT: verplichte parameter
--jwTokenFileBestandsnaam en pad naar het UAT-tekstbestand.
**Opmerking**: als u oudere versies van de Bridge voor Linux installeert, moet u een andere opdracht uitvoeren om de worker te starten. Voor versies 2024.2 en ouder moet u de worker starten met de opdracht `TabBridgeClientWorker` (niet de opdracht `run-bridge.sh`). Alle opdrachtopties zijn hetzelfde. **Agent gestart** Het volgende bericht geeft aan dat de agent is gestart: `“Service started: ...”` **De worker stoppen** Gebruik `Control-C` om de worker te stoppen. In plaats van de worker opnieuw te starten, kunt u een nieuwe worker voor de containerimage starten. #### Standaardpooltoewijzing Als u geen pool met de opdrachtoptie `--poolId` hebt toegewezen, wordt de client toegewezen aan de standaardpool. Als u de client met specifieke domeinen of VConns wilt gebruiken, kunt u de client via de gebruikersinterface aan een benoemde pool toewijzen. Het menu hiervoor in Tableau Cloud is Start \> Instellingen \> Bridge. Zie [De Bridge-clientpool configureren](https://help.tableau.com/current/online/nl-nl/to_enable_bridge_live_connections.htm) voor meer informatie. #### Een pool-ID gebruiken Als u de Bridge-worker start met de opdracht `run-bridge.sh`, is `poolId` optioneel. Het gedrag van de client is echter afhankelijk van de vraag of de client is geregistreerd op een site en of de client is toegewezen aan een pool. Tableau Bridge kan op elk willekeurig moment verbinding maken met of zich registreren bij één Tableau Cloud-site. De client wordt geregistreerd op een site wanneer u zich afmeldt en opnieuw aanmeldt. **Als er geen pool-ID is opgegeven** - Als de Bridge-client is geregistreerd, blijft de clientstatus hetzelfde: - Als de client aan een pool is toegewezen, blijft deze aan de pool toegewezen, ongeacht of het een benoemde pool of een standaardpool is. - Als de client niet aan een pool is toegewezen, blijft deze niet toegewezen. - Als de Bridge-client nieuw is (u bent nog nooit aangemeld bij Tableau Cloud), wordt de client toegewezen aan de standaardpool. **Als er een pool-ID wordt verstrekt** - Als de pool-ID is opgegeven en correct is, wordt de Bridge-client toegewezen aan de genoemde pool. - Als de pool-ID is opgegeven en onjuist is: - Als de Bridge-client niet is geregistreerd, wordt de client toegewezen aan de standaardpool. - Als de Bridge-client is geregistreerd, blijft de clientstatus hetzelfde, ongeacht of het een benoemde pool, standaardpool of niet-toegewezen pool betreft. #### De pool-ID vinden Om de pool-ID te vinden, gaat u naar de pagina Instellingen \> Bridge en klikt u op de naam van de pool. Bijvoorbeeld: ![](/tableau/current/nl-nl/online/nl-nl/Img/bridge_pool_id.png) ## Bridge voor Linux-client upgraden Door steeds over de nieuwste versie van Bridge te beschikken zorgt u ervoor dat u kunt profiteren van de nieuwste functies en oplossingen die in elke nieuwe versie zijn opgenomen. U kunt geen in-place upgrade uitvoeren voor de container. In plaats daarvan moet u een nieuwe containerimage maken met de nieuwste binaire Bridge-directory's en vervolgens de Bridge-client aan de pool toevoegen naast de vorige versie. Nadat u de functionaliteit hebt gevalideerd, verwijdert u de vorige Bridge-client. Volg deze stappen: 1. Installeer en configureer de nieuwe Tableau Bridge-client zoals beschreven in de bovenstaande secties. 2. Voeg de nieuwe Bridge-client toe aan de relevante pool. Zie [Pooling-activiteiten configureren](https://help.tableau.com/current/online/nl-nl/to_enable_bridge_live_connections.htm). 3. Controleer de status van de Bridge-taken om de stabiliteit te valideren voordat u doorgaat naar de volgende stap. 4. Verwijder de vorige Bridge-client(s) uit de pool. Open de pool, identificeer de clientcomputer die verwijderd moet worden en klik op **Verwijderen**. 5. Wacht tot het time-outproces voor extractvernieuwing op de Bridge-client is voltooid. De standaardinstelling voor time-outs is 24 uur. Zie [dataSourceRefreshInstellingen](https://help.tableau.com/current/online/nl-nl/to_sync_change_computer_site.htm#dataSourceRefreshSettings) voor meer informatie. 6. Nadat de time-outperiode voor vernieuwing is verstreken, kunt u het vorige exemplaar van de Bridge-client verwijderen. ## Problemen oplossen ### Oudere versies installeren Als u oudere versies van de Bridge voor Linux installeert, moet u een andere opdracht uitvoeren om de worker te starten. Voor versies 2024.2 en ouder start u de worker met de opdracht `TabBridgeClientWorker` (niet de opdracht `run-bridge.sh`). Alle opdrachtopties zijn hetzelfde als hierboven gedocumenteerd in [Stap 4: Voer de Bridge-container uit](#runBridgeContainer). Bijvoorbeeld:  /opt/tableau/tableau\_bridge/bin/TabBridgeClientWorker -e --patTokenId="Mytoken" --userEmail="admin@tableau.com" --client="myBridgeAgent" --site="mySite" --patTokenFile="/home/jSmith/Documents/MyTokenFile.txt" --poolId="1091bfe4-604d-402a-b41c-29ae4b85ec94" ### Fout bij opstarten van worker In sommige gevallen wordt de volgende fout weergegeven nadat u de opdracht `run-bridge.sh` hebt uitgevoerd: `Missing log in parameters. Aborting the attempt to start service worker.` In de meeste gevallen moet u de opdracht opnieuw uitvoeren met de oorspronkelijke opties. De optie `-e` lost het probleem op. Met de optie `-e` wordt de Bridge Worker-service op de voorgrond uitgevoerd. Als u de Bridge-client in de achtergrondmodus uitvoert en er een opstartfout optreedt, controleer dan of alle invoerparameters paden naar eventuele vereiste bestanden bevatten. In de achtergrondmodus wordt bijvoorbeeld geen gebruikerscontext verstrekt om een pad naar het tokenbestand op te lossen. ### Werken met logbestanden Logbestanden worden opgeslagen in de map `My_Tableau_Bridge_Repository/Logs` van de gebruiker. Om logboeken op te slaan in een `tmp` \-map, voert u de volgende opdracht uit: docker container run --volume /tmp/bridge\_logs:/root/Documents/My\_Tableau\_Bridge\_Repository/Logs -it bridge\_final /bin/bash In dit voorbeeld wordt de locatie opgegeven door /tmp/brug\_logs. Met de Docker-opdracht kunt u de logbestanden eenvoudiger opslaan en hoeft u de Bridge-logbestanden niet handmatig uit de container naar uw lokale bestandssysteem te kopiëren. ### MySQL-stuurprogramma mislukt Als `LC_MESSAGES` niet ingesteld zijn met `UTF-8`\-landinstellingen, kunnen er lees- en weergaveproblemen optreden. U kunt het bestand `/etc/profile` bewerken of de worker opnieuw starten met behulp van de volgende opdracht: LC\_ALL=en\_US.UTF-8 /opt/tableau/tableau\_bridge/bin/run-bridge.sh -e ### Bridge Client stopt onverwacht vanwege het verlopen van het Personal Access Token Wanneer een Personal Access Token (PAT) verloopt, wordt de verbinding tussen de Bridge-client en Tableau Cloud verbroken en kan de container worden afgesloten. U kunt vanuit de Bridge-client controleren of uw PAT is verlopen door de opdracht Start op de voorgrond uit te voeren. Als het PAT is verlopen, ziet u de volgende fout: `The client credentials are invalid. To complete the request, reset the credentials, and sign in to the Tableau Bridge client.` Als u de oorspronkelijke eigenaar van het PAT bent, kunt u ook controleren of het PAT is verlopen door naar Accountinstellingen beheren te gaan in Tableau Cloud. Om het probleem op te lossen, moet u een nieuw PAT genereren en de bovenstaande stappen volgen - [Stap 4: Voer de Bridge-container uit](#runBridgeContainer). ### Time-outfouten met ingesloten extract en ingesloten live verbinding Release 24.3 van Bridge op Linux heeft aanzienlijke prestatieverbeteringen geleverd voor ingesloten extracten en ingesloten liveverbindingen. Als u te maken krijgt met time-outfouten bij eerdere releases, raden wij aan te upgraden naar versie 24.3 van Bridge voor Linux. Als het probleem hiermee niet is opgelost, publiceer dan de databron afzonderlijk van de werkmap.