Home m16e-nome.png English Version
Consultoria & Serviços Informáticos
Entrada Serviços Suporte LiveCD Download
Suporte Profissional
Obtenha todo o apoio que necessita. Veja as nossas ofertas de suporte ou contacte um dos nossos distribuidores.

Ó Evaristo, tens cá disto?

Por: Pedro Ramos - Pedro Ramos - S.I.

(artigo publicado na Bits & Bytes nº 103, adaptado para HTML)

Conheça como pode ter este sistema de apoio à gestão sob licença GPL, em Português de Portugal no seu Windows.

Este artigo pretende dar respostas aos muitos pedidos de esclarecimentos dos utilizadores do Windows, que pretendem instalar o Evaristo. Para quem ainda não conhece, o Evaristo é uma aplicação de gestão feita em Portugal e que está disponibilizada gratuitamente, sendo fornecida com o código-fonte respectivo e à qual os utilizadores podem acrescentar as funcionalidades que entenderem.

Antes de começar sugerimos que leia uma vez mais o artigo sobre o Evaristo saído na edição de Março de 2005 da PC Guia. Certifique-se que a máquina aonde vai ser instalado o Postgresql tem uma partição NTFS, quer dizer que só se pode instalar num Windows NT (NT4, 2000, XP, 2003 Server ou Vista) - ver manual do PostgreSQL .

Se tiver uma rede com postos de trabalho em Windows 95, 98 ou ME pode executar o Evaristo, claro, desde que o PostgreSQL esteja instalado num Windows NT, Linux, Mac OS/X, Unix, etc.

Download e instalação dos componentes

A partir de então pode começar a instalação. Neste momento, não tendo ainda pronto o wizard de instalação (em desenvolvimento), a instalação é ainda morosa, mas não será tarefa assustadora para um principiante. Para começar temos de fazer o download dos vários componentes necessários ao Evaristo:

  • download do J2SE(TM) Runtime Environment para Windows. caso ainda não o tenha instalado o Java Runtime Environment 1.4, ou superior, é necessário fazê-lo.
  • download do ficheiro postgresql-8.0.3.zip da versão do PostgreSQL para Windows. Basta utilizar um dos mirrors na lista apresentada (o mirror de Portugal não estava on-line, quando se escreveu o artigo);
  • download do Evaristo para Windows

Java Runtime Environment

É pouco mais do que executar o programa de instalação e aceitar a licença.

Instalação do Java - aceitar a licença

Carregar em Next

Instalação do Java - opções de instalação

E depois em Finish

Instalação do Java - conclusão de instalação

PostgreSQL

Descompactando o zip, é criado um directório com o nome postgresql-8.0.3, deverá, então, fazer um duplo click no ficheiro postgresql-8.0.msi. Aqui, também não é muito mais do que executar o programa de instalação e aceitar a licença.

Instalação do PostgreSQL - lançando o instalador

Escolher a língua da interface,

Instalação do PostgreSQL - escolher a língua

aceitar os componentes definidos por omissão,

Instalação do PostgreSQL - componentes

aceitar o utilizador definido por omissão,

Instalação do PostgreSQL - utilizador, domínio e password

clickar em Yes,

Instalação do PostgreSQL - criar utilizador

tomar nota da password e clickar em OK,

Instalação do PostgreSQL - password

clickar em OK,

Instalação do PostgreSQL - mensagem

aceitar os parâmetros definidos por omissão,

Instalação do PostgreSQL - configuração da Base de Dados

aceitar os componentes definidos por omissão,

Instalação do PostgreSQL - linguagens de programação

aceitar os módulos definidos por omissão,

Instalação do PostgreSQL - módulos

e, finalmente, Finish!

Instalação do PostgreSQL - conclusão

Evaristo

Aqui, basta descompactar o ficheiro mpb2-2-all-win.zip, num directório à sua escolha, p. ex., C:\Programas.

Instalação

Agora que temos todas as peças, pode começar a instalação propriamante dita do Evaristo. Pode saltar este ponto se optar por usar a base de dados de demonstração da PRSI.

Os próximos passos são muito semelhantes aos da instalação em Linux. Temos de criar o utilizador dono da base de dados e a base de dados. Para tal abra uma janela da linha de comandos e execute aí os seguintes comandos:

cd %programfiles%\postgresql\8.0\bin
createuser -daP -U postgres m16e
depois de premir ENTER, introduza a password para o utilizador m16e e a do postgres (super-utilizador)
psql -U m16e -f “C:\Programas\evaristo-v2r2\sql\mpb2-2.sql” template1
depois de premir ENTER, introduza a password do utilizador m16e.

Instalação do PostgreSQL - criação do utilizador da Base de Dados

Para quem fez uma instalação em rede é necessário rever a configuração do PostgreSQL:

notepad "C:\Programas\postgresql\8.0\data\postgresql.conf"
e alterar a linha
#listen_addresses =  para  listen_addresses = '*'

Instalação do PostgreSQL - funcionamento em rede

Isto vai fazer com que o PostgreSQL aceite ligações TCP/IP nas interfaces definidas na máquina, o que é indispensável para a ligar a uma aplicação Java através do JDBC. Para uma explicação mais pormenorizada consulte a documentação em http://www.postgresql.org/docs/8.0/static/runtime-config.html#RUNTIME-CONFIG-CONNECTION.

O outro passo é um pouco mais delicado, dado que se trata de definir que máquinas e utilizadores podem ligar-se ao servidor de dados. Entre as várias configurações possíveis (ver http://www.postgresql.org/docs/8.0/interactive/client-authentication.html#AUTH-PG-HBA-CONF), escolhemos uma que permite o acesso aos utilizadores via Internet ou intranet à máquina em que está instalado o PostgreSQL. Para tal, basta acrescentar com o notepad a seguinte linha no fim do ficheiro 'pg_hba.conf':

host mpb2-2 m16e 0.0.0.0/0 md5 # para acesso via Internet

host mpb2-2 m16e 192.168.1.0/32 md5 # para acesso via subnet

De seguida, deverá reinicializar o PostgreSQL com os comandos net stop pgsql-8.0 e net start pgsql-8.0 ou, se preferir, reiniciar o computador.

Instalação do PostgreSQL - configurar acessos do exterior

Personalizar os ficheiros mpbiz-backoffice.properties e (ou) mpbiz-pos.properties. Aqui temos que fazer as seguintes alterações:

De:
xgui.dir=/usr/local/m16e/evaristo-v2r2/xgui
reports.dir=/usr/local/m16e/evaristo-v2r2/reports
Para:
xgui.dir=C:\Programas\evaristo-v2r2\xgui
reports.dir=C:\Programas\evaristo-v2r2\reports

Nota: de verá substituir C:/Programas pelo nome do directório onde o instalou.

E por fim personalizar os ficheiros batch o Evaristo.bat e o Evaristo-pos.bat, que estão na pasta aonde o instalou. Tem que ter um aspecto semelhante a estes exemplos. Poderá, ainda, criar um atalho para o ambiente de trabalho. Para quem não sabe como fazê-lo basta clicar no botão direito do rato quando este esta posicionado no ficheiro, e seleccionar a opção Enviar para e Ambiente de trabalho (criar atalho).

REM evaristo.bat

set EVARISTO_REL=v2r2
set EVARISTO_HOME="%programfiles%"\evaristo-v2r2
set TOOLS_REL=v0r15
set LIB_DIR=%EVARISTO_HOME%\lib
set JDBC_DRIVER="%programfiles%"\postgresql\8.0\jdbc\postgresql-8.0-311.jdbc3.jar
set EXT_JAR_DIR=%LIB_DIR%

set JRUBY_JAR=%EXT_JAR_DIR%\jruby.jar
set MINML2_JAR=%EXT_JAR_DIR%\MinML2.jar
set DV_PATH=%LIB_DIR%\classes;%LIB_DIR%\datavision-0.8.4.jar
set DV_PATH=%DV_PATH%;%JRUBY_JAR%;%MINML2_JAR%

set M16E_FREE_TOOLS_JAR=%LIB_DIR%\m16e-free-tools-%TOOLS_REL%.jar
set EVARISTO_JAR=%LIB_DIR%\evaristo-%EVARISTO_REL%.jar

rem app's classpath
set MPBIZ_CLASSPATH=.;.\i18n;%JDBC_DRIVER%;%M16E_FREE_TOOLS_JAR%
set MPBIZ_CLASSPATH=%MPBIZ_CLASSPATH%;%EVARISTO_JAR%;%DV_PATH%

java -Xint -classpath %MPBIZ_CLASSPATH% com.m16e.mpbiz.MpBiz -f mpbiz-backoffice.properties %1 %2

E, para o P.O.S:

REM Evaristo-pos.bat

set EVARISTO_REL=v2r2
set EVARISTO_HOME="%programfiles%"\evaristo-v2r2
set TOOLS_REL=v0r15

set LIB_DIR=%EVARISTO_HOME%\lib
set JDBC_DRIVER="%programfiles%"\postgresql\8.0\jdbc\postgresql-8.0-311.jdbc3.jar
set EXT_JAR_DIR=%LIB_DIR%

set JRUBY_JAR=%EXT_JAR_DIR%\jruby.jar
set MINML2_JAR=%EXT_JAR_DIR%\MinML2.jar

set DV_PATH=%LIB_DIR%\classes;%LIB_DIR%\datavision-0.8.4.jar
set DV_PATH=%DV_PATH%;%JRUBY_JAR%;%MINML2_JAR%

set M16E_FREE_TOOLS_JAR=%LIB_DIR%\m16e-free-tools-%TOOLS_REL%.jar
set EVARISTO_JAR=%LIB_DIR%\evaristo-%EVARISTO_REL%.jar

rem app's classpath
set MPBIZ_CLASSPATH=.;.\i18n;%JDBC_DRIVER%;%M16E_FREE_TOOLS_JAR%
set MPBIZ_CLASSPATH=%MPBIZ_CLASSPATH%;%EVARISTO_JAR%;%DV_PATH%

java -Xint -classpath %MPBIZ_CLASSPATH% com.m16e.mpbiz.pos.MpBizPOS -f mpbiz-pos.properties %1 %2

Aconselhamos (vivamente) a consulta dos manuais de utilizador do Evaristo, PostgreSQL e do JAVA, aonde pode encontrar alguns dos exemplos que contemplam a maior parte das situações:


Existe uma mailing list do Evaristo na SourceForge (http://lists.sourceforge.net/lists/listinfo/evaristo-users) aonde poderá obter respostas aos seus problemas. Para tal tem apenas que a subscrever.