Installazione e configurazione della piattaforma alfresco

1. QBR | Novembre 2009
Installazione Alfresco

2. Argomenti Trattati
 Modulo 1: Introduzione ad Alfresco
 Modulo 2:Preparazione all’installazione
 Modulo 3: Installazione
 Modulo 4: Configurazione di base
 Modulo 5: Configurare il File System

3. Modulo 1
Introduzione

4. Cosa è….
 Gestore documentale Open Source
 E’ estendibile
 Modello dei Dati:Custom Content Model
 Servizi: Web Script, Web Service
 Licenza GPL3 (General Public License)
 Licenza Commerciale
 Il Modello Open Source consente di utilizzare i più
recenti contributi della comunità:
 Hibernate
 Open Office
 Lucene

5. Cosa è una piattaforma di ECM
 ECM raggruppa un insieme di tecnologie Content-Centric:
 Document Management (DM): Catalogare, Organizzare e
Condividere file Binari prodotti da software di Authoring
 Web Content Management (WCM): Creazione e Gestione di
contenuti destinati ad essere fluiti attraverso il Web
 Records Management (RM): Identificazione, Classificazione,
Archiviazione e Distruzione di Record (Pratiche elettroniche)
 Digital Asset Management: Archiviazione, Catalogazione,
Gestione, Ricerca full-text di risorse e contenuti digitali
(Video, Audio, Immagini)
 Collaboration: Strumenti che facilitano la collaborazione, la
condivisione di informazioni tramite Wiki, Blog, Siti Personali,
Calendari Condivisi..
 Search: supporto alla ricerca dei contenuti
2/73

6. La Nascita
 Alfresco è stata fondata nel 2005 da un gruppo di
persone provenienti dall’ECM Documentum®
 I progettisti di Alfresco hanno alle spalle più di 15
anni di esperienza nel settore degli ECM.
 I finanziatori sono aziende leader nel settore degli
investimenti
 SAP Ventures.
3/73

7. L’Obiettivo
 Fornire una soluzione Open Source di ECM
 Superare soluzioni commerciali:
 Documentum®
 Microsoft® SharePoint®
 In Termini di
 Caratteristiche
 Funzionalità
 Vantaggi per gli utenti
4/73

8. I Componenti Open Source
Componenti Open Source Funzionalità implementata
in Alfresco
Java 1.5
Spring 1.2 Aspect-Oriented Framework
MyFaces JSF Implementation Implementazione delle specifiche
JavaServer Faces (JSF) di Sun
JBoss App Server 4.0 Application Server
JBoss Portal 2.0 Portal
PDFBox – Open Source Java PDF
Library
JBoss jBPM Workflow Avanzati

9. I Componenti Open Source
Componenti Open Source Funzionalità implementata
in Alfresco
Apache Lucene Text Search Engine
Hibernate Persistenza del Database
FreeMarker Presentation per il Framework Web Script,
Views
Mozilla Rhino JavaScript Engine JavaScript engine
OpenSymphony Quartz Scheduling di processi asincroni.
Apache Axis Web Service
OpenOffice 2.0 Conversione di documenti office in PDF
Apache FOP Trasformazione di XSL:FO in PDF
Apache POI Java API per l’estrazione di Metadati da file
di Microsoft Office
ImageMagick Conversione di file di Immagini

10. Standards e Protocolli Supportati
Standard/Protocolli Note
FTP Il Contenuto può essere caricato nel
repository via FTP
WebDAV Permette di leggere e scrivere via HTTP sul
repository
CIFS Permette al repository di essere montato
come un disco condiviso
JSR-170-Java Content Alfresco è un JCR-compliant repository
Repository API
JSR-168-Java Portlet
Integration
SOAP Alfresco Web Services usa SOAP-based
web Services
RESTful API
LDAP LDAP Directory o Microsoft Active Directory
server

11. Modulo 2
Preparazione all’Installazione

12. I Passi da compiere
 Installare Java SE Development Kit (JDK) 6.0
(http://it.sun.com/)
 Installare Database - RDBMS Open Source MySQL (
http://dev.mysql.com/downloads)
 Configurare Alfresco con il Database
 Installare l’Application Server Tomcat
 Installare Open Office
 Installare ImageMagick
 Installare Flash Player 10.x
 Installare Alfresco
 Run di Alfresco

13. Installare Alfresco
Software Requirements

14. Installare Alfresco

15. Installare MySQL
 Scaricare il RDBMS MySQL (http://dev.mysql.com/downloads)
 E’ richiesta almeno la versione MySQL 5.0.67 o successive
 Avviare il MySQL Server Instance Configuration Wizard per configurare il server
 Verificare l’installazione: cmd <mysql –u root –p>
 Creare il DB Alfresco con account user e pass Alfresco
 In <alfresco>/extras/databases/mysql‘
 Eseguire il commando:
 mysql -u root -p <db_setup.sql
 Scaricare MySQL Java Connector library
http://dev.mysql.com/downloads/connector/j/
 Copiare il JAR file in <container>/common/lib or <container>/server/default/lib
 In tomcat/shared/classes/alfresco/extension modificare I file-
 custom-repository.properties
 comment out the HSQL connection lines (using #)
 uncomment the MySQL connection lines and adjust as appropriate
 custom-hibernate-dialect.properties
 comment out the HSQL line using #
 uncomment the MySQL line

16. Installare Alfresco su Tomcat 6
 Copiare Alfresco.war in <TOMCAT_HOME>/webapps
 Creare <TOMCAT_HOME>/Shared/classes e copiare la cartella
extension dal WAR
 Nel file <TOMCAT-HOME>/conf/catalina.properties sostituire
shared.loader=${catalina.base}/shared/classes,${catalina.base}/
shared/lib/*.jar
 Configurare le variabili di ambiente:
 JAVA_HOME
 JRE_HOME
 TOMCAT_HOME
 copiare la cartella lib e endorsed e i18n all’interno della cartella
common di Tomcat
 Aumentare la memoria della JVM
 se tomcat è installato come servizio
 se è installato da file .sh o .bat allora modificare i seguenti parametri
-Xms128Mb -Xmx256M

17. Componenti Aggiuntivi
 OpenOffice
 ImageMagick
 Microsoft Office Add-ins
 Flash Player
 SWF Tools
 SharePoint Protocol Support
 Language packs

18. Open Office
 Usato per trasformare i Documenti da un formato ad un
altro, ad esempio un file può essere trasformato da
formato testo a un file pdf.
 Scaricare OpenOffice.org dal sito
http://download.openoffice.org
 Installare il SW
 Modificare la riga
“ooo.exe=C:/Alfresco/OpenOffice.org/program/soffice.exe”
nel file “alfresco-global.properties

19. ImageMagick
 Usato per trasformare le immagini.
 Modificare nel file alfresco-global.properties in
<classPathRoot> in modo da farlo puntare alla root
directory di installazione
 Set img.root=C:/Alfresco/ImageMagick
 Set img.exe=C:/Alfresco/ImageMagick/bin/convert.exe

20. Microsoft Office Add-ins
 Usato per integrare Alfresco con Microsoft Office 2003/2007
 Scaricare il file alfresco-community-office2003-addins-3.2.zip
 Installare il .NET 2.0 Framework
 Eseguire le diverse installazioni per word, excel, powerpoint
 Eseguire un Office Application (Word)
 In Web Client URL:
 WebDAV: http://server:8080/alfresco/webdav/
 CIFS: server_aalfresco
 Inserire User e Pass per Autenticarsi

21. Flash Player e SWF Tool
 Ver. 10.x - Usato per visualizzare la funzionaltà seleziona file
su Alfresco Share
 Pdf2swf è usato per effettuare il previewing di file PDF.
 Modificare il file alfresco-global.properties swf.exe=C:/Alfresco/
bin/pdf2swf

22. Packs Language
Scaricare la traduzione Italiana dal sito
http://tinymce.moxiecode.com/download_i18n.php
 Unpack i file:
 Explorer: <TOMCAT_HOME>/webapps/alfresco/scripts/tinny_mce
 Share: <TOMCAT_HOME>/webapps/share/modules/editors/tinny_mce

23. Lanciare Alfresco
 Windows C:alfresco  alf_start.bat
 Linux /opt/alfresco  alfresco.sh
 Server statup in nnnn ms  ok
 Browse:http://localhost:8080/alfresco.

24. Modulo 3
Configurazione di base

25. File Global Properties
 Il File alfresco-global.properties contiene le
customizzazioni per estendere Alfresco
 $TOMCAT_HOME/shared/classes/
 Configurare la dir.root “Dir.root=C:/Alfresco/alf_data”
 Configurare la connessione al DB:
 Selezionare il Driver JDBC per il DB usato
 Set Hibernate dialect per il proprio DB

26. Modulo 4
Configurare il File System

27. Configurare SMB/CIFS
 2 tipi di implementazioni:
 Java – Tutte le piattaforme
 Implementazione Java socket based del protocollo SMB/CIFS che
può essere usato su ogni piattaforma
 NetBIOS – Windows Only
 Interfaccia specifica di Windows che usa chiamate Win32 NetBIOS
API via JNI code (default su Windows)
 Le seguenti proprietà possono essere configurate per il
SMB/CIFS Server
 Cifs.enable = abilita il CIFS Server
 Cifs.serverName= specifica l’host name dell’Alfresco CIFS Server
 Cifs.domain= domanio o workgroup
 Cifs.sessionTimeout = specifica la sessione di timeout CIFS
 Cifs.broadcast= specifica la maschera per la rete

28. Configurare SMB/CIFS
 Copiare i due file vti-context.xml e vti.properties che si trovano in
alfrescoWEB-INFclassesalfrescomoduleorg.alfresco.module.vticontext in
sharedclassesalfrescoextension
 Configurare i File con i propri parametri personalizzati

29. Configurare FTP Server
 La configurazione del Server FTP:
 ftp.enabled= abilita il server FTP
 ftp.port= specifica la porta FTP (default 21)
 rootDirectory= specifica il path della directory root

30. Configurare NFS Server
 Deve essere attivata la connessione TCP
 Nfs.enable= abilita o disabilita il Server NFS

31. Modulo 5
Configurare l’EMAIL Server

32. Configurare email server
 file alfresco-global.properties

33. Configurare RMI email service
 Run email server in una diversa JVM e server
interagendo con Alfresco server tramite Remote Method
Invocation (RMI)
 Cartella <configRoot>classesalfresco
 File remote-email-service-context.xml
 Modifica la configurazione RMI

34. Configurare email service
 Modifica delle proprietà dell’email server
 Cartella <configRoot>classesalfresco
 Custom-email-server.properties
 Email-service-context.xml

35. Configurare il protocollo IMAP
 Integrazione fra il repository e i Client di posta: Outlook,
Apple Mail, Thunderbird)
 IMAP mount points definisce le Cartelle che possono
essere visualizzate dal Client IMAP
 Abilitare il protocollo IMAP: alfresco-global.properties

36. Bibliografia
http://wiki.alfresco.com/wiki/Main_Page
http://ecmarchitect.com/
 www.alfresco.com
 www.qbrservice.it/Wiki Qbr

37. Contatti
Grazie per l’Attenzione!
Ing. Mirco Leo
QBR ENG.
mirco.leo@qbreng.it
QBR web site: http://www.qbrgroup.it