Connect SteelCentral Portal to the Aternity Data Source

The SteelCentral Portal™ offers an end-to-end digital experience by enabling you to view data from several products in the SteelCentral Suite side by side in a single dashboard. Add the Aternity Data Source to the Portal to view Aternity's data from the past seven days alongside that of other products.

For example, if your users are complaining of slow performance, you can monitor the application's performance on the end user device (Aternity), the network performance (NetProfiler), and the server performance (AppInternals) all on the same screen, side by side.

View dashboards from different data sources in the Portal

The Portal which you host on your server, which must connect to a data source for each product. To view Aternity data, you must connect it to the Aternity Data Source.

Connect the Portal to the Aternity Data Source

Read more about the Portal in the Portal User Guide > Administrator > Data Source Management > Adding a Data Source.

Tip

You can only view Aternity data for the past seven days.

Before you begin

Aternity supports connection of an Aternity Data Source to SteelCentral Portal™ version 2.0.

Procedure

  1. Step 1 Open a browser and sign in to Aternity.
  2. Step 2 Access the the Gear Icon > Integration Settings > SteelCentral Portal screen and toggle the switch to On to enable Aternity integration with the portal.
    Integration settings for the SteelCentral Portal
    Field Description
    Username/Password

    Displays the username and password which you enter in SteelCentral Portal™ to access your Aternity Data Source.

    Make note of this field, required when you add the Aternity Data Source to the Portal.

    Generate New Password

    Select to create a new password for your Aternity Data Source username, for example, if you think the password may not be secure.

    Important

    When you generate a new password, your SteelCentral Portal™ disconnects from the Aternity Data Source until you provide it with the new password.

    Save Select to apply the integration.
  3. Step 3 Verify you can access the Aternity Data Source from the Portal server, by going to http://<aternity_docker_components_server_hostname>:60070/admin/verify on a machine with a browser in the same subnet as Portal.

    Use the hostname of the Aternity Docker Components Server or the external URL to the Portal as defined in the properties.ini during installation of the Docker Components.

    Enter the dedicated username and password from Aternity's Integration Settings page to access the Aternity Data Source for Portal.

    To perform verify using a local Aternity username and password, that user must have the Portal API role.

    View the response to your verification request
    Response Description

    Verified

    Displays this single word when you successfully accessed the Aternity Data Source.

    Error during authentication: bad credentials

    Displays when the username and password are not recognized as valid Aternity credentials.

    Authorization error: user is not authorized to use this API

    Displays when the Aternity username and password are valid but do not have the privileges to use this verify command.

    Other connection errors

    If the browser could not access the Aternity data source, configure your proxy server and firewall to allow communication from the Portal server to your Aternity Data Source URL over port 60070.

    If the verification continues to fail, contact Customer Services for assistance.

  4. Step 4 Access your SteelCentral Portal™ from a browser.
  5. Step 5 Add the Aternity Data Source by selecting Configure > Data Sources > Add.
    Add a new data source to Portal
  6. Step 6 Specify the data source's details by selecting Select data source type > Aternity.
    Select Aternity as a data source
    Field Description
    Use secure communication

    Select this option if your Portal connects to the Aternity Data Source over secure port.

    Aternity on-premise uses the default port 60070 for communication with the data source. You can change it, if necessary.

    Host Name

    Enter the base URL of the Aternity Data Source without the protocol.

    Use the Host Name of the Aternity Docker Components Server or the external URL to the Portalas defined in the properties.ini during installation of the Aternity Docker Components Server.

    Port

    Enter the default 60070 or the port you configured for secured HTTPS (SSL) communication, or 80 if you did not configure a secured external connection when setting up the server.

    Username/Password

    Enter the dedicated username and password from Aternity's Integration Settings page to access the Aternity Data Source for Portal.

    Check the system connected to the Aternity Data Source successfully.

    Confirm the Portal successfully connected to the Aternity Data Source
  7. Step 7 Continue by using the predefined Aternity dashboards, or create your own custom panels with Aternity data in the Portal.