A document on updating a bundle's metadata in the Metadata Manager storage.

Although a bundle with changed metadata of a certain type and PID is updated, the Metadata Manager will not update the changes in its storage and provide them to management applications unless the metadata version is incremented.

To retain backward compatibility with bundles based on older versions of the Configuration Admin, the Metadata Manager supports updating an XML-defined metatype by declaring a new PID. On bundle update the Metadata Manager checks the metatype PID in the bundle's manifest - if the old PID is not present, the manager deletes related data from its storage and saves a new storage entry associated with the new PID.