1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
|
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to you under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
ReplicationRun.testReplication
******************************
The test method testReplication in org.apache.derbyTesting.functionTests.tests.replicationTests.ReplicationRun
executes the replication tests:
Short story:
------------
startServer
- start server on master host.
startServer
- start server on slave host.
startReplication
- tells master server that the/a database is to be replicated on
the slave server.
startSlave
- tells slave server to act as slave for the database on master
server which is to be replicated.
runTest
- runs the specified test while replication is active.
stopReplication
- tells the master server to stop replicating the database
- "NOOP" in PoC (Proof of concept) code.
stopServer
- In the PoC code shutdown of or killing the master server
forces failover on the slave.
Detailed story:
--------------
initEnvironment()
- gets test specifications from the ${user.dir}/replicationtest.properties file.
initMaster(masterServerHost,replicatedDb)
- The PoC code (Proof of concept) requires that the master database is copied by OS commands
from some original database (possibly empty) to the master database (in
<test.master.databasepath>/db_master/). Also see README.properties.
startServer(masterJvmVersion, derbyMasterVersion,
masterServerHost,
ALL_INTERFACES,
masterServerPort,
masterDatabasePath +PS+ masterDbSubPath)
- start the master server
startLoad(masterPreRepl,
masterDbSubPath,
masterServerHost,
masterServerPort)
- Optionally start load on the master server.
startServer(slaveJvmVersion, derbySlaveVersion,
slaveServerHost,
ALL_INTERFACES,
slaveServerPort,
slaveDatabasePath +PS+ slaveDbSubPath)
- start the slave server
startReplication(jvmVersion, replicatedDb,
masterServerHost, // Where the startreplication command must be given
masterServerPort, // master server interface accepting client requests
masterServerHost, // An interface on the master: masterClientInterface (==masterServerHost),
slaveServerPort,
slaveServerHost,
slaveReplPort)
- tell master server to start replication 'replicatedDb' on 'slaveServerHost'.
startLoad(masterPostRepl,
masterDbSubPath,
masterServerHost,
masterServerPort)
- Optionally start load on master server.
startLoad(slavePreSlave,
slaveDbSubPath,
slaveServerHost,
slaveServerPort)
- Optionally start load on slave server.
startSlave(jvmVersion, replicatedDb,
masterServerHost, // masterClientInterface (==masterServerHost)
masterServerPort, // masterServerPort
slaveServerHost, // slaveClientInterface // where the startslave command must be given
slaveServerPort,
slaveServerHost, // for slaveReplInterface
slaveReplPort)
- Tell slave server to take replication slave role for database 'replicatedDb' on (master)
server 'masterServerHost' with port 'masterServerPort'.
startLoad(masterPostSlave,
masterDbSubPath,
masterServerHost,
masterServerPort)
- Optionally start load on master server.
startLoad(slavePostSlave,
slaveDbSubPath,
slaveServerHost,
slaveServerPort)
- Optionally start load on slave server.
runTest(replicationTest,
jvmVersion,
testClientHost,
masterServerHost, masterServerPort,
replicatedDb)
- Run the 'replicationTest' against the 'replicatedDb' on the master server.
stopReplication(replicatedDb)
- Tell master server to stop replication of 'replicatedDb'. A "NOOP" on PoC:
stopServer(masterJvmVersion, derbyMasterVersion, // V2b: forces failover on slave
masterServerHost, masterServerPort)
- In the PoC shutdown of or killing the master server forces failover on
the slave server, i.e. "simulating" a "failover" command on the slave!
verifySlave()
- run the sql script or JUnit "test" to verify correct state in the replicated database on the slave server.
Full story:
-----------
See org.apache.derbyTesting.functionTests.tests.replicationTests.ReplicationRun.
|
