Configure system components
- Last UpdatedFeb 20, 2025
- 2 minute read
- PI System
- Adapter for DNP3 1.2
- Adapters
This section includes steps to configure your system components as well as a list and description of the available system component parameters.
To configure your system components:
-
To initialize the configuration, use the PUT method in conjunction with the http://localhost:5590/api/v1/configuration/system/components REST endpoint.
-
Create an empty text file using a text editor.
-
Copy and paste a sample configuration for system components into the file. For example:
[
{
"ComponentId": "OmfEgress",
"ComponentType": "OmfEgress"
}
]
If you are configuring an adapter with two adapter instances, you can use the following example:
[
{
"ComponentId": "DNP3-1",
"ComponentType": "DNP3"
},
{
"ComponentId": "DNP3-2",
"ComponentType": "DNP3"
},
{
"ComponentId": "OmfEgress",
"ComponentType": "OmfEgress"
}
]
-
Using the available parameters, update the example JSON parameters for your environment.
Available parameters include ComponentId and ComponentType
Note: The OmfEgress component is required to run the adapter. Both its ComponentId and ComponentType are reserved and should not be modified.
-
Save the file. For example, ConfigureComponents.json.
-
Open a command line session. Change directory to the location of ConfigureComponents.json.
-
Enter the following cURL command (which uses the PUT method) to initialize the system components configuration.
curl -d "@ConfigureComponents.json" -H "Content-Type: application/json" -X PUT "http://localhost:5590/api/v1/configuration/system/components"
Note: If you installed the adapter to listen on a non-default port, update 5590 to the port number in use.
REST URLs
|
Relative URL |
HTTP verb |
Action |
|---|---|---|
|
api/v1/configuration/system/components |
GET |
Retrieves the system components configuration |
|
api/v1/configuration/system/components |
POST |
Adds a new component to the system configuration |
|
api/v1/configuration/system/components |
PUT |
Updates the system components configuration |
|
api/v1/configuration/system/components/<componentId> |
DELETE |
Deletes a specific component from the system components configuration Note: All the logs and configurations files for the deleted components are moved to the corresponding logs/Removed or Configuration/Removed folder. |
|
api/v1/configuration/system/components/<componentId> |
PUT |
Creates a new component with the specified componentId in the system configuration |