Install Aternity on-premise 10

Perform the server install of a fresh Aternity on-premise deployment where each component has its own dedicated computer in larger deployments, or you can combine several components on the same computer for smaller deployments. The components of the Aternity on-premise solution are:

Order for installing Aternity on-premise components
Field Description
Aternity Oracle Database Server

The Aternity Oracle Database Server is an Oracle database which hosts the Aternity system settings, data model and performance data.

Aternity Vertica Database Server

The Aternity Vertica Database Server stores the performance data from the past 31 days in the Vertica format, which is most efficient for displaying in Aternity dashboards.

Aternity Dashboard Server

The Dashboard Server displays Aternity's intuitive dashboards using Tableau as its engine.

Aternity Dashboard Gateway Server

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.

Aternity Management Server

The Aternity Management Server acts as the system's central server, which manages and integrates all the system components. When users access Aternity to view the dashboards or configure the system, they access this server via a browser.

Aternity Data Warehouse Server

The Data Warehouse Server stores the raw data gathered from the Aggregation Servers, and aggregates (summarizes) it for the Oracle Database Server. It constantly aggregates and re-summarizes data in the main database in the background, replacing older, more detailed data with summary data as it ages. Therefore older data typically has limited drill-down capabilities.

Aternity Aggregation Server

An Aggregation Server gathers (aggregates) the data directly from Aternity Agents on monitored devices, and passes it on to the Management Server.

Aternity ETL Server

The Aternity ETL Server is a component of Aternity on-premise, which aggregates and converts performance data from the Aternity Oracle Database Server to the Vertica database format, and sends it to the Vertica Database Server.

Aternity REST API Server

The Aternity REST API Server is a component in Aternity on-premise which allows authorized users to send REST API queries to directly extract and analyze Aternity's data without accessing Aternity's dashboards. You can combine the data with other data sources if needed, or transform it as required, then view it in Microsoft Excel, Power BI, or your own data application.

Aternity Data Source for Portal

The Aternity Data Source for Portal provides Aternity data to the SteelCentral Portal™, so you can view end-user experience data in its dashboards. You can configure the Portal to connect to your Aternity Data Source.

Aternity Agent

The Aternity Agent monitors end user experience by measuring device and application performance. It is a small background utility which runs on each monitored device, and reports its data to the Aternity Aggregation Server.

You must install the Aternity components in the prescribed order in this procedure.

If you have an existing Aternity deployment, follow the instructions to update from your legacy Aternity to version 9.x.

Before you begin

If you are deploying Aternity in an air-gapped network, download the following files and packages before beginning the setup procedures.

File Name Description Link for download

Aternity_OnPremise_<version>_GA.zip

Download the package that includes the setup of the following Aternity servers: Management Server, Aggregation Server, Data Warehouse Server. Vertica Database Server, Dashboard Gateway, ETL Server, Aternity REST API Server, Aternity Data Source for Portal, (For Aternity 10.0.1 only) TableauServer-9-3-22-Aternity-64bit.exe for the Aternity Dashboard Server

Download the latest Aternity on-premise's main setup package from the Riverbed support site by selecting Software (size).

Oracle_11.2.0.4.part1.exe, Oracle_11.2.0.4.part2.exe or Winx64_12102_database_1of2.zip, Winx64_12102_database_2of2.zip

Download the pair of setup files for one of the supported versions of Aternity Oracle Database Server.

Only these exact versions of Oracle to work with this version of Aternity.

Related Links section of the Riverbed support site

Oracle 11.2.0.4 part 1, Oracle 11.2.0.4 part 2

(Aternity 10.0.1) Oracle 12.1.0.2 part 1, Oracle 12.1.0.2 part 2,

OracleSilentInstall_12.1.0.2.zip, OracleSilentInstall_11.2.0.4.zip

Download the script to use the express setup of the Aternity Oracle Database, which requires the complete Oracle setup packages.

Related Links section of the Riverbed support site

Silent Install 11.2.0.4, Silent Install 12.1.0.2

(For Aternity 10.0) TableauServer-9-3-3-Aternity-64bit.exe

The Aternity Dashboard Server uses Tableau, a third party product, as its main engine. Only this exact version of Tableau works with Aternity 10.

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.

Related Links section of the Riverbed support site

Win64OpenSSL_Light-1_0_2n.exe

Download this patch to address an HTTPS (SSL) vulnerability required to access Aternity. Run this during a Dashboard Server fresh setup or update.

Download from this third party site.

Tableau's Apache server update files: vc_redist_x86.exe, httpd-2.4.27-Win32-VC15.zip, and mod_log_rotate-1.00a-win32-VC15.zip

Download this patch to address an Apache server security issue for the Dashboard Server.

Download from this third party site.

.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.

Search for these versions on the Microsoft Download Center.

Chrony

Synchronizes time and time zones between the Aternity components.

If not included in your version of CentOS, search for Chrony, and download the version for your Linux OS.

Database template (DBT)

(Optional) When a DBA manually deploys the Aternity Oracle Database Server, you can use a template to set default values in the setup assistant (DBCA), depending on the size of your deployment.

Contained in the express setup of the Aternity Oracle Database (see above).

Procedure

  1. Step 1 Plan the strategy of your new Aternity on-premise installation:
    Considerations when planning your installation of Aternity on-premise
    • Decide on the size of your deployment, based on the number of devices to monitor. This directly determines the number of servers you need, and their hardware specifications.

      Important

      If your sizing requires that you deploy more than one dedicated Aternity Aggregation Server, you must deploy a third party load balancer (LB). Then configure the Aternity Agent of all devices to point to the LB's virtual IP address (learn more). Configure the LB with persistent (sticky) sessions to ensure the Agent maintains its connection with the same server. Aternity also supports sticky sessions also when the LB implements stickiness via cookies.

      If you deploy more than one dedicated Aternity Aggregation Server, you must have a third party load balancer operating between them.

  2. Step 2 Download the latest Aternity on-premise's main setup package from the Riverbed support site by selecting Software (size).

    The setup package is for all Aternity servers.

    Download Aternity on-premise from the website

    There are also entries in the Useful Links section which are required for database setup.

  3. Step 3 Install the Aternity Oracle Database Server on a dedicated computer:

    For Aternity 10.x, use Oracle 12.1.0.2 or 11.2.0.4.

    Use the express database setup for a fast, easy, small installation
  4. Step 4 Run the Aternity Database Verification Utility for a fresh installation to ensure the database's internal structure and naming is fully compliant with Aternity's requirements.
    Use the Aternity Database Verification Utility to ensure the database is ready for Aternity 10.x
  5. Step 5 Install a single Aternity Vertica Database Server or a cluster of Vertica Database Servers.

    The Aternity Vertica Database Server stores the performance data from the past 31 days in the Vertica format, which is most efficient for displaying in Aternity dashboards. It receives its data from the Aternity ETL Server, which translates performance data from the Aternity Oracle Database Server to this server.

    The number of Vertica Database Servers depends on the sizing of your deployment and your level of high availability and redundancy.

    Learn more about installing a single Vertica Database Server or a cluster of servers.

    Set up one or more nodes of a Vertica Database Server to hold Aternity's data
  6. Step 6 On a separate computer, install the Aternity Dashboard Server.

    The Dashboard Server displays Aternity's intuitive dashboards using Tableau as its engine.

    Install the Dashboard Server and Dashboard Gateway on the same computer
  7. Step 7 On the Dashboard Server, install the Aternity Dashboard Gateway Server.

    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.

    Add the Dashboard Gateway to the Dashboard Server computer
  8. Step 8 On another computer, install the Aternity Management Server.

    To setup the Aternity Management Server, you must register with Aternity's online activation form. Enter your contact details and serial number to send an activation key to your email (learn more).

    You can add more components on the Management Server computer for smaller deployments:

    Install further components on the same Management Server computer for small or medium deployments
  9. Step 9 Install the Aternity dashboard layouts from the Management Server, which plants them in the Dashboard Server via the Dashboard Gateway.

    The Aternity dashboard layouts contain the names, calculations and layouts of the system's dashboards for this Aternity version.

    Install the layouts from the Management Server into the Dashboard Server via Dashboard Gateway
  10. Step 10 (For deployments above 20,000 devices only) Install a standalone Aternity Data Warehouse Server.

    The Data Warehouse Server stores the raw data gathered from the Aggregation Servers, and aggregates (summarizes) it for the Oracle Database Server.

  11. Step 11 (For deployments above 5000 devices only) Install a standalone Aggregation Server.

    An Aggregation Server gathers (aggregates) the data directly from Aternity Agents on monitored devices, and passes it on to the Management Server.

    As your deployment grows in size, add more identical Aggregation Servers (see deployment sizing for details). If your sizing requires that you deploy more than one dedicated Aternity Aggregation Server, you must deploy a third party load balancer (LB). Then configure the Aternity Agent of all devices to point to the LB's virtual IP address (learn more). Configure the LB with persistent (sticky) sessions to ensure the Agent maintains its connection with the same server. Aternity also supports sticky sessions also when the LB implements stickiness via cookies.

    Aggregation Server collects and consolidates data from monitored devices
  12. Step 12 On a separate computer, set up a new Aternity ETL Server.

    The Aternity ETL Server is a component of Aternity on-premise, which aggregates and converts performance data from the Aternity Oracle Database Server to the Vertica database format, and sends it to the Vertica Database Server.

  13. Step 13 (Optional) To retrieve Aternity data via REST API, set up a new Aternity REST API Server.

    The Aternity REST API Server is a component in Aternity on-premise which allows authorized users to send REST API queries to directly extract and analyze Aternity's data without accessing Aternity's dashboards. You can combine the data with other data sources if needed, or transform it as required, then view it in Microsoft Excel, Power BI, or your own data application.

  14. Step 14 (Optional) To view Aternity data in SteelCentral Portal™, set up a new Aternity Data Source for Portal.

    The Aternity Data Source for Portal provides Aternity data to the SteelCentral Portal™, so you can view end-user experience data in its dashboards. You can configure the Portal to connect to your Aternity Data Source.

    Once it is set up, you can connect the Aternity Data Source to Portal

  15. Step 15 To manage the number of monitored devices reporting to the system, configure licenses.
  16. Step 16 Add devices as monitored devices which report their performance to Aternity, by installing the Aternity Agent.
    Important

    Aternity on-premise 10 requires that devices ONLY run Aternity Agent 9.0.x, 9.1.7 or 9.2.5.

    Product Supported Aternity Agent
    Aternity 10.x

    Aternity Agent 9.0.x, 9.1.7 or 9.2.5 ONLY.

    Aternity 9.x

    Aternity Agent 9.0.x ONLY.

    Add the Agent on devices to report their performance to Aternity