Volttron

In addition to the changes made in the [4.0-beta](https://github.com/VOLTTRON/volttron/releases/tag/4.0-beta) release, the following modifications have been made.
- Applications are broken out into their own repository: https://github.com/VOLTTRON/volttron-applications
- Some commands have been broken out into their own subcommands (for instance, volttron-ctl serverkey is now under volttron-ctl auth serverkey)
- Configuration Store for dynamically updating agent configurations
- VOLTTRON configuration wizard allows for more agent setups.
- Added volttron-ctl update command to update agents. Using this command does not lose the public/private keypair when installing agents.

API Changes
- Keystore public() method has been changed to a property.

Known Issues (VC and VCP issues are slated to be better handled in the coming weeks)
- 962 Issue connecting to some peers on platforms.
- 961 Management UI hangs when opening a platform with a fakedriver
- 956 MODBUS driver issue with non sequential registers
- Pre-authorizing needs to take place in order for communication from VCP and VC can be easily done.
- Unregistering platforms does not work through VC.
- Device management UI still in progress and will be part of the next point released.


4.0-patch
Continued testing and deployment since the 4.0 release has identified issues which require a patch. There should be no comparability issues with this and the 4.0 release. The only required action is to restart the VOLTTRON instance and agents after pulling the new changes into your local copy. If you are operating from source, please replace the 4.0 source with this.

Note this release is off master not develop.

The specific issues identified can be reviewed here: https://github.com/VOLTTRON/volttron/milestone/18

To see a diff of actual changes you may compare using the following:
https://github.com/VOLTTRON/volttron/compare/62c766650caf554621b6c94422ddf47f4485a799...master

Today the VOLTTRON team is proud to announce the release of VOLTTRON 4.0 beta. This is a culmination of the last half of year since the 3.5RC1 release. We have added made working with VOLTTRON a much easier experience as well as added new features. Backwards compatibility is maintained where possible but some features do require changes. These changes are not as drastic as the 2.0 to 3.0 upgrade and we will have documentation on upgrade paths by the time of the full release.
- All documentation will now be maintained on http://volttron.readthedocs.io and the old github wiki will be deprecated. The goal is to have a single source of documentation that track multiple branches of source code.
- One of the biggest changes is the introduction of the Configuration Store. Eventually agents will be able to be configured in a running state. This potentially will allow you to not have to package a configuration file with your agent. This greatly enhances the flexibility and configurability of the drivers, however, this change is not backwards compatible with your current master driver. There is a script (https://github.com/VOLTTRON/volttron/blob/develop/scripts/update_master_driver_config.py) that will do the update for you entirely. You can read about the specification for the configuration store http://volttron.readthedocs.io/en/develop/core_services/config_store/Commandline-Interface.html and read how to use the config store from the platform http://volttron.readthedocs.io/en/develop/specifications/configuration-store.html.
- Cloning the main VOLTTRON repository will not get you the applications. Those have been moved to their own repository at https://github.com/VOLTTRON/volttron-applications
- The auth command has been moved to be a subcommand. So volttron-ctl auth-add has become volttron-ctl auth add. This auth is now documented http://volttron.readthedocs.io/en/develop/core_services/control/PlatformCommands.html.
- The volttron-ctl serverkey command has been moved under the auth subcommand. So to get the serverkey of the current platform you can execute volttron-ctl auth serverkey.
- VIP IDENTITY has matured and is now guaranteed to be unique on a platform both at installation and run-time. The generated identities are now based upon the agent name. This allows a constant convention for determining agent ids. The spec for VIP IDENTITIES is at http://volttron.readthedocs.io/en/develop/specifications/agent-vip-id.html. Note the volttron-ctl status command has been improved to show the agent identity.
- We have enhanced the volttron-cfg command to be more flexible and allow extensions to the platform to be built rapidly. You can setup and configure an instance by answering a few questions instead of having to edit configuration files. Note you will still need to modify the config files for advanced setups.
- VOLTTRON configuration wizard (volttron-cfg) allows setting up a simple platform for demonstration and simplifies muilti-platform deployments
- Improved robustness of VOLTTRON Central Management UI
- More reliable mechanism for transferring agents for remote install
- AggregatorAgent which aggregates specified data points and stores in a new table

This release candidate is the culmination of development efforts since the release of 3.0. It is being released as a candidate to give the community a chance to explore the new capabilities and changes to existing features before it becomes the new main (master) branch. Additionally, RC1 will be utilized in PNNL's campus deployment to verify stability.
- VOLTTRON Central Management
- Simplified platform registration through using a keystore
- Resource tree view for status of VOLTTRON deployment
- Data points can be charted through selection in tree
- Alerts system allows agents to throw alerts when they encounter errors
- Drivers
- Improved robustness of BACnet configuration generator
- BACnet priority for points is now configurable
- Devices can be returned to a "default state" defined by the driver
- Historians
- MongoDB Historian added
- Metadata being stored
- Performance enhancements based on scalability results
- ForwardHistorian refactored to be more general and reliable
- Simulation interaction
- MATLab interface allows models to interact with VOLTTRON message bus
- Security
- Agents can restrict access to their capabilities based on authorized actors
- Test Suite
- New VOLTTRON test suite for testing the platform code
- Tests can be used to check contributed services for compatibility
- Example Agents
- Fake driver to provide a minimal driver implementation example and mock data for exploring the platform
- Updated example for using the Actuator highlighting the new RPC interface for simplifying interaction
- ExampleSubscriber agent which provides an all-in-one example of publish and subscribing by providing its own fake device data

- VOLTTRON Central Management
- Simplified platform registration through using a keystore
- Resource tree view for status of VOLTTRON deployment
- Alerts system allows agents to throw alerts when they encounter errors
- Drivers
- Improved robustness of BACnet configuration generator
- BACnet priority for points is now configurable
- Devices can be returned to a "default state" defined by the driver
- Historians
- MongoDB Historian added
- Metadata being stored
- Performance enhancements based on scalability results
- ForwardHistorian refactored to be more general and reliable
- Security
- Agents can restrict access to their capabilities based on authorized actors
- Test Suite
- New VOLTTRON test suite for testing the platform code
- Tests can be used to check contributed services for compatibility
- Example Agents
- Fake driver to provide a minimal driver implementation example and mock data for exploring the platform
- Updated example for using the Actuator highlighting the new RPC interface for simplifying interaction
- ExampleSubscriber agent which provides an all-in-one example of publish and subscribing by providing its own fake device data

This release addresses bug 223 in the Actuator where agents could issue control actions despite not having a reservation. This has been fixed and now agent must have scheduled a reservation prior to issuing commands.

This release also addresses issue 234 caused where changing the case of topic names in drivers causes a conflict in the historian. For instance, if the driver config for "mytopic" becomes "MyTopic" and the historian would error when encountering this "duplicate filename".

The fix for issue 226 ensures that the required library pytz is installed even when numpy is not.