Návod -> Zoznam zmien

Zoznam zmien píše vývojár, ktorý zmeny vykonal. Pričom ho dopĺňajú ostatní riešitelia, a tým zaznamenávajú vykonané zmeny. Tento zoznam má formu wiki článku, alebo je vo formáte TXT (https://svn.cnl.tuke.sk/monica/BasicMeter/Collector/jxcoll/doc/changelog - ukážka). Je členený do viacerých odsekov. Hlavička obsahuje názov jedeného z troch komponentov nástroja BasicMeter, na ktorom boli vykonané zmeny. To znamená exportér, kolektor alebo analyzér. Pod to sa napíše aktuálna verzia komponentu a dátum. Mali by sa tu napísať taktiež informácie o stabilite komponentu, prípadne či už bol zverejnený. Nasleduje odsek s tromi časťami, do ktorých sa píšu jednotlivé zmeny:

• Pridané
• Vylepšené
• Opravené

Ak je niektorá časť prázdna, neuvádza sa ani jej názov. Meno autora sa píše v zátvorkách za zmenou, ktorú vykonal. Každá zmena sa začína písať v novom riadku a v prislúchajúcej časti. Keďže formát TXT je veľmi jednoduchý a bez podpory zložitejšieho formátovania textu, začíname každú zmenu symbolom “*“. Medzi jednotlivé časti zmien vložíme jeden prázdny riadok. Nová verzia komponentu sa pridáva na začiatok zoznamu, keďže je z pohľadu čitateľa najdôležitejšia. Ukážka takéhoto zoznamu zmien je v nasledujúcich riadkoch:

---++KOLEKTOR

---+++JXColl (3.5) stable; 21.5.2010

*Pridané:*
   * Pridaná podpora 178 i.e., z toho 9 CNL i.e. Ak by kolektor prijal dáta z exportéra s dátovým typom, ktorý kolektor zatiaľ nepodporuje, informuje o chybe vhodnou ERROR hláškou s popisom problému a i.e. preskočí. [[Tomáš Vereščák][Tomáš Vereščák]]
   * Pridaná možnosť nastavenia cesty k súboru ipfixFields.xml v konfiguračnom súbore jxcoll.conf. [[Tomáš Vereščák][Tomáš Vereščák]]

*Vylepšené:*
   * Implementované korektné ukončovanie (čisté vypnutie vlákien, spracovanie zvyšných záznamov v PacketCache, odpojenie z databázy), JXColl sa vypína ako doteraz, pomocou Ctrl+C, alebo manuálnym poslaním signálu SIGINT. Treba otestovať počas prevádzky ACP prenosu! [[Tomáš Vereščák][Tomáš Vereščák]]
   * Pri chybe načítania ipfixFields.xml nie sú spúšťané žiadne vlákna, program sa rovno ukončí. [[Tomáš Vereščák][Tomáš Vereščák]]

*Opravené:*
   * Opravený problém s padaním kolektora - odstránený memory leak, ktorý vznikal počas parsovania IPFIX paketu do jednotlivých i.e.. [[AdrianPekar][Adrián Pekár]] a [[Tomáš Vereščák][Tomáš Vereščák]]
   * V prípade ak dáta posielané exportérom nemajú správny dátový typ (poslal sa nesprávny počet bajtov), kolektor nespadne, ale informuje o vzniknutej situácii vhodnou ERROR hláškou s popisom problému a i.e. preskočí. [[Tomáš Vereščák][Tomáš Vereščák]]

---+++JXColl (3.1-9) unreleased; 23.3.2010

*Vylepšené:*
   * jxcolld loguje do /var/log/jxcoll/log.... [[AdrianPekar][Adrián Pekár]]

*Opravené:*
   * Opravená chyba pri reprezentácii uint64 čísel. Predtým čísla väčšie ako 2^63-1 mali nesprávnu hodnotu a záporne znamienko - previedli sa na int64. [[AdrianPekar][Adrián Pekár]]

---+++JXColl (3.1-8) unreleased; 6.12.2009

*Vylepšené:*
   * Namiesto prehľadávania in-memory xml dokumentu počas parsovania dát z exportéra sa načítajú údaje o i.e. vo forme objektov do kolekcie typu HashMap. K týmto informáciám sa pristupuje jednoducho cez číslo i.e. a tento spôsob urýchli spracovanie dát z exportéra. [[Tomáš Vereščák][Tomáš Vereščák]]
   * Kolektor je odteraz dostupný aj vo forme DEB balíka s init.d skriptami pre jxcolld (daemon bežiaci na pozadí). [[AdrianPekar][Adrián Pekár]]

---+++JXColl (3.1) unreleased; 4.5.2009

*Vylepšené:*
   * Zmena v podpore protokolu ACP (po pozastavení prenosu sa údaje z aktuálneho paketu pošlú až po posledný, a až potom sa prenos pozastaví). Po obnovení prenosu sa pošlú údaje z aktuálneho paketu. [[AdrianPekar][Adrián Pekár]]

KOLEKTOR

JXColl (3.5) stable; 21.5.2010

Pridané:

• Pridaná podpora 178 i.e., z toho 9 CNL i.e. Ak by kolektor prijal dáta z exportéra s dátovým typom, ktorý kolektor zatiaľ nepodporuje, informuje o chybe vhodnou ERROR hláškou s popisom problému a i.e. preskočí. Tomáš Vereščák
• Pridaná možnosť nastavenia cesty k súboru ipfixFields.xml v konfiguračnom súbore jxcoll.conf. Tomáš Vereščák

Vylepšené:

• Implementované korektné ukončovanie (čisté vypnutie vlákien, spracovanie zvyšných záznamov v PacketCache , odpojenie z databázy), JXColl sa vypína ako doteraz, pomocou Ctrl+C, alebo manuálnym poslaním signálu SIGINT. Treba otestovať počas prevádzky ACP prenosu! Tomáš Vereščák
• Pri chybe načítania ipfixFields.xml nie sú spúšťané žiadne vlákna, program sa rovno ukončí. Tomáš Vereščák

Opravené:

• Opravený problém s padaním kolektora - odstránený memory leak, ktorý vznikal počas parsovania IPFIX paketu do jednotlivých i.e.. Adrián Pekár a Tomáš Vereščák
• V prípade ak dáta posielané exportérom nemajú správny dátový typ (poslal sa nesprávny počet bajtov), kolektor nespadne, ale informuje o vzniknutej situácii vhodnou ERROR hláškou s popisom problému a i.e. preskočí. Tomáš Vereščák

JXColl (3.1-9) unreleased; 23.3.2010

Vylepšené:

• jxcolld loguje do /var/log/jxcoll/log.... Adrián Pekár

Opravené:

• Opravená chyba pri reprezentácii uint64 čísel. Predtým čísla väčšie ako 2^63-1 mali nesprávnu hodnotu a záporne znamienko - previedli sa na int64. Adrián Pekár

JXColl (3.1-8) unreleased; 6.12.2009

Vylepšené:

• Namiesto prehľadávania in-memory xml dokumentu počas parsovania dát z exportéra sa načítajú údaje o i.e. vo forme objektov do kolekcie typu HashMap . K týmto informáciám sa pristupuje jednoducho cez číslo i.e. a tento spôsob urýchli spracovanie dát z exportéra. Tomáš Vereščák
• Kolektor je odteraz dostupný aj vo forme DEB balíka s init.d skriptami pre jxcolld (daemon bežiaci na pozadí). Adrián Pekár

JXColl (3.1) unreleased; 4.5.2009

Vylepšené:

• Zmena v podpore protokolu ACP (po pozastavení prenosu sa údaje z aktuálneho paketu pošlú až po posledný, a až potom sa prenos pozastaví). Po obnovení prenosu sa pošlú údaje z aktuálneho paketu. Adrián Pekár

-- MiroslavPorada - 08 May 2011