1 - INSTALAÇÃO Linux 
O pacote de instalação do TerraMA2 para Linux foi testado e compilado para a distribuição Debian. Caso o usuário queira usar outra distribuição Linux poderá compilar a plataforma na distribuição Linux de sua preferência, conforme descrito no item 6.


1.1 - Instalando Pacote Debian
    O pacote Debian 16.04 tem as seguintes dependências; TerraLib, NodeJs, Postgres/PostGIS, Java e Geoserver.

IMPORTANTE: A instalação requer conexão com internet.


1.1.1 - Instalando TERRALIB

    Baixe a versão 5.3.1 da TerraLib do site  http://www.dpi.inpe.br/terralib5. Caso outra
versão mais nova esteja disponível, procure na página pela versões anteriores (Previous Releases and previous source code...).
    Não use uma versão diferente da indicada e testada.

    Descomprima o arquivo  terralib-5.3.1-ubuntu-16.04.tar.gz  com comando:
 
Para UBUNTU 16.04:
# tar -xvzf terralib-5.3.1-ubuntu-16.04.tar.gz

Digite o comando:
#  ./install.sh


        Aguarde pela mensagem "Finished successfully!"


NOTA: O Aplicativo TerraView versão 5.3.1 é instalado juntamente com a TerraLib


1.1.2 - Instalando NodeJs
   Para instalar o NodeJs, digite no terminal as seguintes linhas de comando: 

# sudo apt-get install -y curl


# curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -


        Aguarde pela mensagem  "Reading package lists... Done"


# sudo apt-get install -y nodejs


        Aguarde pelo término da instalação

1.1.3 - Instalando PostgreSQL + PostGIS

  Para instalar servidor de banco dados PostgreSQL + PostGIS, digite no terminal as seguintes linhas de comando dependendo da versão do Ubuntu de sua preferência.

Para UBUNTU 16.04:
# sudo apt-get install postgresql-9.5-postgis-2.2

   Se aparecer a seguinte mensagem: Do you want to continue? [Y/n] (digite Y para continuar)

   Por padrão a instalação do PostgreSQL cria uma conta de usuário com login: postgres, porém sem uma senha definida. A plataforma TerraMA2 requer que esta conta tenha uma senha definida, portanto digite no terminal as seguintes linhas de comando, substituindo <password> pela senha desejada:  

# sudo -u postgres psql
# ALTER USER postgres WITH PASSWORD 'postgres';
# \q

IMPORTANTE: Não esquecer do Ponto-Virgula ; no comando ALTER acima.

NOTA:  Após a definição da senha do usuário "postgres" ou criação de outra conta com login e senha diferentes, será necessário informar qual login e senha o TerraMA2 vai utilizar. Veja procedimento a seguir.
Sugerimos a instalação do PgAdmin3  para administração do banco PostgreSql pela interface gráfica. Portanto, digite no terminal a seguinte linha de comando:

# sudo apt-get install pgadmin3


Se aparecer a seguinte mensagem: Do you want to continue? [Y/n] (digite Y para continuar)

1.1.4 "Instalando Java, TOMCAT e Geoserver
   Para a publicação dos dados do TerraMA2 na aplicação Web Instalar o Java 8, Tomcat8  e Geoserver 2.10.3.
   Para instalar o Java 8 recomendamos utilizar o pacote "default" distribuído pela própria versão do Ubuntu. Digite os comandos:

# sudo apt-get update
# sudo apt-get install default-jdk

   Edite o arquivo environment  em /etc   
   Use um editor: vi ou gedit

# sudo vi /etc/environment
        OU
# sudo gedit /etc/environment


   Inserir a linha abaixo e salve
JAVA_HOME="/usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java"


   Digite o comando para ler as alterações
# source /etc/environment


   Para instalar o Tomcat recomendamos utilizar o pacote "default" distribuído pela própria versão do Ubuntu. Digite os comandos:

# sudo apt-get install tomcat8 tomcat8-admin


   Será necessário editar o arquivo "tomcat-users.xml" que está em  /var/lib/tomcat8/conf .  Procure o trecho abaixo que está comentado e copie para fora do comentário, como está abaixo. Inclua a regra "manager-gui" em "roles".
   Utilize comando cd + caminho para abrir local do arquivo, conforme abaixo:

# cd /var/lib/tomcat8/conf

  Novamente utilize um editor de texto vi ou gedit.

# sudo vi tomcat-users.xml  
     OU
# sudo gedit tomcat-users.xml


Antes
<!--
  <role rolename="tomcat"/>
  <role rolename="role1"/>
  <user username="tomcat" password="tomcat" roles="tomcat"/>
  <user username="both" password="tomcat" roles="tomcat,role1"/>
  <user username="role1" password="tomcat" roles="role1"/>
-->
Depois
  <role rolename="tomcat"/>
  <role rolename="role1"/>
  <user username="tomcat" password="tomcat" roles="tomcat,manager-gui"/>
  <user username="both" password="tomcat" roles="tomcat,role1"/>
  <user username="role1" password="tomcat" roles="role1"/>


   Reinicie o serviço do Tomcat com:

# sudo service tomcat8 restart


   A seguir será necessário alterar o limite para arquivos *.WAR no Tomcat, pois o arquivo do Geoserver a ser importado ultrapassa o valor default. Abra o arquivo "web.xml"  que está em  /usr/share/tomcat8-admin/manager/WEB-INF . Note que o valor está em 50MB e o arquivo que iremos importar tem aproximadamente 70MB. Procure pelo trecho abaixo e altere ambos os parâmetros "<max-file-size>" e "<max-request-size>", da seguinte maneira:

# cd /usr/share/tomcat8-admin/manager/WEB-INF
# sudo gedit web.xml

   Procure a sessão abaixo e modifique conforme apresentado a seguir.

Antes
        <multipart-config>
          <!-- 50MB max -->
          <max-file-size>52428800</max-file-size>
          <max-request-size>52428800</max-request-size>
          <file-size-threshold>0</file-size-threshold>
        </multipart-config>

Depois
        <multipart-config>
          <!-- 50MB max -->
          <max-file-size>104857600</max-file-size>
          <max-request-size>104857600</max-request-size>
          <file-size-threshold>0</file-size-threshold>
        </multipart-config>


   Salve as alterações acima e reinicie o serviço do Tomcat com:
# sudo service tomcat8 restart


   O GeoServer testado para ser utilizado pelo TerraMA2 é a versão 2.10.3. Assim descomprima o arquivo "geoserver-2.10.3-war.zip"  com comando:
# unzip geoserver-2.10.3-war.zip


   No navegador digite "localhost:8080/manager". Digite o login: tomcat  e Senha: tomcat na janela aberta. A tela do navegador deverá apresentar a aplicação de gerencia do Tomcat.

   No campo "WAR file to deploy" procure pelo arquivo "geoserver.war" que foi descompactado pelo comando acima. Clique em "Deploy".  Observe que a aplicação deve aparecer na lista acima.
  

   Clique no link "/geoserver" para acessar o menu principal do GeoServer. No navegador digite em 
- login: admin  e
- Senha: geoserver           para acessar o GeoServer.
  
   A instalação do Geoserver vem configurada com um mínimo de utilização da memória do computador. Como as aplicações da plataforma TerraMA2 normalmente demandam muitos dados a serem publicados diariamente, pode ser necessário aumentar ao limites de duas variáveis do tomcat.  Na pasta  /usr/share/tomcat8/bin   edite ou crie o arquivo "setenv.sh" modificando ou inserindo os parâmetros  -Xms128M  e  -Xmx756M  para algo em torno de -Xms512M  e  -Xmx1024M.  Assim, a linha de comando deve ficar da seguinte maneira:

# cd /usr/share/tomcat8/bin
# sudo gedit setenv.sh

  Digite a linha no arquivo
#  export CATALINA_OPTS="-Xms512M -Xmx1024M -Duser.timezone=GMT"


   Reinicie o serviço do tomcat após alteração. Os valores ideais vão depender da máquina disponível.

# sudo service tomcat8 restart


   Para verificar se o tomcat recebeu a alteração dos limites acima, use o comando
# ps aux | grep tomcat


1.1.5 - Instalando VMIME

   Para instalação do VMINE  utilize
# sudo dpkg -i terrama2-vmime-4.0.5_0.9.2-ubuntu16.04_amd64.deb

OBS: Algumas dependências serão instaladas caso não existam na máquina. 
Neste caso uma mensagem de erro será apresentada no terminal. 
Para prosseguir com a instalação digite a linha de comando a seguir no terminal:

# sudo apt-get install -f -y

1.1.6- Instalando TerraMA2

   Para instalar o TerraMA2  com os módulos de administração e monitoramento, digite no terminal a seguinte linha de comando:

   Para UBUNTU 16.04:
# sudo dpkg -i TerraMA2-4.0.5-release-linux-x64-Ubuntu-16.04.deb

OBS: Algumas dependências serão instaladas caso não existam na máquina. Neste caso uma mensagem de erro será apresentada no terminal. Para prosseguir com a instalação digite a linha de comando a seguir no terminal:
# sudo apt-get install -f -y

  Para Instalar a documentação

# sudo dpkg -i terrama2-doc-4.0.5.deb 


   Para iniciar as duas aplicções WEB do TerraMA2, temos duas opções
   
OPÇÃO 1: Utilizar o PM2 para inciar automaticamente ao iniciar o sistema operacional.

# cd /opt/terrama2/4.0.5/share/terrama2/scripts
# sudo chmod +x config_pm2.sh
# sudo ./config_pm2.sh

OPCAO 2: Abrir 2 terminais de comando e digitar em cado os comandos
>>> Terminal 1  <<<<<<
# cd /opt/terrama2/4.0.5/webapp
# sudo npm start


>>> Terminal 2  <<<<<<
# cd /opt/terrama2/4.0.5/webmonitor
# sudo npm start


--------------------------------- 
IMPORTANTE: Caso ambos os módulos, Administração (webapp) e Monitoramento (webmonitor) já estejam em execução e algum dos arquivos acima forem modificados, será necessário reiniciar os serviços desses módulos. Utilize a seguinte linha de comando no terminal:
# sudo pm2 restart webapp webmonitor


Para remover o Terrama2 poderá utilizar um dos comandos a seguir.
# sudo apt remove terrama2
        Remove o TerraMA2 e dependências instaladas. Não remove o diretório onde foi realizada a instalação, arquivo de log e bancos de dados.


# sudo apt remove terrama2 --purge
        Remove o TerraMA2 , dependências instaladas, o diretório onde foi realizada a instalação, arquivo de log e todos os bancos de dados.


1.1.7- Teste dos módulos da plataforma TerraMA2
Para testar os dois aplicativos Web da plataforma TerraMA2 digite as URLs abaixo.
* Módulo de Administração - digite:
        http://localhost:36000


Na janela do navegador digite o login e senha iniciais do administrador são:
   * Usuário:  admin 
   * Senha: admin 
  

* Módulo de Monitoramento - digite:
        http://localhost:36001