Una buona notizia

Una buona notizia da Atlassian. Come annunciato dal loro Blog, Atlassian University è adesso accessibile a tutti. tutti i contenuti soo disponibili a chiunque voglia imparare.

Basta connettersi al link university.atlassian.com per poter usufruire gratuitamente di tutti i contenuti.

Migliaia di Tips, informazioni, articoli sono a disposizione :-). Anche se in inglese, questi articoli sono molto interessanti. Li consiglio a tutti coloro che vogliono imparare, iniziare ad imparare i prodotti della Atlassian o che sono curiosi di capire quali potenzialità può offrire. Buon divertimento 😀

Affrontiamo un argomento abbastanza spinoso. Backup e Restore dei dati di Confluence e JIRA.

Premessa

Almeno una volta nella vita capiterà di dover eseguire il restore. Lo stesso accadrà anche per Confluence e JIRA, che non sono da meno. Il consiglio che dò è di preparavi a tale evento, eseguendo dei test di restore dai backup che sono stati realizzati, cercando di capire bene tutte le operazioni che devono essere eseguite e tutti i problemi che si possono presentare. Al termine delle prove, si disporrà della esperienza per poter eseguire le operazioni necessarie senza grosse difficoltà.

In questo post vedremo alcuni scenari e descriveremo come eseguire il restore dei dati, rischi e punti di attenzione.

Tipologie di backup

Esaminiamo le possibili tipologie di backup che abbiamo a disposizione.

Per tutte le installazioni (onDemand e download) messe a disposizione, possiamo eseguire un backup generale di:

• Confluence – Tutti gli space (pagine, commenti, allegati, etc), comprensivi degli utenti, sono esportati su di un unico file ZIP;
• JIRA – Tutti i progetti e gli allegati, comprensivi degli utenti, sono esportati su di unico file ZIP.

Per Confluence è possibile anche eseguire una esportazione di un singolo Space ed importarlo. Lo stesso può essere eseguito anche su JIRA, con la differenza che è possibile eseguire l’import di un singolo progetto, sempre partendo da un intero backup (Rif. alla seguente risposta su Atlassian Answer).

Per grandi installazioni, su server locali, non è conveniente eseguire delle esportazioni così indicate, in quanto i file XML risultano troppo grandi per essere gestiti. In questo caso occorre fare riferimento alla seguente pagina, dove viene specificato meglio quale strategia utilizzare per i backup e per i ripristini. Di seguito comunque indicheremo come eseguire un restore.

Una considerazione….

I dati presenti sul file ZIP possono variare da versione a versione (sia per Confluence che per JIRA) e non sempre si riesce ad importare da una versione all’altra. E’ possibile operare una workaround, come  riportato nel seguente link, ma nel caso di  evidenti differenze di versioni (es. da una versione 3.5 ad una 5.5), allora conviene procedere all’aggiornamento dei dati attraverso un upgrade del sistema Confluence o JIRA.

Possibili scenari

I principali scenari che vi si possono presentare sono:

• Restore di un sistema installato su di un server locale, sia esso il server di produzione, sia esso il server di test da utilizzare per vari scopi (test di nuovi plugin, ambiente di test per replicare eventuali malfunzionamenti, etc);
• Spostamento dei dati da un confluence ondemand ad una installazione in locale (in questo ultimo caso si vuole portare le informazioni da uno o più space verso una installazione che già contiene degli space e che risulta in uso).

Nel caso del primo scenario, nella ipotesi che si disponga di una installazione della stessa versione del backup, possiamo eseguire il ripristino come segue:

1. Riportare il file di backup su (CONFLUENCE_HOME)/restore oppure posizionarlo su apposita directory dove eseguire il restore delle informazioni. La procedura consente di poter selezionare dove prelevare il file ZIP (vedi figura successiva);
2. Accedendo alla sezione di amministrazione, sezione Import Site, selezionare quindi il file da importare, come mostrato nelle due figure successiva, per Confluence e per JIRA.

CONFLUENCE ADMINISTRATION

JIRA ADMINISTRATION

Qualora sia stata eseguita una strategia di backup differente (come indicato prima, facendo riferimento alla pagina del manuale di confluence), dove si è eseguito:

• Backup del database;
• Backup della Confluence Home (o JIRA Home)

il ripristino deve essere eseguito ripristinando entrambe le due componenti sopra indicate, a server spento. Quindi riattivare il tomcat ed attendere il riavvio, controllando tutti i messaggi che si presentano nel log. Qualora si stia predisponendo una nuova installazione, vuoi di un server di test o di altro, occorre allora modificare i puntamenti al database, presenti nel file confluence.cfg.xml, e inserire dove è stato eseguito le coordinate del database di cui si è eseguito il restore. Questa modalità può essere eseguita solo su installazioni in locale.

 Punti di attenzione

Come ho indicato prima, i file ZIP presentano anche le indicazioni degli utenti. DI conseguenza, quando si esegue il restore, occorre prestare molta attenzione. Se si vuole eseguire un restore di un backup su di una installazione già avviata (vuoi per eseguire una unificazione di sistemi diversi, una on demand ed una locale), quando si esegue una importazione dello ZIP, gli utenti vengono riportati sulla installazione in cui si esegue il restore, rimuovendo il contenuto preesistente. Se non si agisce con criterio, si rischia di fare dei danni.

In questo caso occorre operare degli accorgimenti. Nel caso di JIRA, eseguire una importazione di un singolo progetto (nel caso di più progetti, l’operazione potrebbe richiedere molto tempo: Valutare bene le operazioni in questo caso). Nel caso di Confluence, procedere ad una esportazione di singolo space e relativa importazione.

Un calendario per Confluence

Team Calendar è un addon per Confluence che implementa un calendario, con un insieme di funzionalità aggiuntive che estendono le funzionalità di Confluence e degli altri prodotti della Atlassian quali JIRA.

Nato come semplice Calendario (nome originario Calendar), fu in seguito acquisito dalla Atlassian e venne esteso sempre di più con nuove funzionalità. Venne meglio integrato con Confluence e, successivamente, con JIRA, rendendolo uno strumento molto potente e versatile per condividere eventi, scadenze, pianificazioni di progetto ed altro. L’Addon è a pagamento.

L’installazione dell’Addon non richiede particolari operazioni o accortezze. Nel corso della sua evoluzione, Confluence ha reso l’installazione di Addon sempre più semplice ed automatica, come mostrato in figura:

L’Addon è anche disponibile per la versione odDemand di Confluence. SI tratta di uno dei pochi plugin disponibili. Una volta attivato, è possibile utilizzarlo dalla apposita voce presente nella barra in alto, come mostrato nella seguente figura:

Una volta selezionato, si accede alla sezione di gestione dei calendari, come mostrato nella seguente figura:

Selezionando le varie voci è possibile aggiungere un nuovo o un calendario esistente, importare un calendario. Possiamo aggiungere un nuovo calendario ed agganciarlo ad uno space di Confluence, come mostra la seguente figura:

Fornite le indicazioni necessarie, il Calendario viene creato ed è subito fruibile per la generazione di nuovi eventi.

La generazione di nuovi eventi, richiede l’inserimento di pochi e semplici parametri, come mostrato in figura:

Particolare importanza presenta l’attributo Event Type, che consente di poter categorizzare gli eventi per una migliore rappresentazione degli stessi sul calendario e aumentarne la leggibilità.

Nei prossimi post verificheremo come poter utilizzare Team Calendar su Confluence.

Premessa

In questo post esporremo alcune delle ultime novità del sistema Confluence, il sistema WIKI della ATLASSIAN.

Citazioni nei commenti

E’ stato introdotto un automatismo nell’inserire delle citazioni di testo nei commenti. Questo meccanismo è stato introdotto per ridurre le operazioni di copia/incolla.  Semplicemente basta selezionare il testo. Automaticamente, come mostrato nella figura successiva, selezionando un testo sarà proposto in automatico una icona che consente di inserire su commento:

Il risultato sarà quindi visibile nel commento:

Questa funzionalità è già presente sulla versione OnDemand. Sulla versione download, è possibile inserire questa nuova funzionalità attraverso il seguente plugin .

Maggiore integrazione con JIRA

Confluence mette a disposizione un insieme di Macro che consentono di realizzare una maggiore integrazione tra i due sistemi. In questo paragrafo, descriveremo delle funzionalità di reportistica che Confluence mette a disposizione. Occorre che i due sistemi siano collegati (attraverso la funzione di Application Link).

Selezionando il menù CREATE, è possibile generare dei JIRA REPORT. Selezionando questa opzioni si verrà reindirizzati alla seguente pagina:

Una volta selezionato il tipo di report che si intende generare:

• Change Log (elenco delle variazioni che una determinata versione metterà a disposizione)
• Status Report (Statistiche sul progetto)

sarà richiesto il progetto e i relativi parametri per potersi collegare al progetto JIRA. Attraverso la funzione di Application Link, opportune autocomposizioni aiuteranno l’utente a selezionare i vari parametri:

Una volta inseriti i parametri, Confluence predisporrà una pagina già predisposta di tutte le informazioni. L’utente può quindi eventualmente personalizzare la pagina a proprio uso e consumo.

I risultati saranno i seguenti:

STATUS REPORT

Change Log

Premessa

Dedico questo articolo ad Atlassian Confluence, uno dei migliori Wiki enterprise esistenti al mondo.

Confluence è un sistema Wiki, a pagamento, che consente di poter centralizzare le informazioni aziendali su di un sistema unico, consentendo all’azienda di mettere a disposizione dei dipendenti/collaboratori un unico repository su cui interagire in maniera semplice e veloce. Confluence dispone anche di interfacce appositamente disegnate per i dispositivi mobile, anche se con funzionalità limitate, che consente di poter accedere alle informazioni con smartphone e tablet.

Confluence dispone di un insieme di funzionalità base abbastanza completo. La sola installazione del sistema consente di implementare un portale completo e semplice. Funzionalità aggiuntive sono messe a disposizione attraverso un insieme molto vasto di plugin, realizzati sia dalla stessa Atlassian, che da partner/aziende terze parti.

Atlassian Confluence Questions

Iniziamo a vedere nel dettaglio questo nuovo plugin (al momento in cui viene realizzato questo post, il plugin è ancora in Beta), realizzato dalla Atlassian stessa, che consente di realizzare un semplice sistema di Q&A interattivo. Basandosi sulla esperienza di Answers, il forum della Atlassian, viene messo a disposizione un nuovo sistema interattivo per creare delle sezioni di Q&A dove tutti gli utenti del Confluence stesso possono interagire.  Si tratta di Questions.

L’obbiettivo è quello di aumentare l’interazione tra gli utenti e di consentire lo scambio delle informazioni.

Basandosi sul principio, usatissimo, di chiedere ai colleghi quando si hanno dei dubbi, o per arrivare a dipanare dei dubbi, Questions, si pone l’obbiettivo di dare la possibilità di far scrivere delle domande a tutti gli utenti e consentire, sempre a tutti gli utenti, di rispondere. La seguente figura, disponibile sul Blog di Atlassian, mostra come utilizzare questa nuova funzionalità.

L’interfaccia risulta molto semplice. L’utente può formulare la domanda, inserire tutte le indicazioni che ritiene utili, comprensiva di immagini e TAG.

Una volta pubblicata la domanda, chiunque può contribuire alla risposta ed alla risoluzione del problema. In questo modo la conoscenza viene condivisa con tutti.

Come si può notare, la grafica riprende un pò quella utilizzata da stackoverflow, dove è possibile dare anche un voto alla risposta oltre che referenziare utenti, pagine ed altre informazioni che possono aiutare ulteriormente a rispondere alla domanda.

Come mostrato nella precedente immagine, è possibile anche ricercare la Q&A per topic/tag visualizzare delle statistiche e accedere anche all’elenco delle stesse.

Segnalo che il motore di ricerca mantiene lo standard attualmente in essere, mettendo a disposizione un ottimo motore di ricerca e consentendo di poter ottenere velocemente le informazioni che si ricercano, come mostrato in figura:

Conclusioni

Questo plugin mette a disposizione un ottimo strumento per poter creare delle sezioni Q&A. Estende ulteriormente l’interazione tra i vari utenti e aumenta ulteriormente la condivisione delle informazioni. Le funzioni di ricerca sono molto potenti e precise, rispetto ad altri sistemi.

D’altro canto, questa sezione risulta unica per l’intera installazione Confluence. Non risulta possibile avere a disposizione delle sezioni distinte per Space. La sezione delle Questions è trasversale per tutti gli space.

Di default, tutti gli utenti che possono accedere a Confluence, possono anche accedere a Questions. Non è possibile impostare delle restrizioni su singoli utenti, ma solo a gruppi di utenti.