Bug 877467
| Summary: | elasticsearch upgrade step needed, either in docs or in katello-upgrade | |||
|---|---|---|---|---|
| Product: | [Retired] Subscription Asset Manager | Reporter: | Tom McKay <tomckay> | |
| Component: | Docs Release Notes | Assignee: | Eliska Slobodova <eslobodo> | |
| Status: | CLOSED CURRENTRELEASE | QA Contact: | Og Maciel <omaciel> | |
| Severity: | high | Docs Contact: | ||
| Priority: | unspecified | |||
| Version: | 1.2 | CC: | bkearney, dmacpher, jomara, mbacovsk, omaciel, sclewis | |
| Target Milestone: | rc | |||
| Target Release: | --- | |||
| Hardware: | Unspecified | |||
| OS: | Unspecified | |||
| Whiteboard: | ||||
| Fixed In Version: | Doc Type: | Bug Fix | ||
| Doc Text: |
Add this to the upgrade steps:
During the Katello upgrade we need to upgrade Elasticsearch from 0.18 to 0.19. It is necessary to flush indexes before the yum upgrade. When the 0.19 is started for the first time it tries to convert all the DB in new format so the old indexes wouldn't match. Note: During the DB conversion the backup is created so it is possible to revert the DB back to 0.18 format. The recommended steps are as follows:
After stopping the katello instance according the generic instructions and before yum upgrade start Elasticsearch
service elasticsearch start
Flush indexes
curl host:9200/_flush
Stop Elasticsearch
service elasticsearch stop
For some more info about ES upgrade see ES release notes [http://www.elasticsearch.org/download/2012/10/23/0.19.11.html]
|
Story Points: | --- | |
| Clone Of: | ||||
| : | 878075 (view as bug list) | Environment: | ||
| Last Closed: | 2013-02-25 16:17:21 UTC | Type: | Bug | |
| Regression: | --- | Mount Type: | --- | |
| Documentation: | --- | CRM: | ||
| Verified Versions: | Category: | --- | ||
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | ||
| Cloudforms Team: | --- | Target Upstream Version: | ||
| Embargoed: | ||||
| Bug Depends On: | ||||
| Bug Blocks: | 816564, 878075 | |||
|
Description
Tom McKay
2012-11-16 15:41:45 UTC
The description of what needs to by done manually during upgrade is in the first paragraph https://fedorahosted.org/katello/wiki/Upgrade#katelloupgradefrom1.1to1.2 I'm not sure what to do with the content to get it to the docs. Changing the component to doc-Release_Notes Adding PM Ack for doc chnage only. I updated the Release Notes book with the complete description (the individual steps are also mentioned in the Installation Guide which is linked to from the Release Notes). Please review the chapter in the updated book and let me know what you think: http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Subscription_Asset_Manager/1.2/html-single/Release_Notes/index.html#installation-and-upgrading Thanks! Hi Eliska, I checked the changes and there's one minor change we should make. Turns out I was performing this task (upgrade) yesterday and when flushing the elasticsearch index, instead of using curl host:9200/_flush you should use curl localhost:9200/_flush (localhost instead of host). Thanks in advance. Alright, fixed. The updated book should appear shortly. Thank you. Have also modified Install Guide with host -> localhost: http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Subscription_Asset_Manager/1.2/html/Installation_Guide/sect-Installation_Guide-Administration-Upgrading_Subscription_Asset_Manager.html Removed blocker flag as changes made in Install Guide and Release Notes Hey Dan, this looks good to me, so I'm going to flag it as VERIFIED. I wasn't sure if you wanted to handle it or not, so I hope this is ok. :) Closing; SAM 1.2 Release Notes are out now: https://access.redhat.com/knowledge/docs/en-US/Red_Hat_Subscription_Asset_Manager/1.2/html-single/Release_Notes/index.html |