De JMX-poorten inschakelen

Om u te helpen bij het oplossen van een probleem met Tableau Server, kan Tableau Support u vragen de JMX-poorten van de server in te schakelen. Deze poorten kunnen handig zijn voor het monitoren en oplossen van problemen, meestal met een tool als JConsole. In versie 2022.1 en nieuwer kunnen de JMX-poorten veilig worden ingeschakeld. Dit is de aanbevolen methode. In versies ouder dan 2022.1 kunt u de poorten alleen onbeveiligd inschakelen.

Beveiligde JMX-poorten inschakelen

Vanaf versie 2022.1 van Tableau Server, kunt u JMX-poorten veilig inschakelen. In deze procedure wordt uitgelegd hoe u JMX veilig kunt inschakelen. Om JMX in eerdere versies in te schakelen, raadpleeg Onbeveiligde JMX-poorten inschakelen hieronder.

Om beveiligde JMX-poorten in te schakelen op Tableau Server:

  1. Meld u aan als gebruiker met sudo-toegang op de computer waarop TSM is geïnstalleerd.

  2. Voer deze opdracht uit:

    tsm maintenance jmx enable

    De opdracht heeft verschillende opties die u kunt opgeven wanneer u deze uitvoert. Als u bij het uitvoeren van de opdracht geen opties opgeeft, wordt u op basis van de door u gegeven antwoorden om opties gevraagd.

    Bijvoorbeeld:

    C:\Windows\system32>tsm maintenance jmx enable
    We do not recommend you enable JMX unsecured on a production environment. Would you like to enable security features for JMX?
    (y/n): y
    JMX access is readonly by default. Would you like to add readwrite access?
    (y/n): n
    Would you like to enable SSL?
    (y/n): y
    Would you like to require client authentication (mTLS)?
    (y/n): n
    Enabling JMX with the specified settings. This will perform a server restart. Do you want to continue?
    (y/n): y
    Starting enable JMX asynchronous job.

    Zie tsm maintenance jmx enable voor meer informatie over de opdracht en de opties.

Onbeveiligde JMX-poorten inschakelen

Voor versies van Tableau Server ouder dan 2022.1.0 geldt dat als u JMX-poorten inschakelt, deze alleen onbeveiligd kunnen worden ingeschakeld.

Belangrijk Het inschakelen van onbeveiligde JMX-poorten kan een beveiligingsrisico met zich meebrengen. Wij raden u ten zeerste aan om beveiligde JMX te gebruiken. Als u geen versie van Tableau Server hebt waarbij dit wordt ondersteund, moet u zich bewust zijn van het risico en dit beperken door de toegang tot de JMX-poorten te beperken tot het kleinste aantal clients dat praktisch is voor uw scenario. Meestal beperkt u de toegang via de firewallregels van de host, een extern beveiligingsapparaat of routeringsregels.

Om onbeveiligde JMX-poorten op Tableau Server in te schakelen:

  1. Stop de server.

  2. Voer de volgende opdracht in:

    tsm configuration set -k service.jmx_enabled -v true
  3. Lopende wijzigingen toepassen:

    tsm pending-changes apply

    Als voor de in behandeling zijnde wijzigingen de server opnieuw moet worden opgestart, geeft de opdracht pending-changes apply een prompt weer om u te laten weten dat de server opnieuw wordt gestart. Deze prompt verschijnt ook als de server is gestopt, maar in dat geval vindt er geen herstart plaats. U kunt de prompt onderdrukken met de optie --ignore-prompt, maar dit verandert niets aan het herstartgedrag. Als opnieuw opstarten niet nodig is voor de wijzigingen, worden de wijzigingen zonder waarschuwing van een prompt toegepast. Zie tsm pending-changes apply voor meer informatie.

  4. Start de coördinatieservice en TSM-beheercontroller opnieuw op (als tableau-systeemaccount):

    sudo su -l tableau -c "systemctl --user restart appzookeeper_0.service"

    sudo su -l tableau -c "systemctl --user restart tabadmincontroller_0.service"

    Het kan even duren voordat de tabadmincontroller opnieuw is opgestart. Als u probeert om in behandeling zijnde wijzigingen toe te passen in de volgende stap voordat de controller volledig opnieuw is opgestart, kan TSM geen verbinding maken met de controller. U kunt controleren of de controller actief is met de opdracht tsm status -v. Er moet staan dat de Tableau Server-beheercontroller wordt uitgevoerd.

  5. Start de server op.

Hoe de JMX-poorten worden bepaald

Standaard worden de JMX-poorten dynamisch toegewezen, binnen een bereik van beschikbare poorten. Zie Tableau Services Manager-poorten voor meer informatie over hoe poorten worden toegewezen en hoe u dynamische toewijzing kunt overschrijven.

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