Set Up a New Aternity Dashboard Worker Server

Add an Aternity Dashboard Worker Server for larger deployment sizes to improve dashboard performance, by creating one or more standalone dedicated PCs which work on background processes for the Aternity Dashboard Server.

The Aternity Dashboard Worker Server accepts much of the intensive processing required to create dashboards, enabling larger Aternity on-premise deployments to display dashboards more efficiently.

Add the number of standalone Dashboard Worker Servers according to the requirements for the size of your deployment.

Dashboards in large deployments are more efficient with Dashboard Worker Servers
Note

The Dashboard Worker Server topology is only available for deployments of Aternity 9.0.2 or later.

Before you begin

Before starting the setup of a Dashboard Worker Server, complete the setup or update of the Dashboard Server.

Make sure the hardware and operating system of the Aternity Dashboard Server conform to the following requirements:

Attribute Requirement

Operating system for Dashboard Server and Dashboard Worker Server

Windows Server 64 bit 2012 R2 or 2008 R2 Enterprise Edition (with KB2117917). Set the date and time formats to Control Panel > Regions > Formats > English (United States).

Hardware

Hardware specifications depend on the size of your Aternity on-premise deployment. Choose the sizing and hardware specifications for your deployment size.

Connectivity for Dashboard Worker Server

This server must connect to the Dashboard Server via numerous ports (always place them together), and to the Aternity Database Server through port 1521.

Procedure

  1. Step 1 On the main Dashboard Server, stop the Tableau service by opening a command prompt as administrator and entering tabadmin stop.
    Stop the server on the main Dashboard Server
  2. Step 2 Access the separate computer where you want to create the Dashboard Worker Server.
  3. Step 3 Log in to the computer as a local administrator.

    To verify you are a local administrator on this computer, not a domain administrator, open the System control panel, select Advanced system settings > Computer Name, and confirm the Change button is active.

  4. Step 4 Download the latest version of Aternity on-premise from our website.

    The setup package is for all Aternity servers.

    Download Aternity on-premise from the website
  5. Step 5 Right-click the setup and select Run as administrator to begin.
  6. Step 6 Enter the pathname on this computer to install the Dashboard Worker Server.
    Important

    You MUST use the exact same drive and pathname on this server as the one you entered when setting up the main Dashboard Server. For example, if you set up the main Dashboard Server on D:\Program Files\Tableau Server\Tableau, you must use this exact local pathname on the Dashboard Worker Server, including the drive name.

    Enter the same drive and pathname as you did when you set up the main Dashboard Server
  7. Step 7 Enter the hostname (recommended), FQDN of the main Dashboard Server.
    Enter the name of the Dashboard Server
  8. Step 8 Complete the setup.

    There is no system tray icon to indicate that the Dashboard Worker Server is running.

    Note

    If you receive the error Worker is not responding, disable the Windows Firewall on the Dashboard Worker Server.

  9. Step 9 Back on the main Dashboard Server, select Start > Configure Aternity Dashboard Server and select Servers.

    View the list of servers in the Tableau cluster, even though the status of Tableau's system tray icon is still Stopped.

    View the list of servers in the Tableau cluster
  10. Step 10 Select Add... to add the Dashboard Worker Server.

    Since the Dashboard Worker Server must take on all the background processes from the main Dashboard Server, you must specify the hostname (recommended), FQDN, or IP address of the Dashboard Worker Server and leave all fields unchanged except the Backgrounder processes.

    Add the Dashboard Worker Server configuration
    Field Description
    Computer

    Enter the hostname (recommended), FQDN, or IP address of the Dashboard Worker Server

    Backgrounder

    Enter the number of processes according to the value specified in your sized deployment.

  11. Step 11 In the same screen, remove the background processes from the main Dashboard Server, by selecting This Computer (Primary) > Edit.

    This ensures the main server delegates all its background processes to the Dashboard Worker Server.

    In the edit window, set its Backgrounder processes to 0.

    Set the background process allocation on the primary computer to zero
  12. Step 12 On the main Dashboard Server, start the Tableau service by opening a command prompt as administrator and entering tabadmin start.
    Start the Dashboard Server after configuring the Dashboard Worker Server
  13. Step 13 To verify, in a browser, sign in directly to the main Dashboard Server.

    For example, go to http://localhost:[port_for_Tableau] on the Dashboard Server, or http://dashboards.aternity.mycompany.com from another computer.

    Log in to Tableau
  14. Step 14 Select Server > Status to verify the Backgrounder entry lists the correct number of processes on the Dashboard Worker Server.

    Verify the Backgrounder processes display under the Dashboard Worker Server and display as green.

    Verify the Dashboard Worker Server has the correct number of Backgrounder processes