Set Up a New Aternity Dashboard Server

This article describes how to set up a new Aternity Dashboard Server.

The Dashboard Server displays Aternity's intuitive dashboards using Tableau as its engine. It presents the data from the Aternity Vertica Database Server.

Create the Dashboard Server which contains the Tableau Server and other components

The Dashboard Server must be a separate computer which contains the following components:

  • Tableau Server: Aternity 12.2 requires that your Dashboard Server runs Tableau Server 2021.3.7 (using Tomcat 9.0.45, Apache httpd 2.4.52).

    Tableau is the engine which processes the data into intuitive dashboards, as defined by the Aternity dashboard definitions.

  • The Dashboard Gateway acts as the interface between the Dashboard Server and the Aternity Management Server, performing background tasks like preprocessing the data for display in the dashboards, and maintaining logs, audits and cleanup. It must be on the same computer as the Dashboard Server. While it has no user interface of its own, it is crucial to the proper functioning of Aternity.

  • The Aternity dashboard definitions describe the layout and format of the Aternity dashboards which present the data to users.

Tip:

Air-gapped networks make offline Tableau setup very lengthy. You must upload and download several files in sequence as a challenge response. Tableau does not allow this in one action. We do not control their setup procedures.

Before you begin

Before creating the Dashboard Server:

  • Complete setting up the Aternity Oracle Database Server.

  • Complete setting up one or more Aternity Vertica Database Servers.

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

    Attribute Requirement

    Operating system for Dashboard Server

    Use any of the following:
    • Windows Server 2019 64 bit or

    • Windows Server 2016 64 bit or

    For updates, if the Dashboard Server is installed on Windows 2012, it is recommended to set up a new server on Windows 2016 or 2019.

    Set the date and time formats to Control Panel > Region > Formats > English (United States).

    Also, go to Control Panel > Region > Administrative > Copy settings and copy your current settings to Welcome screen and system accounts. Make sure that Language for non-Unicode programs is set to English (United States).

    Set language regional formats

    Time zone

    Synchronize all Aternity components to have the same date, time AND time zone.

    We recommend that an IT person define a clock synchronization service, like for example NTP, between all Aternity components. This will provide highly accurate timing for all network components and prevent clock drift.

    Hardware

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

    Microsoft .NET

    Ensure this server has Microsoft .NET 3.5 (exactly) required for the database drivers, and .NET 4.5 or later, required for driver setup (both in parallel). To add .NET to a Windows Server, learn more.

    Tableau version for Dashboard Server

    Aternity 12.2 requires that your Dashboard Server runs Tableau Server 2021.3.7 (using Tomcat 9.0.45, Apache httpd 2.4.52).

    Network

    Ensure this server has a static IP v4 address, and that you open the required ports.

    Connectivity for Dashboard Server

    This server must be open for access on port 80 or 443 from the Aternity Management Server and users accessing the Aternity dashboards from their browser.

    This server requires internet access (port 80) to connect to Tableau's map service to render Aternity's geographic maps correctly.

    In addition, open port 8000 on the Windows Firewall for Tableau's internal load balancer. Check Tableau's online help for a full list of required open ports.

    Permissions for Dashboard Server

    When installing Dashboard Server, one needs either local or domain administrator rights on this computer, and also the administrator rights in the Tableau Server.

    Verify that the Windows account which is going to set up this server has permission to read, write, list and execute in the Tableau Server setup directory and its sub-folders. Learn more.

    For less standard hardware configurations, see the setup instructions and hardware best practices from Tableau. To deploy on a virtual machine, you must guarantee the CPU and memory requirements.

  • In air-gapped networks: Contact Customer Services to get the key for the offline activation.

Procedure

  1. Step 1 Access the new Aternity Dashboard Server.
  2. Step 2 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.

  3. Step 3 Download the latest Aternity on-premise's main setup package from the Riverbed Support Site (learn more).

    Sign in to Riverbed Support Site, then select Software & Documentation > Application Performance Management > Aternity > Aternity Server. Select the required version to download.

    Note:

    Only logged in users with certain permissions can see the download option.

    The setup package is for all Aternity servers.

    Download Aternity on-premise from the website
    There are also entries in the Useful Links which are required for database setup and others:
    • Tableau Package

    • Oracle Packages

    • Install Scripts

    • DB Schema Scripts

    Refer to Useful Links for the necessary Oracle images and other setup packages.
  4. Step 4 Locate the TableauServer-2021-3-7-Aternity-64bit.exe setup file, which you downloaded from the main setup package or from the Additional Packages section.

    Copy it to a temporary location on this computer.

  5. Step 5 Right-click the setup and select Run as administrator to begin.
  6. Step 6 In the Welcome screen, select Next, then in the Install Customization screen enter the path to the setup directory on a local, non-system drive.

    This reduces the risk of the server application competing with the operating system for disk space. For example, use D:\Program Files\Tableau Server\Tableau.

    Select the location to place the Tableau files

    Select Create new Tableau Server installation and then Install. The system starts extracting the files and verifying if the server meets the minimum requirements. If verification passes, select Next.

  7. Step 7 Wait until the setup opens the browser and starts the TSM.
    Use TSM to configure the server

    The URL address of the TSM web UI is http://<machine_hostname>:8850. Port 8850 is used by default for Tableau administration and configuration. In case you want to access the TSM from a different device, the port 8850 should be open on the device where Tableau was deployed. Learn more.

    You can also open the TSM later from the desktop shortcut.

    Sign in to Tableau Services Manager
  8. Step 8 Sign in to the Tableau Services Manager with the Windows host administrator user on that device.

    Now configure the Dashboard Server using Tableau Services Manager.

  9. Step 9 Activate Tableau.

    Enter Aternity's license key for Tableau: TS1E-AFF9-2A60-C12B-CBF5, and select Activate Product Key. Once registration has finished, click Next.

    Activate Tableau
  10. Step 10 Set up Tableau.
    1. a In the Identity Store section, select Local and NOT the other option.

      On the right side you can read additional information.

      Set up the Identity Store as Local
    2. b In the Run As Service Account section, select NT Authority.
      Set up the Service Account
    3. c In the Gateway Port section, enter 80, the default Tableau HTTP port.
      Set the gateway port for Tableau communication

      Other sections are optional.

  11. Step 11 Select Initialize to complete the setup.

    This process can take a while. Note that you will need to create a Tableau Server Administrator account when this process finishes.

  12. Step 12 In the new Tableau Server tab in the browser window which automatically opens, create a Tableau administrator account.

    Enter an administrator username and password for the Aternity Dashboard Server (Tableau). Make a note of it for when you add the Aternity Dashboard Gateway Server.

    Create a Tableau server administrator account
    Tip:

    If the browser does not automatically open, manually go to http://localhost:[port_for_Tableau].

  13. Step 13 In the Tableau Services Manager, in the Status tab, verify that all processes are Active.
    See at the bottom all possible statuses for the processes
    On the Tableau top bar, check the status of the server (running/stopped/degraded). If necessary, use the drop-down menu to start or stop Tableau.
    Restart or stop the Tableau server
  14. Step 14 In the Configuration tab, Topology page, set the topology.
    Enter the values according to the size of your deployment.
    Edit the process allocation for dashboard components
    Field Trial Small Medium Large X-Large XX-Large
    VizQL Server

    1

    2

    2

    2

    2

    2

    Application Server

    1

    1

    1

    1

    1

    1

    Backgrounder

    1

    2

    2

    2

    2

    4

    Cache Server

    1

    1

    1

    1

    1

    1

    Data Server

    1

    2

    2

    2

    2

    2

    When you change the value(s), that value name becomes highlighted and the button Pending Changes appears.
    Configure Tableau performance according to the size of your deployment
    Click the button and see the list of changes. Check and click Apply Live Changes. The Tableau server will be restarted or restart it manually if prompted.
    Apply the changes
  15. Step 15 In the Configuration tab, License page, activate the license if not yet activated during the deployment process.
  16. Step 16 In the Configuration tab, Security page, External SSL tab, configure SSL for secure communication between Dashboard Server and clients (learn more).
  17. Step 17 (For air-gapped networks only) If this computer is not connected to the Internet, perform an offline activation.

    An offline activation can be time consuming. Plan in advance. Contact Customer Services to get the key for the offline activation.

    When you select Activate, it prompts you to save a file for activating Tableau offline (learn more)

    Note:

    If you set up Aternity Dashboard Server on a virtual machine, please note: An offline process (VM migration) may deactivate a valid license. To prevent Tableau license deactivation, verify that either Tableau virtual machine has a Static Mac address or VMotion is disabled on that virtual machine. Follow VMWare documentation to configure Tableau VM Mac address to Static.

    Tip:

    Air-gapped networks make offline Tableau setup very lengthy. You must upload and download several files in sequence as a challenge response. Tableau does not allow this in one action. We do not control their setup procedures.

    1. a Generate the offline.tlq file, and then copy it to a computer with Internet connectivity.
    2. b From a computer with online access, upload the file on the Tableau activation page.
    3. c Download the activation.tlf file, and copy it to the Dashboard Server.
    4. d Upload the activation.tlf file to the Dashboard Server.
  18. Step 18 Verify the setup succeeded, by checking the status of the system on the Tableau top bar: verify it is RUNNING.
    Verify the Tableau is running

    If the Tableau server does not start, open the TSM using the desktop icon and start it manually from the Tableau top bar.

  19. Step 19 If the process did not complete successfully, or one of the steps returned an error:
    1. a Go to http://<machine_hostname>:8850, and enter the machine local administrator's username and password (NOT Tableau administrator).

      Verify you see the TSM.

    2. b Check the logs located in the Tableau data folder (for example, D:\Program Files\Tableau\Tableau Server\data\tabsvc\logs), or contact Aternity customer services.