InstalacaoAlfresco34

Instalação do Alfresco

Alfresco é um Gestor de Documentação Profissional e Open Source.

Requisitos

GNU/Linux Debian Squeeze de 64 bits ou Ubuntu Natty 64 bits.

Pacotes Necessários

É necessário realizar certos passos com antecedência, provendo pacotes necessários para o funcionamento adequado.

apt-get install sun-java6-jdk sun-java6-jre unzip imagemagick libart-2.0-2 libgif4 openoffice.org-headless tomcat6
apt-get install mysql-server mysql-client libmysql-java 
apt-get install postgresql postgresql-client libpg-java

Observações:
- O pacote libmysql-java contém o JDBC do !MySQL
- O pacote libpg-java contém o JDBC do !PostgreSQL
- O Debian não tem esse pacote nos repositórios oficiais, mas podemos utilizar esse pacote de seu irmão Ubuntu. Baixe esse pacote do link http://archive.canonical.com/ubuntu/pool/partner/s/swftools/ correspondente à sua plataforma. A instalação desse pacote é feita diretamente com o dpkg no pacote baixado:
swftools para 64 bits

dpkg -i swftools_0.9.0-0ubuntu2_amd64.deb

Criação de Links Alternativos

Embora os pacotes libmysql-java e libpg-java estejam instalados, para que funcione corretamente com tomcat o método mais simples é criar um link simbólico dos arquivos .jar dessas bibliotecas para o diretório /usr/share/tomcat6/lib/

cd /usr/share/tomcat6/lib/
ln -s ../../java/mysql.jar mysql.jar
ln -s ../../java/postgresql.jar postgresql.jar

Criação do BD para Alfresco

O Alfresco necessita de um BD para armazenar informações. Abaixo a criação do BD para mysql e postgresql:

MySQL

Mostrar quais arquivos de configuração do mysql são necessários alterar.

mysql -u root
create database alfresco default character set utf8 collate utf8_bin;
grant all on alfresco.* to 'alfresco'@'localhost' identified by 'alfresco' with grant option;
grant all on alfresco.* to 'alfresco'@'localhost.localdomain' identified by 'alfresco' with grant option;
flush privileges;

PostgreSQL

O postgresql vem com restrições severas de conexões TCP/IP. Para o correto funcionamento é necessário editar o arquivo /etc/postgresql/8.4/main/pg_hba.conf

su - postgres
createuser alfresco
createdb -O alfresco -E UNICODE alfresco
psql alfresco
alfresco =# ALTER USER alfresco WITH PASSWORD 'alfresco';

Configuração do Tomcat6

Para que possamos utilizar o alfresco corretamente devemos alterar alguns parâmetros de configuração do tomcat6.

Para resolver o problema de Out of Memory que pode acontecer com o Alfresco necessitamos ter os seguintes parâmetros ajustados:

-Xms1G: Memoria inicial em Mb do heap que atribuímos à máquina virtual
-Xmx2Gm: Memoria máxima em Mb do heap da máquina virtual
- Esses parâmetros tem que ser múltiplos de 1024 e maior que 1Mb.

* Para arquitetura com menos de 4Gb de RAM recomenda-se as configurações do arquivo /etc/default/tomcat6 abaixo:

...
# Use "-XX:+UseConcMarkSweepGC" to enable the CMS garbage collector (improved
# response time). If you use that option and you run Tomcat on a machine with
# exactly one CPU chip that contains one or two cores, you should also add
# the "-XX:+CMSIncrementalMode" option.
#JAVA_OPTS="-Djava.awt.headless=true -Xmx128m -XX:+UseConcMarkSweepGC"
JAVA_OPTS="-Djava.awt.headless=true -Xms1G -Xmx4G -Xss1024k -XX:MaxPermSize=128m -XX:NewSize=512m"
...

Instalar Alfresco 3.4

Para a instalação do Alfresco 3.4 Community utilizaremos apenas os arquivos .war que servem aplicações em servidores já existentes.

Primeiramente necessitamos baixar o arquivo alfresco-community-3.4.e.zip do link http://wiki.alfresco.com/wiki/Alfresco_Community_3.4.e_Download para o diretório /tmp/.

Depois de baixado necessitamos descompactar o arquivo num diretório qualquer. Exemplo.:

cd /tmp
mkdir alfresco34
cd alfresco34
unzip /tmp/alfresco-community-3.4.e.zip
cd web-server

Depois é necessário fazer um deploy dos arquivos .war contidos nesse diretório para a raiz de aplicações do tomcat6 /var/lib/tomcat6/webapps/.

unzip -qo webapps/alfresco.war -d /var/lib/tomcat6/webapps/alfresco/
unzip -qo webapps/share.war -d /var/lib/tomcat6/webapps/share/

Copiar os arquivos de exemplos do shared para o tomcat6.

cp -rf shared/ /var/lib/tomcat6/

Configuração do Alfresco

O arquivo de configuração principal do alfresco no share é /var/lib/tomcat6/shared/classes/alfresco-global.properties que deve ser editado para atender suas configurações de BD, etc...

###############################
## Common Alfresco Properties #
###############################

# (To point to the created directory)
dir.root=/srv/alfresco/alf_data

# (pointing to openoffice)
ooo.exe=/usr/bin/soffice
ooo.enabled=true

img.root=/usr/bin

# (activating imagemagick)
img.exe=/usr/bin/convert

# (activating swftools)
swf.exe=/usr/bin/pdf2swf

# (activating outbound mail)
mail.host=localhost
mail.port=25
mail.smtp.auth=false

# (CIFS settings)
cifs.enabled=true
cifs.serverName=alfresco
cifs.tcpipSMB.port=1445
cifs.netBIOSSMB.namePort=1137
cifs.netBIOSSMB.datagramPort=1138
cifs.netBIOSSMB.sessionPort=1139

# (FTP Settings)
ftp.enabled=true
ftp.port=2121

#
# Sample database connection properties
#
db.username=alfresco
db.password=alfresco

# Host DataBase
db.host=localhost
db.name=alfresco

#
# MySQL connection
#
db.port=3306
db.driver=org.gjt.mm.mysql.Driver
db.url=jdbc:mysql://${db.host}:${db.port}/${db.name}

#
# PostgreSQL connection (requires postgresql-8.2-504.jdbc3.jar or equivalent)
#
#db.port=5432
#db.driver=org.postgresql.Driver
#db.url=jdbc:postgresql://${db.host}:${db.port}/${db.name}

#
# Index Recovery Mode
#-------------
index.recovery.mode=AUTO

#
# Alfresco Email Service and Email Server
#-------------

# Email Server properties
#-------------
mail.host=localhost
mail.port=25
mail.encoding=UTF-8
mail.from.default=admin@localhost

#
# The default authentication chain
# To configure external authentication subsystems see:
# http://wiki.alfresco.com/wiki/Alfresco_Authentication_Subsystems
#-------------
#authentication.chain=alfrescoNtlm1:alfrescoNtlm,openldap:ldap

Criar diretório dir.root do alfresco.

mkdir -p /srv/alfresco/alf_data/
chown tomcat6:tomcat6 /srv/alfresco/alf_data/

Tradução para pt_BR

Para ter o Alfresco e o Share traduzidos para o Brasil baixe o arquivo pt_BR_language_pack_34d_community.tgz no diretório /tmp/ e depois descompacte no diretório raiz do tomcat (no caso do Debian é o /var/lib/tomcat6/.

cd /var/lib/tomcat6/
tar xzf /tmp/pt_BR_language_pack_34d_community.tgz

Todos os arquivos colocados no diretório do tomcat6 devem ter permissões corretas.

chown tomcat6:tomcat6 /var/lib/tomcat6/ -R

Acessando Aplicações

Finalmente restartar o servidor de aplicações tomcat6.

/etc/init.d/tomcat6 restart

Agora as aplicações alfresco e share estão disponíveis nos links http://localhost:8080/alfresco/ e http://localhost:8080/share/ conforme telas abaixo:

Figura 1 - Login no Alfresco - [attachment:AlfrescoExplorer-Entrar.png]
Figura 2 - Login no Share - [attachment:AlfrescoShare-Login.png]

Referências

Veja mais em Tradução do Alfresco Explorer e Share pt_BR

InstalacaoAlfresco34 (last edited 2011-09-19 23:22:29 by localhost)

Ubuntu Wiki