DOC-1161: updates to upgrade.