docebo lms, cms, kms manuale di installazione · un learning management system è uno strumento per...

Company site: www.docebo.comWeb Hosting site: www.docebohosting.com Developers site: www.docebo.orgLMS site www.docebolms.orgCMS site www.docebocms.orgKMS site www.docebokms.org

Docebo LMS, CMS, KMS

Manuale di installazione

http://www.docebo.com/

http://www.docebokms.org/

http://www.docebocms.org/

http://www.docebolms.org/

http://www.docebo.org/

http://www.docebohosting.com/

Manuale per l'installatore

A.0 IntroduzioneA.1 La suite doceboA.2 L'accessibilitàA.3 Cos'é l'e-learningA.4 Cosé il software open sourceA.5 Configurazione server – prerequisitiA.6 Configurazioni specifiche del php.iniA.7 Configurare il vostro sistema windows per DoceboLMSA.8 Far funzionare Apache + PHP + Mysql su Linux Red HatA.9 Far funzionare Apache + PHP + Mysql su Mac OSXA.10 Installazione di DoceboLMSA.11 Manutenzione: Upgrade, Patch, Backup e RestoreA.12 Usare PHPMyAdmin

Licenza di utilizzo








A.0 Introduzione

Benvenuti alla fase 3 del progetto Docebo, come potrete vedere oramai con la suite open source che vi mettiamo a disposizione non potete solo fare e-learning ma anche gestire portali, reti intranet e archivi di file.

Nei mesi passati da docebo 2.0.4 a docebo 3.0 il lavoro fatto è stato molto, la nascita da zero di un content manager che vuole andare a competere direttamente con Mambo, Drupal e i vari Nuke ne è un esempio, il fatto che Docebo 3.0 derivi da implementazioni di progetti svolti per aziende ed enti pubblici con più di 3.500 utenti ne garantisce la solidità.

L'idea con cui andiamo a rilasciare questa versione è basata su quattro principi fondamentali:

• Accessibilità• Ogni organizzazione è completamente diversa da un'altra, docebo deve replicare, nella gestione

utenti, tutte le peculiarità delle realtà con cui si interfaccia• Il modulo gestione utenti deve poter consentire di creare applicativi in modo veloce ed immediato• La community di sviluppo deve allargarsi, per questo nasco docebo.org, portale dedicato a tutte le

attività che faranno crescrere il progetto (sviluppo, traduzioni, documentazione ecc ...)

Quest'anno, 2005, è l'anno in cui entra in campo anche Docebo SRL, azienda che supporta e sponsorizza sia dal punto di vista finanziario che dal punto di visto logistico tutto il progetto open source Docebo.org, questo tipo di organizzazione ci consente di:

• Porsi sul mercato della consulenza in modo credibile verso i clienti che hanno bisogno di qualsiasi tipo di supporto sugli applicativi docebo

• Continuare ad offrire un servizio gratuito in termini di continuità nello sviluppo e crescita delle community sempre più efficace a chi vuole affrontare indipendentemente l'approccio agli applicativi docebo

Per consuelenza e audit: www.docebo.com

Per acquistare solo web hosting www.docebohosting.com










A.1 La suite Docebo

Dalla versione 3.0 il progetto Docebo sono si occupa solo di e-learning ma aggiunge alle sue attività anche un content manager (CMS) e un archiviatore online di file (KMS).

L'attività che è stata fatta è quella di separare la gestione dell'utenza dagli applicativi ottenendo così:

• Che un utente possa entrare nei 3 applicativi con lo stesso user e password• Che chi installa docebo possa scegliere se attivare, oltre alla piattaforma di e-learning anche il

sistema per generare siti web e/o il sistema con cui archiviare file• Decidere quali dei tre applicativi sarà la pagina principale

Questo approccio di Lavoro consente inoltre allo staff Docebo di poter creare nuovi moduli in modo veloce ed immediato, non è impensabile in futuro pensare ad un docebo e-commerce o docebo crm.








A.2 L'accessibilità

Tutti gli applicativi Docebo sono implementati nel rispetto dei requisiti per i siti INTERNET previsti dal Decreto Ministeriale 8 luglio 2005, ovvero come richiesto dalla Legge 04/2004 (Legge “Stanca” sull’accessibilità dei siti INTERNET e degli strumenti informatici). Grazie a tale conformità i software Docebo (Piattaforma di e-learning, Content Management, Knowledge Management) possono essere fruiti anche da utenti soggetti a disabilità.

Nel processo di validazione gli applicativi Docebo tengono in considerazione le tecniche di implementazione suggerite sia dalla normativa statunitense (Section 508) che dalle linee guida W3C WCAG 1.0 (come da progetto e-Europe). L'accessibilità degli applicativi è continuamente migliorata grazie ai suggerimenti degli utilizzatori del sistema.

Docebo mette a disposizione per ogni sua installazione un MANUALE DI ACCESSIBILITA' in cui vengono illustrate le tecniche di validazione utilizzate ed in cui si dichiara la conformità dell'installazione ai requisiti richiesti.

A titolo di esempio illustriamo alune delle tecniche utilizzate:

• Codice XHMTL 1.1 e validazione wai AA più i punti della AAA previsti dal decreto.• Doppia interfaccia di Login: L'utente puà decidere se accedere in modalità normale o ad alta

accessibilità, in questo secondo caso vengono disabilitate alcuni funzioni javascript non accessibili e fornite soluzioni equivalenti. Il resto del codice è già completamente accessibile anche per l'interfaccia standard.

• Access key: E' possibile abilitare le access key per accedere via tastiera alle macro voci del menu di e-learning

• Blind Navigation: All'inizio del codice è possibile utilizzare link specifici per saltare direttamente alle aree desiderate (potete fare una prova disabilitando i fogli di stile)








A.3 Cosé l'e-learning

Con questo paragrafo non abbiamo la pretesa di spiegarvi cosa sia l'e-learning, preferiamo partire dicendovi cosa, secondo noi, NON è (o NON E' SOLTANTO) l'e-learning.

• L'e-learning non è un sito web da cui si possono scaricare files• L'e-learning non è (solo) un sistema di videoconferenza• L'e-learning non è usare un PC nell'aula informatica della scuola• L'e-learning non è (solo)un segnale video trasmesso via internet

Generalmente possiamo considerare e-learning quel tipo di attività che consiste nel:

"attività didattica gestita attraverso strumenti telematici basata su internet e intranet, nel nostro caso il contenuto è erogato attraverso strumenti telematici fruibili attraverso un browser web"

Un learning management system è uno strumento per gestire l'erogazione di conoscenza che:

• Gestisce gli utenti• Gestisce contenuti didattici e oggetti didattici• Gestisce voti e risultati• Gestisce l'interazione degli utenti• Monitora l'attività degli utenti

Ricorda che un buon LMS non serve a nulla senza un buon insegnate e un progetto didattico!








A.4 Cos'é il software open source

La suite Docebo è Open Source e gratis, la licenza sotto cui è rilasciata è la GPL 2.0 (General Public License), la sua gratuità vi consente di:

• Scaricare liberamente il software• Modificarlo• Utilizzarlo per qualsiasi fine (anche commerciale, dunque potete rivenderlo, fare corsi a pagamento,

creare siti a pagamento ecc ...)• Non riconoscere nessun tipo di pagamento allo staff docebo che lo ha sviluppato.

L'unico limite è che la licenza del software e delle modifiche che voi effettuate deve essere la stessa sotto cui la suite Docebo è rilasciata, dunque la GPL; A titolo di esempio rispondiamo ad alcune domande classiche che vengono poste riguardo al software open source:

• Posso fare formazione a pagamento con la vostra piattaforma di e-learning (o CMS o KMS)?•

SI

• Sono un programmatore, posso vendere ad un mio cliente installazione e modifiche di docebo che ho fatto io?

•SI

• Posso usare il vostro CMS per il mio sito aziendale che ha scopo di lucro?•

CERTAMENTE SI

• E' vero che i corsi che ho scritto e pubblicato in e-learning diventano open source visto che la piattaforma è open source?

NO, il maeteriale didattico pubblicato può essere anche proprietario e protetto.

• Ho visto un sito che, pur utilizzando docebo e-learning lo ha chiamato in un'altro modo, è legale questo?

SI, a patto che non abbia rimosso i credits di Docebo dal codice sorgente (come staff siamo tolleranti che qualcuno tolga il "Powered By" anche se preferiremmo rimanesse visibile)

• Posso trasformare la licenza Open Source di Docebo in una licenza Closed Source?

ASSOLUTAMENTE NO

• Può da un giorno all'altro docebo cambiare licenza e costringermi a pagare?

ASSOLUTAMENTE NO

• Come si finanzia Docebo SRL se regala il software?

Da ricerche di mercato (Gartner Group, 2003) il costo delle licenze è solo il 17% della spesa informatica totale di una azienda, Docebo SRL eroga consulenza e servizi a valore aggiunto che prescindono dal vendere licenze, in particolare docebo effettua:

• Sviluppo software sotto forma di personalizzazione della suite docebo• Formazione, consulenza e Audit in ambito di E-Learning, Content Management, Learning

Management• Web Hosting e managed housing dei suoi applicativi• Assistenza tecnica








• Rivendita di SMS e servizi di Videoconferenza• Sviluppo di oggetti didattici

Per maggiori informazioni sulle attività docebo visitate:

www.docebo.comwww.docebohosting.com








A.5 Configurazione server - prerequisiti

Come riportato ovunque DoceboLMS funziona su diversi sistemi operativi, solo l'utilizzo di SCORM richiede configurazioni specifiche.

Sistemi operativi testati:

• Linux Red Hat 8 Testato da noi• Linux Red Hat Enterprise Adv. server Testato da noi• Linux Fedora core 1 Testato da noi con il supporto di Eticoweb.it• Linux Debian Testato da noi con il supporto di Seeweb.it• Windows 2000/XP Testato da noi• Windows 2003 Server (+Apache) Testato da noi in locale• Mac OSX Testato da Francesco Pozzi, University of Parma

Sistemi operativi che presentano problemi:

Linux fedora core 2 e 3 per questo bug: http://bugs.php.net/bug.php?id=30894 , solo per chi ha safe_mode ad ON e usa la connessione via FTP.

Sistemi operativi non testati:

• FreeBSD• Altri Unix• Windows '98• Windows 'NT• Windows 2000 Server

Componenti richiesti:

• PHP 4.2.x più recente ( Non lo abbiamo ancora testato con PHP5, per ragioni di sicurezza si consiglia PHP 4.3.10)

• MySql 3.23 or più recente (Attenzione! Usare Mysql4 va bene ma sono necessari i permessi dell'utente database per creare le tabelle temporanee, nella versione 3.23 questo non è un problema)

• Apache 1.3.x o 2.0.x

Configurazione server suggerita

• Per utilizzare i componenti SCORM è necessario abilitare la libreria domxml (Estensione del php che deve essere attivata da php.ini p per windows o installata per Linux)

• Per ragioni di sicurezza consigliamo di configurare il php.ini con Safe_Mode to ON e Register Global to OFF (Nota, se hai il safe mode configurato ad ON sei obbligato ad usare la connessione ftp per caricare il package SCORM, se sei in windows in locale invece configura l'upload come "fs" in config.php anche se il safe_mode è a ON, per approfondire vai in fondo a questo documento)

•Suggerimenti per il caricamento di file

• La cartella filecourses e tutte le sue sottodirectory devono avere il permessi CHMOD 777 (Per sistemi windows devi configurare i permessi di accesso, questo non è necessario per i sistemi windows in locale, ex. Casa/ufficio).

• La dimensione massima dei file che possono essere caricati sono definiti dal server e vanno configurati da che lo gestisce definendo i seguenti parametri:

• Max Upload filesize• Max Post Filesize• Max execution time• Memory limit (Useful higher more than 8 Mb for unzip functions)








Abbiamo notato che in alcune installazioni di Linux Red Hat può accadere che la configurazione dei parametri relativi alla massima dimensione dei files possa essere gestita non da apache ma da PhP, in questo caso dovete cambiare all'interno del file httpd.conf il parametro LimitRequestBody.

Il caricamento di files può avvenire attraverso due sistemi, questo va configurato in fase di setup ed eventualmente dopo, nel config.php• "fs" significa file sistem, è il vecchio metodo e non lavora con il caricamento di SCORM package con il

safe_mode ad ON ( la funzione "ftp" non lavorerà con il vostro sistema windows di casa su cui testate la piattaforma, in questo caso reimpostate "fs")

• "ftp" questa opzione usa la funzione FTP del PHP, è molto più sicura e potente. I dati di FTP sono gli stessi che utilizzate per collegarvi e caricare i vostri file, escluso l'indirizzo IP che deve essere 127.0.0.1, esempio:

$ftphost = "127.0.0.1"; // normally this settings is ok$ftpport = "21"; // same as above$ftpuser = "[email protected]";$ftppass = "mypassword";$ftppath = "/var/www/html/";








A.6 Configurazioni specifiche del php.ini

Qualche volta può capitare che dovete modificare alcune configurazioni del php.ini per avere performance migliori o per risolvere qualche problema specifico. Se avete il sito presso un provider dovete chiedere a lui di effettuare queste modifiche, ma se state lavorando sul pc di casa o avete un server vostro potete intervenire direttamente. Modificate le configurazioni del php.ini solo se necessario!

Le modifiche avvengono editando un file di testo che si chiama php.ini (se usate easyphp fate riferimento all'immagine qui sotto)

Ok, prima di partire è necessario fare una precisazione, il simbolo ";" posizionato davanti a dei testi o dei parametri significa che quelli non sono i parametri reali e non verranno letti, le vostre modifiche in quel caso non avranno effetto! Esempio, se dovete editare il parametro relativo all'error reporting dovete editare l'ultima linea qui evidenziata e non la prima in quanto è commentata:

;error_reporting = E_ALL & ~E_NOTICE;; - Show only errors;;error_reporting = E_COMPILE_ERROR|E_ERROR|E_CORE_ERROR;; - Show all errors;error_reporting = E_ALL & ~E_NOTICE

Ok, analizziamo i parametri che vengono cambiati più comunemente:

error_reporting: se impostato su E_ALL verranno visualizzati anche i notice che non sono errori di programmazione ma solo incongruenze, se vedete troppi notice cambiate il seguente parametro

da:

error_reporting = E_ALL

a:

error_reporting = E_ALL & ~E_NOTICE

upload_max_filesize: imposta la dimesione massima dei file da caricare, se caricate Learning Object di grandi dimensioni potete cambiare queste impostazioni








da:

upload_max_filesize = 2M

a:

upload_max_filesize = 24M

questo parametro è dipendente da un'altro parametro:

post_max_size: imposta la massima dimensione di dati che può essere spedita tramita il metodo "post", dovete configurarla con la stessa dimesione dell'upload_max_filesize, cambiate questa configurazione

da:

post_max_size = 8M

a:

post_max_size = 24M

max_execution_time: se dovete fare upload che impiegano molto tempo o elaborare query importanti cambiate queste impostazioni

da:

max_execution_time = 30

a:

max_execution_time = 300

memory_limit: se avete errori riguardo la massima memoria da abilitare cambiate questo parametro

da:

memory_limit = 8M

a:

memory_limit = 16M

L'ultima cosa da analizzare riguarda il DomXml():, è utile configurarla se si lavora con scorm (che usa dati XML), inoltre con DoceboLMS abbiamo intenzione di gestire anche altri elementi come XML:

Per abilitare DomXml() sul vostro easyphp procedere come segue

Tasto destro sulla E nera

• Fermare easyphp

• Tasto destro sulla e nera

• Congfiration/Extension

• Flaggare domxml








Nel caso il sistema dia errore:

• Cercare una dll chiamata iconv.dll

• Copiarla in system32

• Riavvare apache

Attenzione che potrebbe dare problemi se si ha installato easyphp 1.7 su una installazione precedente di easyphp (es. 1.6 ), in questo caso cancellare completamente tutte le directory easyphp rimaste dopo l'installazione.








Se non usate easyphp dovete configurare il file php.ini in questo modo (esempio per windows):

Cambiare:

;extension=php_domxml.dll

in:

extension=php_domxml.dll








A.7 Configurare il vostro sistema windows per DoceboLMS

Per poter cominciare a lavorare con DoceboLMS è utile emulare, sul vostro PC casalingo, un server web. In questo modo potete far girare il sistema (in quasi tutte le sue funzioni) sul vostro PC simulando l'attività online come se foste in hosting da un provider. In questa sezione viene affrontata l'installazione su PC Windows, nella prossima su Linux. Vengono poi affrontati gli argomenti relativi all'utilizzo di PHPMyadmin.

Per scaricare easyPHP andate qui: http://www.easyphp.org/telechargements.php3 e scaricate la versione 1.7 oppure 1.8

EasyPHP

Installare easyphp è davvero facile. Dopo aver scaricato l'ultima versione da easyphp.org cliccare sull'icona di setup per lanciare l'installazione. Una volta lanciata l'installazione Easyphp ci chiederà pochi elementi per poter essere installato. La prima maschera è una maschera di benvenuto, cliccare sul tasto procedi (suivant) per procedere nell'installazione.

Avremo poi delle maschere che ci chiederanno di accettare licenze ecc ... noi clicceremo su “suivant” (procedi) fino a che non incontriamo la maschera che ci chiede dove** vogliamo installare il nostro easyphp (** Inteso “in che directory” lo vogliamo installare. A quel punto sceglieremo un percorso adatto (Se avete dubbi lasciate quello predefinito.)

Cliccare ancora su suivant fino alla fine dell'installazione.

Cliccare poi su “terminer”. A questo punto EasyPHP è installato. Supponiamo che abbiate scelto di installarlo in c:\easyphp. Qui avrete una serie di cartelle, quella che vi interessa è la cartella www: è lì che apache processa i files ed è lì che dovrete caricare il vostro DoceboLMS

Servono ancora un paio di elementi per spiegarvi come funziona easyphp. Una volta lanciato l'applicativo troverete in basso a destra una E nera con un puntino rosso. Se il puntino rosso è lampeggiante allora il server è attivo, se il puntino rosso e fisso allora il server è fermo.








Per gestire easyphp basta che clicchiate sulla E nera. Con il click del tasto destro del mouse otterrete un menu dei comandi che vi consente di gestire il server, con un doppio click del tasto sinistro una consolle di informazioni.

Verificare che l'installazione sia andata a buon fine:

Per verificare che Apache e PHP funzionino correttamente useremo la funzione PHPInfo che interroga il server chidedendo informazioni relativamente alla configurazione del PHP. Se ci verrà data una schermata tipo questa tutto funziona correttamente:

Come costruire il file che verifica il funzionamento di PHP e Apache? E' semplicissimo, create un file di testo che chiameremo info.txt, inseriteci questo codice:

<? phpinfo(); ?>

Salvate il file e rinominatelo da info.txt a info.php, mettetelo nella cartella WWW, aprite il vostro Browser e scrivete, nella barra dell'indirizzo: http://localhost/info.php, dovreste ottenere la schermata scritta sopra.

Per abilitare DomXml() sul vostro easyphp procedere come segue

Tasto destro sulla E nera








• Fermare easyphp

• Tasto destro sulla e nera

• Congfiration/Extension

• Flaggare domxml

Nel caso il sistema dia errore:

• Cercare una dll chiamata iconv.dll








• Copiarla in system32

• Riavvare apache

Attenzione che potrebbe dare problemi se si ha installato easyphp 1.7 su una installazione precedente di easyphp (es. 1.6 ), in questo caso cancellare completamente tutte le directory easyphp rimaste dopo l'installazione.

Attenzione! Prima di procedere con l'installazione di DoceboLMS sul PC di casa è necessario creare, con PHPMYadmin, un database vuoto








A.8 Far funzionare Apache + PHP + Mysql su Linux Red Hat 8.0

Questo minitutorial spera di risolvere alcuni problemi relativi alla configurazione di Red Hat 8.0 con PHP Apache e Linux. Purtroppo Red Hat, non si sa per che strana policy, non aggancia PHP a Mysql e ci costringe a fare un paio di trucchetti per poterlo far funzionare.

Nel caso i pacchetti Apache PHP e Mysql non siano installati procedete all'installazione degli stessi. Su Red Hat 8 lo si fa in questo modo: Barra degli strumenti/Impostazioni del sistema/installazione pacchetti (come da screenshot)

Una volta entrati nel sistema (come root) dovrete selezionare (sempre che non siano già installati) i 3 elementi necessari (Apache, PHP, Mysql)

Apache: E' collocato in Server WebPHP: E' collocato in Server WebApache: E' collocato in Server per database SQL

Per vedere cosa è installato all'interno delle sezioni cliccate su dettagli.








Una volta selezionati i pacchetti necessari cliccate aggiorna, La vostra Red Hat, dopo aver verificato le dipendenze, passerà all'aggiornamento dei pacchetti.

Ora PHP, Mysql e Apache sono installati ma purtroppo non è ancora finita. Infatti è necessario configurare il php.ini affinché possa parlare con mysql.

Le operazioni da fare sono 2:

1) Editare il php.ini affinché supporti anche gli script php che iniziano con <? e non solo quelli che iniziano con <?php

2) Installare il file mysql.so

Ricordiamo che per editare un file di sistema abbiamo bisogno dei permessi di root, possiamo farlo senza fare logout con queste semplici operazioni:

1) Lanciare il terminal (Strumenti di sistema/Terminal)2) Loggarsi come superuser (su e inserire poi la password)3) Lanciare il vostro editor di testo preferito (Nel mio caso Kedit o bluefish) - Il Kedit verrà lanciato come root

e non come utente, dunque avete i permessi per giocare con i files di sistema.4) Per effettuare l'operazione 1 aprite il file php.ini che sta in etc/php.ini e configurate su ON ll seguente

parametro

; Allow the <? tag. Otherwise, only <?php and <script> tags are recognized.short_open_tag = On

5) Per gli esperimenti in locale vi conviene anche impostare il safe mode ad Off e il register global ad on

OK, salvate tutto e la prima operazione è fatta. La seconda operazione è più semplice, prendete il file mysql.so e copiatelo brutalmente in usr/lib/php4/ , mi raccomando di farlo con i permessi di root.








L'unica cosa da fare ora è riavviare i servizi. Lo possiamo fare in due modi, o via Terminal o via tool grafico. Visto che questo tutorial è dedicato ai novizi vediamo come avviarlo via tool grafico:

L'attivazione/riavvio dei servizi avviene posizionandosi sul servizio che ci inseressa (httpd corrisponde ad apache e mysqld corrisponde a mysql), e dando il comando (Avviare, Arrestare, Riavviare)

Ricordiamo che per rendere effettive le variazioni al php è necessario riavviare apache.

Ora potete collegarvi via brover digitando http://localhost o digitandohttp://127.0.0.1

NOTA: Nel caso il servizi di apache non parta effettuate questa modifica:aprite il file etc/hosts e modificatelo da:

127.0.0.1 localhost.localdomain localhost

cambiandolo in:

127.0.0.1 dhcppc0 localhost.localdomain localhost

I files che devono essere processati da apache si trovano in var/www/html

Relativamente ai permessi necessari per poter scrivere da utente semplice(non root) nella cartella var/www/html/ ricordiamo che è necessario








configurare quella cartella con i permessi 777, in questo modo anchel'utente semplice può scrivervi.

Un'altra comodità è quella di creare un collegamento a quella cartella suldesktop del cliente in modo da non dover percorrere ogni volta tutto ilpercorso per arrivare a var/www/html








A.9 Far funzionare Apache + PHP + Mysql su MAC OSX

1.Download MAMP 1.0b (as DiskImage) dal sito:

http://www.webedition.de/en/serviceCenter/mamp.php

2. Aprire il file dmg e copiare la cartella MAMP in Applicazioni. La cartella contiene le seguenti sottocartelle

La cartella htdocs è la home directory di Apache.

3. Lanciare l’applicazione MAMP: apparirà la seguente schermata








Seguire le informazioni contenute nell’open start page:

Da “Preferences…” è possibile modificare le porte di ascolto di Apache e MySQL e selezionare fra PHP4 e PHP5 (per DoceboLMS consigliato ancora PHP4).








A.10 Installazione di DoceboLMS

Importante: Prima di partire con l'installazione dovete avere a disposizione le seguenti informazioni:

Compatibilità:Versione PHP: 4.2.2 o superiori (compatibilità a php5 da versione 3.0.1)Versione MySql 3.23 o superiori

Inoltre sono consigliate:upload_max_filesize = 24Mmax_execution_time = 300post_max_size = 24Mestensione domxml(); attiva (non necessaria per PHP5)

Le informazioni che dovrete avere a disposizione sono:Accesso FTP: Host, User e PasswordConnessione database: Nome Database, User e Password

Se installate sul PC windows di casa lo user del database sarà “root”, non inserite password e il nome del database lo sceglierete voi nel momento della creazione via phpmyadmin (vedi capitolo successivo), inoltre, sempre sul pc windows di casa non configurate ftp come metodo di caricamento ma http (in config.php il nome del metodo ftp è “fs” ma questa informazione non vi serve se non andate a toccare a mano il file config.php), sul pc di casa non avrete bisogno di usare i dati ftp.

Installazione:L'installer di Docebo 3.x è davvero potente, l'installazione è divisa in diversi momenti, alcuni passi delle schermate visualizzate sono visibili solo se qualcosa va storto.

Il primo passo da fare è quello di caricare i file via ftp (se siete sul PC di casa questa operazione potete saltarla e copiare i file nella directory opportuna), di solito questi file vegono archiviati nella directory principale.

Nota: la directory principale può avere come percorso “/”, capire l'esatto percorso è davvero importante per configurare il caricamento file via ftp nella fase di installazione, ad esempio la directory root può essere /htdocs/








Dopo aver caricato i file avrete visibili i seguenti files e directory:

doceboCmsdoceboCoredoceboKmsdoceboLmsdoceboScsfilesinstallupgradeadmin.phpconfig.phpindex.php

Se siete su un server Linux dovrete impostare i permessi in questo modo (dopo aver finito l'installazione) (su windows non è necessario)

tutti i file devono avere permessi 644tutte le directory devono avere permessi 777








Prima dell'installazione questi file e directory devono avere permessi 777:

[file] config.php[directory] files e tutte le sottodirectory

se intendete usare anche doceboCms per far funzionare le statistiche dovete rendere scrivibili (con permessi 777) la directory

/doceboCms/addons/bbclone/var

e i file in essa contenuti

Per ragioni di sicurezza, dopo l'installazione devi:

eliminare la directory install/eliminare la directory upgrade/

Impostare a 644 i permessi per il file admin.php, config.php e index.phpImpostare a 644 i permessi per il file .htaccess located nella directory files/Impostare a 644 i permessi per il file .htaccess located nella directory principaleImpostare a 644 i permessi per il file .htaccess posizionato nella directory /doceboCms/addons/bbclone/var

Percorsi per l'installazione sul pc windows di casa: Supponendo che abbiate messo i file in una directory chiamata "docebo" dovete richiamare il seguente url:

http://localhost/docebo/install

Percorsi per l'installazione su server: Supponendo abbiate un dominio che è website.com ed abbiate installato tutto nella directory principale otterrete: www.website.com/install/

Usando i seguenti link potete raggiungere i tre applicativi docebo e l'area di ammnistrazione:

www.website.com/doceboLms/www.website.com/doceboCms/www.website.com/doceboKms/www.website.com/doceboCore/ o con questo link www.website.com/admin.php

Potete inoltre definire quali degli applicativi farà da pagina principale.



http://www.website.com/doceboKms/

http://www.website.com/doceboCms/

http://www.website.com/doceboLms/






Dopo aver lanciato l'installer attraverso /install/otterrete la seguente schermata:

e' dunque necessario accettare la licenza








E' necessario scegliere quale piattaforma installare, si può scegliere una sola applicazione (es. E-learning) o più applicazioni, in questo caso la scelta dell'applicazione principale (quella che sarà l'home page)sarà scelto in un'altro step








In questa interfaccia si potrà configurare la connessione al database, è inoltre configurabile l'interfaccia FTP, si vedrà inoltre come configurare il giusto path (percorso)








Come potete vedere il primo screen di login non la root, il path corretto è /htdocs/

In questa interfaccia verranno formulate alcune domande che gestiranno l'abilitazione/disabilitazione di alcune funzioni, sarà inoltre creato il super amministratore che avrà tutti i diritti nell'area di amministrazione.








Una volta finito attendere alcuni secondi e NON cliccare fino a che il database non sarà creato.

Ora ci saranno diversi step che caricheranno diversi moduli di linguagiio (Ex. English for CMS, English for LMS ecc ...)








Una volta finito avrete unapagina di istruzioni che vi guiderà a tutti gli applicativi installati.








A.11 Manutenzione, Upgrade patch e backup

Aggiornare docebo 2.0.x a docebo 3.0 ha i seguenti passi:

1) Eliminare tutti i vecchi file di docebolms 2.0.x tranne:

tutti i file contenuti in fileCoursesil file config.php

2) ora copia il contenuto di fileCourses secondo il seguente schema:

fileCourses/ dentro files/doceboLms/ (incluse le sottodirectory) fileCourses/photo/ dentro files/doceboCore/photo/ (spostalo da fileCourses)fileCourses/userFile/ dentro files/common/users/ ( spostalo da fileCourses)

3) Aggiungi alla fine del file config.php il seguente codice

$GLOBALS['where_files'] = '/files'; $GLOBALS['prefix_fw'] = 'core'; //prefix for tables $GLOBALS['prefix_lms'] = 'learning'; //prefix for tables $GLOBALS['prefix_cms'] = 'cms'; //prefix for tables $GLOBALS['prefix_scs'] = 'conference'; //prefix for tables $GLOBALS['prefix_kms'] = 'kms'; //prefix for tables

Nota: il codice deve essere copiato prima del simbolo ?>

4) Ora copiate tutti i file di docebo 3.0 nelle directory che li dovrebbero contenre (non sovrascrivete la directory "files" che avete già sistemato) e lanciate le directory upgrade/ o patch/ e seguite le istruzioni- Nota: attendere fino a che le pagine di upgrade abbiano finito di lavorare prima di cliccare!

Installare patch a docebo 3.x

Esistono due tipi di patch, una che sostituisce solo i file, l'altra che cambia anche la struttura del database.

• Step 1 sovrascrivere i file che devono essere aggiornati• Step 2 consiste nel lanciare le directory upgrade/ o patch/ per l'aggiornamento del database• Step 3 eliminare le directory upgrade/ o patch/

Backup docebo 3.x

Esistono 3 tipi di backup:

• Files backup, copiare tutta la directory files, questo farà backup di learning object, immagini, avatar e file caricati.

• Database backup, usando phpmyadmin (fare riferimento al capitolo successivo) potete fare un backup totale del database, in questo caso salvereste solo i dati

• Backup totale: Scaricare tutti i file e fare un backup del database

Suggeriamo di fare un backup periodico totale e di usare questi backup per testare gli upgrade più impegnativi.








A.12 Usare PHPMyadmin (e comandi di shell)

Per poter creare database è necessario poterlo amministrare. Un ottimo strumento per farlo via Browser è il PHPMyadmin. Installarlo in locale è semplicissimo, basta scompattare il file che scaricherete dal sito ufficiale di PHPMyadmin, copiare la cartella phpmyamdin nella cartella www e richiamare la schermata digitando questo indirizzo:

http://localhost/phpmyadmin/ e troverete la schermata inziale che è questa:

Se state lavorando in locale non preoccupatevi dei messaggi di Warning che vi vengono proposti. Nel caso doveste installare PHPMyadmin su un server remoto (Potrebbe essere necessario se il vostro provider non vi mette a disposizione questa interfaccia) è necessario configurare il file config.inc.php

Una volta richiamato il vostro phpmyadmin ( in locale sarà http://localhost/phpmyadmin/ ) avrete, nella prima schermata, la possibilità di:

• Selezionare, attraverso un menu a tendina, un database esistente

• Creare un nuovo database

Una volta effettuata l'operazione desiderata arriverete all'interfaccia di gestione del vostro PHPMyadmin. Le nuove versioni hanno un menu di navigzione posizionato in alto che consente di:








• Vedere la struttura del database

• Effettuare operazioni sql (Es. Caricare un database preesistente)

• Fare un Backup del database

• Cercare dati

• Visualizzare struttura delle query (utile per i programmatori)

• Elimnare un database (ATTENZIONE!!!)

Relativamente alle funzioni a noi necessarie ci serve analizzare soltanto i primi 3 menu.

Structure: Presenta l'elenco delle tabelle presenti nel database fornendoci una serie di opzioni:

• Browse: Serve a vedere il contenuto della tabella

• Select: Serve a fare delle interrogazioni alla tabella

• Insert: Serve ad inserire nuovi dati nella tabella

• Properties: Visualizza la struttura della tabella

• Drop: Elimina la tabella (ATTENZIONE!!!)

• Empty: Svuota la tabella del suo contenuto (ATTENZIONE!!!)

Le domande più frequenti sono:

D: Come faccio ad eliminare un solo record dalla tabella?

R: Scegliere la tabella di interesse, Cliccare su Browse e scegliere Delete relativamente al record da eliminare.

D: Se la password è in MD5 come posso inserirla facendo in modo che mantenga quell'algoritmo di cryptaggio?

R: Scegliere la tabella, cliccare Browse, cliccare su Edit e inserire, in chiaro, la password da sostituire. Selezionare dal menu a tendina Function di fianco al campo della password la funzione desiderata (nel nostro caso md5).








SQL: Questa parte del menu serve a caricare dati interi o database già esistenti. L'utilizzo è molto semplice, basta “sfogliare” il prorio PC alla ricerca del file del database ( generalmente è un file con estensione .sql ma si trovano anche con estensione .sql.php .txt .php ecc ... ). Questo strumento è utile per caricare nuovi database ma anche per caricare nuove parti di database a aggiungendole a DB già esistenti.

Non è detto che tutte le operazione di caricamento dei files vadano a buon fine, in particolare questo può accadere quando si è fatto un backup di files troppo grossi o con versioni diverse del PHPMyadmin. La soluzione alternativa può essere quella di copiare nella finestra di testo il contenuto testuale del file.sql. Questa seconda soluzione risolve il 90% dei problemi.

Una ulteriore alternativa (ultima spiaggia) è quella di agire da console di comando con la seguente istruzione:

mysql database -u user -h host .p pass < file.sql

Dove • database = nome del database• user: nome utente• pass: password• file.sql: Nome del file da caricare

Ricordiamo di salvare il file in una directory raggiungibile via Ftp in modo da poter scaricare il backup.








Export: Questa funzione è importante per effettuare backup del nostro database. La console di gestione che ci viene presentata è abbastanza articolata:

Nella parte centale abbiamo la lista delle tabelle del database, nella parte di sinistra le opzioni di salvataggio, quelle che ci interessano sono:

• Structure Only: Salva la struttura del database ma non i dati in essa contenuti• Structure and data: Salva sia la struttura che i dati• Data Only: Salva solo i dati ma non la struttura del database• Xml: Salva in formato XML

Le opzioni riportate sotto sono relative alle peculiarità che il file salvato deve avere:• Add 'Drop Table': Aggiunge alle istruzioni della creazione della tabella anche una istruzione di distruzione

della tabella preesistente. (Esempio, se ho una tabella che si chiama pippo nel mio DB e carico una nuova tabella con lo stesso nome, l'istruzione di caricamento della nuova tabella si occuperà anche di cancellare quella vecchia, se non ci fosse l'istruzione di drop table la nuova tabella non verrebbe caricata e si genererebbe un messaggio di errore).

• Save as file: Salva il backup come file (Se spuntato il flag Bzipped il file verrà compresso).

Se nella lista delle tabelle non selezioniamo nulla il PHPMyadmin interpreterà questa istruzione come “salva tutte le tabelle”, nel caso volessimo fare un backup parziale potremo selezionare alcune delle tabelle tenedo premuto il tasto CTRL e cliccando con il mouse sulle tabelle desiderate.








Generalmente l'interfaccia di gestione PHPmyadmin è fornita di default dal provider che vi vende l'hosting, se lo installate su windows per lavorare in locale non necessita di nessun accorgimento particolare in termini di configurazione.Nel caso voleste installarla su Windows per leggere database che si trovano online o installarla nel vostro spazio web perché il vostro fornitore di Hosting non ve lo mette a disposizione potete configurare il tutto editando il file config.inc.php come segue:Supponedo che:Ip DB Server: 156.123.22.34User: PippoPassword: TopolinoNome Database: Minnie

Allora:

$cfgServers[1]['host'] = '156.123.22.34'; // MySQL hostname$cfgServers[1]['port'] = ''; // MySQL port - leave blank for default port$cfgServers[1]['adv_auth'] = false; // Use advanced authentication?$cfgServers[1]['stduser'] = ''; // MySQL standard user (only needed with advanced auth)$cfgServers[1]['stdpass'] = ''; // MySQL standard password (only needed with advanced auth)$cfgServers[1]['user'] = 'Pippo'; // MySQL user (only needed with basic auth)$cfgServers[1]['password'] = 'Topolino'; // MySQL password (only needed with basic auth)$cfgServers[1]['only_db'] = 'Minnie'; // If set to a db-name, only this db is accessible$cfgServers[1]['verbose'] = ''; // Verbose name for this host - leave blank to show the hostname$cfgServers[1]['bookmarkdb'] = ''; // Bookmark db - leave blank for no bookmark support$cfgServers[1]['bookmarktable'] = ''; // Bookmark table - leave blank for no bookmark support

Nel config.inc.php troverete più parametri di configurazione che si ripetono. Servono a getire DB in host diversi con la stessa interfaccia.

Il comando di backup attraverso shell è:

mysqldump -c -hlocalhost -uusername -ppassword nome_db > dump.sql

Dove:

– hlocalhost = host del DB– uusername = nome utente– ppassword = password– nome_db = nome del database– dump.sql = nome del file che verrà salvato

Attenzione, i parametri -h -u e -p e i dati che li compongono non dovranno avere spazi. Es. Utente ciccio -> -uciccio








A.13 Licenza di utilizzo di questa documentazione

Tu sei libero:

• di distribuire, comunicare al pubblico, rappresentare o esporre in pubblico l’opera

• di creare opere derivate

• di utilizzare l'opera per scopi commerciali.

Alle seguenti condizioni:

Attribuzione. Devi riconoscere la paternità dell'opera all'autore originario.

Condividi sotto la stessa licenza. Se alteri, trasformi o sviluppi quest’opera, puoi distribuire l’opera risultante solo per mezzo di una licenza identica a questa.

• In occasione di ogni atto di riutilizzazione o distribuzione, devi chiarire agli altri i termini della licenza di quest’opera.

• Se ottieni il permesso dal titolare del diritto d’autore, è possibile rinunciare a ciascuna di queste condizioni.

Le tue utilizzazioni libere e gli altri diritti non sono in nessun modo limitati da quanto sopra.

Questo è un riassunto in lingua corrente dei concetti chiave della licenza completa (codice legale).

Limitazione di responsabilità








docebo lms, cms, kms manuale di installazione · un learning management system è uno strumento per...

Documents