Capitolo 3:

Installare Envolution

Sarete lieti di sapere che l’installazione di Envolution è molto semplice col seleziona e clicca. Descriviamo qui la procedura:

Prima di procedere

REGOLA NUMERO UNO: FATE SEMPRE UNA COPIA DEL VOSTRO DATABASE E DEI FILE PRIMA DI INSTALLARE QUALSIASI SOFTWARE.

Per non dover ripetere questa regola importante nei seguenti capitoli, vi inviterò semplicemente a rileggere la regola numero uno.

Per prepararsi adeguatamente all’installazione di Envolution, bisognerebbe avere tutte le informazioni e gli strumenti necessari. L’unico requisito assoluto per installare Envolution, premesso i requisiti di sistema suddetti, è un browser web. Ma alcuni altri strumenti faciliteranno l’installazione e la gestione. Perciò vi consigliamo l’utilizzo di alcuni strumenti di amministrazione di database. Per il database MySQL consigliamo phpMyAdmin che potete trovare all’indirizzo http://phpmyadmin.sourceforge.net.

Questo software è un’interfaccia web Open Source per MySQL ed è molto semplice da installare e da configurare. Comunque non è essenziale. Se siete su un server di hosting e non sapete creare un database, per la vostra installazione iniziale di Envolution dovete rivolgervi all’amministratore del server e chiedergli di creare un database MySQL per voi. Assicuratevi di ricevere il nome utente e la password per il database, se sono diversi dai vostri dati di registrazione, perché vi serviranno per la connessione al vostro database.

Avete anche bisogno di un client FTP o SSH, con SCP, per trasferire i file dal vostro computer alla vostra cartella web sul server. Suggeriamo un minimo di 20 MB di spazio su disco per installare Envolution.

Step 1: Scaricare il programma

Scaricare Envolution da http://www.envolution.com oppure la versione tradotta in italiano dal sito http://www.envolution.it . Salvare il pacchetto compresso in una cartella temporanea e decomprimere (gli utenti più smaliziati possono scaricare il pacchetto e decomprimerlo direttamente nella cartella del server…ricordate la regola numero uno).

Step 2: Trasferire i files nella www root

Trasferire il contenuto della sottocartella html dalla cartella temporanea dove avete decompresso il pacchetto di Envolution via FTP o SCP alla cartella sul web (che chiameremo cartella root).

Step 3: Controllare i permessi dei files

Settare gli attributi corretti ai file config.php e config-old.php che ora si trovano nella cartella root, cioè principale

Su sistemi UNIX basta digitare:

chmod 666 config.php

chmod 666 config-old.php

Poi selezionare la cartella /themes/Envolved e digitare:

chmod 777 xcache

oppure

chmod 777 /themes/Envolved/xcache

Questo passaggio è necessario per ogni "skin" (tema) che si trova nella cartella /themes del vostro sito. Ripetere semplicemente il procedimento descritto per il tema Envolved. Così:

chmod 777 /themes/DuskyBlue/xcache

chmod 777 /themes/LiquidLogic/xcache

chmod 777 /themes/Envolved/xcache

chmod 777 /themes/LogicII/xcache

chmod 777 /themes/PiterpanV2/xcache

chmod 777 /themes/X-Indus/xcache

Per default Envolution contiene 7 temi, sei dei quali richiedono il chmod della sottocartella xcache per essere eseguiti.

Se si sta aggiornando da PostNuke .714 bisogna dare il chmod 644 al file /install/Encompass.php e al file /install/pn714.php in questo modo:

chmod 644 /install/Encompass.php

chmod 644 /install/pn714.php

Man mano che verranno aggiunti script di aggiornamento e nuovi temi, bisognerà ripetere questi passaggi. Per esempio quando sarà completato lo script di aggiornamento per PHP-Nuke, bisognerà fare il chmod a 644 allo script di aggiornamento.

Sotto Windows rimuovere l’attributo di sola lettura dei file config.php e config-old.php digitando:

attrib -r config.php

attrib -r config-old.php

Se state usando NTFS assicurarsi di avere i permessi appropriati su file e cartelle. Le cartelle xcache presenti in ogni sottocartella dei temi di /themes non hanno invece bisogno degli attributi chmod, in quanto Windows non li utilizza.

Un’altra considerazione importante riguarda le impostazioni PHP. Le recenti versioni di PHP hanno impostate le register_globals , che per l’installazione devono essere settate su “ON”. Ciò può essere fatto settando il file php.ini così:

register_globals = On

Nello stesso file si può notare che PHP concede agli script per default solo 8MB di memoria. Si può modificare la quantità di memoria disponibile come segue: (considerando p.es. di concedere 20MB di memoria)

max_execution_time = 60 ; Tempo massimo di esecuzione dello script in secondi

memory_limit = 20M ; Quantità massimo di memoria diponibile per lo script

Per chi non ha accesso al php.ini (siti ospitati su host virtuali, p.es.) e invece al file .htaccess, può configurare questo come segue:

php_flag register_globals on

Se neanche questo è possibile, vuol dire che il vostro provider ha disabilitato qualsiasi modifica e non vi resta altro da fare che contattarlo e richiedere queste impostazioni.

Altre impostazioni del file .htaccess molto utili per server di tipo Apache sono:

ErrorDocument 500 /error.php

ErrorDocument 404 /error.php

ErrorDocument 403 /error.php

ErrorDocument 402 /error.php

ErrorDocument 401 /error.php

ErrorDocument 400 /error.php

Queste istruzioni indicano i percorsi dei messaggi d’errore sul vostro sito. Per default Envolution mostra un messaggio d’errore abbastanza umoristico: provate a trovarlo. Da notare che il percorso per il file error.php è assoluto. Di conseguenza se error.php si trova nella root del sito, non bisogna fare nessuna modifica nel percorso, altrimenti bisogna indicare il percorso esatto del file.

Ulteriori informazioni sul file .htaccess si possono trovare p. es. all’indirizzo http://codesorcery.net/authentication/resources.html

Step 4: Lanciare l'installazione

Lanciate il vostro browser web e digitate l’indirizzo del vostro sito nella barra degli indirizzi. Per esempio: http://www.miosito.com/install.php (oppure per i siti in locale o intranet http://localhost/install.php ).

Step 5: Selezionare la lingua

Selezionare la lingua che volete usare nell’installazione di Envolution e cliccate su set language. English è la lingua preimpostata.

Per default Envolution è preimpostato sulla lingua inglese, ma ogni sito di supporto internazionale offre la versione nella propria lingua. Una lista degli indirizzi web del Supporto Internazionale lo trovate aggiornato su http://www.envolution.it/envlist.html .

Envolution presenta un nuovo metodo esclusivo per l’installazione: con i files appropriati di installazione e di lingua è il primo CMS che offre una installazione multilingua e specifica nella lingua prescelta. Ciò significa che una volta scelta la lingua, a differenza degli altri CMS, Envolution presenta il sito già con tutti i menu, le selezioni ed i contenuti nella lingua prescelta.

Siamo i primi tra i maggiori CMS a offrire questo servizio. E la lista delle lingue disponibili continua ad allungarsi…

Step 6: Licenza

Leggere l’accordo di licenza e cliccare su "Continua" se siete d’accordo. Se non accettate i termini della licenza, allora chiudete il vostro browser e cancellate tutti i file che compongono Envolution. A questo punto nessuna modificazione o alterazione o aggiunta è stata fatta al vostro database eccetto per i file che avete caricato nella vostra cartella web principale.

Step 7: Controllo dei dati

Questo passaggio nel processo d’installazione è un doppio controllo sulla correttezza degli attributi dei file config.php e config-old.php e delle cartelle xcache suddette.

Se non sono corretti, verrà visualizzato un messaggio che spiega cosa fare per poter procedere. Se le impostazioni sono corrette, scorrere la pagina verso il basso e cliccare su "continue".

Step 8: Impostazione dei dati del DB/Administrator

Viene presentato un modulo da compilare con i dati necessari alla connessione al database. Le informazioni richieste sono:

Una volta completato questo passaggio, cliccare su "submit" per continuare.

Step 9: Controllo dati DB/Amministatore

Con questa finestra si ha l’opportunità di modificare le informazioni appena inserite nel passaggio precedente. Controllare con cura i dati inseriti. Per modifiche cliccare su "Change info" per tornare alla pagina precedente.

Se i dati sono corretti, cliccare su "New Install" (NOTARE: gli aggiornamenti saranno spiegati in modo approfondito in un altro capitolo).

Allo stato attuale sono supportati gli upgrade da PostNuke .714, ma stiamo lavorando agli scripts di upgrade per le altre versioni di PostNuke e anche per PHP-Nuke. Consultare il sito http://www.envolution.it per ulteriori sviluppi ed assistenza,

Step 10: Crea il Database

Questa finestra mostra i dati usati per creare il database e per installare le tabelle nel database stesso. Se si ha il permesso di creare un database sul server allora spuntare la casella "Create the database".Se il vostro provider ha già creato il database per voi, lasciate la casella non spuntata.

Cliccare su "Start" per creare e/o riempire il database.

Step 11: Controllo dei risultati della Sql

Questa pagina mostra le tabelle inizialmente installate nel vostro database. Se non ci sono errori, cliccare su "Continue" per proseguire.

Step 12: Dati del superuser

Questa pagina permette la scelta del nome utente e della password per il superutente del sito.

È necessario crearlo ora. Il superutente ha l’accesso completo a tutte le funzioni e strumenti del vostro sito Envolution.

Bisogna scegliere un nome utente e una password con cura ed assicurarsi che nessuno possa avere accesso a queste informazioni. Consigliamo di scegliere un nome utente e una password differenti da quelli scelti per la registrazione e per il database.

Usare password di almeno otto caratteri e inserire lettere, numeri, ma anche altri segni come punti interrogativi, ecc.

Una volta scelti nome utente e password per l’amministratore/superutente, inserire l’indirizzo di mail dell’amministratore e l’indirizzo web del sito. Cliccare su "Set login".

Se non si ricorda più la password dell’Amministratore dopo il completamento dell’installazione, si può sempre riconfigurare la password inserendo il seguente comando nel vostro database MySQL:

UPDATE envo_users SET pn_pass=MD5('mianuovapassw') WHERE pn_uname='Admin';

Assicurarsi di modificare envo_ col prefisso usato e pn_name col nome creato per l’Admin. La nuova password deve essere inserita tra gli apici al posto di mianuovapassw.

Step 13: Immissione dei dati generali di Envolution

Questa pagina aggiorna le tanelle definitive del vostro database MySQL. Se non ci sono errori, cliccare su "Finish" per completare la vostra installazione di Envolution.

Se vi vengono segnalati degli errori, segnatevi i messaggi d’errore e se non sapete proprio come risolverli, visitate i nostri siti web all’indirizzo http://www.envolution.com oppure http://www.envolution.it e registratevi gratuitamente. Una volta registrati, potete rivolgervi al forum di discussione o iscrivervi alla mailing list per ricevere il supporto per il vostro nuovo sistema Envolution

Fate una ricerca sui forum per vedere se il vostro problema o errore non sia già stato postato. In questo modo si trova spesso velocemente la soluzione ai problemi più comuni.

Envolution ha anche una lista di FAQ (domande poste più frequentemente) con le esperienze degli altri membri della comunità. Si accede alla lista delle FAQ dal menu principale del sito di Envolution.

Magari il miglior modo per ricevere aiuto in tempi brevi è proprio l’iscrizione alla mailing list degli utenti di Envolution o a quella degli sviluppatori di Envolution. Envolution utilizza eccellenti programmi di mailing list che permettono a chiunque di iscriversi, togliersi e visionare all’archivio della lista da un qualsiasi browser web. Una semplice interfaccia punta e clicca facilita la gestione della propria sottoscrizione. L’indirizzo della mailing list lo trovate sempre nel menu principale dei siti ufficiali di Envolution: http://www.envolution.com e http://www.envolution.it .

Step 14: I Credits

L’ultima pagina riguarda i "Credits". C’è il riepilogo breve dei nomi dei fondatori e sviluppatori che lavorano a Envolution.

Avvisa anche di cancellare il file install.php e la cartella /install directory dalla vostra cartella web principale.

Deve essere fatto immediatamente per evitare che qualcuno possa accedere al nome utente e alla password del vostro database MySQL.

Evitate anche che qualcuno lanci di nuovo il programma d’installazione sovrascrivendo le scelte da voi fatte.

Dopo aver letto le informazioni della pagina e cancellato il file install.php e la cartella /install dalla vostra cartella web principale, cliccare su "Go to your Envolution powered website" per vedere il risultato dell’installazione effettuata.

Non fermatevi! Servono ancora molte informazioni per utilizzare ed apprezzare la potenza di un sistema di gestione di qualità come Envolution.

Speriamo che l’installazione sia andata liscia e che possiate concentrarvi di più sui contenuti del vostro nuovo sito Envolution per soddisfare al meglio i vostri utenti. Gustatelo!

Continuate a leggere questo manuale per imparare a controllare la potenza che Envolution vi offre per gestire il vostro sito web.

Step 15: Il primo accesso al sito

Ora potete accedere al vostro sito appena installato. Sarà simile all’immagine in basso. Tutti i dati che vedete nel vostro sito Envolution possono essere modificati in modo molto semplice a vostro piacimento.

Ma prima dobbiamo imparare ancora alcune cose.

A questo punto puoi accedere scrivendo la tua login nella casella “superuser login name” e naturalmente la password nella casella "User's Login" e confermando i dati sul bottone “login”

I control box degli “user” sono a destra nella finestra e circa a mezza pagina verso il basso.

Sotto queste caselle troverai anche il control box "Remember me" come mostrato nella figura (user’s login qui accanto), ma per ora puoi pure ignorarlo.

Piu tardi scopriremo l’uso anche di questo paramentro.

Scrivi il tuo nome , ricordati che sei l’amministratore, la tua password e premi il bottone "Login" per entrare nel tuo nuovo web, naturalmente come amministratore  .

A questo punto, (se non ti interessa l’aggiornamento di installazione precedenti) puoi saltare al capitolo 5.

Capitolo 4:

Aggiornare le installazioni precedenti

Eseguire l’aggiornamento delle vecchie installazioni di Envolution è molto semplice e simile a quanto descritto nel capitolo 3.

L’unica differenza sta nello “Step 9” dove anzi che cliccare su “nuova installazione” (New Install} devi semplicemente premere il bottone "Upgrade".

Una volta che avrai premuto "Upgrade" ti sarà presentata una finestra nella quale saranno richieste per l’aggiornamento dell’ installazione esistente di Envolution o una delle diverse CMS disponibili.

Nel caso di versione 1.0.0 lo script automaticamente disabilita la possibilità di Upgrade in quanto non esistono precedenti versioni.

Ricordarsi di fare il chmod a 644 al file /install/Encompass.php e al file /install/pn714.php prima di fare l’upgrade.

È però possibile aggiornare facilmente altri CMS come PostNuke, nella versione 0.713 e 0.714 , purtroppo per ora- manualmente i files contenuti nel file di installazione compresso nella vostra PostNuke root web directory (normalmente ./www/postnuke/). Questo metodo richiede ancora degli aggiornamenti da eseguire abbastanza noiosi, come l’aggiornamento delle tabelle del database, ma la procedura e relativamente semplice e sarà presto completata