Configuration bundle issues

This topic describes problems that can arise when pushing a configuration bundle from the manager to the peer nodes.

Bundle validation failure when pushing a very large bundle

If you attempt to push a very large configuration bundle (>200MB), bundle validation might fail due to various timeouts. To remediate, you can adjust the number of peers that the manager simultaneously pushes the bundle to.

By default, the manager pushes the bundle to a maximum of 5 peers simultaneously. The max_peers_to_download_bundle setting in server.conf provides a means to further limit the number of peers that receive the bundle simultaneously.

For example if you set max_peers_to_download_bundle = 3, the manager pushes the bundle to three peers at a time. When one peer finishes the download, the manager pushes the bundle to another peer, and so on, until all peers have received the bundle.

For details, see the server.conf specification.

Bundle validation remains in progress and does not complete

If the bundle validation process remains in progress on the manager, and no validation response appears, you must cancel and reset the the bundle push operation to escape the in-progress state.

To cancel and reset the bundle push operation, hit the following endpoint on the manager: cluster/manager/control/default/cancel_bundle_push.