[DOCS-11188] Instructions for upgrading use OM from tar missing critical step Created: 11/Jan/18  Updated: 29/Oct/23  Resolved: 16/Jan/18

Status: Closed
Project: Documentation
Component/s: Ops Manager
Affects Version/s: None
Fix Version/s: None

Type: Task Priority: Major - P3
Reporter: Corbett Waddingham (Inactive) Assignee: Robert Justice (Inactive)
Resolution: Fixed Votes: 1
Labels: triage
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Participants:
Days since reply: 6 years, 4 weeks ago

 Description   

Cisco has run into a problem on their Entitlement Services project after upgrading OM from 3.4 to 3.6. They followed all of the steps on the documentation; however, their gen.key file was somehow overwritten during the process. We are now working with them to try to recover as much of their data in their appDB as possible.

We can avoid situations like this in the future by recommending that customers make a copy of their gen.key prior to commencing their upgrade. There is an infobox on the page that recommends making a backup of the conf-mms.properties file before proceeding. This infobox should be modified to read:

It is crucial that you back up the existing conf-mms.properties and gen.key files because the upgrade process will delete existing data.

Alternatively, a new infobox should be added with a caveat about backing up the gen.key file. In either case, we should point out to customers how critical this file is to preserve and help them make sure they do not lose it during any upgrade processes.



 Comments   
Comment by Githook User [ 17/Jan/18 ]

Author:

{'name': 'Robert Justice', 'email': 'robertjustice@Roberts-MacBook-Air-3.local'}

Message: Added gen.key to upgrade admonition (DOCS-11188)

Added admonition to save gen.key to the install pages, per James Broadhead (DOCS-11188).
Branch: v3.4
https://github.com/10gen/mms-docs/commit/e5dac6e3400f338cdf13601f97f9d202b1d72f54

Comment by Githook User [ 17/Jan/18 ]

Author:

{'name': 'Robert Justice', 'email': 'robertjustice@Roberts-MacBook-Air-3.local'}

Message: Added gen.key to upgrade admonition (DOCS-11188)

Added admonition to save gen.key to the install pages, per James Broadhead (DOCS-11188).
Branch: v3.4
https://github.com/10gen/mms-docs/commit/e5dac6e3400f338cdf13601f97f9d202b1d72f54

Comment by Githook User [ 17/Jan/18 ]

Author:

{'name': 'Robert Justice', 'email': 'robertjustice@Roberts-MacBook-Air-3.local'}

Message: Added gen.key to upgrade admonition (DOCS-11188)

Added admonition to save gen.key to the install pages, per James Broadhead (DOCS-11188).
Branch: v3.6
https://github.com/10gen/mms-docs/commit/cd647ffe1b8432871a893ca18b56fc0436a945d4

Comment by Githook User [ 17/Jan/18 ]

Author:

{'name': 'Robert Justice', 'email': 'robertjustice@Roberts-MacBook-Air-3.local'}

Message: Added gen.key to upgrade admonition (DOCS-11188)

Added admonition to save gen.key to the install pages, per James Broadhead (DOCS-11188).
Branch: v3.6
https://github.com/10gen/mms-docs/commit/cd647ffe1b8432871a893ca18b56fc0436a945d4

Comment by Githook User [ 17/Jan/18 ]

Author:

{'name': 'Robert Justice', 'email': 'robertjustice@Roberts-MacBook-Air-3.local'}

Message: Added gen.key to upgrade admonition (DOCS-11188)

Added admonition to save gen.key to the install pages, per James Broadhead (DOCS-11188).
Branch: master
https://github.com/10gen/mms-docs/commit/48bb0251a09ac4121bcba134ca1a39ebf5ecc9fc

Comment by Githook User [ 17/Jan/18 ]

Author:

{'name': 'Robert Justice', 'email': 'robertjustice@Roberts-MacBook-Air-3.local'}

Message: Added gen.key to upgrade admonition (DOCS-11188)

Added admonition to save gen.key to the install pages, per James Broadhead (DOCS-11188).
Branch: master
https://github.com/10gen/mms-docs/commit/48bb0251a09ac4121bcba134ca1a39ebf5ecc9fc

Generated at Thu Feb 08 08:02:16 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.