Custom Update the Management Server for Aternity 10

During your update of each Aternity server, you can choose between the express update, or a custom update.

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

This article describes the custom upgrade of the Management Server.

Important:

Always check the sizing before updating. Version 10 uses different database sizes, dashboard requirements and new servers.

For example, if the updated requirements for your sizing state you must have a new standalone Aggregation Server, you must use the custom update to remove the legacy embedded Aggregation Server from within the Management Server, then run the setup again on a standalone server to a fresh setup of a new Aggregation Server there.

Use the updated sizing to determine whether a component is embedded or standalone
Tip:

If your sizing requires you to update or create a standalone server, run the setup on each standalone computer.

Remove an embedded component during upgrade, then set up on a standalone server

Before you begin

Before updating the Management Server:

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

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

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

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

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

  • Aternity 10 requires you set up one or more new Vertica Database Servers, depending on the size of your deployment.

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

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

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

    Attribute Requirement

    Hardware

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

    In addition, check the ports which you must open on this server (learn more).

    Network

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

    Operating system for Management Server and Data Warehouse Server

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

    Both servers set up and use Apache Tomcat 8.5.14.

    Time zone

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

    Permissions

    Ensure you have local administrator privileges on this computer.

Procedure

  1. Step 1 Access the Aternity Management 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.

    Wait until the service has the status Stopped (not Stopping).

  4. Step 4 Locate 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 Custom (Change Existing Settings).
    Important:

    Always check the sizing before updating. Version 10 uses different database sizes, dashboard requirements and new servers.

    • 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 type of setup
  8. Step 8 Review the existing pathname and select Next.

    The setup displays the settings of the existing deployment on this computer.

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

  9. Step 9 Select the servers you want to update on this computer, based on the sizing of your deployment.

    The setup displays the settings of the existing deployment on this computer. Selecting a server adds its component to this computer. Deselecting it disables it from this computer.

    Important:

    Only deselect a server if you are planning to disable it from this computer, due to a change in topology.

    Select the servers to add to the computer during the upgrade
    • (Up to 100 devices) The Management Server computer has ALL the following: Oracle Database Server, Data Warehouse Server, and Aggregation Server, all on the same computer.

    • (Less than 5,000 devices) The Oracle Database Server is standalone. The Management Server computer has ALL the following: the Data Warehouse Server, and Aggregation Server.

    • (Less than 20,000 devices) The standalone servers are: Oracle Database Server and Aggregation Server. The Management Server computer has the Data Warehouse Server.

    • (Above 20,000 devices) The standalone servers are: Oracle Database Server, Management Server, Data Warehouse Server and Aggregation Server.

    Add more components on the same Management Server computer

    For example, if the updated requirements for your sizing state you must have a new standalone Aggregation Server, you must use the custom update to remove the legacy embedded Aggregation Server from within the Management Server, then run the setup again on a standalone server to a fresh setup of a new Aggregation Server there.

    Remove an embedded component during upgrade, then run add it on a standalone server
    Tip:

    If your sizing requires you to update or create a standalone server, run the setup on each standalone computer.

  10. Step 10 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).

    Aternity requires a live email address for every production deployment of Aternity on-premise, to properly honor our commitments of royalty payments to vendors of third party software.

    Go to https://activation.aternity.com.

    When completed, Aternity sends the activation key to your email.

    Retrieve an activation key to continue the setup
    Field Description
    Company Name

    Enter the name of your enterprise which purchased Aternity.

    Contact Email / Confirm Email

    Enter your work email address which you can access. Aternity sends the activation key to this address.

    Important:

    You must check the inbox of this account for the activation key. You cannot continue setup without this key.

    Serial Number for your Aternity Purchase

    Enter the exact serial number of the latest Aternity purchase.

    Environment Type

    Define the purpose of your system, for identification purposes only. If you are not sure, select Unknown.

    Release

    Select the version Aternity which you want to activate.

  11. Step 11 Enter the activation key which you received via email from the online activation form.
    Tip:

    Copy all characters in the key, including the 'equals' (=) signs at the end.

    Enter the activation key
  12. Step 12 Review the address that this computer presents to other components when they want to connect, and define the URL to access to this computer.

    The setup displays the settings of the existing deployment on this computer.

    Important:

    If you change the Hostname field during an upgrade, it would require changing all components which connect to this server.

    Review the Management Server address
    Field Description
    Hostname

    Enter the listening address to which other components connect to the Management Server. Select the FQDN (recommended), hostname or IP v4 address from the drop-down list, or enter it manually.

    For example, when the Aggregation Server sends data to the Management Server, it must send to this address.

    It displays several entries if this computer has more than one network card (NIC) or several virtual IPs.

    External URL

    Enter the complete URL (including protocol) which users must use in a browser to access Aternity. For example, https://aternity.company.com

    Tip:

    If you made a mistake in this field, use the Configuration Tool to change it later.

  13. Step 13 (Only for small deployments, if the Aternity Aggregation Server is also on this computer) Define the properties of this Aggregation Server.
    Select the device types which may connect to Aternity
    Field Description
    Device Types

    Select whether this Aggregation Server accepts connections from mobile, Mac and Windows monitored devices, or just Windows devices. Typically, you would use the default All devices setting.

  14. Step 14 Select the size of your deployment as the number of devices you expect to monitor.

    This defines the storage and memory settings for the Oracle Database Server and the Data Warehouse Server. A smaller deployment saves storage and memory space, while a larger size improves performance.

    Learn more.

    Select your deployment size
  15. Step 15 Verify the connection details of the Management Server with the Oracle Database Server.

    The setup displays the settings of the existing deployment on this computer.

    Important:

    Only change these values if you have moved the Aternity Oracle Database Server or if you have changed the structure of the database.

    Typically you enter details in the Connection tab, but if you have a custom database connection URL, use the Advanced Properties tab.

    Confirm or edit the Management Server's connection with the Oracle Database Server
    Field Description
    Database Server hostname/IP address

    Enter the FQDN, hostname (recommended) or IP address of the Oracle Database Server.

    Database Service Name

    Enter the Oracle database service name (usually Aternity). This is the alias to the instance of the Aternity database.

    Database Port

    Enter the port required to access the Oracle Database Server (default is 1521).

    Use the Advanced Properties if you have a custom database connection URL. This overrides any settings in the Connection tab.

    Configure your custom database connection URL
    Field Description
    Customize URL

    Select to enter your own custom connection string to the database. Ask your DBA if you have a custom database implementation which requires a custom URL.

    Tip:

    If you have Oracle RAC (Real Application Clusters) deployed, configure the connection string of Aternity's database service to use only a one single instance in the cluster. You can configure the failover option to use another server if required.

    Therefore Aternity does NOT support RAC's load balancing and high availability features. We recommend you contact Customer Services to discuss your overall DR / high availability architecture.

    Custom Database URL

    Enter the custom database connection URL, such as (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVER = DEDICATED)(SERVICE_NAME = ATERNITY)))

  16. Step 16 Configure the connection of the Management Server to the Vertica Database Server, and automatically initialize the database by creating its schema.
    Configure your Vertica database connection URL
    Field Description
    Vertica Server hostname/IP address

    Enter the hostname, IP address, or DNS name of the Vertica Database Server. For a Vertica cluster, enter the hostname, IP address, or DNS name of any one of the cluster servers.

    Vertica Database Name

    Enter the name of the Vertica database, which is set during the Vertica Database Server setup.

    Vertica Port

    Enter port 5433 to access the Vertica Database Server.

    Username and Password

    Enter Vertica's system-level (DBADMIN) username and password, which allows the creation of the Vertica Aternity schema user.

  17. Step 17 Review the credentials to access the schema of the existing database.

    The setup displays the settings of the existing deployment on this computer.

    Important:

    Only change this information if your DBA changed the credentials of the schemas.

    Enter the name and password of the two database schemas
    Field Description
    Platform Database Credentials

    Displays the name of the ATERNITY schema (sometimes, Aternity) and its password.

    This is the name of the business data schema, which stores the performance measurements and device data over the past year or two, along with contextual data, like device details and user details.

    Configuration Database Credentials

    Displays the name of the GR schema (sometimes, GR) and its password.

    This is the name of the system settings schema, which stores Aternity's system settings.

  18. Step 18 Review the tablespaces of the Aternity database.

    Your DBA already set this information in the database itself.

    DBA can confirm the database tablespaces
  19. Step 19 Review the web security when accessing Aternity.

    The setup displays the settings of the existing deployment on this computer.

    Secure the Management Server
    Tip:

    For secure HTTPS (SSL) web access to Aternity, you must secure both the Aternity Management Server and the Aternity Dashboard Server.

    Select to access Aternity via HTTP or HTTPS
    Field Description
    HTTP or HTTPS

    Select HTTPS if you want any connection to this server to be via HTTPS.

    Tip:

    To see the Aternity's system-wide security settings, view the security overview of all components.

    Port

    Enter the Management Server listening port. Aternity users view dashboards, and components communicate with the Management Server, using this port.

    In small, ‘all-in-one’ deployments, this defines the port for Aternity Agents which report data to Aternity. In large deployments, other Aternity components must connect to this server though this port.

    The default for HTTP is 80 and for HTTPS, 443.

    Custom keystore

    Enter the pathname of the system's keystore containing only the certificate that verifies your company's identity. Additional certificates may interfere with single signon processes.

    You must add your enterprise's certificate to the system's Java keystore file (.jks) using Java's keytool utility (see Oracle's keytool documentation).

    Custom keystore password

    Enter the password required to access the system's keystore file.

  20. Step 20 Configure the memory allocation size of your deployment, and confirm the timezone of the Aternity servers on this computer.
    Configure the memory allocation and time zone
    Field Description
    Java Virtual Machine memory

    Configure the JVM heap size according to the values listed for the size of your deployment.

    You can tweak this value later on if required.

    Customize Timezone

    Select a time zone, only if you need to override the timezone settings of the operating system.

    Important:

    The time zones of the Oracle Database Server, Dashboard Server, Management Server, and Data Warehouse Server must all be identical.

    JMS Memory Maximum

    Enter the ActiveMQ JVM heap size according to the value listed for this server for the size of your deployment.

    You can tweak this value later if required.

  21. Step 21 (Optional) Personalize the Aternity sign in screen.
    Optionally add a logo to the Aternity sign in screen
    Field Description
    Use Custom Logo

    Select to enter your own logo.

    Local File

    Enter the pathname to the PNG or JPG logo file stored locally on this computer.

    Remote URL

    Enter the web URL to the PNG or JPG logo file stored on the internet.

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

  23. Step 23 Shut down all processes of the server before continuing the update.

    Select Close processes to end them manually, or wait for them to end normally and select Retry.

    Close processes to continue with update
  24. Step 24 (Optional) If you previously defined custom attributes and mapped them to a system attribute, you can change the mapping if required.
    Tip:

    Typically, you would not change these settings.

    For example if you had an attribute called MyCompanyPlace which you previously mapped to office, you can change the mapping to location by choosing MyCompanyPlace for the Location field.

    Change your legacy custom attribute mappings to Aternity 's attributes
    Field Description
    Frontline / Originating

    Displays whether Aternity obtains this attribute from the frontline client (like the remote desktop), or from the originating virtual server which hosts the virtual session.

  25. Step 25 Make sure you do NOT select to start the AterrnityPlatform service, and select Finish.
  26. Step 26 (Optional) To change the required disk space of the Oracle Database Server, you can change the retention times of some Aternity REST APIs by running an SQL script on the Oracle Database Server.

    See the sizing information for details on the impact of the hard disk requirements for the Oracle Database Server.

    Note:

    Aternity automatically removes legacy data older than one month. To keep that data, you must run the script which extends retentions before starting the Management Server.

    This requires that you be logged in to the Oracle Database Server as the ATERNITY schema user. The scripts are located on the Aternity Management Server in <aternity_home_dir>\versioning\db\aternity\current\utils.

    File name Description

    data_retention_rest_api_short.sql

    (Default) Sets a short data retention time for these REST APIs:

    data_retention_rest_api_long.sql

    Sets a long data retention time for these REST APIs:

    (Updates only) Aternity maintains the same data retention times for the Performance Navigator as you had in your legacy version. However, you can reduce the required disk space on your Oracle Database Server by shortening retention times of the Performance Navigator by running an SQL script from the Aternity Management Server in <setup_dir>\versioning\db\aternity\current\utils.

    File name Description

    data_retention_PN_1_month.sql

    Sets a retention time of up to one month for Performance Navigator data.

    data_retention_PN_3_months.sql

    Sets a retention time of up to three months for Performance Navigator data.

    data_retention_PN_12_months.sql

    Sets a retention time of up to 12 months for Performance Navigator data.