Download as
Browse Code »

Commit 85a701589c22401193b4ffe53ac7b7963e211f55

Authored by Edmar Moretti
1 parent b4c2c6c6
Exists in master

Atualização do readme

Showing 1 changed file with 154 additions and 48 deletions   Show diff stats
README.md
  Diff comments   View file @85a7015
1   -# Versão 6 do i3Geo
  1 +# Versão em desenvolvimento do i3Geo
2 2  
3   -Para versões do Mapserver 6.x ou posteriores
  3 +Para versões do Mapserver 6.x ou posteriores e Openlayers 3
4 4  
5 5 Utilize esse repositório para manter seu código sempre atualizado diariamente. Isso garante o recebimento de correções de bugs.
6 6  
... ... @@ -10,7 +10,11 @@ Guia completo sobre instalação e administração do software, veja em: https:/
10 10  
11 11 Sobre segurança: http://moodle.gvsig-training.com/mod/book/view.php?id=5025&chapterid=116
12 12  
13   -# Guia rápido de instalação
  13 +# Guia de instalação
  14 +
  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.
  16 +
  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.
14 18  
15 19 ## Windows
16 20  
... ... @@ -24,15 +28,24 @@ Teste a instalação digitando em seu navegador de internet: http://localhost (s
24 28  
25 29 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.
26 30  
  31 +Alguns usuários reportaram problemas ao instalar o Apache em algumas versões do Windows. Nesses casos a seguinte rotina pode resolver o problema:
  32 +
  33 +* No Painel de Controle, digite no campo de pesquisa UAC
  34 +* Escolha a opção “Alterar configurações de Controle de Contas de Usuário”.
  35 +* Na janela que será aberta na sequência, configure para “Nunca notificar“.
  36 +* Reinicie o computador
  37 +* Execute novamente o arquivo apache-install.bat
  38 +* Para confirmar que tudo ocorreu bem, abra o navegador de internet e digite http:\\localhost
  39 +
27 40 ### i3Geo
28 41  
29 42 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.
30 43  
31 44 #### Primeira opção:
32 45  
33   -* Baixe o código da versão 6 do i3Geo: https://softwarepublico.gov.br/gitlab/i3geo/i3geo6/repository/archive.zip
34   -* Descompacte a pasta i3GEO6.git para dentro da pasta c:\ms4w\Apache\htdocs
35   -* Renomeie a pasta c:\ms4w\Apache\htdocs\i3GEO6.git para c:\ms4w\Apache\htdocs\i3geo
  46 +* Baixe o código do i3Geo: https://softwarepublico.gov.br/gitlab/i3geo/i3geo6/repository/archive.zip
  47 +* Descompacte a pasta i3GEO.git para dentro da pasta c:\ms4w\Apache\htdocs
  48 +* Renomeie a pasta c:\ms4w\Apache\htdocs\i3GEO.git para c:\ms4w\Apache\htdocs\i3geo
36 49 * Teste o funcionamento digitando no navegador http://localhost/i3geo
37 50  
38 51 #### Segunda opção:
... ... @@ -41,38 +54,82 @@ Para obter o código do i3Geo você tem duas opções, a primeira utiliza simple
41 54 * 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"
42 55 * No terminal digite a sequência de comandos:
43 56  
44   - mkdir i3geo
45   -
46   - cd i3geo
47   -
48   - git -c http.sslVerify=false clone http://softwarepublico.gov.br/gitlab/i3geo/i3geo6.git .
49   -
50   -Não esqueça o ponto no final da linha acima.
  57 +```
  58 +mkdir i3geo
  59 +cd i3geo
  60 +git -c http.sslVerify=false clone http://softwarepublico.gov.br/gitlab/i3geo/i3geo6.git .
  61 +```
  62 +
  63 +Não esqueça o PONTO no final da linha acima.
  64 +
  65 +### Postgis (opcional)
  66 +
  67 +Para instalar o Postgis siga o roteiro mostrado em http://postgis.net/windows_downloads
  68 +
  69 +Instale também o Pgadmin, que é uma interface gráfica para o Postgis: http://www.pgadmin.org/download/windows.php
  70 +
  71 +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.
  72 +
  73 +* Primeiro baixe o arquivo https://softwarepublico.gov.br/gitlab/i3geo/i3geosaude/blob/master/databasei3geosaude.backup
  74 +* 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".
  75 +* 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".
  76 +* 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.
51 77  
52   -## Linux (baseado em Ubuntu)
  78 +## Linux (baseado em Ubuntu 14.04)
53 79  
54 80 Instale os softwares necesários para configurar o servidor web com PHP5, Mapserver e outros.
55 81  
  82 +Importante: versões mais novas do Ubuntu utilizam PHP7, nesses casos, o i3Geo não irá funcionar.
  83 +
56 84 No terminal, digite a sequência de comandos abaixo.
57 85  
58   - sudo apt-get install apache2 apache2-doc apache2-utils cgi-mapserver mapserver-bin sqlite libapache2-mod-php5 php5 php5-common php5-dev php5-curl php5-json php5-gd php5-odbc php5-pgsql php5-sqlite php5-ps php5-xmlrpc php5-xsl php5-imagick php5-mapscript
59   -
60   - sudo apt-get install php5-mbstring
61   -
62   - sudo apt-get install proj-epsg
63   -
64   - sudo a2enmod cgi
65   -
66   - sudo service apache2 restart
67   -
68   - sudo mkdir /var/www/html/i3geo
69   -
70   - sudo mkdir /tmp/ms_tmp
71   -
72   - sudo ln -s /tmp/ms_tmp /var/www/html/ms_tmp
73   -
  86 +```
  87 +sudo apt-get install apache2 apache2-doc apache2-utils cgi-mapserver mapserver-bin sqlite libapache2-mod-php5 php5 php5-common php5-dev php5-curl php5-json php5-gd php5-odbc php5-pgsql php5-sqlite php5-ps php5-xmlrpc php5-xsl php5-imagick php5-mapscript
  88 +sudo apt-get install php5-mbstring
  89 +sudo apt-get install proj-epsg
  90 +sudo a2enmod cgi
  91 +sudo service apache2 restart
  92 +sudo mkdir /var/www/html/i3geo
  93 +sudo mkdir /tmp/ms_tmp
  94 +sudo ln -s /tmp/ms_tmp /var/www/html/ms_tmp
  95 +```
  96 +
  97 +Caso queira usar o software em conjunto com o i3Geo:
  98 +
  99 +```
  100 +sudo apt-get install r-cran-spatstat
  101 +sudo apt-get install r-base r-base-core r-cran-maptools
  102 +```
  103 +
  104 +### Dependendo da versão do Ubuntu, pode ser ainda necessário isso:
  105 +
  106 +```
  107 +sudo apt-get install php5-mbstring
  108 +```
  109 +
  110 +Em alguns casos a mbstring já é instalada junto com o PHP, por isso esse comando pode gerar mensagem de erro sem maiores consequências.
  111 +
  112 +Lista de códigos EPSG, sua ausência faz com que os serviços WMS não funcionem.
  113 +
  114 +```
  115 +sudo apt-get install proj-epsg
  116 +```
  117 +
  118 +Ativa o modo CGI
  119 +
  120 +```
  121 +sudo a2enmod cgi
  122 +```
  123 +
  124 +Para reiniciar o Apache e efetivar as mudanças
  125 +
  126 +
  127 +```
  128 +sudo service apache2 restart
  129 +```
  130 +
74 131 Teste a instalação digitando no seu navegador web http://localhost
75   -
  132 +
76 133 ### i3Geo
77 134  
78 135 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.
... ... @@ -81,30 +138,33 @@ Após a instalação, digite no navegador web http://localhost/i3geo
81 138  
82 139 #### Primeira opção:
83 140  
84   -* Baixe o código da versão 6 do i3Geo: https://softwarepublico.gov.br/gitlab/i3geo/i3geo6/repository/archive.zip
85   -* Descompacte a pasta i3GEO6.git para dentro da pasta /var/www/html
86   -* Renomeie a pasta /var/www/html/i3GEO6.git para /var/www/html/i3geo
  141 +* Baixe o código do i3Geo: https://softwarepublico.gov.br/gitlab/i3geo/i3geo6/repository/archive.zip
  142 +* Descompacte a pasta i3GEO.git para dentro da pasta /var/www/html
  143 +* Renomeie a pasta /var/www/html/i3GEO.git para /var/www/html/i3geo
87 144 * Teste o funcionamento digitando no navegador http://localhost/i3geo
88 145  
89 146 #### Segunda opção:
90 147  
91 148 * No terminal digite a sequência de comandos:
92 149  
93   - sudo apt-get install git-core
94   -
95   - cd /var/www/html/i3geo
96   -
97   - sudo git -c http.sslVerify=false clone http://softwarepublico.gov.br/gitlab/i3geo/i3geo6.git .
98   -
  150 +```
  151 +sudo apt-get install git-core
  152 +cd /var/www/html/i3geo
  153 +sudo git -c http.sslVerify=false clone http://softwarepublico.gov.br/gitlab/i3geo/i3geo6.git .
  154 +```
  155 +
99 156 Não esqueça o ponto no final da linha acima.
100 157  
101 158 ### Permissões
102 159  
103 160 Para uso local você pode modificar de forma mais liberal as permissões dos arquivos. No terminal digite:
104 161  
105   - sudo chmod -R 777 /var/www/html/i3geo
106   -
107   - sudo chmod -R 777 /var/www/html/ms_tmp
  162 +```
  163 +sudo chmod -R 777 /var/www/html/i3geo
  164 +sudo chmod -R 777 /var/www/html/ms_tmp
  165 +```
  166 +
  167 +Em ambiente de produção devem ser consideradas as orientações que constam no artigo sobre segurança (ver Wiki).
108 168  
109 169 ### Atualização do código
110 170  
... ... @@ -112,8 +172,54 @@ Válido apenas se você não é um desenvolvedor do i3Geo e não tenha feito che
112 172  
113 173 Abra o terminal e digite os seguintes comandos (no Linux pode ser necessário usar `sudo`):
114 174  
115   - git stash
116   -
117   - git -c http.sslVerify=false pull
118   -
119   - git stash pop
  175 +```
  176 +cd i3geo
  177 +git stash
  178 +git -c http.sslVerify=false pull
  179 +git stash pop
  180 +```
  181 +### Postgis (opcional)
  182 +
  183 +Instale o PostgreSQL e Postgis
  184 +
  185 +(dependendo da versão do Postgresql pode ser necessário alterar de 9.1 para a versão correta)
  186 +
  187 +```
  188 +apt-get install postgresql postgis pgadmin3
  189 +apt-get install postgresql-9.1-postgis
  190 +```
  191 +
  192 +#### Instalando o banco de dados i3GeoSaude para testes
  193 +
  194 +Observações:
  195 +
  196 +* dependendo da versão do Postgresql pode ser necessário alterar de 9.1 e 1.5 para a versão correta. Veja a pasta /usr/share/postgresql para descobrir a versão instalada)
  197 +
  198 +* pode ser necessário o uso de sudo, exemplo: sudo su postgres -c "createdb i3geosaude"
  199 +
  200 +* você pode primeiro mudar para o usuário postgres e depois executar os comandos. Nesse caso utilize "sudo su postgres" e depois "psql"
  201 +
  202 +* para sair de "psql" digite \d
  203 +
  204 +* usando psql diretamente, termine a linha de comando sempre com ";"
  205 +
  206 +* para entrar em psql no database i3geosaude utilize "psql -d i3geosaude"
  207 +
  208 +* para executar um arquivo SQL utilize "\i arquivo.sql"
  209 +
  210 +Comandos para instalação:
  211 +
  212 +```
  213 +su postgres -c "psql -c \"ALTER USER postgres WITH PASSWORD 'postgres'\""
  214 +su postgres -c "createdb i3geosaude"
  215 +su postgres -c "createlang -d i3geosaude plpgsql"
  216 +su postgres -c "psql -d i3geosaude -f /usr/share/postgresql/9.1/contrib/postgis-1.5/postgis.sql"
  217 +su postgres -c "psql -d i3geosaude -f /usr/share/postgresql/9.1/contrib/postgis-1.5/spatial_ref_sys.sql"
  218 +su postgres -c "psql -d i3geosaude -c 'GRANT ALL ON geometry_columns TO PUBLIC;'"
  219 +su postgres -c "psql -d i3geosaude -c 'GRANT ALL ON geography_columns TO PUBLIC;'"
  220 +su postgres -c "psql -d i3geosaude -c 'GRANT ALL ON spatial_ref_sys TO PUBLIC;'"
  221 +/usr/bin/pg_restore --host localhost --port 5432 --username "postgres" --dbname "i3geosaude" --schema-only --list "/var/www/databasei3geosaude.backup"
  222 +/usr/bin/pg_restore --host localhost --port 5432 --username "postgres" --dbname "i3geosaude" --data-only --list "/var/www/databasei3geosaude.backup"
  223 +```
  224 +
  225 +(o password é: postgres)
... ...