CREAZIONE DI UN SOTTOSITO
REDAZIONE Revisione Redatto da Funzione Data Approvato da Funzione Data 00 Silvia Governatori Analista funzionale junior 28/01/2011 REVISIONI Revisione 00 Prima emissione Descrizione Data ultima stampa DD/02/YYYY 16:02:00 A2/P2 Pag. 2 di 17
INDICE INDICE DELLE FIGURE...4 INTRODUZIONE...6 1 CREAZIONE E PREPARAZIONE DEI FILE...7 2.1 Creazione dei File...7 2.2 Diritti e permessi (solo per macchine linux)...8 2.3 Compilazione file di configurazione...9 2 MODIFICA DELLE TABELLE NEL DB...10 3.1 Modifica tabelle...10 3.2 Tabella Sottositi...11 3.3 Tabella System...12 3.4 Tabella Templates...12 3.5 Tabella Gruppi...12 3.6 Tabella Indici...13 3.7 Tabella Gruppi_Indici...13 3.8 Tabella VociIndice...13 3.9 Tabella Servizo (potrebbe essere personalizzata)...14 3.10 Tabella StiliOggetti...14 4 CONFIGURAZIONE APACHE...15 4.1 Primo controllo...15 5 PAGINE DI SISTEMA...16 6 GRAFICA...17 Data ultima stampa DD/02/YYYY 16:02:00 A2/P2 Pag. 3 di 17
Indice delle figure Figura 1: tabella sottositi...11 Figura 2: tabella system...12 Figura 3: tabella templates...12 Figura 4: tabella gruppi...12 Figura 7: tabella voci indice...13 Figura 8: tabella servizio...14 Figura 9: tabella stili oggetti....14 Data ultima stampa DD/02/YYYY 16:02:00 A2/P2 Pag. 4 di 17
GLOSSARIO APACHE È il nome dato alla piattaforma server Web modulare più diffusa in grado di operare da sistemi operativi UNIX-Linux e Microsoft. Apache è un software che realizza le funzioni di trasporto delle informazioni, di internetwork e di collegamento, ha il vantaggio di offrire anche funzioni di controllo per la sicurezza come quelli che compie il proxy..ini Estensione di un file di inizializzazione. È un formato di file testuale utilizzato da numerosi programmi per la memorizzazione delle opzioni di funzionamento dei programmi stessi. NETWORK E-ntRA È l insieme dei siti di una installazione del CMS E-ntRA. RECORD È un oggetto di un database strutturato in dati che contiene un insieme di campi o elementi, ciascuno dei quali possiede nome e tipo propri. Solitamente un record è formato nei database (ad esempio Microsoft Access) dalla riga nella tabella. Si può considerare un insieme di due dati: un puntatore e il dato vero. Il puntatore è l'informazione che deve avere il dato. Data ultima stampa DD/02/YYYY 16:02:00 A2/P2 Pag. 5 di 17
INTRODUZIONE In questo manuale viene descritta la procedura per la creazione di un nuovo sottosito all interno del network e-ntra. Prima di procedere con le fasi di creazione del sottosito, assicurarsi di avere le abilitazioni necessarie per modificare il i file sul sistema, gestire i permessi di accesso (nel caso si lavori con ambiente linux), e modificare le tabelle utilizzate da e-ntra nel database. Data ultima stampa DD/02/YYYY 16:02:00 A2/P2 Pag. 6 di 17
CREAZIONE E PREPARAZIONE DEI FILE 2.1 Creazione dei File Questa fase prevede che il pacchetto base di e-ntra sia già presente nel file system. Ipotizziamo, per questo esempio, che la cartella che contiene il pacchetto e-ntra si chiami Pacchetto. Se tale cartella non è già presente, è buona norma crearla duplicando la cartella che contiene il sito base, avendo cura di svuotare le cartelle ModEditCustom, Download e Immagini. ATTENZIONE : All interno della cartella Immagini ci sono delle immagini di sistema come (00274.gif, 06113.gif, cestino1.gif) che vengono utilizzate all interno dell area di amministrazione. Questi file non sono da cancellare. Sono da mantenere inoltre le cartelle Icone e Templates. Ipotizziamo, inoltre, di voler creare il sottosito chiamato Sottosito02. Creare una nuova cartella allo stesso livello di pacchetto, nominandola Sottosito02. Nella cartella andranno copiate le seguenti cartelle: CACHE Config Download Immagini LogAccessi ModEditCustom Multimedia P3P RSS Templates XML XSL Se si lavora sotto linux, creare dei link alle seguenti cartelle che si trovano nella cartella Pacchetto : Admin Engine SetUP UserExit Il comando è: ln s../pacchetto/admin ln s../pacchetto/engine ln s../pacchetto/userexit Data ultima stampa DD/02/YYYY 16:02:00 A2/P2 Pag. 7 di 17
2.2 Diritti e permessi (solo per macchine linux) In linux, tutte le cartelle devono essere leggibili, scrivibili e modificabili dall utente di apache (tipicamente www-data). Quindi, usando i seguenti comandi chown -Rf [utente]:[gruppo] chmod Rf 751 si impostano correttamente i permessi di accesso. Su windows questo passaggio non è necessario. Data ultima stampa DD/02/YYYY 16:02:00 A2/P2 Pag. 8 di 17
2.3 Compilazione file di configurazione Nella cartella Config, sono locati i file di configurazione. In questa fase vanno modificati i seguenti file: Config.ini Modificare: RARoot, RAFSRoot Ad esempio: RARoot = http://www.pacchetto.it/sottosito02 RAFSRoot = /var/www/html/sottosito02 ConfigAdmin.ini Modificare: RARootAdmin, RAFSRootAdmin, ModEditCustom Ad esempio: RARootAdmin = http://www.pacchetto.it/sottosito002/admin RAFSRootAdmin = /var/www/html/sottosito02/admin ModEditCustom = /var/www/html/sottosito02/modeditcustom/ ATTENZIONE: se si lavora in ambiente windows, nel modificare i config, prestare attenzione al fatto che le cartelle Admin ed Engine non sono nella RARoot, quindi controllare i collegamenti in tutto il file. Data ultima stampa DD/02/YYYY 16:02:00 A2/P2 Pag. 9 di 17
MODIFICA DELLE TABELLE NEL DB 3.1 Modifica tabelle Le tabelle interessate alla modifica sono: Sottositi System Templates Gruppi Gruppi_Indici Indici Servizi (solo in caso di personalizzazioni). In linea generale, per ciascuna di queste tabelle, duplicare i record del sito principale (di norma 001 ), cambiando il codice sottosito con quello nuovo (nel nostro caso 002 ). NOTA: I codici delle successive tabelle che iniziano per ER o quelli WWW presenti nel campo indicante il Sottosito sono codici di test e non sono da considerare. Data ultima stampa DD/02/YYYY 16:02:00 A2/P2 Pag. 10 di 17
3.2 Tabella Sottositi Figura 1: tabella sottositi Nella duplicazione della riga 001 in 002, compilare i campi, facendo riferimento a quanto sotto riportato: T29_Id_SottoSito I codici sottosito sono sequenziali (001, 002, 003 etc). Es: 002. T29_Desc_SottoSito Il nome del sottosito, viene visualizzato in amministrazione. Es: Sottosito02. T29_DB Il nome dil DB Es: Entra. T29_Server_Name Inserire il nome del server. Normalmente esso è lo stesso del sito principale. Es: www.pacchetto.it. T29_Script_Name Inserire il nome del sottosito. Normalmente è lo stesso della cartella creata. Es: Sottosito02 T29_Config_Name Percorso nel file system del file Config.ini, partendo dalla root principale. Es per linux: var/www/html/sottosito02/config.ini. Es per windows: C:Programmi/Apache/Sottosito/Config.ini T29_Admin_Name Percorso nel file system del file ConfigAdmin.ini, partendo dalla root principale. Es per linux: var/www/html/sottosito02/configadmin.ini. Es per windows: C:Programmi/Apache/Sottosito/ConfigAdmin.ini. T29_ConfigBatch Percorso nel file system del file ConfigBatch.ini, partendo dalla root principale. Es per linux: var/www/html/sottosito02/configbatch.ini. Es per windows: C:Programmi/Apache/Sottosito/ConfigBatch.ini. T29_VisRicerca Può essere lasciato vuoto. Data ultima stampa DD/02/YYYY 16:02:00 A2/P2 Pag. 11 di 17
3.3 Tabella System Figura 2: tabella system Ci sono 7 righe da duplicare inserendo il nuovo codice Sottosito come riprodotto nella tabella: <nuovo codico sottostio> CSSDEFAULTBROWSER RABrowser <nuovo codico sottostio> FONTCSSDEFAULT 01 <nuovo codico sottostio> HOMEPAGE 25001xxx0409 <nuovo codico sottostio> INDEXDEFAULT 01 <nuovo codico sottostio> LANGUAGE 0 <nuovo codico sottostio> TEMPLATEDEFAULT 03 <nuovo codico sottostio> TEMPLATEDEFMAIN vuoto xxx = nuovo codice sottosito 3.4 Tabella Templates Figura 3: tabella templates In questa tabella sono censiti i telai usati dal sito. A meno di personalizzazioni, essi sono: 01 ServizioRA 02 RAPrint 03 3Colonne 04 2ColonneSX 05 2ColonneDX 06 1Colonne 3.5 Tabella Gruppi Figura 4: tabella gruppi Data ultima stampa DD/02/YYYY 16:02:00 A2/P2 Pag. 12 di 17
In questa tabella bisogna duplicare le righe dei gruppi di utenti creati se si intende mantenerli per il nuovo sito (va inserito almeno Pagine di Servizio (0001) e Redazione(0002)). 3.6 Tabella Indici Figura 5: tabella indici In questa tabella bisogna duplicare gli indici che si vogliono mantenere nel nuovo sottosito. Vanno inseriti, almeno, 01 ServizioRA 02 Footer 03 Home 04 Metanavigazione 05 FontAAA 06 Lingue 3.7 Tabella Gruppi_Indici Figura 6. tabella gruppi indici In questa tabella bisogna duplicare le righe degli indici creati nel vecchio sito che si vogliono mantenere. Vanno inseriti almeno i record relativi alle due tabelle viste prima. 3.8 Tabella VociIndice Figura 5: tabella voci indice Se si vuole che gli indici precedentemente creati riportino anche il loro contenuto, ovvero le loro voci di indice, nel nuovo sottosito duplicare le righe interessate nella tabella VociIndice in questo modo: es. se vogliamo duplicare le voci d indice dell indice Home (T31_Id_Indice 03 tab. Indici) si devono duplicare nella tab. VociIndice tutte le righe che hanno nel campo T32_Id_Indice Data ultima stampa DD/02/YYYY 16:02:00 A2/P2 Pag. 13 di 17
il valore 03 cambiando solamente il codice sottosito (T32_SottoSito) e mantenendo gli altri campi dei record uguali. 3.9 Tabella Servizo (potrebbe essere personalizzata) Figura 6: tabella servizio In questa tabella risiedono i servizi attivi per il/i sito/siti. Se si vuole riportare un servizio anche nel nuovo sottosito duplicare il record interessato ricordandosi di cambiare il codice sottosito e mettere nel campo T65_AttivaDisattiva 1 = Attivo. ATTENZIONE : L asterisco (*) nel campo T65_Id_SottoSito sta ad indicare che quel record vale per tutti i sottositi, quindi se si desidera mantenere lo stesso servizio per tutti i sottositi non bisogna inserire nessun record. 3.10 Tabella StiliOggetti Figura 7: tabella stili oggetti. In questa tabella bisogna duplicare i record che si vogliono mantenere nel nuovo sottosito se si vuole usare lo stesso stile degli oggetti (per la maggior parte riquadri) anche per il nuovo sottosito. ATTENZIONE : L asterisco (*) nel campo T133_Id_SottoSito sta ad indicare che quel record vale per tutti i sottositi, quindi se si desidera mantenere lo stesso stile degli oggetti per tutti i sottositi non bisogna inserire nessun record. Data ultima stampa DD/02/YYYY 16:02:00 A2/P2 Pag. 14 di 17
4 CONFIGURAZIONE APACHE Aggiungere, se necessario, nelle configurazioni di Apache la regola per cui l indirizzo internet del nuovo sottosito deve puntare alla cartella del nuovo sottosito. Nel nostro esempio: http://www.pacchetto.it/sottosito02 Deve puntare alla cartella Var/www/html/Sottosito02 ATTENZIONE: se si lavora in ambiente windows, devono essere creati anche gli alias: http://www.pacchetto.it/sottosito02/admin in Var/www/html/Pacchetto/Admin e http://www.pacchetto.it/sottosito02/engine in Var/www/html/Pacchetto/Engine 4.1 Primo controllo Ora è possibile fare una prima verifica di funzionamento del sito, digitando l indirizzo specificato nella tabella Sottositi. Nel nostro esempio: http://www.pacchetto.it/sottosito02 Si dovrebbe visualizzare una pagina completamente vuota, con la scritta pagina in costruzione, e la grafica del sito di pacchetto. Data ultima stampa DD/02/YYYY 16:02:00 A2/P2 Pag. 15 di 17
5 PAGINE DI SISTEMA Per poter iniziare a lavorare sul sito è necessario inserire le pagine di sistema. Sono definite pagine di sistema tutte le pagine il cui numero identificativo è inferiore a 2500. Per poter inserire le pagine di sistema, è necessario essere almeno loggati in amministrazione (per un qualunque sito). Quindi utilizzare le utilità di SetUp presenti solo nel sito principale http://www.pacchetto.it/setup Lì selezionare la voce Inserisci pagine di sistema, e compilare i campi nel seguente modo: utente database password database Database Host Driver nickname usato per apportare le modifiche al database relativa password nome del database dove si trova il sito (es: Entra) normalmente localhost. il tipo di database che si utilizza (mysqldb, sqlserver, access...) Completare l operazione creando una pagina che assumerà il numero di pagina 2500, e diverrà la nuova homepage. Data ultima stampa DD/02/YYYY 16:02:00 A2/P2 Pag. 16 di 17
6 GRAFICA Completate tutte le operazioni, si avrà un sito vuoto identico al sito di pacchetto. Agendo sul file./sottosito/templates/css/style_0.css è possibile personalizzare la grafica del sito. Le immagini della grafica si trovano nella cartella./sottosito/immagini/templates/ FINE DOCUMENTO Data ultima stampa DD/02/YYYY 16:02:00 A2/P2 Pag. 17 di 17