Onboarding ABB Ability™ History on Edgenius OS

Prerequisites:

Before onboarding ABB Ability™ History on Edgenius OS, ensure that the edge environment is properly set up with the following requirements.

Hardware Requirements:

RAM: Minimum 64 GB
CPU: Minimum 8 cores
Storage:
- 300 GB SSD for Edgenius OS and required base software (as recommended by the Edgenius team)
- Additional storage: Minimum 100 GB per pod for ABB Ability™ History
  - Refer to the ABB Ability™ History Sizing Documentation for detailed storage guidelines and to determine the appropriate disk size based on your workload and data retention requirements.

Software & Platform Requirements:

Key cloak must be installed and configured for authentication and identity management.
OpenShift CLI (oc) must be installed and properly configured to interact with the OpenShift cluster.

Ensure that all prerequisites are validated before starting the onboarding process. Proper sizing and configuration are critical for optimal performance, scalability, and reliability of ABB Ability™ History services on Edgenius OS.

Configure Key-Cloak as Identity Server for ABB Ability™ History authentication

To enable secure authentication for ABB Ability™ History, access the Keycloak portal and configure the required client within the Edgenius environment.

Access Keycloak Portal: Ensure the Keycloak DNS entry is added to your system’s hosts file
```
<Keycloak-IP-Address>   idp.<hostname>
```
Open a browser and navigate to the Keycloak URL and log in using the provided administrative credentials.
```
https://idp.HOSTNAME/admin/master/console/
```
Create a New Client in Edgenius Realm:
1. Once logged in switch to the Edgenius Realm.
2. Go to Clients and click on Create Client.
3. Provide the following details:
  1. Client Name: ability-history-client
  2. Client ID: ability-history-client

Hauler Package Requirements:

To deploy ABB Ability™ History on Edgenius OS, the required Hauler packages must be obtained in advance. These packages contain the necessary container images and deployment artifacts needed for installation in a controlled or offline environment.

Obtaining Hauler Packages:

You can acquire the Hauler packages using one of the following methods:

Request from ABB Ability™ History Team:

Reach out directly to the ABB Ability™ History team to obtain the latest, validated Hauler packages for your deployment.
Raise a Service Ticket: Create a request through the official support channel link at ABB Ability™ History L4 Support

Note:

Always use the latest recommended Hauler package versions to ensure compatibility and security.
Verify package integrity and completeness before proceeding with deployment.
Ensure alignment between the Hauler package version and the target Edgenius OS and OpenShift environment.

Access to Edge Management Portal:

To proceed with onboarding and management activities, ensure that you have proper access to the Edge Management Portal (EMP).

Configure Host Entry:

Add the Edge Management Portal DNS name to the hosts file on your Windows machine.
This ensures that the portal is accessible from your local environment.

<EMP-IP-Address>   management.<hostname>

Access the Portal:

Open a web browser and navigate to the following URL, Replace with your actual edge environment hostname.

Login to EMP:

Upon accessing the URL, you will be redirected to the Edge Management Portal login page.
Enter your credentials to log in and access the portal.

Note:

Ensure network connectivity between your Windows machine and the Edge VM.
Verify that the DNS entry or hosts file configuration is correct if the page does not load.
Refer to the screenshots below for a visual reference of the EMP login page.

https://management.<hostname>/