KNOWLEDGE BASE

Tableau Prep Conductor Process in a STATUS_UNAVAILABLE State After Configuring The net.properties File


Published: 14 Dec 2021
Last Modified Date: 15 Dec 2021

Issue

After configuring the Java net.properties file for Tableau Server OAuth connections to work with a Forward Proxy, Tableau Prep Conductor may fail to enable with its status listed as STATUS_UNAVAILABLE. 

The Tabadminagent log will report that the flowprocessor license check has failed, for example:
 
INFO  com.tableausoftware.tabadmin.agent.status.ServiceStatusRequestRunner - Posting status update for flowprocessor_0: STATUS_UNAVAILABLE, detail message: License check did not succeed for flowprocessor_0

Environment

  • Tableau Server 2021.1 and later

Resolution

To resolve this issue with configuring the net.properties file, follow the steps below:

Configure Java net.properties proxy settings (Windows, Linux)

1. Locate the version of java that you are using to run Tableau Server.
    For example:
    a. On Linux this may be: opt/tableau/tableau_server/packages/repository*/jre
    b. On Windows: C:\Program Files\Tableau\Tableau Server\packages\repository*\jre
2. In the java locations directory, click on the “conf” folder.
    a. If this directory does not exist, then create one.
3. In the “conf” folder, locate the net.properties file, and open it in an editor (if this file does not exist, then           create one by the same name)
    a. NOTE: You may not have write permissions on this file, if this is the case, use System file         settings to modify the permissions so you have write access to this file.
4. Modify/Create the below values:
  • http.proxyPort=<your proxy port>
  • http.proxyHost=<your proxy host address> IMPORTANT! Make sure to only include the host. If your proxy address is http://myproxy:8888 (http://myproxy:8888/) then you should set http.proxyHost=myproxy
  • https.proxyPort=<your proxy port>
  • https.proxyHost=<your proxy host address> IMPORTANT! Make sure to only include the host. If your proxy address is http://myproxy:8888 (http://myproxy:8888/) then you should set https.proxyHost=myproxy
    By default http.nonProxyHosts will =localhost|127.*|[::1]. Make sure to include the following:
  • Server host names and IP addresses of other Tableau Server computers in the same cluster.
  • Separate each item by “|”
5. Repeat steps 1-4 on all Tableau Server nodes
6. Stop Tableau Server
7. Reboot all Tableau Server nodes
8. Start Tableau Server
9. Verify all services are working as expected and test the OAuth connections.

Connecting through a Proxy that requires Authorization

If your proxy requires that you sign in with a username and password, then you will need to set up the below in order for OAuth requests to work through the proxy.

1. Locate the version of java that you are using to run Tableau Server. For example:
    a.  on Linux this may be: opt/tableau/tableau_server/packages/repository*/jre
    b. on Windows: C:\Program Files\Tableau\Tableau Server\packages\repository*\jre
2. In the java locations directory, click on the “conf” folder.
    a. If this directory does not exist, then create one.
3. In the “conf” folder, locate the net.properties file, and open it in an editor (if this file does not exist, then       create one by the same name)
    a. NOTE: You may not have write permissions on this file, if this is the case, use System file settings to modify the permissions so you have write access to this file.
4. Modify/Create the below values:
    a. http.proxyUser=<your proxy username>
    b. http.proxyPassword=<your proxy password>
5. Repeat steps 1-4 on all Tableau Server nodes
6. Stop Tableau Server
7. Reboot all Tableau Server nodes
8. Start Tableau Server
9. Verify all services are working as expected and test the OAuth connections.

Cause

The root cause is an improperly configured net.properties file resulting in the proxy configuration not working appropriately leading to service degradation.
Did this article resolve the issue?