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
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.