documented upgrade procedure