Skip to content

Instantly share code, notes, and snippets.

Show Gist options
  • Select an option

  • Save edilsonvilarinho/e432829af93e43f1d60b5475544b6bad to your computer and use it in GitHub Desktop.

Select an option

Save edilsonvilarinho/e432829af93e43f1d60b5475544b6bad to your computer and use it in GitHub Desktop.

Revisions

  1. edilsonvilarinho created this gist Aug 30, 2024.
    191 changes: 191 additions & 0 deletions Guia-de-Instalação-do-Apache-Tomcat-8-no-CentOS7.md
    Original file line number Diff line number Diff line change
    @@ -0,0 +1,191 @@

    # Guia de Instalação do Apache Tomcat 8 no CentOS 7

    Este guia explica como instalar o Apache Tomcat 8, a versão estável mais recente, em uma instância de servidor Vultr CentOS 7.

    ## Pré-requisitos

    Antes de continuar, você precisa:

    - Implantar uma nova instância de servidor Vultr CentOS 7.
    - Fazer login nesta máquina a partir do seu terminal SSH como um usuário sudo não-root.

    ## Passo 1: Atualize o seu sistema CentOS

    Primeiramente, você precisa atualizar o sistema para o status estável mais recente:

    ```bash
    sudo yum install epel-release
    sudo yum update -y && sudo reboot
    ```

    Use o mesmo usuário sudo para fazer login no sistema após a reinicialização.

    ## Passo 2: Instale o Java

    Você precisa instalar o Java SE 7.0 ou superior antes que o Apache Tomcat possa funcionar corretamente. Aqui, vamos instalar o OpenJDK Runtime Environment 1.8.0 usando YUM:

    ```bash
    sudo yum install java-1.8.0-openjdk.x86_64
    ```

    Você pode confirmar a instalação com:

    ```bash
    java -version
    ```

    A saída deve ser semelhante ao seguinte:

    ```plaintext
    openjdk version "1.8.0_91"
    OpenJDK Runtime Environment (build 1.8.0_91-b14)
    OpenJDK 64-Bit Server VM (build 25.91-b14, mixed mode)
    ```

    ## Passo 3: Crie um usuário dedicado para o Apache Tomcat

    Por questões de segurança, você precisa criar um usuário não-root dedicado chamado "tomcat" que pertença ao grupo "tomcat":

    ```bash
    sudo groupadd tomcat
    sudo mkdir /opt/tomcat
    sudo useradd -s /bin/nologin -g tomcat -d /opt/tomcat tomcat
    ```

    Desta forma, você criou um usuário "tomcat" que pertence ao grupo "tomcat". Você não pode usar esta conta de usuário para fazer login no sistema. O diretório home é `/opt/tomcat`, que é onde o programa Apache Tomcat irá residir.

    ## Passo 4: Baixe e instale a versão mais recente do Apache Tomcat

    Você sempre pode encontrar a versão estável mais recente do Apache Tomcat 8 em sua página oficial de download, que é 8.0.33 no momento da redação deste guia.

    Na seção "Binary Distributions" e, em seguida, na lista "Core", use o link apontando para o arquivo "tar.gz" para compor um comando wget:

    ```bash
    cd ~
    wget http://www-us.apache.org/dist/tomcat/tomcat-8/v8.0.33/bin/apache-tomcat-8.0.33.tar.gz
    sudo tar -zxvf apache-tomcat-8.0.33.tar.gz -C /opt/tomcat --strip-components=1
    ```

    ## Passo 5: Configuração de permissões adequadas

    Antes de executar o Apache Tomcat, você precisa configurar permissões adequadas para vários diretórios:

    ```bash
    cd /opt/tomcat
    sudo chgrp -R tomcat conf
    sudo chmod g+rwx conf
    sudo chmod g+r conf/*
    sudo chown -R tomcat logs/ temp/ webapps/ work/
    sudo chgrp -R tomcat bin
    sudo chgrp -R tomcat lib
    sudo chmod g+rwx bin
    sudo chmod g+r bin/*
    ```

    ## Passo 6: Configurar um arquivo de unidade Systemd para o Apache Tomcat

    Para maior conveniência, você deve configurar um arquivo de unidade Systemd para o Apache Tomcat:

    ```bash
    sudo vi /etc/systemd/system/tomcat.service
    ```

    Popule o arquivo com o seguinte conteúdo:

    ```plaintext
    [Unit]
    Description=Apache Tomcat Web Application Container
    After=syslog.target network.target
    [Service]
    Type=forking
    Environment=JAVA_HOME=/usr/lib/jvm/jre
    Environment=CATALINA_PID=/opt/tomcat/temp/tomcat.pid
    Environment=CATALINA_HOME=/opt/tomcat
    Environment=CATALINA_BASE=/opt/tomcat
    Environment='CATALINA_OPTS=-Xms512M -Xmx1024M -server -XX:+UseParallelGC'
    Environment='JAVA_OPTS=-Djava.awt.headless=true -Djava.security.egd=file:/dev/./urandom'
    ExecStart=/opt/tomcat/bin/startup.sh
    ExecStop=/bin/kill -15 $MAINPID
    User=tomcat
    Group=tomcat
    [Install]
    WantedBy=multi-user.target
    ```

    Salve e saia do editor:

    ```plaintext
    :wq
    ```

    ## Passo 7: Instale o haveged, um programa relacionado à segurança

    Por questões de segurança, você deve instalar o haveged:

    ```bash
    sudo yum install haveged
    sudo systemctl start haveged.service
    sudo systemctl enable haveged.service
    ```

    ## Passo 8: Inicie e teste o Apache Tomcat

    Agora, inicie o serviço do Apache Tomcat e configure-o para iniciar junto com o sistema:

    ```bash
    sudo systemctl start tomcat.service
    sudo systemctl enable tomcat.service
    ```

    Para testar o Apache Tomcat em um navegador, você precisa modificar as regras do firewall:

    ```bash
    sudo firewall-cmd --zone=public --permanent --add-port=8080/tcp
    sudo firewall-cmd --reload
    ```

    Em seguida, você pode testar a instalação do Apache Tomcat visitando a seguinte URL em um navegador:

    ```plaintext
    http://[seu-IP-do-servidor-Vultr]:8080
    ```

    Se tudo estiver funcionando corretamente, você verá a página inicial padrão do Apache Tomcat.

    ## Passo 9: Configure a interface de gerenciamento web do Apache Tomcat

    Para usar o "Manager App" e o "Host manager" na interface web do Apache Tomcat, você precisa criar um usuário administrador para o seu servidor Apache Tomcat:

    ```bash
    sudo vi /opt/tomcat/conf/tomcat-users.xml
    ```

    Dentro do segmento `</tomcat-users ...>...</tomcat-users>`, insira a seguinte linha para definir um usuário administrador:

    ```xml
    <user username="yourusername" password="yourpassword" roles="manager-gui,admin-gui"/>
    ```

    Lembre-se de substituir "yourusername" e "yourpassword" por valores próprios, quanto mais incomuns, melhor.

    Salve e saia do editor:

    ```plaintext
    :wq
    ```

    Reinicie o Apache Tomcat para que suas modificações entrem em vigor:

    ```bash
    sudo systemctl restart tomcat.service
    ```

    Atualize a página inicial do Apache Tomcat em seu navegador. Faça login no "Manager App" e no "Host manager" usando as credenciais que você configurou anteriormente.

    A configuração do Apache Tomcat está completa. Agora você pode usá-lo para implantar suas próprias aplicações.