-
Notifications
You must be signed in to change notification settings - Fork 24
Instalação manual
O TerraMA² foi testado na distribuição linux Ubuntu versão 16.04, portanto, não é garantido o funcionamento em uma distribuição diferente. Caso queira instalar em outra distribuição, siga o manual de instalação via Docker.
Para instalar o TerraMA², primeiro é necessário instalar as dependências a seguir:
A versão da Terralib utilizada é a 5.4.5. Para instalar é necessário fazer o download do instalador, extrair os arquivos e rodar o script install.sh localizado na pasta extraída, ou, rodar os comandos a seguir:
wget http://www.terrama2.dpi.inpe.br/pub/downloads/terralib-5.4.5-ubuntu-16.04.tar.gz
tar -xvzf terralib-5.4.5-ubuntu-16.04.tar.gz
./install.shAguarde pela mensagem Finished successfully!.
A versão do PostgreSQL deve ser 9 ou maior, porém, recomendamos a 11 por ser mais recente. Para instalar, rode os comandos a seguir:
sudo touch /etc/apt/sources.list.d/pgdg.list
sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt/ xenial-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
curl https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
sudo apt-get update
sudo apt-get install -y postgresql-11-postgis-2.5 postgresql-server-dev-11Caso queira instalar outra versão, acesse o site do PostgreSQL.
Para a administração do banco de dados PostgreSQL pela interface gráfica, instale o PGAdmin com o seguinte comando:
sudo apt-get install -y pgadmin4
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 TerraMA² requer que esta conta tenha uma senha definida, portanto, digite no terminal o seguinte comando:
sudo -u postgres psql -c "ALTER USER postgres WITH PASSWORD 'postgres'"
Esse comando atribui a senha postgres ao banco de dados.
O NodeJS deve estar na versão 8. Para instalar rode os comandos a seguir:
sudo apt-get install -y curl
curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt-get -y install nodejsAntes de instalar o Geoserver, é necessário a instalação do Java 8 com o seguinte comando:
sudo apt-get install -y openjdk-8-jdkA versão recomendada para ser utilizado no TerraMA² é a 2.12.5 e pode ser instalado de duas formas. A forma mais rápida é utilizando o binário (Platform Independent Binary), encontrado no site do Geoserver. A forma mais recomendada é utilizando o Web Archive, também encontrado no site. Seguem os passos para as duas formas de instalação:
Instalação utilizando o binário
Para instalar o Geoserver utilizando o binário, faça o download do arquivo e descompacte.
cd /home/${USER}
wget -c https://ufpr.dl.sourceforge.net/project/geoserver/GeoServer/2.12.5/geoserver-2.12.5-bin.zip
unzip geoserver-2.12.5-bin.zipInstalação utilizando o Web Archive
Para essa forma de instalação é necessário instalar o Tomcat com o seguinte comando:
sudo apt-get install -y tomcat8 tomcat8-admin
Depois é necessário editar o arquivo tomcat-users.xml localizado em /var/lib/tomcat8/conf. Para isso, digite os comando abaixo:
cd /var/lib/tomcat8/conf
sudo gedit tomcat-users.xml
Procure o trecho abaixo:
<!--
<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"/>
-->
E substitua por este trecho:
<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"/>
A seguir, será necessário alterar o limite para arquivos .war no Tomcat, pois, o arquivo do Geoserver a ser importado ultrapassa o valor padrão. Abra o arquivo web.xml que está em /usr/share/tomcat8-admin/manager/WEB-INF.
cd /usr/share/tomcat8-admin/manager/WEB-INF
sudo gedit web.xml
Procure pelo trecho abaixo:
<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>
E substitua por este trecho:
<multipart-config>
<!-- 100MB max -->
<max-file-size>104857600</max-file-size>
<max-request-size>104857600</max-request-size>
<file-size-threshold>0</file-size-threshold>
</multipart-config>
Rode o comando a seguir para reiniciar o Tomcat.
sudo service tomcat8 restart
Agora faça o download do Web Archive no site do Geoserver e descompacte o zip com o seguinte comando.
unzip geoserver-2.12.5-war.zip
Abra o navegador e digite localhost:8080/manager. Na janela que abrir, digite o login tomcat e a senha tomcat. A tela do navegador deverá apresentar a aplicação de gerenciamento do Tomcat. No campo WAR file to deploy procure pelo arquivo geoserver.war que foi descompactado pelo comando acima, encontrado na pasta geoserver-2.12.5-war.
Memória do JAVA
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 TerraMA² normalmente demandam muitos dados a serem publicados diariamente, pode ser necessário aumentar os limites de duas variáveis do Java (-Xms e -Xmx). Para alterar essas variáveis, rode os comandos a seguir:
echo "JAVA_OPTS=\"$JAVA_OPTS -Xms2048m -Xmx4096m -XX:+UseParallelGC\"" | sudo tee -a /etc/environment > /dev/null
source /etc/environmentCaso o Geoserver tenha sido instalado usando o Web archive rode também esses comandos:
echo "CATALINA_OPTS=\"$CATALINA_OPTS -server -Xms2048m -Xmx4096m -XX:+UseParallelGC -Duser.timezone=GMT\"" | sudo tee -a /etc/environment > /dev/null
source /etc/environment
sudo service tomcat8 restart
Para instalar o TerraMA², dois arquivos .deb devem ser baixados (terrama2-doc-4.1.1.deb e TerraMA2-4.1.1-release-linux-x64-Ubuntu-16.04.deb) e depois instalados com os comandos a seguir:
wget http://www.terrama2.dpi.inpe.br/pub/downloads/terrama2-doc-4.1.1.deb
sudo dpkg -i terrama2-doc-4.1.1.deb
wget http://www.terrama2.dpi.inpe.br/pub/downloads/TerraMA2-4.1.1-release-linux-x64-Ubuntu-16.04.deb
sudo dpkg -i TerraMA2-4.1.1-release-linux-x64-Ubuntu-16.04.deb
sudo apt-get install -f -yPara finalizar a instalação, é necessário alterar as permissões da pasta onde o TerraMA² foi instalado, instalar as dependências do NodeJS e criar os arquivos de configuração. Para isso, rode os comandos a seguir:
sudo mkdir /opt/terrama2/4.1.1/webapp/node_modules
sudo mkdir /opt/terrama2/4.1.1/webcomponents/node_modules
sudo mkdir /opt/terrama2/4.1.1/webmonitor/node_modules
sudo chmod 755 -R /opt/terrama2/4.1.1
sudo chown 1000:1000 -R /opt/terrama2/4.1.1
sudo chown -R 1000:1000 "/home/$(id -gn 1000)/.npm"
sudo chown -R $USER:$(id -gn $USER) /home/$(id -gn 1000)/.config
cd /opt/terrama2/4.1.1/webapp
sudo -u $(id -gn 1000) npm install
sudo -u $(id -gn 1000) npm run grunt
cd config/
sudo cp -a db.json.example db.json
sudo cp -a settings.json.example settings.json
cd /opt/terrama2/4.1.1/webcomponents
sudo -u $(id -gn 1000) npm install
sudo -u $(id -gn 1000) npm run grunt
cd /opt/terrama2/4.1.1/webmonitor
sudo -u $(id -gn 1000) npm install
sudo -u $(id -gn 1000) npm run grunt
cd config/
sudo cp -a sample_instances instancesExistem duas formas de iniciar os aplicativos web do TerraMA². A forma mais simples é utilizando o npm start. Basta navegar até a pasta dos aplicativos e rodar o comando.
Abra o terminal e digite:
cd /opt/terrama2/4.1.1/webapp
npm startAbra outra janela de terminal e digite:
cd /opt/terrama2/4.1.1/webmonitor
npm startAs janelas de terminal devem permanecer abertas enquanto os aplicativos estiverem em uso.
A segunda forma é utilizando a ferramenta PM2. Essa ferramenta permite que os aplicativos web sejam inicializados com o sistema operacional, não sendo necessário abrir os terminais e executar o comando npm start manualmente sempre que for usar a plataforma.
Instalação e configuração
Para instalar e configurar o PM2 navegue até a pasta /opt/terrama2/4.1.1/share/terrama2/scripts e rode o script config_pm2.sh.
cd /opt/terrama2/4.1.1/share/terrama2/scripts
./config_pm2.shEsse comando irá configurar as duas aplicações web para iniciar automaticamente com o sistema operacional, utilizando o seguinte comando:
pm2 start npm --name NOME_DA_APLICAÇÃO -- startPara reiniciar uma aplicação, digite:
sudo pm2 restart NOME_DA_APLICAÇÃOPara remover uma aplicação, digite:
pm2 delete NOME_DA_APLICAÇÃONo lugar do NOME_DA_APLICAÇÃO digite o nome de uma das aplicações web: webapp ou webmonitor.
Caso você tenha instalado o Geoserver utilizando o instalador binário, é necessário inicializá-lo. Basta navegar até a pasta onde está instalado e rodar o script startup.sh. Seguem os comandos:
cd /home/${USER}/bin
./startup.sh
É possível também iniciá-lo com o PM2, basta rodar o comando abaixo:
pm2 start startup.sh --name geoserver -- startPara utilizar as aplicações web abra o navegador e digite http://localhost:36000 para abrir o Módulo de administração e http://localhost:36001 para abrir o Módulo de monitoramento. Para abrir o Geoserver digite http://localhost:8080/geoserver.
Para acessar o Módulo de administração é necessário fazer o login. Por padrão o usuário é admin e a senha é admin. O usuário do Geoserver é admin e a senha é geoserver.
Este manual ensinou a instalar o TerraMA² com as configurações padrão. Para obter informações sobre a configuração da plataforma acesse o guia de configuração.