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). O recomendado é o TAR+GZIP. A desvantagem do formato zip é que ele não inclui as permissões de arquivos como no tar.gz; em especial, a permissão de execução para os scripts precisará ser atribuída manualmente.
Nota: Você encontra também distribuições não-oficiais em outros formatos, disponibilizados em outros repositórios, como pacote RPM para RedHat Linux, ou pacote DEB para Debian GNU/Linux. Apenas os formatos oficiais disponibilizados pelo projeto Apache Jakarta porém são considerados neste guia.
tar padrão do Linux, mas
a maioria das distribuições Unix, como o Solaris, tem sua própria implementação de
tar que pode apresentar alguma incompatibilidade. A tentativa de
descompactar o pacote com o comando tar original do Solaris, por
exemplo, resulta no erro “tar: directory checksum error”, conforme o trecho de
saída a seguir:
... x jakarta-tomcat-4.1.30/server/webapps/admin/.../ActionTag.class, 2978 bytes, 6 tape blocks x jakarta-tomcat-4.1.30/server/webapps/admin/.../ActionsTag.class, 3935 bytes, 8 tape blocks tar: directory checksum error
/bin, /usr/bin,
/usr/local/bin, /opt/bin; as localizações
podem variar de uma plataforma para outra) estão no PATH do usuário de
instalação, bem como o JAVA_HOME/bin;
adicione-os se necessário. Por exemplo:
echo $PATHPATH=/usr/bin:/usr/local/bin:$JAVA_HOME/bin:$PATH; export PATHtar em seu sistema
operacional, com o comando whereis ou o which.
Verifique também a versão do comando tar identificando se é o GNU tar:
which tar (ou whereis tar)tar --version/bin/tar tar (GNU tar) 1.15.1
which unzip (ou whereis unzip)Os procedimentos de instalação neste tutorial pressupõem como convenção
o caminho /opt como diretório base para a instalação. Os demais
exemplos citados neste tutorial se referem a este caminho. Em algumas
plataformas, pode-se preferir usar /usr/local ou mesmo outro local
personalizado, como por exemplo /web. Como não há padrão rígido
para esta organização, se você optar por outra localização, basta lembrar de
alterar as referências ao caminho de instalação conforme necessário.
Os demais diretórios sugeridos dentro do caminho base de instalação, conforme exibido a seguir, são criados durante os passos de instalação adiante:
/opt/
install/ (pacotes de instalação de software)
apache-tomcat-?.?.*.* (pacote Tomcat, formato tar.gz ou zip)apache-tomcat-*/ (Tomcat instalado)A instalação do Tomcat é muito simples e consiste, essencialmente,
em descompactar o pacote de arquivos no local desejado.
Os comandos de instalação procuram utilizar máscaras de substituição (?
e * nos nomes de arquivo para se manterem genéricos em relação à
versão específica do Tomcat, já que os procedimentos são idênticos para toda versão.
Importante: Para os comandos com máscaras de substituição
a seguir funcionarem, referenciando apenas um arquivo como esperado, não deve existir mais
de uma versão do Tomcat. Se você tem múltiplas versões de Tomcat, especifique os números
de versão versão sem máscaras, como em apache-tomcat-5.5.20 por exemplo,
ao invés de apache-tomcat-?.?.*.
Com o usuário de instalação, execute no terminal de comandos o seguinte:
cd /optmkdir installinstall/ o pacote de instalação do Tomcat.script cria um arquivo de registro tomcat-install.log
com toda a saída apresentada na tela durante a instalação (até que seja
finalizado com o comando exit):script install/tomcat-install.logz que já descompacta o formato gzip. As outras
opções xvf são respectivamente para eXtrair, exibir mais
informações (Verbose) e especificar o nome do arquivo (File):tar -xzvf install/apache-tomcat-?.?.*.tar.gz
unzip install/apache-tomcat-?.?.*.zipln -s apache-tomcat-?.?.?? tomcatcd tomcat/bin ls -l *.sh chmod +x *.sh cd ../..
exitSe precisar conferir depois em detalhes o que aconteceu durante a instalação,
em busca de algum problema ou dúvida, consulte o arquivo install/tomcat-install.log
gerado.
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
senha de admininistrador com autorizações para uso das ferramentas admin e
manager do Tomcat. Estando no diretório base logo após a instalação, execute
os seguintes passos adicionais:
cd tomcat/conf/tomcat-users.xml com o editor de texto de sua
preferência.<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="altere" roles="admin,manager" fullName="Tomcat Administrator" /> </tomcat-users>
De acordo com o arquivo RELASE-NOTES.txt que acompanha o Tomcat
5.5, usuários de Linux devem ajustar o ambiente com uma variável para
compatibilidade de kernel, da seguinte forma:
export LD_ASSUME_KERNEL=2.2.5
export LD_ASSUME_KERNEL=2.4.1
Retornar para o Tutorial do Tomcat.
© 2003-2007, Márcio d'Ávila, mhavila.com.br, direitos reservados. O texto e código-fonte apresentados podem ser referenciados, distribuídos e utilizados, desde que expressamente citada esta fonte e o crédito do(s) autor(es). A informação aqui apresentada, apesar de todo o esforço para garantir sua precisão e correção, é oferecida "como está", sem quaisquer garantias explícitas ou implícitas decorrentes de sua utilização ou suas conseqüências diretas e indiretas.