Download as
Browse Code »

Commit de8ccb0f089d9b7ad64050d4bbb7d2bf7f6a7df7

Authored by Fábio Ribeiro
1 parent ae437811
Exists in readme

Quebra de linha para facilitar os commits

Showing 1 changed file with 101 additions and 43 deletions   Show diff stats
README.md
  Diff comments   View file @de8ccb0
... ... @@ -2,25 +2,38 @@
2 2  
3 3 Para versões do Mapserver 7.x ou posteriores e Openlayers 4
4 4  
5   -Utilize esse repositório para manter seu código sempre atualizado diariamente. Isso garante o recebimento de correções de bugs.
  5 +Utilize esse repositório para manter seu código sempre atualizado diariamente.
  6 +Isso garante o recebimento de correções de bugs.
6 7  
7   -Arquivos antigos e outras informações, veja em: https://softwarepublico.gov.br/social/i3geo/
  8 +Arquivos antigos e outras informações, veja em:
  9 +https://softwarepublico.gov.br/social/i3geo/
8 10  
9   -Guia completo sobre instalação e administração do software, veja em: https://softwarepublico.gov.br/gitlab/i3geo/i3geo/wikis/home
  11 +Guia completo sobre instalação e administração do software, veja em:
  12 +https://softwarepublico.gov.br/gitlab/i3geo/i3geo/wikis/home
10 13  
11   -Sobre segurança: https://softwarepublico.gov.br/gitlab/i3geo/i3geo/wikis/notas-sobre-seguranca
  14 +Sobre segurança:
  15 +https://softwarepublico.gov.br/gitlab/i3geo/i3geo/wikis/notas-sobre-seguranca
12 16  
13 17 # Guia de instalação
14 18  
15   -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.
  19 +O i3Geo pode ser instalado em diferentes sistemas operacionais Linux e também no
  20 +Windows. Nesse tutorial será mostrado como instalar no Windows e no Ubuntu.
16 21  
17   -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.
  22 +Os arquivos do i3Geo estão disponíveis no Portal do Software Público Brasileiro
  23 +(SPB). Para ter acesso a eles é desejável fazer um cadastro. O SPB, utiliza o
  24 +Git, um sistema de controle de versões para disponibilizar o código. Assim, para
  25 +obter os arquivos do i3Geo é necessário ter um cliente Git. No Windows pode ser
  26 +utilizado o Tortoise. A utilização do Git é importante pois você poderá
  27 +atualizar o software sempre que achar necessário.
18 28  
19 29 ## Docker
20 30  
21   -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.
  31 +Esta versão do i3geo conta com uma imagem Docker que pode ser utilizada para
  32 +testar rapidamente o software e também utiliá-lo em ambiente produtivo após as
  33 +suas customizações.
22 34  
23   -Para usar basta ter o Docker instalado no seu computador e executar o seguinte comando:
  35 +Para usar basta ter o Docker instalado no seu computador e executar o seguinte
  36 +comando:
24 37  
25 38 `docker run -i -t -p 80:8080 --rm i3geo/i3geo`
26 39  
... ... @@ -30,44 +43,58 @@ Em seguida, acesse um navegador de sua preferência e insira o seguinte endereç
30 43  
31 44 Mais opções em https://hub.docker.com/u/i3geo/dashboard/
32 45  
33   -Dicas sobre Docker: https://www.digitalocean.com/community/tutorials/como-instalar-e-utilizar-o-docker-primeiros-passos-pt
  46 +Dicas sobre Docker:
  47 +https://www.digitalocean.com/community/tutorials/como-instalar-e-utilizar-o-docker-primeiros-passos-pt
34 48  
35 49 ## Windows
36 50  
37   -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.
  51 +Utilize pacote MS4W, que irá transformar o seu computador em um servidor web
  52 +(apenas para uso pessoal), ao instalar os softwares APACHE, PHP e Mapserver.
38 53  
39   -Para isso faça o download do arquivo de instalação em http://www.ms4w.com/download.html#download.
  54 +Para isso faça o download do arquivo de instalação em
  55 +http://www.ms4w.com/download.html#download.
40 56  
41   -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".
  57 +Nas opções de pacotes escolha pelo menos "MS4W Base Files" e "Install and Start
  58 +Apache Server", na opção "Destination root" escolha "C:\" e em "Apache port"
  59 +mantenha como "80".
42 60  
43   -Teste a instalação digitando em seu navegador de internet: http://localhost (se não funcionar, reinicie o computador).
  61 +Teste a instalação digitando em seu navegador de internet: http://localhost (se
  62 +não funcionar, reinicie o computador).
44 63  
45   -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.
  64 +Depois de instalado o MS4W você terá em seu computador a pasta
  65 +c:\ms4w\Apache\htdocs. Dentro dessa pasta é que o i3Geo deverá ser copiado.
46 66  
47   -Alguns usuários reportaram problemas ao instalar o Apache em algumas versões do Windows. Nesses casos a seguinte rotina pode resolver o problema:
  67 +Alguns usuários reportaram problemas ao instalar o Apache em algumas versões do
  68 +Windows. Nesses casos a seguinte rotina pode resolver o problema:
48 69  
49 70 * No Painel de Controle, digite no campo de pesquisa UAC
50 71 * Escolha a opção “Alterar configurações de Controle de Contas de Usuário”.
51 72 * Na janela que será aberta na sequência, configure para “Nunca notificar“.
52 73 * Reinicie o computador
53 74 * Execute novamente o arquivo apache-install.bat
54   -* Para confirmar que tudo ocorreu bem, abra o navegador de internet e digite http:\\localhost
  75 +* Para confirmar que tudo ocorreu bem, abra o navegador de internet e digite
  76 + http:\\localhost
55 77  
56 78 ### i3Geo Windows
57 79  
58   -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.
  80 +Para obter o código do i3Geo você tem duas opções, a primeira utiliza
  81 +simplesmente o download de um arquivo e a segunda utiliza o Git. A vantagem da
  82 +segunda opção é que você poderá atualizar sua instalação de forma mais fácil.
59 83  
60 84 #### Primeira opção:
61 85  
62   -* Baixe o código do i3Geo: https://softwarepublico.gov.br/gitlab/i3geo/i3geo/repository/archive.zip
  86 +* Baixe o código do i3Geo:
  87 + https://softwarepublico.gov.br/gitlab/i3geo/i3geo/repository/archive.zip
63 88 * Descompacte a pasta i3geo.git para dentro da pasta c:\ms4w\Apache\htdocs
64   -* Renomeie a pasta c:\ms4w\Apache\htdocs\i3geo.git para c:\ms4w\Apache\htdocs\i3geo
  89 +* Renomeie a pasta c:\ms4w\Apache\htdocs\i3geo.git para
  90 + c:\ms4w\Apache\htdocs\i3geo
65 91 * Teste o funcionamento digitando no navegador http://localhost/i3geo
66 92  
67 93 #### Segunda opção:
68 94  
69 95 * Instale o Git: https://git-for-windows.github.io/ utilizando as opções default.
70   -* 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"
  96 +* Após a instalação, clique com o botão da direita sobre a pasta
  97 + c:\ms4w\Apache\htdocs e escolha a opção "Git Bash Here"
71 98 * No terminal digite a sequência de comandos:
72 99  
73 100 ```
... ... @@ -82,7 +109,8 @@ Não esqueça o PONTO no final da linha acima.
82 109  
83 110 Válido apenas se você não é um desenvolvedor do i3Geo e não tenha feito checkout via SSH.
84 111  
85   -Clique com o botão da direita sobre a pasta c:\ms4w\Apache\htdocs\i3geo e escolha a opção "Git Bash Here"
  112 +Clique com o botão da direita sobre a pasta c:\ms4w\Apache\htdocs\i3geo e
  113 +escolha a opção "Git Bash Here"
86 114  
87 115 ```
88 116 git stash
... ... @@ -92,7 +120,8 @@ git stash pop
92 120  
93 121 Observação:
94 122  
95   -* Pode ser que você precise registrar um usuário no Git antes de executar um stash. Para isso execute os seguintes comandos:
  123 +* Pode ser que você precise registrar um usuário no Git antes de executar um
  124 + stash. Para isso execute os seguintes comandos:
96 125  
97 126 ```
98 127 git config --global user.email seuemail@example.com
... ... @@ -102,22 +131,34 @@ git config --global user.name "Seu Nome"
102 131  
103 132 ### PostGIS Windows (opcional)
104 133  
105   -Para instalar o PostGIS siga o roteiro mostrado em http://postgis.net/windows_downloads
  134 +Para instalar o PostGIS siga o roteiro mostrado em
  135 +http://postgis.net/windows_downloads
106 136  
107   -Instale também o pgAdmin, que é uma interface gráfica para o PostGIS: http://www.pgadmin.org/download/windows.php
  137 +Instale também o pgAdmin, que é uma interface gráfica para o PostGIS:
  138 +http://www.pgadmin.org/download/windows.php
108 139  
109   -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.
  140 +Caso deseje, carregue no PostGIS o banco de dados do i3GeoSaúde. Esse banco é
  141 +utilizado em alguns dos tutoriais do i3Geo e pode servir de teste para uso com o
  142 +SAIKU.
110 143  
111   -* Primeiro baixe o arquivo https://softwarepublico.gov.br/gitlab/i3geo/i3geosaude/raw/master/databasei3geosaude.backup
112   -* 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".
113   -* 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".
114   -* 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.
  144 +* Primeiro baixe o arquivo
  145 + https://softwarepublico.gov.br/gitlab/i3geo/i3geosaude/raw/master/databasei3geosaude.backup
  146 +* Abra o pgAdmin e crie uma nova conexão com o banco de dados. Em nome do host
  147 + utilize "localhost" e o login e senha que você usou na istalação, normalmente
  148 + "postgres".
  149 +* Utilize as opções do pgAdmin para criar um novo banco de dados chamado
  150 + i3geosaude. Ao criá-lo, utilize o banco de dados postgres como template e
  151 + login e senha "postgres".
  152 +* Clicando sobre o novo banco de dados, localize a opção "restore" e faça a
  153 + carga do banco de dados que foi baixado no início.
115 154  
116 155 ## Linux (baseado em Ubuntu 14.04)
117 156  
118 157 Instale os softwares necesários para configurar o servidor web com PHP5, Mapserver e outros.
119 158  
120   -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).
  159 +Importante: versões mais novas do Ubuntu utilizam PHP7, nesses casos, siga os
  160 +passos baseados no Ubuntu 16
  161 +(https://softwarepublico.gov.br/gitlab/i3geo/i3geo#linux-baseado-em-ubuntu-16).
121 162  
122 163 No terminal, digite a sequência de comandos abaixo.
123 164  
... ... @@ -144,7 +185,8 @@ sudo apt-get install r-base r-base-core r-cran-maptools
144 185 sudo apt-get install php5-mbstring
145 186 ```
146 187  
147   -Em alguns casos a mbstring já é instalada junto com o PHP, por isso esse comando pode gerar mensagem de erro sem maiores consequências.
  188 +Em alguns casos a mbstring já é instalada junto com o PHP, por isso esse comando
  189 +pode gerar mensagem de erro sem maiores consequências.
148 190  
149 191 Lista de códigos EPSG, sua ausência faz com que os serviços WMS não funcionem.
150 192  
... ... @@ -169,9 +211,11 @@ Teste a instalação digitando no seu navegador web http://localhost
169 211  
170 212 ## Linux (baseado em Ubuntu 16)
171 213  
172   -As versões mais recentes do Ubuntu utilizam como padrão o PHP 7, que é incompatível com o Mapserver e i3Geo.
  214 +As versões mais recentes do Ubuntu utilizam como padrão o PHP 7, que é
  215 +incompatível com o Mapserver e i3Geo.
173 216  
174   -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:
  217 +Nesses casos é necessário adicionar um repositório de código que contenha o PHP
  218 +5 e compilar o Mapserver, o que pode ser feito seguindo-se o roteiro:
175 219  
176 220 Digite no terminal Linux:
177 221  
... ... @@ -220,7 +264,9 @@ service apache2 restart
220 264  
221 265 ### i3Geo Linux
222 266  
223   -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.
  267 +Para obter o código do i3Geo você tem duas opções, a primeira utiliza
  268 +simplesmente o download de um arquivo e a segunda utiliza o Git. A vantagem da
  269 +segunda opção é que você poderá atualizar sua instalação de forma mais fácil.
224 270  
225 271 Após a instalação, digite no navegador web http://localhost/i3geo
226 272  
... ... @@ -245,18 +291,21 @@ Não esqueça o ponto no final da linha acima.
245 291  
246 292 ### Permissões
247 293  
248   -Para uso local você pode modificar de forma mais liberal as permissões dos arquivos. No terminal digite:
  294 +Para uso local você pode modificar de forma mais liberal as permissões dos
  295 +arquivos. No terminal digite:
249 296  
250 297 ```
251 298 sudo chmod -R 777 /var/www/html/i3geo
252 299 sudo chmod -R 777 /var/www/html/ms_tmp
253 300 ```
254 301  
255   -Em ambiente de produção devem ser consideradas as orientações que constam no artigo sobre segurança (ver Wiki).
  302 +Em ambiente de produção devem ser consideradas as orientações que constam no
  303 +artigo sobre segurança (ver Wiki).
256 304  
257 305 ### Atualização do código (Ubuntu)
258 306  
259   -Válido apenas se você não é um desenvolvedor do i3Geo e não tenha feito checkout via SSH.
  307 +Válido apenas se você não é um desenvolvedor do i3Geo e não tenha feito checkout
  308 +via SSH.
260 309  
261 310 Abra o terminal e digite os seguintes comandos (pode ser necessário usar `sudo`):
262 311  
... ... @@ -269,7 +318,8 @@ git stash pop
269 318  
270 319 Observação:
271 320  
272   -* Pode ser que você precise registrar um usuário no Git antes de executar um stash. Para isso execute os seguintes comandos:
  321 +* Pode ser que você precise registrar um usuário no Git antes de executar um
  322 + stash. Para isso execute os seguintes comandos:
273 323  
274 324 ```
275 325 cd /var/www/html/i3geo
... ... @@ -281,7 +331,8 @@ git config --global user.name "Seu Nome"
281 331  
282 332 Instale o PostgreSQL e PostGIS
283 333  
284   -(dependendo da versão do PostgreSQL pode ser necessário alterar de 9.1 para a versão correta)
  334 +(dependendo da versão do PostgreSQL pode ser necessário alterar de 9.1 para a
  335 +versão correta)
285 336  
286 337 ```
287 338 apt-get install postgresql postgis pgadmin3
... ... @@ -292,11 +343,13 @@ service postgresql start
292 343  
293 344 Observações:
294 345  
295   -* Dependendo da versão do PostgreSQL alguns comandos podem ser diferentes. Veja a pasta /usr/share/postgresql para descobrir a versão instalada)
  346 +* Dependendo da versão do PostgreSQL alguns comandos podem ser diferentes. Veja
  347 + a pasta /usr/share/postgresql para descobrir a versão instalada)
296 348  
297 349 * Pode ser necessário o uso de sudo, exemplo: sudo su - postgres -c "createdb i3geosaude"
298 350  
299   -* Você pode primeiro mudar para o usuário postgres e depois executar os comandos. Nesse caso utilize "sudo su postgres" e depois "psql"
  351 +* Você pode primeiro mudar para o usuário postgres e depois executar os
  352 + comandos. Nesse caso utilize "sudo su postgres" e depois "psql"
300 353  
301 354 * Para sair de "psql" digite \d
302 355  
... ... @@ -306,7 +359,9 @@ Observações:
306 359  
307 360 * Para executar um arquivo SQL utilize "\i arquivo.sql"
308 361  
309   -* 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.
  362 +* Pode ser que ao final do processo, ele seja executado apesar de ter encontrado
  363 + erros. Isso se deve a diferenças de versões do PostgreSQL e PostGIS, e pode
  364 + ser ignorado.
310 365  
311 366 Comandos para instalação:
312 367  
... ... @@ -328,7 +383,10 @@ pg_restore --host localhost --port 5432 --username postgres --dbname i3geosaude
328 383  
329 384 ## Chave utilizada pela API do GoogleMaps
330 385  
331   -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.
  386 +Devido às restrições de uso da API do GoogleMaps, é necessário registrar uma
  387 +chave no site do Google para o seu endereço de servidor para que as
  388 +funcionalidades do i3Geo que utilizam essa API funcionem. Veja como fazer em:
  389 +http://code.google.com/apis/maps/signup.html.
332 390  
333 391 A chave deve ser incluída na variável $googleApiKey do arquivo i3geo/ms_configura.php.
334 392  
... ...