# Pré-Requisitos de Instalação

<div class="document" id="bkmrk-pr%C3%A9-requisitos-de-in" itemscope="itemscope" itemtype="http://schema.org/Article" role="main"><div itemprop="articleBody"><section id="bkmrk-pr%C3%A9-requisitos-de-in-1"># Pré-Requisitos de Instalação

É recomendável que a equipe técnica responsável pela implantação no sistema Polare na instituição tenha alguma experiência com as tecnologias a seguir.

**Java.** O sistema Polare está sendo escrito em [Java](https://java.com/) e portanto alguma experiência com essa linguagem pode ser útil, mas não estritamente necessário para implantaçao do sistema.

**Maven.** O sistema Polare utiliza uma ferramenta construção de projeto e gerenciamento de dependências chamada [Maven](https://maven.apache.org/). Não é necessário ter conhecimento aprofundado sobre essa ferramenta, visto que para gerar os artefatos `<span class="pre">.war</span>` do sistema Polare é preciso apenas ter o Maven instalado e executar comandos pré-definidos no *shell* do sistema.

**Git.** Git é um sistema de versionamento (controle de versão) distribuído. Necessário para obtenção do código fonte do sistema Polare. Não é necessário ter conhecimento aprofundado sobre essa ferramenta, visto que para obter o código fonte do sistema Polare é preciso apenas ter o Git instalado e executar comandos pré-definidos no *shell* do sistema.

**Web.** Pode ser necessário editar algumas páginas *web* do sistema Polare de forma a customizar a identidade visual da instituição. O sistema Polare utiliza o *framework web* [Thymeleaf](https://www.thymeleaf.org/), mas algum conhecimento básico de html, css e javascript deve ser suficiente para efetuar alterações em páginas *web* do sistema.

**Linux.** Experiência fundamental. Nessa implantação utilizamos o [Ubuntu](https://ubuntu.com/) linux por conveniência. Outras *distros* linux podem ser utilizadas de acordo com a necessidade da instituição.

**Docker.** Nesta implantação optamos por utilizar [Docker](https://docs.docker.com/get-docker/), embora cada instituição possa definir como o sistema Polare deverá ser implantado internamente. Entretanto, recomendamos Docker como uma forma moderna e robusta de executar esse tipo de implantação.

**Postgresql.** Experiência com bancos de dados é importante em virtualmente qualquer sistema moderno de *sofware*. Não é estritamente necessária para a implantação do sistema Polare, mas é útil para entender e resolver certos problemas relacionados com migrações e *schemas*, bem como configuração de usuários e acesso ao banco de dados.

<section id="bkmrk-software-e-hardware--0">## Software e Hardware necessários

**Infraestrutura de API**. É necessário instalar uma infraestrutura de que permita acessar a API de sistemas. Essa API de sistemas é responsável por fornecer ao sistema Polare informações do usuário servidor, como por exemplo, lotação e hierarquia funcional. Tecnicamente, essa infraestrutura é um conjunto de sistemas a parte que fornece informações armazenadas nos bancos de dados do SIG via API [Restful](https://en.wikipedia.org/wiki/Representational_state_transfer).

A UFRN pode disponibilizar um ambiente contendo essa infraestrutura. Acesse a documentação oficial (é necessário login) para mais detalhes:

</section><section id="bkmrk-https%3A%2F%2Fdocs.info.uf">[https://docs.info.ufrn.br/doku.php?id=cooperacao:tutoriais:infraestrutura:api:montagem\_infraestrutura\_api](https://docs.info.ufrn.br/doku.php?id=cooperacao:tutoriais:infraestrutura:api:montagem_infraestrutura_api).

<figure class="align-center" id="bkmrk-vis%C3%A3o-geral-do-ambie">![_images/visao-geral-ambiente-api.png](https://polare-install-docs.readthedocs.io/en/latest/_images/visao-geral-ambiente-api.png)<figcaption><span class="caption-text">Visão geral do ambiente</span>[](https://polare-install-docs.readthedocs.io/en/latest/requisitos.html#id2 "Permalink to this image")

</figcaption></figure>Note

A infraestrutura de API utilizada pelo Polare no IFPA foi instalada anteriormente para ser utilizada pelo SIGAA Mobile. Nesse caso a infraestrutura de API foi reutilizada.

Warning

Alguns erros de API no sistema Polare podem ser corrigidos atualizando as imagens Docker de uma infraestrutura de API previamente instalada. O problema decorre da defasagem entre a versão da infraestrutura de API instalada e o Polare.

**Maven.** Instalar o Maven. Basicamente fazer o download da ferramenta e acessar os executáveis contidos no diretório bin via linha de comando. Para mais detalhes acesse [https://maven.apache.org/download.cgi](https://maven.apache.org/download.cgi)

**Git.** Instalar o Git. Para mais detalhes acesse [https://git-scm.com/download/linux](https://git-scm.com/download/linux)

**Servidor Linux.** Instalar um servidor Linux com seguintes configurações:

- 4 GB de memória Ram
- 100 GB de armazenamento
- 4 núcleos de processador
- Ubuntu 22.04.1 LTS

**Docker e Docker-compose**. Instalar no servidor Linux as versões mais atuais do [Docker](https://docs.docker.com/get-docker/) e [Docker-compose](https://docs.docker.com/compose/).

</section></section></div></div><footer id="bkmrk-%C2%A0previousnext%C2%A0-reach"><div aria-label="Footer" class="rst-footer-buttons" role="navigation">[ Previous](https://polare-install-docs.readthedocs.io/en/latest/index.html "Guia de Instalação do Sistema Polare")[Next ](https://polare-install-docs.readthedocs.io/en/latest/instalacao.html "Instalação do Sistema")</div>---

<div><div class="ethical-rtd loaded" data-ea-campaign-types="community|house|paid" data-ea-keywords="only words|readthedocs-project-815127|readthedocs-project-polare-install-docs" data-ea-manual="true" data-ea-publisher="readthedocs" data-ea-type="readthedocs-sidebar" id="bkmrk-reach-specific-devel"><div class="ethical-sidebar"><div class="ethical-content">[![Sponsored: EthicalAds](https://media.ethicalads.io/media/images/2021/08/Screen_Shot_2021-08-03_at_2.45.09_PM.png)](https://server.ethicalads.io/proxy/click/1641/04ae2d26-7892-40ad-913e-b37a3e3dfb58/)<div class="ethical-text">[**Reach specific developers** <span class="ea-body">on the open source, privacy-first ad network:</span> **EthicalAds**](https://server.ethicalads.io/proxy/click/1641/04ae2d26-7892-40ad-913e-b37a3e3dfb58/)</div></div><div class="ethical-callout"><small>*[Ad by EthicalAds](https://www.ethicalads.io/?ref=rtd-sidebar)*</small> · [ℹ️](https://www.ethicalads.io/advertisers/topics/devops/?ref=rtd-sidebar-buy-ads)</div></div></div></div>© Copyright 2023, UFRN/IFPA. <span class="commit">Revision `ce91cf46`.</span>

Built with [Sphinx](https://www.sphinx-doc.org/) using a [theme](https://github.com/readthedocs/sphinx_rtd_theme) provided by [Read the Docs](https://readthedocs.org/).</footer>