Was this page helpful?
Yes No
Server Administrator Guide > Troubleshooting > Troubleshoot Install and Upgrade

Troubleshoot Tableau Server Install and Upgrade

Follow the suggestions in this topic to resolve common issues with Tableau Server. For additional troubleshooting steps based on process status viewed on the Status page, see Troubleshoot Server Processes.

General Troubleshooting Steps

Many Tableau Server issues can be addressed with some basic steps:

  1. Make sure there is enough disk space on each computer running Tableau Server. Limited disk space can cause a failure to install, a failure to upgrade, or problems running Tableau Server.

  2. Restart Tableau Server. Issues related to indexing and processes not fully started can be resolved by restarting Tableau Server in a controlled way. To restart Tableau Server, use the tabadmin restart command. This will stop all the processes associated with Tableau Server and then restart them.

  3. Clean up files associated with the Coordination Service (ZooKeeper). To clean up Coordination Service files, use the tabadmin cleanup --reset-coordination command.

Starting Tableau Server

Tableau Server cannot determine if it fully started

In some instances Tableau Server may report that it could not determine if all components started properly on startup. A message displays: "Unable to determine if all components of the service started properly."

If you see this message after starting, verify that Tableau Server is running as expected by using a tabadmin status -v command.

If the status shows as running ("Status: RUNNING"), then the server successfully started and you can ignore the message. If the status is DEGRADED or STOPPED, see "Tableau Server doesn't start" in the next section.

Tableau Server doesn't start

If Tableau Server does not start or is running in a degraded state, run the tabadmin restart command from a command prompt. This will shut down any processes that are running, and restart Tableau Server.

Installing Tableau Server

Install fails due to hardware requirements

Starting with version 9.0, Tableau Server cannot install if the computer you are installing on does not meet the minimum hardware requirements. The requirements apply to both primary server computers and worker computers. For details on minimum hardware requirements, see Minimum Hardware Requirements and Recommendations for Tableau Server.

Install or upgrade generates an error when PostgreSQL ODBC driver does not install correctly

In certain circumstances (when a system reboot is pending, or another program is being installed or updated, the Tableau Server PostgreSQL ODBC driver does not install correctly. When this happens, this message displays:

PostgreSQL ODBC driver (64-bit) version 09.03.0400 did not install properly.

Note: The version may be different, depending on what version of Tableau Server you are installing.

If this occurs, follow these steps to correct the issue:

  1. Check to see if the driver shows as installed in Control Panel.

  2. If the driver is not installed, download it from the Tableau Drivers page and install it.

  3. If the driver is installed, uninstall it from Control Panel, restart the computer, download the driver, and install it again.

Upgrading Tableau Server

Extract migration is slow

Tableau Server 9.0 introduced a more reliable storage mechanism for data extracts called the File Store. Upgrading from a previous version requires migration of the extracts. This can take a long time (up to several hours) if you have a large number of extracts or extracts that have a lot of data. During migration a message displays:

Migrating extracts to File Store
This process may take up to several hours.

If the migration progress appears to be stalled or stuck, you can verify that migration is continuing by watching the tabadmin.log. An entry is written to this log for each extract that is migrated. You can periodically copy the log and open your copy in a text editor like Notepad to verify that entries are being written to it.

 

Upgrading fails due to lack of disk space

If there is not enough disk space for the Tableau Server Setup program to run and do the upgrade, the installation will fail. The amount of disk space required will depend on the size of your repository database and the number and size of your extracts. As a part of upgrading to version 9.0, the Setup program migrates extracts to the new File Store and this takes space.

To free up disk space:

  1. Zip and save logs using the tabadmin ziplogs command.

    After you create the ziplogs file, save it to a safe location that is not part of your Tableau Server installation.

  2. Clean up unnecessary files using the tabadmin cleanup command. For more information, see Remove Unneeded Files

Reindexing Tableau Server Search & Browse

Problems that can be solved by reindexing Search & Browse

Symptoms of an index that needs to be rebuilt include:

  • A blank list of sites when a user attempts to log in
  • A blank list of projects when a user tries to select a project
  • Missing content (workbooks, views, dashboards)
  • Unexpected or inaccurate alerts (for example, an "refresh failed" alert on a workbook that does not include an extract)

If you see any of these behaviors, rebuild the Search & Browse index using the tabadmin reindex command.

Activating Tableau Server

Tableau Server license activation fails

In some instances Tableau Server license activation may fail with one of the following error messages:

  • Function flxActCommonLicSpcPopulateFromTS returned error 50030, 71521,
  • No license found for 'Tableau Server'

To resolve this issue, try these solutions in the order listed:

Verify the date and time

Verify the date and time on the primary Tableau Server computer is correct. If the clock is set to a time and date earlier than the current date, Tableau Server cannot be activated.

Verify FlexNet Licensing Service has started

If the date and time on the Tableau Server computer are correct, verify that the FlexNet Licensing Service is running on the primary Tableau Server computer.

  1. On the primary computer, from the Windows Start menu, open services.msc.

  2. In the Services dialog box, verify that the status of FlexNet Licensing Service 64 (64-bit) or FlexNet Licensing Service (32-bit) is Started.

    If FlexNet is not listed as Started, right-click FlexNet Licensing Service and select Start.

    If the Start option is grayed out, the service may be set to Disabled. To enable the service:

    1. Right-click FlexNet Licensing Service and select Properties.

    2. From the Startup type drop-down list, select Manual.

    3. Click the Start button, and then click OK.

Force the product key to be read again

  1. On the primary Tableau Server computer, sign in as administrator and open a command prompt.

  2. Change to the Tableau Server bin directory. By default this is:

    C:\Program Files\Tableau\Tableau Server\10.2\bin
  3. Type the following commands:

    tabadmin stop
    lmreread
    tabadmin start

Send the contents of trusted storage to Tableau Support

If FlexNet Licensing Services is installed and running but you're still seeing an error, there might be a problem with the Tableau product key information. To resolve this issue, complete the following steps to create a file of the key information located in trusted storage.

  1. On the primary Tableau Server computer, sign in as administrator and open a command prompt.

  2. Change to the Tableau Server bin directory. By default this is:

    C:\Program Files\Tableau\Tableau Server\10.2\bin
  3. Type the following command:

    serveractutil -view > LicResults.txt
  4. Contact Customer Support (http://www.tableau.com/support/request) and include the LicResults.txt file that you created.