O pacote oficial de distribuição do Tomcat para Unix/Linux é disponibilizado para download pelo projeto Jakarta em dois formatos alternativos: um pacote TAR compactado com GZIP (extensão .tar.gz), ou um pacote ZIP (.zip). É recomendado utilizar o pacote TAR+GZIP, pois o formato ZIP não inclui as permissões de arquivos, como por exemplo, as permissões para a execução dos scripts de instalação.
Para instalar o Tomcat, basta executar os passos descritos a seguir:
- Passo 1. Copie o arquivo obtido por download para algum diretório e descompacte-o. A seqüência de comandos necessária para a concretização deste passo é apresentada na Listagem 4-1.
# Copia o arquivo binário para o diretório /opt.
sudo mv apache-tomcat-6.0.13.tar.gz /opt/
# Descompactando o arquivo.
sudo tar -xzvf apache-tomcat-6.0.13.tar.gz
# Renomeia o diretório onde foi descompactado o arquivo.
sudo mv apache-tomcat-6.0.13 tomcat
Listagem 4-1 - Seqüência de comandos para execução do Passo 1.
- Passo 2. A configuração inicial mínima recomendada após a instalação dos arquivos do Tomcat é adicionar, no arquivo conf/tomcat-users.xml, um usuário e uma senha de administrador com autorizações para uso das ferramentas admin e manager do Tomcat. No diretório onde foi realizada a instalação, serão executados os seguintes passos adicionais apresentados na Listagem 4-2.
1. cd tomcat/conf/
2. Edite o arquivo tomcat-users.xml com o editor de texto de preferência.
3. Adicione a linha em destaque a seguir, definindo um nome e senha para o usuário administrativo do Tomcat (altere a senha, e opcionalmente também o nome, à sua escolha):
<tomcat-users>
<user name="tomcat" password="tomcat" roles="tomcat"/>
<user name="role1" password="tomcat" roles="role1"/>
<user name="both" password="tomcat" roles="tomcat,role1"/>
<user name="admin" password="admin" roles="admin, manager"/>
</tomcat-users>
4. Salve o arquivo e encerre a edição.
Listagem 4-2 - Seqüência de comandos para execução do Passo 2.
- Passo 3. Para ter certeza de que tudo está funcionando corretamente, o Tomcat será inicializado através dos comandos apresentados na Listagem 4-3. A saída referente à execução dos comandos da Listagem 4-3 é apresentada na Listagem 4-4.
# Acessa o diretório /bin do Tomcat
cd $CATALINA_HOME/bin
# Inicializa o Tomcat
sudo sh ./startup.sh
Listagem 4-3 - Seqüência de comandos para execução do Passo 3.
Using CATALINA_BASE: /opt/tomcat
Using CATALINA_HOME: /opt/tomcat
Using CATALINA_TMPDIR: /opt/tomcat/temp
Using JRE_HOME: /home/paulojr/jdk1.6.0_02
Listagem 4-4 - Saída referente a execução do Passo 3.
- Passo 4. Finalmente, basta inserir o endereço http://localhost:8080 no browser e a página inicial do Tomcat será exibida, como mostrado na Figura 4-1.
Figura 4-1 - Página inicial do servidor Tomcat. Instalação realizada com sucesso.