Delete an adapter component
- Last UpdatedFeb 04, 2025
- 2 minute read
- PI System
- Adapter for DNP3 1.2
- Adapters
When you remove an adapter component, the configuration and log files are saved into a sub-directory in case they are needed later. Any associated types, streams, and data remain on the respective endpoints.
Note: OmfEgress component is required and cannot be deleted.
To delete an adapter component:
1. Start any of the Configuration tools capable of making HTTP requests.
2. Run a DELETE command to the following endpoint:
http://localhost:5590/api/v1/configuration/system/components/<componentId>
Note: You must make an empty DELETE command against the Id of the component you want to delete. 5590 is the default port number. If you selected a different port number, replace it with that value.
Example using Postman:
DELETE "http://localhost:5590/api/v1/configuration/system/components/<componentId>"
File relocation
All configuration and log files are renamed and moved. The files are renamed according to the timestamp of removal, for example, FileName.json_removed_yyyy-MM-dd--hh-mm-ss.
Configuration files are moved to the following location:
-
Windows: %programdata%\OSIsoft\Adapters\AdapterName\Configuration\Removed
-
Linux: /usr/share/OSIsoft/Adapters/AdapterName/Configuration/Removed
Log files are moved to the following location:
-
Windows: %programdata%\OSIsoft\Adapters\AdapterName\Logs\Removed
-
Linux: /usr/share/OSIsoft/Adapters/AdapterName/Logs/Removed
In the following example, one adapter service is installed on a particular Windows node with the name <Adapter>Service1. An adapter component with the name <Adapter>DeviceX was added and configured to this adapter and later removed. Linux follows a similar behavior. This is the resulting relocation and renaming scheme after deletion:




REST URLs
|
Relative URL |
HTTP verb |
Action |
|---|---|---|
|
api/v1/configuration/system/components/<componentId> |
DELETE |
Deletes specified component |
Note: Replace componentId with the Id of the component that you want to delete.