Quickly Update an Aternity Aggregation Server on a Dedicated Computer

For all deployments (except trial) of Aternity on-premise (more than 1000 monitored devices), you must create one or more standalone Aternity Aggregation Servers. If you are creating a standalone Aggregation Server for the first time and not as an upgrade, follow the procedure for a fresh setup.

An Aggregation Server gathers (aggregates) the data directly from Agent for End User Devicess on monitored devices, and passes it on to the Management Server.

Aggregation Server collects and consolidates data from monitored devices

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 Agent for End User Devices 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 when the LB implements stickiness via cookies.

Deploy a third party load balancer if you have multiple Aggregation Servers

Depending on your topology choices, you can place the standalone Aggregation Server either in the DMZ or the enterprise network (see the Aternity on-premise topologies).

You can either setup an Aggregation Server as custom or as express (which is detailed here).

  • If you keep the same topology or security, choose the express update, which keeps your legacy settings in the updated servers.

  • If you are changing your topology or security, choose the custom update.

If you are creating a standalone Aggregation Server for the first time, follow the fresh setup procedure.

Before you begin

Before upgrading one or more standalone Aggregation Servers, you must:

  • Download the latest Aternity on-premise's main setup package from the Aternity Support Site by selecting Software (size) (learn more).

  • If you are running a version earlier than v9, update to v9 before updating to this version.

  • Check the correct sizing for your deployment before updating any of your Aternity servers. Learn more.

  • Prepare the Aternity Oracle Database Server for Aternity by verifying its schema. Learn more.

  • Aternity requires you set up one or more new Vertica Database Servers, depending on the size of your deployment. Learn more. (If you performed the data migration process, then your Vertica Database Server is already up and running.)

  • Update the Dashboard Server by removing the previous version of Tableau and then running the setup of the new version. Learn more.

  • On the Dashboard Server, update the Dashboard Gateway component. Learn more.

  • Confirm that a local administrator on the Management Server can connect to the Dashboard Server.

  • Update the Aternity Management Server by running its express setup or custom setup over the previous version.

  • Update the Aternity dashboard layouts from the Management Server. Learn more.

  • (For deployments above 40,000 devices only) Run the express update or the custom update of a standalone Data Warehouse Server on its own computer, or create a new one.

  • Check that your computer conforms to the minimum system requirements:

    Attribute Requirement

    Hardware requirements for Aternity Aggregation Server

    Each Aggregation Server must be at least a Xeon E3 family, 2 cores at 2.4 GHz, hard disk: 30GB (min), RAM: 12GB (min). To determine the number of servers, check the sizing specifications for your deployment.

    Network

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

    Operating system for Aternity Aggregation Server

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

    The Aggregation Server sets up and uses Apache Tomcat 8.5.32.

    You can also deploy the Aternity Aggregation Server on Linux CentOS or Linux RedHat Fedora.

    Permissions

    Ensure you have local administrator privileges on this computer.

    As your deployment grows, you add more identical servers with the same hardware and system requirements.

Procedure

  1. Step 1 Access your standalone Aggregation Server computer.
  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 Stop the AternityPlatform service.
    To stop the service, you must sign in to the computer as an administrator, and access the Windows Services screen. If the service does not stop within a minute, go to the Task Manager and select End Task for the Java process running on the machine.
  4. Step 4 Select the Aternity_windows-x64.exe setup file, which you downloaded as part of the Aternity on-premise server setup package.

    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 (Optional, recommended) Backup your existing server settings, as they may be useful for support and troubleshooting purposes.

    The size of the backup is roughly equal to the size of the deployment, but does not include raw data files and archived reports.

    Backup to a subfolder under updates, like D:\data\Aternity\updates\backup_20160323-182419. We recommend that you use the default folder. Do NOT save the backup in the parent Aternity folder, D:\data\Aternity\.

    Backup the existing settings of the server
  7. Step 7 Select Express (Use Existing Settings).
    Important

    Always check the sizing before updating. This version uses different database sizes, dashboard requirements and new servers. Learn more.

    • If you keep the same topology or security, choose the express update, which keeps your legacy settings in the updated servers.

    • If you are changing your topology or security, choose the custom update.

    Select the express setup
  8. Step 8 Confirm the summary and complete the setup.
  9. Step 9 Verify the deployment was successful by confirming that the Windows services shows AternityPlatform as running.
  10. Step 10 Review the settings from the existing server, and start the update.

    If it reports that the existing setup is corrupted, cancel the update and contact Customer Services.

  11. Step 11 Configure a secured HTTPS connection.
    If Messaging Broker and/or Raw Data Component are secured with a self-signed certificate, provide a truststore containing the certificate for the root CA that created that certificate. Place this truststore in the same location, relative to Aternity's home directory (the default on Windows hosts is X:\data\aternity), on the Management Server, Data Warehouse Server, and Aggregation Server. For example, D:\Certificates\aternity_truststore.jks. In the Advanced Settings, provide the path to ..\..\Certificates\aternity_truststore.jks.

    Learn more about how to configure a secured HTTPS connection, how to create a truststore, and how to add your enterprise's certificate to the system's Java keystore file (.jks).