Commit 85a701589c22401193b4ffe53ac7b7963e211f55
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
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 | 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. 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,7 +10,11 @@ Guia completo sobre instalação e administração do software, veja em: https:/ | ||
10 | 10 | ||
11 | Sobre segurança: http://moodle.gvsig-training.com/mod/book/view.php?id=5025&chapterid=116 | 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 | ## Windows | 19 | ## Windows |
16 | 20 | ||
@@ -24,15 +28,24 @@ Teste a instalação digitando em seu navegador de internet: http://localhost (s | @@ -24,15 +28,24 @@ Teste a instalação digitando em seu navegador de internet: http://localhost (s | ||
24 | 28 | ||
25 | 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. | 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 | ### i3Geo | 40 | ### i3Geo |
28 | 41 | ||
29 | 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. | 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 | #### Primeira opção: | 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 | * Teste o funcionamento digitando no navegador http://localhost/i3geo | 49 | * Teste o funcionamento digitando no navegador http://localhost/i3geo |
37 | 50 | ||
38 | #### Segunda opção: | 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,38 +54,82 @@ Para obter o código do i3Geo você tem duas opções, a primeira utiliza simple | ||
41 | * 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" | 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 | * No terminal digite a sequência de comandos: | 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 | Instale os softwares necesários para configurar o servidor web com PHP5, Mapserver e outros. | 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 | No terminal, digite a sequência de comandos abaixo. | 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 | Teste a instalação digitando no seu navegador web http://localhost | 131 | Teste a instalação digitando no seu navegador web http://localhost |
75 | - | 132 | + |
76 | ### i3Geo | 133 | ### i3Geo |
77 | 134 | ||
78 | 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. | 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,30 +138,33 @@ Após a instalação, digite no navegador web http://localhost/i3geo | ||
81 | 138 | ||
82 | #### Primeira opção: | 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 | * Teste o funcionamento digitando no navegador http://localhost/i3geo | 144 | * Teste o funcionamento digitando no navegador http://localhost/i3geo |
88 | 145 | ||
89 | #### Segunda opção: | 146 | #### Segunda opção: |
90 | 147 | ||
91 | * No terminal digite a sequência de comandos: | 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 | Não esqueça o ponto no final da linha acima. | 156 | Não esqueça o ponto no final da linha acima. |
100 | 157 | ||
101 | ### Permissões | 158 | ### Permissões |
102 | 159 | ||
103 | Para uso local você pode modificar de forma mais liberal as permissões dos arquivos. No terminal digite: | 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 | ### Atualização do código | 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,8 +172,54 @@ Válido apenas se você não é um desenvolvedor do i3Geo e não tenha feito che | ||
112 | 172 | ||
113 | Abra o terminal e digite os seguintes comandos (no Linux pode ser necessário usar `sudo`): | 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) |