In this video, we will look at setting up a new data transfer from an AVEVA™ PI Server -
to AVEVA™ Data Hub.
Relevant learning resources are included at the end of the video.
As prerequisites for this work, you will need administration access
in AVEVA™ Data Hub.
You will have completed AVEVA™ Data Hub service activation in AVEVA Connect
and you will have set up user access.
We suggest you refer to the process documentation for AVEVA Data Hub on
docs.aveva.com regarding AVEVA Data Hub and creating a new data transfer.
Please also reach out to available technical support, customer success or other resources
for help with this activity.
As an administrator, you may wish to create a new data transfer for AVEVA™ Data Hub
to increase the value it brings to your organisation.
Let's look at the process for creating and configuring a data transfer
in the following sections.
Before you start, here is some information you will need to collate, to support this activity.
Your AVEVA™ Data Hub namespace name. This is shown on the Data Hub home page,
next to the namespace settings 'cog' icon.
Identify the names of the Asset Framework Server (or AF Server) and
the Data Archive server, that stores the data you wish to transfer into your service.
You will also need details of a suitable service account, with read access to the Data Archive.
Your PI Server administrator can provide the account details to you.
We also recommend you read docs.aveva.com data hub documentation,
on server account permissions.
Open 'Data collection'...
Access 'PI to Data Hub'.
Review the agent account permissions information.
Let's start with downloading and running the agent, to begin your set up activity.
Open AVEVA™ Data Hub from AVEVA Connect.
Open 'Data Collection' as shown, and select 'PI to Data Hub Agents'.
Select the 'Download Agent' button.
Note the link to the process guide, for step by step help.
Download and open the 'exe' file and run the installer program.
Select 'Next' to continue. You will be asked to authenticate in the data hub service.
Log in to Data Hub (if required) and then return to the agent when authentication is confirmed.
Select 'Next' to proceed.
Select your Namespace from the drop-down list.
If required, add an optional description for this Agent.
Enter your PI Server service account name and password, if not selected, using 'This account'.
Select 'Install' to run the agent.
Read the prompt, then select 'OK' to proceed.
Select 'Close' to finish this step.
The next step - the configuration utility, will open automatically, to continue the process.
Next, lets review the steps for using the PI to Data Hub Agent Configuration Utility.
This services account, added earlier by the Agent, will be used.
Configurations, to create the data transfer, still need to be selected.
Select an Asset Framework (or AF) Server or a PI Data Archive Server, by selecting an icon.
Selecting the AF Server first, makes it easier to locate the required Data Archive Server.
Type your AF Server name, as shown.
Select 'Add Server'.
The AF Server was successfully added.
Select the Data Archive Server and then select 'Add Selected Data Archive'.
The Data Archive Server is also selected.
If you wish to set an alternative display name for use in the cloud, for security reasons,
this function allows you to create it.
If this is required - add the alternative name now, before you start your transfer.
Use the 'Test Connection' function to ensure the server connection is available.
Select 'Save' to save your changes.
Check the agent status is 'Good' and other details are correct,
in Data Collection, PI to Data Hub Agents area.
Check Agent status shows as registered.
You are now ready to create your transfer.
Next, we will carry out the transfer of data from your PI Server into AVEVA™ Data Hub.
Select the Agent and select 'Create Transfer' to start defining the details of your data transfer.
Type a name for your transfer.
Select a start date for the data you require.
You may want to include historic data, if available.
These fields are already set by the configuration utility.
The metadata to be transferred can be selected using the tabs, as shown.
Select this option to delete unwanted data from the cloud, when changes
to your transfer are made.
Select 'OK' to proceed.
Select your AF Database assets, for the transfer, as required.
Using an AF Server during configuration ensures all PI Points associated with
selected AF Elements are automatically added to your transfer.
This removes the need for manual searches to find individual PI Points.
Use search to refine your selection.
Select the required elements.
Select 'Add AF Elements To Transfer' to confirm your selection.
Select individual elements and explore the related AF element information, if needed.
You can also use PI Point Search for individual PI data points and add these to your transfer.
Select from your search results and add to your transfer.
Select 'Add PI Points to Transfer' to confirm.
Select 'Save' to complete your data transfer selection.
Select the Agent and now select 'Start Transfer' to begin the data transfer.
Select 'Start' to begin.
View the 'Transfer Metrics' tab to see progress of the data.
Historical data archive upload progress can also be checked.
If an error is detected, a warning will be highlighted.
Open the 'Manage Agent' tab to find more detail...
in the Transfer Overview area.
Event message details provide help on further actions, if required.
Finally, let's view and visualise the new data.
Select 'Visualization' and 'Asset Explorer' to view your data.
Select the Namespace that your PI to Data Hub agent is using.
Select an asset that you want to explore.
Make use of filters, if required.
If you selected an alias name for your AF Server, this is now displayed.
If you specified an alias for your Data Archive, this will be used in the Stream ID and
be visible in the Sequential Data Store.
Real-time data can be viewed in the Properties tab, once it is transferred.
For additional resources to help with AVEVA™ Data Hub and creating data transfers, visit
'docs.aveva.com/category/adh-get-started' to view the available guidance.
This concludes the video for creating a PI Server data transfer for AVEVA™ Data Hub.