Como Instalar e Configurar o XWiki no Ubuntu 16.04

XWiki é um software wiki gratuito e de código aberto escrito em Java que roda em um contêiner de servlet como Tomcat, JBoss, etc. O XWiki usa bancos de dados como MySQL ou PostgreSQL para armazenar suas informações. O XWiki nos permite armazenar dados estruturados e executar scripts do servidor dentro da interface wiki. Você pode hospedar vários blogs e gerenciar ou visualizar seus arquivos e pastas usando o XWiki.

O XWiki vem com muitos recursos, alguns deles estão listados abaixo:

Suporta controle de versão e ACL.
Permite que você pesquise em toda a wiki usando curingas.
Exporta facilmente páginas wiki para PDF, ODT, RTF, XML e HTML.
Organização de conteúdo e importação de conteúdo.
Edição de páginas usando editor WYSIWYG.

Requisitos

Um servidor rodando Ubuntu 16.04.
Um usuário não-root com privilégios sudo.

Atualizar o Sistema

Antes de começar, você precisará atualizar o repositório do Ubuntu para a versão mais recente. Você pode fazer isso usando o seguinte comando:

sudo apt-get update -y  
sudo apt-get upgrade -y

Uma vez que o repositório esteja atualizado, reinicie o sistema para aplicar todas as atualizações.

Instalar Java

O XWiki é uma aplicação baseada em Java, então você precisará instalar o Java 8 primeiro. Por padrão, o Java 8 não está disponível no repositório do Ubuntu. Você pode instalar o Java 8 adicionando o repositório PPA webupd8team ao seu sistema.

Primeiro, adicione o PPA executando o seguinte comando:

sudo add-apt-repository ppa:webupd8team/java

Em seguida, atualize o repositório com o seguinte comando:

sudo apt-get update -y

Uma vez que o repositório esteja atualizado, você pode instalar o Java 8 executando o seguinte comando:

sudo apt-get install oracle-java8-installer -y

Após instalar o Java, você pode verificar a versão do Java com o seguinte comando:

java -version

Você deve ver a seguinte saída:

Java version "1.8.0_91"
Java(TM) SE Runtime Environment (build 1.8.0_91-b14)
Java HotSpot(TM) 64-Bit Server VM (build 25.91-b14, mixed mode)

Baixar e Instalar o XWiki

Em seguida, você precisará baixar o arquivo de configuração fornecido pelo XWiki. Você pode baixá-lo usando o seguinte comando:

wget http://download.forge.ow2.org/xwiki/xwiki-enterprise-installer-generic-8.1-standard.jar

Uma vez que o download esteja completo, você pode instalar o arquivo de pacote baixado usando o comando java conforme mostrado abaixo:

sudo java -jar xwiki-enterprise-installer-generic-8.1-standard.jar

Você deve ver a seguinte saída:

28 Jan, 2018 6:57:37 PM INFO: Logging initialized at level 'INFO'
28 Jan, 2018 6:57:37 PM INFO: Commandline arguments: 
28 Jan, 2018 6:57:37 PM INFO: Detected platform: ubuntu_linux,version=3.19.0-25-generic,arch=x64,symbolicName=null,javaVersion=1.7.0_151
28 Jan, 2018 6:57:37 PM WARNING: Failed to determine hostname and IP address
Welcome to the installation of XWiki Enterprise 8.1!
The homepage is at: http://xwiki.org/

Press 1 to continue, 2 to quit, 3 to redisplay

Agora, pressione 1 para continuar a instalação, você deve ver a seguinte saída:

Please read the following information: 
                                                                                              
 XWiki Enterprise - Readme                                                                        
                                                                                                 
                                                                                                 
 XWiki Enterprise Overview                                                                        
XWiki Enterprise é um motor Wiki de segunda geração, apresenta recursos profissionais como       
 Wiki, Blog, Comentários, Direitos de Usuário, Autenticação LDAP, Exportação para PDF, e muito mais.              
O XWiki Enterprise também inclui um avançado mecanismo de formulários e scripts que o torna um ambiente ideal   
 para a construção de aplicações intranet baseadas em dados. Ele possui recursos poderosos       
 de extensibilidade, suporta scripts, extensões e é baseado em uma arquitetura altamente modular          
. O mecanismo de script permite acessar uma poderosa API para acessar o repositório do XWiki       
 em modo de leitura e gravação.                                                                
O XWiki Enterprise é usado por grandes empresas ao redor do mundo e tem um forte                    
 Suporte para um uso profissional do XWiki.                                                        
 Dicas                                                                                         
Aqui estão algumas dicas para você começar com o XWiki assim que terminar de instalá-lo:     
                                                                                                 
A documentação pode ser encontrada no site XWiki.org                                        
Se você notar algum problema, por favor, registre um problema em nosso rastreador de problemas                              
Se você deseja conversar com usuários ou desenvolvedores do XWiki, por favor, use nossas                                 
 Listas de discussão & Fórum                                                                                                                                            
Você também pode acessar o código fonte do XWiki                                                                                     
Se você precisar de suporte comercial, por favor, visite a                                                 
 Página de suporte                                                                                     
                                                                                                 
                                                                                                 

Press 1 to continue, 2 to quit, 3 to redisplay

Agora, pressione 1 para continuar a instalação, você deve ver a seguinte saída:

See the NOTICE file distributed with this work for additional        
information regarding copyright ownership.                           
This is free software; you can redistribute it and/or modify it      
under the terms of the GNU Lesser General Public License as          
published by the Free Software Foundation; either version 2.1 of     
the License, or (at your option) any later version.                  
This software is distributed in the hope that it will be useful,     
but WITHOUT ANY WARRANTY; without even the implied warranty of       
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU     
Lesser General Public License for more details.                      
You should have received a copy of the GNU Lesser General Public     
License along with this software; if not, write to the Free          
Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA   
02110-1301 USA, or see the FSF site: http://www.fsf.org.              

Press 1 to accept, 2 to reject, 3 to redisplay

Agora, pressione 1 para aceitar o contrato de licença, você deve ver a seguinte saída:

Select the installation path:  [/usr/local/XWiki Enterprise 8.1] 

Press 1 to continue, 2 to quit, 3 to redisplay

Agora, pressione enter e pressione 1 para selecionar o caminho de instalação padrão, você deve ver a seguinte saída:

  [x] Pack 'Core' required
???????????????????????????????????????????????????????????????????????????????
  [x] Include optional pack 'Default Wiki'
???????????????????????????????????????????????????????????????????????????????
Enter Y for Yes, N for No: 
Y
Press 1 to continue, 2 to quit, 3 to redisplay

Agora, pressione Y e pressione 1 para continuar a instalação, você deve ver a seguinte saída:

[ Starting to unpack ]
[ Processing package: Core (1/2) ]
[ Processing package: Default Wiki (2/2) ]
[ Unpacking finished ]

Agora, você será solicitado a criar atalhos para o usuário, você pode pressionar ‘ Y para adicioná-los. Em seguida, você será solicitado a gerar um script de instalação automática, basta pressionar Enter para selecionar o valor padrão, uma vez que a instalação esteja concluída, você deve ver a seguinte saída:

???????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????
Generate an automatic installation script
???????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????
Enter Y for Yes, N for No: 
Y
Select the installation script (path must be absolute)[/usr/local/XWiki Enterprise 8.1/auto-install.xml]

Installation was successful
application installed on /usr/local/XWiki Enterprise 8.1
[ Writing the uninstaller data ... ]
[ Console installation done ]

Agora, o XWiki está instalado em seu sistema, é hora de iniciar o script de inicialização do XWiki conforme mostrado abaixo:

cd /usr/local/XWiki Enterprise 8.1  
sudo bash start_xwiki.sh

Por favor, aguarde um momento para iniciar os processos. Agora, você deve ver algumas mensagens no terminal conforme mostrado abaixo:

start_xwiki.sh: 79: start_xwiki.sh:
Starting Jetty on port 8080, please wait...
2018-01-28 19:12:41.842:INFO::main: Logging initialized @1266ms
2018-01-28 19:12:42.905:INFO:oejs.Server:main: jetty-9.2.13.v20150730
2018-01-28 19:12:42.956:INFO:oejs.AbstractNCSARequestLog:main: Opened /usr/local/XWiki Enterprise 8.1/data/logs/2018_01_28.request.log
2018-01-28 19:12:42.965:INFO:oejdp.ScanningAppProvider:main: Deployment monitor [file:/usr/local/XWiki%20Enterprise%208.1/jetty/contexts/] at interval 0
2018-01-28 19:13:31,485 [main] INFO  o.x.s.s.i.EmbeddedSolrInstance - Starting embedded Solr server... 
2018-01-28 19:13:31,507 [main] INFO  o.x.s.s.i.EmbeddedSolrInstance - Using Solr home directory: [data/solr] 
2018-01-28 19:13:43,371 [main] INFO  o.x.s.s.i.EmbeddedSolrInstance - Started embedded Solr server. 
2018-01-28 19:13:46.556:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@2c9f9fb0{/xwiki,file:/usr/local/XWiki%20Enterprise%208.1/webapps/xwiki/,AVAILABLE}{/xwiki}
2018-01-28 19:13:46.697:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@64c37088{/,file:/usr/local/XWiki%20Enterprise%208.1/webapps/root/,AVAILABLE}{/root}
2018-01-28 19:13:46.776:INFO:oejs.ServerConnector:main: Started ServerConnector@1ffa4bae{HTTP/1.1}{0.0.0.0:8080}

O XWiki agora está em funcionamento, é hora de acessar a interface web do XWiki.

Acessar o XWiki

O XWiki roda na porta 8080, então você precisará permitir a porta 8080 através do firewall. Primeiro, habilite o firewall UFW com o seguinte comando:

sudo ufw enable

Em seguida, permita a porta 8080 através do firewall UFW com o seguinte comando:

sudo ufw allow 8080/tcp

Em seguida, recarregue as regras do firewall para aplicar todas as alterações executando o seguinte comando:

sudo ufw reload

Você pode obter o status do firewall UFW com o seguinte comando:

sudo ufw status

Agora, abra seu navegador web e digite a URL http://your-server-ip:8080, você será redirecionado para a página inicial do XWiki conforme mostrado abaixo:

Painel do XWiki

Você pode parar o servidor XWiki a qualquer momento pressionando o botão Ctrl + C no terminal.

Conclusão

Parabéns! você instalou e configurou com sucesso o XWiki no servidor Ubuntu 16.04. Espero que agora você possa facilmente hospedar seu próprio site wiki usando o XWiki no servidor Ubuntu 16.04. Para mais informações, você pode verificar a página de documentação oficial do XWiki em https://www.xwiki.org/xwiki/bin/view/Documentation/. Sinta-se à vontade para comentar se você tiver alguma dúvida.