Migration from 4.1 to 5.0¶
5.0 includes numerous changes (Tagging Service, Message Bus performance increase, Multi-platform pub/sub, etc.), but the majority of these should be invisible to most users.
Key issues to note are:
Operations Agents¶
Several agents have been moved from “services/core” to “services/ops” to highlight their use in monitoring a deployment. They are not necessary when developing against a single instance, but are essential for VOLTTRON(tm) in a deployed environment.
Agents affected:
- services/ops/AgentWatcher
- services/ops/AlertAgent,0.4
- services/ops/AlertMonitor
- services/ops/Alerter
- services/ops/EmailerAgent
- services/ops/FailoverAgent
- services/ops/FileWatchPublisher
- services/ops/LogStatisticsAgent
- services/ops/MessageDebuggerAgent
- services/ops/SysMonAgent
- services/ops/ThresholdDetectionAgent
Rebuild Agents¶
Rebuilding agents is :underline:`required` when upgrading to a new VOLTTRON(tm) version to ensure that agents are operating with the latest code. Errors will occur if agents built in a previous version attempt to run with the latest version of the platform.
ForwardHistorian¶
The ForwardHistorian configuration has been changed. Please see: https://github.com/VOLTTRON/volttron/blob/develop/services/core/ForwardHistorian/README.rst for the new options.
Note
NOTE If you have no entry for service_topic_list in your configuration, the new default will cause
ALL data to be forwarded. Please update your configuration if you are forwarding a subset of data.
VOLTTRON Central Management UI¶
The url for VOLTTRON Central Management is now http://IP:port/vc/index.html
Agent Versions¶
To get the versions of agents in the VOLTTRON project, run “python scripts/get_versions.py”.
| Agent Name | 4.1 | 5.0 |
|---|---|---|
| CAgent | 1.0 | 1.0 |
| CSVHistorian | N/A | 1.0.1 |
| ConfigActuation | 0.1 | 0.1 |
| DataPublisher | 3.0.1 | 3.0.1 |
| DataPuller | N/A | 3.5 |
| ExampleDrivenControlAgent | 0.1 | 0.1 |
| ExampleSubscriber | 3.0 | 3.0 |
| ListenerAgent | 3.2 | 3.2 |
| ProcessAgent | 0.1 | 0.1 |
| SchedulerExample | 0.1 | 0.1 |
| SimpleForwarder | 3.0 | 3.0 |
| SimpleWebAgent | 0.1 | 0.1 |
| WeatherForecastCSV_UW | ||
| WebRPC | ||
| WebSocketAgent | 0.0.1 | 0.0.1 |
| PrometheusScrapeAgent | N/A | 0.0.1 |
| WeatherAgent | ||
| ActuatorAgent | 1.0 | 1.0 |
| BACnetProxy | 0.2 | 0.3 |
| CrateHistorian | 1.0.1 | 1.0.2 |
| DataMover | 0.1 | 0.1 |
| ExternalData | 1.0 | 1.0 |
| ForwardHistorian | 3.7 | 4.0 |
| MQTTHistorian | 0.1 | 0.2 |
| MasterDriverAgent | 3.1.1 | 3.1.1 |
| MongodbAggregateHistorian | 1.0 | 1.0 |
| MongodbHistorian | 2.1 | 2.1 |
| MongodbTaggingService | N/A | 1.0 |
| OpenEISHistorian | 3.1 | 3.1 |
| SEP2Agent | N/A | 1.0 |
| SEP2DriverTestAgent | N/A | 1.0 |
| SQLAggregateHistorian | 1.0 | 1.0 |
| SQLHistorian | 3.6.1 | 3.6.1 |
| SQLiteTaggingService | N/A | 1.0 |
| VolttronCentral | 4.0.3 | 4.2 |
| VolttronCentralPlatform | 4.0 | 4.5.2 |
| WeatherAgent | 3.0 | 3.0 |
| AgentWatcher | 0.1 | 0.1 |
| AlertAgent | 0.4 | 0.4 |
| AlertMonitor | 0.1 | 0.1 |
| Alerter | 0.1 | 0.1 |
| EmailerAgent | 1.3 | 1.3.1 |
| FailoverAgent | 0.2 | 0.2 |
| FileWatchPublisher | 3.6 | 3.6 |
| LogStatisticsAgent | 1.0 | 1.0 |
| MessageDebuggerAgent | N/A | 1.0 |
| SysMonAgent | 3.6 | 3.6 |
| ThresholdDetectionAgent | 3.7 | 3.7 |