sabato 26 febbraio 2011

Installare Alfresco in modalità testuale su server Linux

Il nuovo installer BitRock per Alfresco consente di installare il prodotto insieme a tutte le componenti accessorie (jvm, Tomcat, Mysql, Openoffice, Imagemagick, ...) in maniera molto semplice e veloce.
Spesso però è necessario installare Alfresco su una macchina che non dispone di interfaccia grafica, ma alla quale possiamo accedere da remoto solo via terminale a caratteri, ad esempio tramite ssh ed scp. In questo caso o si rinuncia ad usare l'installer e invece si procede alla installazione e configurazione manuale di tutte le singole componenti, oppure si può comodamente continuare ad usare l'installer nella sua modalità testuale. Di seguito una descrizione di come procedere.

Nel nostro caso descriveremo una installazione effettuata su un server remoto Linux Ubuntu 10.04 (Lucid) a 64 bit. (nota: da Alfresco EE 3.4.0 in avanti sono ufficialmente supportati solo sistemi a 64 bit).

1) Scaricare l'installer (Community o Enterprise) per il sistema operativo e renderlo eseguibile
chmod +x alfresco-enterprise-3.4.0-installer-linux-x64.bin
2) Visualizzare le opzioni disponibili da riga di comando, tramite il parametro --help
./alfresco-enterprise-3.4.0-installer-linux-x64.bin --help
Appare un elenco di opzioni:


L'opzione che interessa è --mode <mode>. Di default mode è gtk, ma in questo caso sceglieremo text. La seconda opzione è quella relativa alla lingua d'installazione, scegliamo quindi l'italiano tramite l'opzione --installer-language it
./alfresco-enterprise-3.4.0-installer-linux-x64.bin --mode text --installer-language it
Dando invio parte il processo di installazione, che pone una serie di domande sulle componenti da installare e sulle porte da usare. Dato che in questa dimostrazione abbiamo deciso di non installare Alfresco come root ma tramite un utente normale, è necessario scegliere porte sopra alla 1024. Normalmente, su un ambiente di test o produzione, è buona norma in creare un utente dedicato ed un gruppo per Alfresco, fornendogli i privilegi necessari ad usare tutte le porte.


La schermata iniziale:
mauri@ubuntu10-laptop:~$ ./alfresco-enterprise-3.4.0-installer-linux-x64.bin --mode text --installer-language it
---------------------------------------------------------------------
Benvenuto al programma d'installazione di Alfresco Enterprise

---------------------------------------------------------------------
Seleziona i componenti che vuoi installare; deseleziona i componenti che non
vuoi. Clicca Avanti quando sei pronto per continuare.

MySQL : Y (Cannot be edited)
Java : Y (Cannot be edited)
Alfresco : Y (Cannot be edited)
SharePoint [Y/n] :y
Records Management [Y/n] :n
Web Quick Start [Y/n] :y
Web Project Management (AVM) [Y/n] :n
Quickr Connector Support [Y/n] :n
OpenOffice [Y/n] :y
La selezione e' corretta? [Y/n]: y

Si procede con la selezione delle porte, dopo aver scelto l'opzione "Advanced" nel menu Installation Type:
---------------------------------------------------------------------
Installation Type

[1] Easy - Installs servers with the default configuration
[2] Advanced - Configures server ports and service properties
Scegli un opzione [1] : 2
Di seguito è necessario scegliere un folder dove installare Alfresco e se usare il database MySQL allegato oppure una installazione esistente. In questo caso preferiamo usare il MySQL di Ubuntu, in modo da poterlo gestire autonomamente
---------------------------------------------------------------------
Installation Folder

Please choose a folder to install Alfresco Enterprise.

Select a folder [/home/mauri/alfresco-3.4.0]:

---------------------------------------------------------------------
Database Installation

Please select which database configuration you wish to use. If you select an existing database you should configure the Alfresco application before running the Alfresco server.

[1] I wish to use the bundled MySQL database
[2] I wish to use an existing database
Scegli un opzione [1] : 2
E' da notare che la URI JDBC proposta di default è sbagliata. Sostituire quindi in seguito dentro il file di configurazione alfresco-global.properties
jdbc:mysql://localhost/alfresco?useUnicode=yes#38characterEncoding=UTF-8
con
jdbc:mysql://localhost/alfresco?useUnicode=yes&characterEncoding=UTF-8
Procediamo quindi fino alla fine, rispondendo alle domande poste. Alla fine partirà il processo di installazione vero e proprio
---------------------------------------------------------------------
Il programma d'installazione e' pronto per installare Alfresco Enterprise sul
tuo pc.

Vuoi continuare? [Y/n]: y

---------------------------------------------------------------------
Attendere prego, mentre Alfresco Enterprise e'installato sul tuo computer.

 Installazione...
 0% ______________ 50% ______________ 100%
 ########################################
Al termine della procedura è necessario andare a controllare che il file alfresco-global.properties sia configurato correttamente (è il file più importante e si trova sotto tomcat/shared/classes). Da notare che è raccomandato che MySQL sia configurato per usare il charset UTF-8. Per la corretta configurazione e creazione del database sono già disponibili ottime guide online.

Volendo utilizzare una JVM diversa da quella in bundle con Alfresco, è ad esempio possibile rinominare la cartella Java presente nella cartella d'installazione di Alfresco, quindi creare un collegamento simbolico al JDK già presente sulla macchina. In questo caso, avendo installato l'ultimo JDK Sun per Linux ed avendo $JAVA_HOME = /usr/lib/jvm/java-6-sun è possibile dare il seguente comando:
ln -s /usr/lib/jvm/java-6-sun java
Alla partenza Alfresco userà questa JVM al posto di quella integrata, se è quello che desiderate. Assicuratevi che si tratti però di una versione di JVM tra quelle certificate e supportate, o potreste avere problemi.

Il file tomcat/bin/setenv.sh può essere quindi editato per modificare le JAVA_OPTS ed ottimizzare (sapendo esattamente quello che si sta facendo), i parametri della Java Virtual Machine. Per iniziare è consigliabile leggersi prima un buon documento sull'argomento.

Al termine, per avviare Alfresco, è utile avere subito sott'occhio i log, quindi si può eseguire il seguente comando:
./alfresco.sh start; tail -f tomcat/logs/catalina.out

AGGIORNAMENTO: ho aggiunto le istruzioni per creare il database mysql.

lunedì 14 febbraio 2011

Presentazione di Alfresco Enterprise 3.4

Queste sono le slide della presentazione di Alfresco Enterprise 3.4 effettuata durante il webinar online tenuto il 14 febbraio 2011.

A breve sarà disponibile sul sito Alfresco la registrazione completa audio e video in italiano della sessione Webex: http://www.alfresco.com/it/about/events/ondemand/