Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Getting Started

There are two parts to setting up the Tableau for Confluence Pro connector

...

Info
titlePre-requisites

Confluence usernames and Tableau usernames must be the same for each user

Tableau Server Configuration

You will need to allow connections from Confluence to your Tableau Server.

Tsm

...

Step 1: Disable trusted ip checking in Tableau

Code Block
languagebash
themeMidnight
tsm configuration set -k wgserver.extended_trusted_ip_checking -v false

Step 2: Find your Confluence Server(s) IP address (e.g. 192.168.1.1)

Step 3: Replace the following example code with your Confluence Server(s) IP addresses and run the command

Code Block
languagebash
themeMidnight
titleExample Commands
tsm configuration set -k wgserver.trusted_hosts -v "192.168.1.1, 192.168.1.2" // These IPs are examples, please use the ones from your Confluence Server(s).

Step 4: Run the following commands to finish the tsm setup 

Code Block
languagebash
themeMidnight
tsm pending-changes apply
Note
titleNotes

If you have multiple nodes in a Datacenter instance, you need to add all of them

The comma separated list of ip addresses should be within double quotes with a space after each comma.

Confirm that the restart completed

Tabadmin

...

Step 1: Find tabadmin in C:\Program Files (x86)\Tableau\Tableau Server\7.0\bin and run the following command 

Code Block
languagebash
themeMidnight
tabadmin set wg_server.extended_trusted_ip_checking false

Step 2: Find your Confluence Server(s) IP address (e.g. 192.168.1.1)

Step 3: Replace the following example code with your Confluence Server(s) IP addresses and run the command

Code Block
languagebash
themeMidnight
titleExample Commands
tabadmin set wgserver.trusted_hosts "192.168.1.1, 192.168.1.2" // These IPs are examples, please use the ones from your Confluence Server(s).

Step 4: Run the following commands to finish the tabadmin setup 

Code Block
languagebash
themeMidnight
tabadmin configure
tabadmin restart
Note
titleNotes

If you have multiple nodes in a Datacenter instance, you need to add all of them

The comma separated list of ip addresses should be within double quotes with a space after each comma.

Confirm that the restart completed

Tableau Server behind a Proxy

...

You will also need to tell Tableau Server to trust connections coming to it through a proxy, this will require additional steps:

Step 1: Find the hostnames which your Proxy would report

Step 2: Replace the following example code with your hostnames and run the commands

Code Block
languagebash
themeMidnight
titleExample Commands
tsm configuration set -k gateway.trusted_hosts -v "TableauServer, localhost, tableau" // These should be the hostnames which your Proxy would report.
tsm configuration set -k gateway.public.port -v "443"
tsm configuration set -k gateway.trusted -v "127.0.0.1, 10.10.10.11"
tsm configuration set -k gateway.public.host -v "tableau.example.com"
Note
titleNotes

See https://help.tableau.com/current/server/en-us/proxy.htm#reverse-proxy-server for more details on what values to place in each of these.

Confluence App Configuration

...

Install the plugin from the Atlassian Marketplace: https://marketplace.atlassian.com/apps/350103/tableau-for-confluence-pro?hosting=server&tab=overview

Start a trial or install your license.

Image Removed

  1. Click to Cog drop-down
  2. Click on Add-ons
  3. Click on Configuration in the Tableau section of the left menu bar
  4. Fill out at least one Tableau server URL using the key "prod"
    1. Click Save
  5. Add more servers using keys other than "prod" (optional)
    1. You must click save after adding every entry

If you need to provide a domain for your users, you can use the key domain. For example, if your username looks like acmecorp/john, then you would set a key of domain with a value of acmecorp.

Troubleshooting

...

If users are not seeing reports appearing as expected, you can test that trusted authentication is properly working by adding the Key debugusername and then setting the Value to a single debug user which you want to use for testing purposes.

...

There are two parts to setting up Tableau for Confluence Pro. You must do them in this order. 

Step 1. Set up Tableau per the Tableau Server Configuration

Step 2. Set up the Tableau for Confluence Pro app in Confluence per Confluence App Configuration