Jak přejít ze starších verzí JIRA na JIRA 6

25.05.2015 |  máme pro vás doporučení pro bezproblémový upgrade

 

Pokud využíváte některou ze starších verzí JIRA a zaujali vás poslední novinky v ní uvedené společností Atlassian, nebo byste jen rádi měli aktuální verzi, je potřeba procesu migrace věnovat zvláštní péči, aby vše proběhlo bez jakýchkoliv problémů. Obtížnost, potenciální problémovost a proces migrace záleží na stáří vaší JIRA instance.

 

Obecné doporučení

Pokud provádíte jakýkoliv upgrade na produkčním prostředí, tak doporučujeme vytvoření nové souběžně běžící instance s vlastní databází, jen pozor, pokud se obě relace nalézají na jedné doméně a jsou rozlišeny jen porty, tak je potřeba každou využít v jiném prohlížeči (nebo využít jednu v anonymním režimu prohlížeče) a to díky kvůli konfliktům mezi cookies relací.

Před započetím následujících operací vypněte JIRA instanci, vyprázdněte aplikační log a nechte JIRA několik hodin fungovat běžným způsobem (nebo kratší dobu při silnějším vytížení) pro naplnění logu přetrvávajícími problémy, které budou součástí jednoho z kroků.

 

 

Migrace z JIRA 4.x na JIRA 6.x

Pokud máte tuto relativně novější verzi JIRA, tak máte přechod z ní značně usnadněn díky potřebě jen nové instance. Předpokládejme tedy, že již máte připravenu novou instanci JIRA.

 

  1. 1. Kontrola kompatibility pluginů - /plugins/servlet/upm/check?source=manage
  • Mnohdy se může stát, že některý z pluginů se přestal vyvíjet nebo jeho vývoj již nepokračuje takovým tempem a bylo by nemilé po migraci zjistit, že pro vás důležité rozšíření funkcionality JIRA tu není. Proto je potřeba se na této adrese přesvědčit, zda budou všechny (alespoň ty kritické) pluginy fungovat.
  • Vybereme tedy verzi, na kterou budeme přecházet a klikneme na Check. Po zkontrolování vidíme, které pluginy jsou kompatibilní, nekompatibilní nebo kompatibilní, pokud je aktualizujeme.

 

 

  1. 2. Kontrola integrity - /secure/admin/IntegrityChecker.jspa
  • V dalším kroku je zálohováním vhodné zkontrolovat integritu dat v JIRA pomocí Integrity checkeru.
  • Zaškrtneme tedy Select All, klineme na Check a pokud něco není v pořádku, tak chyby necháme opravit.

 

 

  1. 3. Atlassian Support Tools (Log scanner) - /plugins/servlet/stp/view/
  • Procedur před započetím upgradu je více, protože si musíme být jisti „zdravím“ aktuální instance.
  • Tímto krokem necháme plugin projet celý aplikační log a získáme (po jeho vyprázdnění na začátku) všechny aktuální chyby, které odkazuj na Atlassian dokumentaci nebo issue s řešeními. Dle popisů v dokumentaci zjistíte závažnost jednotlivých chyb a budete se snažit většinu před dalším postupem odstranit.

 

 

  1. 4. Zálohování
  • V JIRA probíhá zálohování ve dvou krocích, kdy prvním z nich je vytvoření XML zálohy veškerého obsahu kromě souborů (přílohy issue – obrázky, videa, soubory,…) a druhým je zkopírování obsahu adresáře s přílohami do datového adresáře nové instance.

 

  1. 1.  XML záloha - /secure/admin/XmlBackup!default.jspa
  • Zde jen zadáte název souboru zálohy a pojeho vytvoření rovnou vidíte jeho umístění.

 

 

  1. 2. Příprava a zkopírování attachments adresáře s daty z nynější JIRA (např. /opt/jira-data/data/attachments) do nového data adresáře.

 

  1. 5. Obnova dat na nové instanci
  • XML záloha - /secure/admin/XmlRestore!default.jspa
  1. 1. Zálohu z minulého kroku zkopírujeme z jejího umístění do import adresáře nové instance (např. /opt/jira-data-new/import)
  2. 2. Následně zadáme do pole název souboru a v případě potřeby i další volby a klikneme na Restore
  • Ujistěte se, že znáte přihlašování údaje pro administrátorský účet v zálohovaných datech!
  • V závislosti na velikosti původní instance může obnova trvat i delší dobu.
  1. 6. Ověření integrity dat a kontrola logu
  • zopakujeme si bod 2) apo pár hodinách testovacího provozu projdeme Log scanner (bod 3)

 

Migrace z JIRA 3.x nebo starší na JIRA 6.x

V případě využívání takovéto staří verze budeme potřebovat pro snadný postup ještě jednu instanci, tedy budou celkem tři. Stávající, verze 4.4.5 a požadovaná nejnovější verze.

Pokud máte připraveny tyto dvě instance navíc, tak postup bude takřka totožný jen z části duplicitní, proto si prosím pročtěte jednotlivé kroky výše, jelikož se budou opakovat a budu dodávat jen místy další komentáře.

 

  1. 1. Kontrola kompatibility pluginů (krok 1 předchozího postupu) - /plugins/servlet/upm/check?source=manage
  • Obzvláště důležité pro takové skoky mezi verzemi, jelikož je zde velká pravděpodobnost ukončení vývoje nějakého pluginu či jeho odkoupení někým jiným
  1. 2.  Kontrola integrity (krok 2 předchozího postupu) - /secure/admin/IntegrityChecker.jspa
  2. 3.  Atlassian Support Tools (krok 3 předchozího postupu) - /plugins/servlet/stp/view/
  3. 4.  Zálohování (krok 4 předchozího postupu)
  4. 5.  Obnova dat do instance JIRA 4.4.5 (krok 5 předchozího postupu)
  5. 6.  Kontrola integrity JIRA 4.4.5 (krok 2 předchozího postupu) - /secure/admin/IntegrityChecker.jspa
  6. 7.  Atlassian Support Tools JIRA 4.4.5 (krok 3 předchozího postupu) - /plugins/servlet/stp/view/
  7. 8.  Zálohování v JIRA 4.4.5 (krok 4 předchozího postupu)
  8. 9.  Obnova dat do instance JIRA 6.x (krok 5 předchozího postupu)
  9. 10. Kontrola integrity JIRA 6.x (krok 2 předchozího postupu) - /secure/admin/IntegrityChecker.jspa
  10. 11. Atlassian Support Tools JIRA 6.x (krok 3 předchozího postupu) - /plugins/servlet/stp/view/

 

Pomocí těchto postupů lze většinou dosáhnout bezproblémové migrace, pokud ale využíváte nějaké specifické úpravy konfigurace nebo starší pluginy, které zanášejí data přímo do JIRA, tak můžete v průběhu postupu narazit na nějaký problém.

Pro lokální podporu neváhejte kontaktovat odborníky na produkty Atlassian ve společnosti Onlio. Pro další informace o novinkách Atlassian a JIRA sledujte web www.myJIRA.cz. Kontakty: tel. ČR +420222744766 / tel. SR +421233889033 / atlassian@onlio.com.

 

Za team Atlassian v Onlio,

Petr Vaníček

Atlassian Server Admin

 

Zpět