diff --git a/README.md b/README.md index af8a0f7..ab74bfd 100755 --- a/README.md +++ b/README.md @@ -2,25 +2,38 @@ Para versões do Mapserver 7.x ou posteriores e Openlayers 4 -Utilize esse repositório para manter seu código sempre atualizado diariamente. Isso garante o recebimento de correções de bugs. +Utilize esse repositório para manter seu código sempre atualizado diariamente. +Isso garante o recebimento de correções de bugs. -Arquivos antigos e outras informações, veja em: https://softwarepublico.gov.br/social/i3geo/ +Arquivos antigos e outras informações, veja em: +https://softwarepublico.gov.br/social/i3geo/ -Guia completo sobre instalação e administração do software, veja em: https://softwarepublico.gov.br/gitlab/i3geo/i3geo/wikis/home +Guia completo sobre instalação e administração do software, veja em: +https://softwarepublico.gov.br/gitlab/i3geo/i3geo/wikis/home -Sobre segurança: https://softwarepublico.gov.br/gitlab/i3geo/i3geo/wikis/notas-sobre-seguranca +Sobre segurança: +https://softwarepublico.gov.br/gitlab/i3geo/i3geo/wikis/notas-sobre-seguranca # Guia de instalação -O i3Geo pode ser instalado em diferentes sistemas operacionais Linux e também no Windows. Nesse tutorial será mostrado como instalar no Windows e no Ubuntu. +O i3Geo pode ser instalado em diferentes sistemas operacionais Linux e também no +Windows. Nesse tutorial será mostrado como instalar no Windows e no Ubuntu. -Os arquivos do i3Geo estão disponíveis no Portal do Software Público Brasileiro (SPB). Para ter acesso a eles é desejável fazer um cadastro. O SPB, utiliza o Git, um sistema de controle de versões para disponibilizar o código. Assim, para obter os arquivos do i3Geo é necessário ter um cliente Git. No Windows pode ser utilizado o Tortoise. A utilização do Git é importante pois você poderá atualizar o software sempre que achar necessário. +Os arquivos do i3Geo estão disponíveis no Portal do Software Público Brasileiro +(SPB). Para ter acesso a eles é desejável fazer um cadastro. O SPB, utiliza o +Git, um sistema de controle de versões para disponibilizar o código. Assim, para +obter os arquivos do i3Geo é necessário ter um cliente Git. No Windows pode ser +utilizado o Tortoise. A utilização do Git é importante pois você poderá +atualizar o software sempre que achar necessário. ## Docker -Esta versão do i3geo conta com uma imagem Docker que pode ser utilizada para testar rapidamente o software e também utiliá-lo em ambiente produtivo após as suas customizações. +Esta versão do i3geo conta com uma imagem Docker que pode ser utilizada para +testar rapidamente o software e também utiliá-lo em ambiente produtivo após as +suas customizações. -Para usar basta ter o Docker instalado no seu computador e executar o seguinte comando: +Para usar basta ter o Docker instalado no seu computador e executar o seguinte +comando: `docker run -i -t -p 80:8080 --rm i3geo/i3geo` @@ -30,44 +43,58 @@ Em seguida, acesse um navegador de sua preferência e insira o seguinte endereç Mais opções em https://hub.docker.com/u/i3geo/dashboard/ -Dicas sobre Docker: https://www.digitalocean.com/community/tutorials/como-instalar-e-utilizar-o-docker-primeiros-passos-pt +Dicas sobre Docker: +https://www.digitalocean.com/community/tutorials/como-instalar-e-utilizar-o-docker-primeiros-passos-pt ## Windows -Utilize pacote MS4W, que irá transformar o seu computador em um servidor web (apenas para uso pessoal), ao instalar os softwares APACHE, PHP e Mapserver. +Utilize pacote MS4W, que irá transformar o seu computador em um servidor web +(apenas para uso pessoal), ao instalar os softwares APACHE, PHP e Mapserver. -Para isso faça o download do arquivo de instalação em http://www.ms4w.com/download.html#download. +Para isso faça o download do arquivo de instalação em +http://www.ms4w.com/download.html#download. -Nas opções de pacotes escolha pelo menos "MS4W Base Files" e "Install and Start Apache Server", na opção "Destination root" escolha "C:\" e em "Apache port" mantenha como "80". +Nas opções de pacotes escolha pelo menos "MS4W Base Files" e "Install and Start +Apache Server", na opção "Destination root" escolha "C:\" e em "Apache port" +mantenha como "80". -Teste a instalação digitando em seu navegador de internet: http://localhost (se não funcionar, reinicie o computador). +Teste a instalação digitando em seu navegador de internet: http://localhost (se +não funcionar, reinicie o computador). -Depois de instalado o MS4W você terá em seu computador a pasta c:\ms4w\Apache\htdocs. Dentro dessa pasta é que o i3Geo deverá ser copiado. +Depois de instalado o MS4W você terá em seu computador a pasta +c:\ms4w\Apache\htdocs. Dentro dessa pasta é que o i3Geo deverá ser copiado. -Alguns usuários reportaram problemas ao instalar o Apache em algumas versões do Windows. Nesses casos a seguinte rotina pode resolver o problema: +Alguns usuários reportaram problemas ao instalar o Apache em algumas versões do +Windows. Nesses casos a seguinte rotina pode resolver o problema: * No Painel de Controle, digite no campo de pesquisa UAC * Escolha a opção “Alterar configurações de Controle de Contas de Usuário”. * Na janela que será aberta na sequência, configure para “Nunca notificar“. * Reinicie o computador * Execute novamente o arquivo apache-install.bat -* Para confirmar que tudo ocorreu bem, abra o navegador de internet e digite http:\\localhost +* Para confirmar que tudo ocorreu bem, abra o navegador de internet e digite + http:\\localhost ### i3Geo Windows -Para obter o código do i3Geo você tem duas opções, a primeira utiliza simplesmente o download de um arquivo e a segunda utiliza o Git. A vantagem da segunda opção é que você poderá atualizar sua instalação de forma mais fácil. +Para obter o código do i3Geo você tem duas opções, a primeira utiliza +simplesmente o download de um arquivo e a segunda utiliza o Git. A vantagem da +segunda opção é que você poderá atualizar sua instalação de forma mais fácil. #### Primeira opção: -* Baixe o código do i3Geo: https://softwarepublico.gov.br/gitlab/i3geo/i3geo/repository/archive.zip +* Baixe o código do i3Geo: + https://softwarepublico.gov.br/gitlab/i3geo/i3geo/repository/archive.zip * Descompacte a pasta i3geo.git para dentro da pasta c:\ms4w\Apache\htdocs -* Renomeie a pasta c:\ms4w\Apache\htdocs\i3geo.git para c:\ms4w\Apache\htdocs\i3geo +* Renomeie a pasta c:\ms4w\Apache\htdocs\i3geo.git para + c:\ms4w\Apache\htdocs\i3geo * Teste o funcionamento digitando no navegador http://localhost/i3geo #### Segunda opção: * Instale o Git: https://git-for-windows.github.io/ utilizando as opções default. -* Após a instalação, clique com o botão da direita sobre a pasta c:\ms4w\Apache\htdocs e escolha a opção "Git Bash Here" +* Após a instalação, clique com o botão da direita sobre a pasta + c:\ms4w\Apache\htdocs e escolha a opção "Git Bash Here" * No terminal digite a sequência de comandos: ``` @@ -82,7 +109,8 @@ Não esqueça o PONTO no final da linha acima. Válido apenas se você não é um desenvolvedor do i3Geo e não tenha feito checkout via SSH. -Clique com o botão da direita sobre a pasta c:\ms4w\Apache\htdocs\i3geo e escolha a opção "Git Bash Here" +Clique com o botão da direita sobre a pasta c:\ms4w\Apache\htdocs\i3geo e +escolha a opção "Git Bash Here" ``` git stash @@ -92,7 +120,8 @@ git stash pop Observação: -* Pode ser que você precise registrar um usuário no Git antes de executar um stash. Para isso execute os seguintes comandos: +* Pode ser que você precise registrar um usuário no Git antes de executar um + stash. Para isso execute os seguintes comandos: ``` git config --global user.email seuemail@example.com @@ -102,22 +131,34 @@ git config --global user.name "Seu Nome" ### PostGIS Windows (opcional) -Para instalar o PostGIS siga o roteiro mostrado em http://postgis.net/windows_downloads +Para instalar o PostGIS siga o roteiro mostrado em +http://postgis.net/windows_downloads -Instale também o pgAdmin, que é uma interface gráfica para o PostGIS: http://www.pgadmin.org/download/windows.php +Instale também o pgAdmin, que é uma interface gráfica para o PostGIS: +http://www.pgadmin.org/download/windows.php -Caso deseje, carregue no PostGIS o banco de dados do i3GeoSaúde. Esse banco é utilizado em alguns dos tutoriais do i3Geo e pode servir de teste para uso com o SAIKU. +Caso deseje, carregue no PostGIS o banco de dados do i3GeoSaúde. Esse banco é +utilizado em alguns dos tutoriais do i3Geo e pode servir de teste para uso com o +SAIKU. -* Primeiro baixe o arquivo https://softwarepublico.gov.br/gitlab/i3geo/i3geosaude/raw/master/databasei3geosaude.backup -* Abra o pgAdmin e crie uma nova conexão com o banco de dados. Em nome do host utilize "localhost" e o login e senha que você usou na istalação, normalmente "postgres". -* Utilize as opções do pgAdmin para criar um novo banco de dados chamado i3geosaude. Ao criá-lo, utilize o banco de dados postgres como template e login e senha "postgres". -* Clicando sobre o novo banco de dados, localize a opção "restore" e faça a carga do banco de dados que foi baixado no início. +* Primeiro baixe o arquivo + https://softwarepublico.gov.br/gitlab/i3geo/i3geosaude/raw/master/databasei3geosaude.backup +* Abra o pgAdmin e crie uma nova conexão com o banco de dados. Em nome do host + utilize "localhost" e o login e senha que você usou na istalação, normalmente + "postgres". +* Utilize as opções do pgAdmin para criar um novo banco de dados chamado + i3geosaude. Ao criá-lo, utilize o banco de dados postgres como template e + login e senha "postgres". +* Clicando sobre o novo banco de dados, localize a opção "restore" e faça a + carga do banco de dados que foi baixado no início. ## Linux (baseado em Ubuntu 14.04) Instale os softwares necesários para configurar o servidor web com PHP5, Mapserver e outros. -Importante: versões mais novas do Ubuntu utilizam PHP7, nesses casos, siga os passos baseados no Ubuntu 16 (https://softwarepublico.gov.br/gitlab/i3geo/i3geo#linux-baseado-em-ubuntu-16). +Importante: versões mais novas do Ubuntu utilizam PHP7, nesses casos, siga os +passos baseados no Ubuntu 16 +(https://softwarepublico.gov.br/gitlab/i3geo/i3geo#linux-baseado-em-ubuntu-16). No terminal, digite a sequência de comandos abaixo. @@ -144,7 +185,8 @@ sudo apt-get install r-base r-base-core r-cran-maptools sudo apt-get install php5-mbstring ``` -Em alguns casos a mbstring já é instalada junto com o PHP, por isso esse comando pode gerar mensagem de erro sem maiores consequências. +Em alguns casos a mbstring já é instalada junto com o PHP, por isso esse comando +pode gerar mensagem de erro sem maiores consequências. Lista de códigos EPSG, sua ausência faz com que os serviços WMS não funcionem. @@ -169,9 +211,11 @@ Teste a instalação digitando no seu navegador web http://localhost ## Linux (baseado em Ubuntu 16) -As versões mais recentes do Ubuntu utilizam como padrão o PHP 7, que é incompatível com o Mapserver e i3Geo. +As versões mais recentes do Ubuntu utilizam como padrão o PHP 7, que é +incompatível com o Mapserver e i3Geo. -Nesses casos é necessário adicionar um repositório de código que contenha o PHP 5 e compilar o Mapserver, o que pode ser feito seguindo-se o roteiro: +Nesses casos é necessário adicionar um repositório de código que contenha o PHP +5 e compilar o Mapserver, o que pode ser feito seguindo-se o roteiro: Digite no terminal Linux: @@ -220,7 +264,9 @@ service apache2 restart ### i3Geo Linux -Para obter o código do i3Geo você tem duas opções, a primeira utiliza simplesmente o download de um arquivo e a segunda utiliza o Git. A vantagem da segunda opção é que você poderá atualizar sua instalação de forma mais fácil. +Para obter o código do i3Geo você tem duas opções, a primeira utiliza +simplesmente o download de um arquivo e a segunda utiliza o Git. A vantagem da +segunda opção é que você poderá atualizar sua instalação de forma mais fácil. Após a instalação, digite no navegador web http://localhost/i3geo @@ -245,18 +291,21 @@ Não esqueça o ponto no final da linha acima. ### Permissões -Para uso local você pode modificar de forma mais liberal as permissões dos arquivos. No terminal digite: +Para uso local você pode modificar de forma mais liberal as permissões dos +arquivos. No terminal digite: ``` sudo chmod -R 777 /var/www/html/i3geo sudo chmod -R 777 /var/www/html/ms_tmp ``` -Em ambiente de produção devem ser consideradas as orientações que constam no artigo sobre segurança (ver Wiki). +Em ambiente de produção devem ser consideradas as orientações que constam no +artigo sobre segurança (ver Wiki). ### Atualização do código (Ubuntu) -Válido apenas se você não é um desenvolvedor do i3Geo e não tenha feito checkout via SSH. +Válido apenas se você não é um desenvolvedor do i3Geo e não tenha feito checkout +via SSH. Abra o terminal e digite os seguintes comandos (pode ser necessário usar `sudo`): @@ -269,7 +318,8 @@ git stash pop Observação: -* Pode ser que você precise registrar um usuário no Git antes de executar um stash. Para isso execute os seguintes comandos: +* Pode ser que você precise registrar um usuário no Git antes de executar um + stash. Para isso execute os seguintes comandos: ``` cd /var/www/html/i3geo @@ -281,7 +331,8 @@ git config --global user.name "Seu Nome" Instale o PostgreSQL e PostGIS -(dependendo da versão do PostgreSQL pode ser necessário alterar de 9.1 para a versão correta) +(dependendo da versão do PostgreSQL pode ser necessário alterar de 9.1 para a +versão correta) ``` apt-get install postgresql postgis pgadmin3 @@ -292,11 +343,13 @@ service postgresql start Observações: -* Dependendo da versão do PostgreSQL alguns comandos podem ser diferentes. Veja a pasta /usr/share/postgresql para descobrir a versão instalada) +* Dependendo da versão do PostgreSQL alguns comandos podem ser diferentes. Veja + a pasta /usr/share/postgresql para descobrir a versão instalada) * Pode ser necessário o uso de sudo, exemplo: sudo su - postgres -c "createdb i3geosaude" -* Você pode primeiro mudar para o usuário postgres e depois executar os comandos. Nesse caso utilize "sudo su postgres" e depois "psql" +* Você pode primeiro mudar para o usuário postgres e depois executar os + comandos. Nesse caso utilize "sudo su postgres" e depois "psql" * Para sair de "psql" digite \d @@ -306,7 +359,9 @@ Observações: * Para executar um arquivo SQL utilize "\i arquivo.sql" -* Pode ser que ao final do processo, ele seja executado apesar de ter encontrado erros. Isso se deve a diferenças de versões do PostgreSQL e PostGIS, e pode ser ignorado. +* Pode ser que ao final do processo, ele seja executado apesar de ter encontrado + erros. Isso se deve a diferenças de versões do PostgreSQL e PostGIS, e pode + ser ignorado. Comandos para instalação: @@ -328,7 +383,10 @@ pg_restore --host localhost --port 5432 --username postgres --dbname i3geosaude ## Chave utilizada pela API do GoogleMaps -Devido às restrições de uso da API do GoogleMaps, é necessário registrar uma chave no site do Google para o seu endereço de servidor para que as funcionalidades do i3Geo que utilizam essa API funcionem. Veja como fazer em: http://code.google.com/apis/maps/signup.html. +Devido às restrições de uso da API do GoogleMaps, é necessário registrar uma +chave no site do Google para o seu endereço de servidor para que as +funcionalidades do i3Geo que utilizam essa API funcionem. Veja como fazer em: +http://code.google.com/apis/maps/signup.html. A chave deve ser incluída na variável $googleApiKey do arquivo i3geo/ms_configura.php. -- libgit2 0.21.2