Como instalar o Alfresco Community Edition no RHEL/CentOS 7/6 e Debian 8
Alfresco é um sistema ECM de código aberto (Enterprise Content Management) escrito em Java que fornece gerenciamento eletrônico, colaboração e controle de negócios.
Este guia abordará como instalar e configurar o Alfresco Community Edition no RHEL/CentOS 7/6, Debian 8 e Ubuntu com servidor Nginx como servidor web frontend para o aplicativo.
Requisitos
Quanto aos requisitos mínimos de sistema, o Alfresco precisa de uma máquina com pelo menos 4 GB de RAM e um sistema operacional de 64 bits.
Etapa 1: Instale o Alfresco Community Edition
1. Antes de prosseguir com a instalação do Alfresco, primeiro certifique-se de que o utilitário wget esteja instalado em sua máquina, emitindo o comando abaixo com privilégios de root ou a partir da conta root.
yum install wget
apt-get install wget
2. Em seguida, configure o nome do host do seu sistema e certifique-se de que a resolução local aponte para o endereço IP do seu servidor emitindo os seguintes comandos:
hostnamectl set-hostname server.alfresco.lan
echo “192.168.0.40 server.alfresco.lan” >> /etc/hosts
3. Remova qualquer MTA da máquina (neste caso, servidor Postfix Mail) emitindo o comando abaixo:
yum remove postfix
apt-get remove postfix
4. Instale as seguintes dependências exigidas pelo software Alfresco para funcionar corretamente:
yum install fontconfig libSM libICE libXrender libXext cups-libs
apt-get install libice6 libsm6 libxt6 libxrender1 libfontconfig1 libcups2
5. Em seguida, vá para a página do repositório Alfresco Community Edition hospedada no portal sourceforge.net e obtenha a versão binária mais recente (ou seja, alfresco-community-5.0.d-installer-linux-x64.bin ) para Linux usando o utilitário wget.
wget http://nchc.dl.sourceforge.net/project/alfresco/Alfresco%205.0.d%20Community/alfresco-community-5.0.d-installer-linux-x64.bin
6. Após a conclusão do download do arquivo binário, emita o seguinte comando para conceder permissões de execução para o arquivo e execute o instalador ao ar livre.
chmod +x alfresco-community-5.0.d-installer-linux-x64.bin
./alfresco-community-5.0.d-installer-linux-x64.bin
7. Após o início do processo de instalação, selecione o idioma e continue o processo de instalação usando o assistente de instalação abaixo como guia para configurar o Alfresco:
[root@server ~]# ./alfresco-community-5.0.d-installer-linux-x64.bin
Language Selection
Please select the installation language
[1] English - English
[2] French - Français
[3] Spanish - Español
[4] Italian - Italiano
[5] German - Deutsch
[6] Japanese - 日本語
[7] Dutch - Nederlands
[8] Russian - Русский
[9] Simplified Chinese - 简体中文
[10] Norwegian - Norsk bokmål
[11] Brazilian Portuguese - Português Brasileiro
Please choose an option [1] : 1
----------------------------------------------------------------------------
Welcome to the Alfresco Community Setup Wizard.
----------------------------------------------------------------------------
Installation Type
[1] Easy - Installs servers with the default configuration
[2] Advanced - Configures server ports and service properties.: Also choose optional components to install.
Please choose an option [1] : 2
----------------------------------------------------------------------------
Select the components you want to install; clear the components you do not want
to install. Click Next when you are ready to continue.
Java [Y/n] :y
PostgreSQL [Y/n] :y
Alfresco : Y (Cannot be edited)
Solr1 [y/N] : n
Solr4 [Y/n] :y
SharePoint [Y/n] :y
Web Quick Start [y/N] : y
Google Docs Integration [Y/n] :y
LibreOffice [Y/n] :y
Is the selection above correct? [Y/n]: y
O assistente de instalação ao ar livre continua….
----------------------------------------------------------------------------
Installation Folder
Please choose a folder to install Alfresco Community
Select a folder [/opt/alfresco-5.0.d]: [Press Enter key]
----------------------------------------------------------------------------
Database Server Parameters
Please enter the port of your database.
Database Server port [5432]: [Press Enter key]
----------------------------------------------------------------------------
Tomcat Port Configuration
Please enter the Tomcat configuration parameters you wish to use.
Web Server domain: [127.0.0.1]: 192.168.0.15
Tomcat Server Port: [8080]: [Press Enter key
Tomcat Shutdown Port: [8005]: [Press Enter key
Tomcat SSL Port [8443]: [Press Enter key
Tomcat AJP Port: [8009]: [Press Enter key
----------------------------------------------------------------------------
Alfresco FTP Port
Please choose a port number to use for the integrated Alfresco FTP server.
Port: [21]: [Press Enter key
A instalação ao ar livre continua…
----------------------------------------------------------------------------
Admin Password
Please give a password to use for the Alfresco administrator account.
Admin Password: :[Enter a strong password for Admin user]
Repeat Password: :[Repeat the password for Admin User]
----------------------------------------------------------------------------
Alfresco SharePoint Port
Please choose a port number for the SharePoint protocol.
Port: [7070]: [Press Enter key]
----------------------------------------------------------------------------
Install as a service
You can optionally register Alfresco Community as a service. This way it will
automatically be started every time the machine is started.
Install Alfresco Community as a service? [Y/n]: y
----------------------------------------------------------------------------
LibreOffice Server Port
Please enter the port that the Libreoffice Server will listen to by default.
LibreOffice Server Port [8100]: [Press Enter key]
----------------------------------------------------------------------------
A configuração da instalação ao ar livre continua.
----------------------------------------------------------------------------
Setup is now ready to begin installing Alfresco Community on your computer.
Do you want to continue? [Y/n]: y
----------------------------------------------------------------------------
Please wait while Setup installs Alfresco Community on your computer.
Installing
0% ______________ 50% ______________ 100%
#########################################
----------------------------------------------------------------------------
Setup has finished installing Alfresco Community on your computer.
View Readme File [Y/n]: n
Launch Alfresco Community Share [Y/n]: y
waiting for server to start....[root@server ~]# done
server started
/opt/alfresco-5.0.d/postgresql/scripts/ctl.sh : postgresql started at port 5432
Using CATALINA_BASE: /opt/alfresco-5.0.d/tomcat
Using CATALINA_HOME: /opt/alfresco-5.0.d/tomcat
Using CATALINA_TMPDIR: /opt/alfresco-5.0.d/tomcat/temp
Using JRE_HOME: /opt/alfresco-5.0.d/java
Using CLASSPATH: /opt/alfresco-5.0.d/tomcat/bin/bootstrap.jar:/opt/alfresco-5.0.d/tomcat/bin/tomcat-juli.jar
Using CATALINA_PID: /opt/alfresco-5.0.d/tomcat/temp/catalina.pid
Tomcat started.
/opt/alfresco-5.0.d/tomcat/scripts/ctl.sh : tomcat started
8. Depois que o processo de instalação terminar e os serviços Alfresco forem iniciados, emita os comandos abaixo para abrir as seguintes portas de firewall para permitir que hosts externos em sua rede se conectem ao aplicativo da web.
firewall-cmd --add-port=8080/tcp -permanent
firewall-cmd --add-port=8443/tcp -permanent
firewall-cmd --add-port=7070/tcp -permanent
firewall-cmd --reload
Caso você precise adicionar outras regras de firewall para portas abertas para acessar serviços Alfresco personalizados, emita o comando ss para obter uma lista de todos os serviços em execução em sua máquina.
ss -tulpn
9. Para acessar os serviços da web Alfresco, abra um navegador e use os seguintes URLs (substitua o endereço IP ou domínio de acordo). Faça login com o usuário admin e a senha configurada para Admin durante o processo de instalação.
http://IP-or-domain.tld:8080/share/
http://IP-or-domain.tld:8080/alfresco/
Para WebDAV.
http://IP-or-domain.tld:8080/alfresco/webdav
Para HTTPS aceite a exceção de segurança.
https://IP-or-domain.tld:8443/share/
Módulo Alfresco SharePoint com Microsoft.
http://IP-or-domain.tld:7070/
Etapa 2: configurar o Nginx como servidor Web front-end para Alfresco
10. Para instalar o servidor Nginx no sistema, primeiro adicione os Repositórios Epel no CentOS/RHEL emitindo o comando abaixo:
yum install epel-release
11. Depois que os repositórios Epel forem adicionados ao sistema, prossiga com a instalação do servidor web Nginx emitindo o seguinte comando:
yum install nginx [On RHEL/CentOS Systems]
apt-get install nginx [On Debian/Ubuntu Systems]
12. Na próxima etapa, abra o arquivo de configuração Nginx em /etc/nginx/nginx.conf com um editor de texto e faça as seguintes alterações:
location / {
proxy_pass http://127.0.0.1:8080;
proxy_redirect off;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
Vá abaixo e certifique-se de comentar a segunda declaração de localização colocando um # na frente das seguintes linhas:
#location / {
}
13. Depois de terminar, salve e feche o arquivo de configuração do Nginx e reinicie o daemon para refletir as alterações emitindo o seguinte comando:
systemctl restart nginx.service
14. Para acessar a interface web do Alfresco, adicione uma nova regra de firewall para abrir a porta 80 em sua máquina e navegue até o URL abaixo. Além disso, certifique-se de que a política Selinux esteja desabilitada em sistemas RHEL/CentOS.
firewall-cmd --add-service=http -permanent
firewall-cmd --reload
setenforce 0
Para desativar completamente a política Selinux no sistema, abra o arquivo /etc/selinux/config e defina a linha SELINUX de enforcing para disabled.
15. Agora você pode acessar o Alfresco através do Nginx.
http://IP-or-domain.tld/share/
http://IP-or-domain.tld/alfresco/
http://IP-or-domain.tld/alfresco/webdav
15. Caso você queira visitar com segurança a interface web Alfresco através do proxy Nginx com SSL, crie um certificado autoassinado para Nginx no diretório /etc/nginx/ssl/ e preencha o certificado com suas configurações personalizadas conforme ilustrado na captura de tela abaixo:
mkdir /etc/nginx/ssl
cd /etc/nginx/ssl/
openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout alfresco.key -out alfresco.crt
Preste atenção ao Nome comum do certificado para corresponder ao nome de host do seu domínio.
17. Em seguida, abra o arquivo de configuração do Nginx para edição e adicione o seguinte bloco antes da última chave de fechamento (o símbolo }).
vi /etc/nginx/nginx.conf
Trecho do bloco Nginx SSL:
server {
listen 443;
server_name _;
ssl_certificate /etc/nginx/ssl/alfresco.crt;
ssl_certificate_key /etc/nginx/ssl/alfresco.key;
ssl on;
ssl_session_cache builtin:1000 shared:SSL:10m;
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
ssl_ciphers HIGH:!aNULL:!eNULL:!EXPORT:!CAMELLIA:!DES:!MD5:!PSK:!RC4;
ssl_prefer_server_ciphers on;
access_log /var/log/nginx/ssl.access.log;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_redirect off;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
## This is the last curly bracket before editing the file.
}
18. Por fim, reinicie o daemon Nginx para aplicar as alterações e adicione uma nova regra de firewall para a porta 443.
systemctl restart nginx
firewall-cmd -add-service=https --permanent
firewall-cmd --reload
e instrua o navegador sobre o URL do seu domínio usando o protocolo HTTPS.
https://IP_or_domain.tld/share/
https://IP_or_domain.tld/alfresco/
19. Para ativar os daemons Alfresco e Nginx em todo o sistema, execute o comando abaixo:
systemctl enable nginx alfresco
Isso é tudo! Alfresco oferece integração com MS Office e LibreOffice através do protocolo CIFs, proporcionando um fluxo de trabalho familiar para os usuários.