Egy régi ügyfelünk (Morphologic Localisation Kft), akinek évekkel ezelőtt fejlesztettünk JIRA addont a JIRA és egy legacy rendszer integrálása céljából, megkeresett minket, hogy segítsünk az általuk használt Confluence rendszer frissítésében. Az első kérdés, amit minden expert ilyenkor feltesz: milyen verziót használnak most.

A válasz meglepő volt: Confluence 2.9. Izgatottak lettünk erre a hírre, mert elképzeltük, mennyi előre nem látható problémát kell majd megoldanunk. Az utolsó alkalom, amikor egy hasonlóan régi Confluence-t láttunk, 2008-ban volt, amikor bevezettük a SonyMusicnál Münchenben.

Az ügyfél maga olyan volt, amit minden tanácsadónak csak kívánni lehet. Elérhetők voltak, megértők, és nagyon könnyű volt velük dolgozni. Nem is találkoztunk személyesen, csak beszéltünk, cseteltünk, de a bizalom az első perctől megvolt mindkét irányban. Ráfordítás alapú munkát javasoltunk, de megértőek voltak a helyzet bizonytalanságát illetően és elfogadták az érveinket. Jó kezdés után a projekt sikerre volt ítélve.

Nagyon is élő dinoszaurusz

Az első dolog, amit érzékeltünk az első bejelentkezés után, hogy az ügyfelünk intenzív használója volt a Confluence-nek éveken át. Komoly tudásbázist és dokumentációt építettek. A másik pedig, hogy a régi kis Confluence 2.9 valószínűtlenül gyors volt. Minden oldal kb 1 ms-en belül megnyílt, mintha csak statikus HTML oldalak lettem volna. Mindez teljesen hihetetlennek tűnt a mai, modern, felhízott rendszerek idején, ideérte a JIRA és Confluence legújabb verzióit.

Érdekes volt látni, hogy a Confluence Download Archive szinte az összes eddigi verziót elérhetővé teszi a 2004(!)-ben kiadott 1.0.3-ig visszamenőleg. Nagyon meglepő volt látni, milyen öreg már a Confluence és hogy mekkora hatalmas változáson ment keresztül az évek során. Az alábbi grafikon a Confluence Standalone ZIP csomag méretének változását mutatja az idő függvényében. Az 1.0.3 19(!) MB-os csomaggal indult, míg a jelenleg utolsó 5.9.4 majdnem 440(!) MB méretű, csaknem 23-szor nagyobb óriás.

Az is megdöbbentő volt, hogyan képzelte a korszerű UI-t az Atlassian 2009-ben, amikor a 2.9 megjelent. Annyira egyszerű, tiszta, de öreges, minden szépségtől mentes felületnek tűnt. Mégis emlékszem, hogy mennyire lenyűgözött 2008 tájékán a Confluence "szépsége".

Emlékszem a régi Rich text/Wiki markup szerkesztőjére, minden hibájával, bosszantó nyűgjével együtt. Szerencsére ez is kihalt és az Atlassian egy összehasonlíthatatlanul szebb, jobb szerkesztőt fejlesztett, amelyet örömmel használok most is eme poszt megírásához.

Szerettem volna feltelepíteni a poszt írásához a Confluence 1.0.3-t, találtam is hozzá egy 2005-ös evaluation licencet a MAC-fiókomban, amelyet el is fogadott. Azonban az adatbázis kapcsolat beállítása után hibák tömkelegét dobta, és sikertelenül megállt a telepítés. Így nézett ki az install screen.

Még a Confluence 2.9 is viccesnek tűnt a ma megszokott kinézethez képest:

A frissítés

Már a kezdetektől nyilvánvaló volt, hogy a frissítést nem lehet egyetlen nagy lépésben elvégezni. Ehelyett három lépésben, ahogy a Confluence Frissítési Dokumentáció is javasolja.

Ügyfelünk nem csak frissíteni akarta a Confluence-t, hanem egy teljesen új szerverkörnyezetbe szerette volna áthelyezni, az adatbázist is megváltoztatva mySQL-ről Postgresre. Emiatt nem követtük szó szerint a dokumentációt.

Két adottság könnyítette a frissítés-áthelyezés folyamatát:

• Nem voltak addonok telepítve, az eredeti Confluence-t önmagában használták
• Abban a helyzetben voltak, hogy a Confluence-t a frissítés idején csak olvasásra használták. Emiatt nem volt szükség tesztfrissítésre, rögtön az éles rendszert lehetett mozgatni. Ráadásul az eredeti szerverkörnyezet nem volt érintett a változásokban.

Frissítés 3.5.13-as verzióra

Első lépésként egy XML backupot készítettem az éles 2.9-es Confluence-ben. Majd a 3.5 széria utolsó 3.5.13-as verzióját telepítettem egy üres Postgres adatbázisra. Végül ebbe a rendszerbe importáltam be az XML állományt. A Confluence gond nélkül upgradelte az adatokat.

Frissítés 3.5.13-ról 5.0.3-ra

A fenti lépéseket ismételve:

• XML export 3.5.13-ból
• 5.0.3 telepítése üres adatbázisba
• XML állomány importálása

Mivel ez is gond nélkül lement, minden adott volt egy sikeres projekthez.

Frissítés 5.0.3-ról to 5.9.4

Mivel az 5.9.4 már az utolsó verzió volt, ezért az installer segítségével telepítettük a Linux környezetbe. Ezt követően a bevált lépéssoroztatot ismételtük: XML backup és visszatöltés.

Minden rendben ment ezúttal is, de a mellékletek még hiányoztak.

Mellékletek frissítése

A Confluence a mellékleteit a Home könyvtár attachments alkönyvtárában tárolja. A korai verziók azonban teljesen már könyvtárstruktúrát használtak a mellékletek elhelyezésére, mint a Confluence 3 és az utána következők.

A 2.9-ről 3.5.13 verzióra való frissítés közben a mellékletek tárhelyének konverziója nem történt meg. Szerencsére az Atlassian lehetőséget ad a tárhely átrendezésére utólag is. Ehhez be kell hívnunk a következő oldal: CONFLUENCE_BASE_URL/admin/restructureattachments.jsp

A könyvtárak kialakítása másodpercek alatt lezajlott, ezt követően a mellékletek megjelentek a 3.5.13-ban is. A további frissítéskor egyszerűen átmásoltam a könyvtárakat az új Home könyvtár attachments mappájába.

Érdekes, hogy a fenti segédoldal a Confluence 5.0.3-ban is elérhető volt, de az 5.9.4-ben már nem. Emiatt minél előbb javasolt elvégezni az attachmentek átrendezését.

A mellékletek megjelenésével véget ért a frissítés. Azaz, csak majdnem. A munkaterületek logói és a felhasználók avatarjai hiányoztak.

Némi guglizással nem sikerült kideríteni, hol tárolta ezeket a Confluence 2.9, de az eredeti attachmentek között felfedeztünk egy könyvtárat, amelynek a neve "nonspaced" volt. Kiderült, hogy ebben vannak a space logók. Elegendő ezt átmásolni a végső Home/attachments könyvtárba, és a logók újra láthatókká válnak.

A felhasznák avatarjait azonban nem sikerült visszaállítani. Ha valaki tudja, hol tárolja ezek a Confluence, írja meg nekünk.

Frissítés utáni tennivalók

Néhány tennivaló akad egy ilyen frissítés után.

• A Confluence Mail Archiving system addon kikapcsolt állapotba került a frissítés közben. Emiatt ezt újra kellett engedélyezni és a POP3 email fiókokat újra fel kellett venni a space-ekhez.
• Meg kell növelni a Confluence által használt Heap méretét. A Confluence 2.9 384MB heappel futott vidáman, az 5.9.4-nek adtunk 1,5GB-t
• Confluence base url beállítását nem szabad elfelejteni

Végszó

Van pár tanulság, amelyet levonhatunk:

• Még a nagyon régi Confluence rendszerek is jó eséllyel frissíthetők a legújabb verzióra.
• Az addonok hiánya jelentősen leegyszerűsíti a folyamatot
• Space logók és avatarok kezelésére külön oda kell figyelni.

A sokkal erősebb szerver ellenére a Confluence 5.9.4 teljesítménye messze elmaradt a régi 2.9-től. Mégsem szeretnénk többet egy ilyen régi verzióval dolgozni. Confluence hatalmas változáson ment át az elmúlt 12 évben, és a kollaboráció, tudásmenedzsment egyik legjobb termékévé vált a sok-sok funkcióval, kellemes UI-al, integrációs lehetőségeivel. Mindez sokkal hatékonyabb eszközzé teszi az őseivel szemben, és egy remek eszközzé, amellyel egyszerűen jó dolgozni.