rserv/doc/eRserver.ChangeLog


Nélio Alves Pereira Filho
nelio@ime.usp.br

+-------------------------------------------------------------------------+
|     Alterações na distribuição padrão do RServ (PostgreSQL-Contrib)     |
+-------------------------------------------------------------------------+
        
Data: Mon Apr 29 15:32:03 BRT 2002


No novo pacote, os seguintes arquivos estão inclusos:   

eRserver/bin/ApplySnapshot
eRserver/bin/CleanLog
eRserver/bin/GetSyncID
eRserver/bin/InitRservTest
eRserver/bin/MasterAddTable
eRserver/bin/MasterDelTable
eRserver/bin/MasterInit
eRserver/bin/MasterRemove
eRserver/bin/MasterSync
eRserver/bin/PrepareSnapshot
eRserver/bin/Replicate
eRserver/bin/RservTest
eRserver/bin/SlaveAddTable
eRserver/bin/SlaveDelTable
eRserver/bin/SlaveInit
eRserver/bin/SlaveRemove
eRserver/share/RServ.pm
eRserver/doc/README.rserv
eRserver/doc/eRserver.ChangeLog
eRserver/lib/rserv.so


+ Novos arquivos:

eRserver/bin/MasterDelTable: 
        elimina-se uma tabela do sistema de replicação (master).
eRserver/bin/MasterRemove: 
        elimina-se todo o sistema de replicação, preservando as 
        outras informações da base de dados (master).
eRserver/bin/SlaveDelTable: 
        elimina-se uma tabela do sistema de replicação (slave).
eRserver/bin/SlaveRemove:
        elimina-se todo o sistema de replicação, preservando as 
        outras informações da base de dados (slave).
eRserver/doc/eRserver.ChangeLog:
        este arquivo.


+ Alterações em arquivos existentes:


eRserver/bin/ApplySnapshot:
        - correção de uso de variável
eRserver/bin/MasterInit
        - opção de se passar o caminho para o shared object 
          rserv.so (opcional).
        - alteração nas queries feitas no BD para se criar as tabelas.
          Foram criadas FK entre as tabelas _rserv_.*, de modo a manter
          a integridade das informações aí contidas.
        - criação da view _rserv_human_log_ para auxiliar a manutenção e 
          visualização do funcionamento do replicador.
        - criação da view _rserv_daily_log_ para auxiliar a manutenção das
          transações que ocorrem diariamente e seu processo de replicação.
eRserver/bin/PrepareSnapshot:
        - opção para se passar o hostname do slave (obrigatória).
        - correção para receber um nome de arquivo como parâmetro.
eRserver/bin/Replicate:
        - alteração para determinar o snapshot correto para o slave
          quando em um ambiente com múltiplos slaves.
eRserver/bin/SlaveInit:
        - opções para possibilitar a conexão com a base servidora.
        - após as configurações do slave, adiciona uma entrada no servidor
          na tabela _rserv_servers_ com seus dados.
eRserver/share/RServ.pm:
        - criação da função GetSlaveId, que retorna o identificador de 
          um dado servidor slave.
        - alteração de query na função PrepareSnapshot, para evitar a 
          duplicidade de informações e replicações.


+-------------------------------------------------------------------------+
|         Testes Realizados no modelo de Replicação e no rServ            |
+-------------------------------------------------------------------------+

+++ Simulação de Falhas aleatórias durante a execução da replicação.
    De acordo com a lógica interna deste modelo de replicação, foram
    simuladas possíveis falhas durante sua execução. As falhas eram
    semelhantes a um situação de queda de conexão, que poderia ocorrer em
    várias partes do processo.
    
    Resultado: o programa se mostrou muito estável, pois estava preparado
               para lidar com tais situações. Nenhuma informação foi perdida
               e/ou corrompida.
    

+++ Simulação de um número muito grande de inserções concorrentes na base, com
    o mecanismo de replicação ativado uma vez por minuto, para mais de uma base.
    Especificamente, foram 10 processos concorrentes, cada um realizando 500
    inserções, sendo que todas deveriam ser replicadas para duas bases.
    
    Resultado: As inserções são efetuadas corretamente. Devido ao fato da
               replicação ocorrer simultaneamente para mais de uma base,
               ocorria uma interferência de um processo no outro, que resultava 
               em um erro de replicação.
    
    Resolução: Associar valores únicos e independentes para cada processo de
               replicação.


+++ Cálculo de limites do rserv, quando utilizado muitas vezes. 
    De acordo com a lógica interna, certos contadores são utilizados e estes 
    poderiam comprometer a replicação, desde que seus limites fossem estourados.
    
    Resultado: pelos limites dos contadores, um sistema em produção máxima
               rServ (uma replicação por minuto) pode funcionar por mais de 
               4000 anos.


+++ Teste de replicação de uma tabela do servidor que não foi configurada no
    cliente.
    
    Resultado: houve a indicação de erro por parte do rserv, pois este se
               baseava somente na configuração do servidor.

    Resolução: no momento de se preparar a lista de alterações a serem
               replicadas, há uma consulta tanto na configuração do servidor
               como na do cliente, a fim de trocar as informações somente das 
               tabelas desejadas.


+++ Execução simultânea do processo de replicação para a mesma base.

    Resultado: erro aletório.
    
    Resolução: verificação inicial se algum processo de replicação já está
               sendo executado.
               

+--------------------------------------------------------------------------+
|   Alterações no DataBase existente para contemplar exigências do rServ   |
+--------------------------------------------------------------------------+

Como descrito na documentação do rserv, é necessário existir um campo único
por tabela. Tal campo é usado para identificar a linha e questão e fazer as
atualizações necessárias.
Para contemplar tal exigência, foi criado um campo chamado 'id', com tipo
serial em cada tabela, com a restriçãão de não poder ser null.
1	dpavlin	1.1
2			Nélio Alves Pereira Filho
3			nelio@ime.usp.br
4
5			+-------------------------------------------------------------------------+
6			\| Alterações na distribuição padrão do RServ (PostgreSQL-Contrib) \|
7			+-------------------------------------------------------------------------+
8
9			Data: Mon Apr 29 15:32:03 BRT 2002
10
11
12			No novo pacote, os seguintes arquivos estão inclusos:
13
14			eRserver/bin/ApplySnapshot
15			eRserver/bin/CleanLog
16			eRserver/bin/GetSyncID
17			eRserver/bin/InitRservTest
18			eRserver/bin/MasterAddTable
19			eRserver/bin/MasterDelTable
20			eRserver/bin/MasterInit
21			eRserver/bin/MasterRemove
22			eRserver/bin/MasterSync
23			eRserver/bin/PrepareSnapshot
24			eRserver/bin/Replicate
25			eRserver/bin/RservTest
26			eRserver/bin/SlaveAddTable
27			eRserver/bin/SlaveDelTable
28			eRserver/bin/SlaveInit
29			eRserver/bin/SlaveRemove
30			eRserver/share/RServ.pm
31			eRserver/doc/README.rserv
32			eRserver/doc/eRserver.ChangeLog
33			eRserver/lib/rserv.so
34
35
36
37			+ Novos arquivos:
38
39			eRserver/bin/MasterDelTable:
40			elimina-se uma tabela do sistema de replicação (master).
41			eRserver/bin/MasterRemove:
42			elimina-se todo o sistema de replicação, preservando as
43			outras informações da base de dados (master).
44			eRserver/bin/SlaveDelTable:
45			elimina-se uma tabela do sistema de replicação (slave).
46			eRserver/bin/SlaveRemove:
47			elimina-se todo o sistema de replicação, preservando as
48			outras informações da base de dados (slave).
49			eRserver/doc/eRserver.ChangeLog:
50			este arquivo.
51
52
53
54			+ Alterações em arquivos existentes:
55
56
57			eRserver/bin/ApplySnapshot:
58			- correção de uso de variável
59			eRserver/bin/MasterInit
60			- opção de se passar o caminho para o shared object
61			rserv.so (opcional).
62			- alteração nas queries feitas no BD para se criar as tabelas.
63			Foram criadas FK entre as tabelas _rserv_.*, de modo a manter
64			a integridade das informações aí contidas.
65			- criação da view _rserv_human_log_ para auxiliar a manutenção e
66			visualização do funcionamento do replicador.
67			- criação da view _rserv_daily_log_ para auxiliar a manutenção das
68			transações que ocorrem diariamente e seu processo de replicação.
69			eRserver/bin/PrepareSnapshot:
70			- opção para se passar o hostname do slave (obrigatória).
71			- correção para receber um nome de arquivo como parâmetro.
72			eRserver/bin/Replicate:
73			- alteração para determinar o snapshot correto para o slave
74			quando em um ambiente com múltiplos slaves.
75			eRserver/bin/SlaveInit:
76			- opções para possibilitar a conexão com a base servidora.
77			- após as configurações do slave, adiciona uma entrada no servidor
78			na tabela _rserv_servers_ com seus dados.
79			eRserver/share/RServ.pm:
80			- criação da função GetSlaveId, que retorna o identificador de
81			um dado servidor slave.
82			- alteração de query na função PrepareSnapshot, para evitar a
83			duplicidade de informações e replicações.
84
85
86
87			+-------------------------------------------------------------------------+
88			\| Testes Realizados no modelo de Replicação e no rServ \|
89			+-------------------------------------------------------------------------+
90
91			+++ Simulação de Falhas aleatórias durante a execução da replicação.
92			De acordo com a lógica interna deste modelo de replicação, foram
93			simuladas possíveis falhas durante sua execução. As falhas eram
94			semelhantes a um situação de queda de conexão, que poderia ocorrer em
95			várias partes do processo.
96
97			Resultado: o programa se mostrou muito estável, pois estava preparado
98			para lidar com tais situações. Nenhuma informação foi perdida
99			e/ou corrompida.
100
101
102			+++ Simulação de um número muito grande de inserções concorrentes na base, com
103			o mecanismo de replicação ativado uma vez por minuto, para mais de uma base.
104			Especificamente, foram 10 processos concorrentes, cada um realizando 500
105			inserções, sendo que todas deveriam ser replicadas para duas bases.
106
107			Resultado: As inserções são efetuadas corretamente. Devido ao fato da
108			replicação ocorrer simultaneamente para mais de uma base,
109			ocorria uma interferência de um processo no outro, que resultava
110			em um erro de replicação.
111
112			Resolução: Associar valores únicos e independentes para cada processo de
113			replicação.
114
115
116			+++ Cálculo de limites do rserv, quando utilizado muitas vezes.
117			De acordo com a lógica interna, certos contadores são utilizados e estes
118			poderiam comprometer a replicação, desde que seus limites fossem estourados.
119
120			Resultado: pelos limites dos contadores, um sistema em produção máxima
121			rServ (uma replicação por minuto) pode funcionar por mais de
122			4000 anos.
123
124
125			+++ Teste de replicação de uma tabela do servidor que não foi configurada no
126			cliente.
127
128			Resultado: houve a indicação de erro por parte do rserv, pois este se
129			baseava somente na configuração do servidor.
130
131			Resolução: no momento de se preparar a lista de alterações a serem
132			replicadas, há uma consulta tanto na configuração do servidor
133			como na do cliente, a fim de trocar as informações somente das
134			tabelas desejadas.
135
136
137			+++ Execução simultânea do processo de replicação para a mesma base.
138
139			Resultado: erro aletório.
140
141			Resolução: verificação inicial se algum processo de replicação já está
142			sendo executado.
143
144
145
146			+--------------------------------------------------------------------------+
147			\| Alterações no DataBase existente para contemplar exigências do rServ \|
148			+--------------------------------------------------------------------------+
149
150			Como descrito na documentação do rserv, é necessário existir um campo único
151			por tabela. Tal campo é usado para identificar a linha e questão e fazer as
152			atualizações necessárias.
153			Para contemplar tal exigência, foi criado um campo chamado 'id', com tipo
154			serial em cada tabela, com a restriçãão de não poder ser null.