mirror of
				https://github.com/MariaDB/server.git
				synced 2025-11-03 14:33:32 +03:00 
			
		
		
		
	Major replication test framework cleanup. This does the following:
 - Ensure that all tests clean up the replication state when they
   finish, by making check-testcase check the output of SHOW SLAVE STATUS.
   This implies:
    - Slave must not be running after test finished. This is good
      because it removes the risk for sporadic errors in subsequent
      tests when a test forgets to sync correctly.
    - Slave SQL and IO errors must be cleared when test ends. This is
      good because we will notice if a test gets an unexpected error in
      the slave threads near the end.
    - We no longer have to clean up before a test starts.
 - Ensure that all tests that wait for an error in one of the slave
   threads waits for a specific error. It is no longer possible to
   source wait_for_slave_[sql|io]_to_stop.inc when there is an error
   in one of the slave threads. This is good because:
    - If a test expects an error but there is a bug that causes
      another error to happen, or if it stops the slave thread without
      an error, then we will notice.
    - When developing tests, wait_for_*_to_[start|stop].inc will fail
      immediately if there is an error in the relevant slave thread.
      Before this patch, we had to wait for the timeout.
 - Remove duplicated and repeated code for setting up unusual replication
   topologies. Now, there is a single file that is capable of setting
   up arbitrary topologies (include/rpl_init.inc, but
   include/master-slave.inc is still available for the most common
   topology). Tests can now end with include/rpl_end.inc, which will clean
   up correctly no matter what topology is used. The topology can be
   changed with include/rpl_change_topology.inc.
 - Improved debug information when tests fail. This includes:
    - debug info is printed on all servers configured by include/rpl_init.inc
    - User can set $rpl_debug=1, which makes auxiliary replication files
      print relevant debug info.
 - Improved documentation for all auxiliary replication files. Now they
   describe purpose, usage, parameters, and side effects.
 - Many small code cleanups:
    - Made have_innodb.inc output a sensible error message.
    - Moved contents of rpl000017-slave.sh into rpl000017.test
    - Added mysqltest variables that expose the current state of
      disable_warnings/enable_warnings and friends.
    - Too many to list here: see per-file comments for details.
		
	
		
			
				
	
	
		
			87 lines
		
	
	
		
			2.4 KiB
		
	
	
	
		
			PHP
		
	
	
	
	
	
			
		
		
	
	
			87 lines
		
	
	
		
			2.4 KiB
		
	
	
	
		
			PHP
		
	
	
	
	
	
# ==== Purpose ====
 | 
						|
#
 | 
						|
# Auxiliary file used by suite/rpl/t/rpl_test_framework.test
 | 
						|
#
 | 
						|
# The purpose is to check that the sync chain generated in
 | 
						|
# rpl_change_topology.inc (invoked from rpl_init.inc) is correct. This
 | 
						|
# is done in two ways:
 | 
						|
#  (1) Print the sync chain.
 | 
						|
#  (2) Execute a statement and verify that it replicates to all slaves.
 | 
						|
#
 | 
						|
#
 | 
						|
# ==== Implementation ====
 | 
						|
#
 | 
						|
# Does this:
 | 
						|
# (1) Set up a given replication topology (rpl_init.inc)
 | 
						|
# (2) Print $rpl_sync_chain
 | 
						|
# (3) Execute "DELETE FROM t1" and then "INSERT INTO t1" on the master
 | 
						|
# (4) Sync and compare all servers.
 | 
						|
# (5) Clean up the replication topology (rpl_end.inc)
 | 
						|
#
 | 
						|
# (Technical detail: Since DELETE FROM t1 is not executed at the end,
 | 
						|
# some servers may have rows left in t1 from a previous invocation of
 | 
						|
# rpl_test_framework.inc.  Therefore, this file will only work in
 | 
						|
# statement mode where "DELETE FROM t1" removes rows that exist on
 | 
						|
# slave but not on master.)
 | 
						|
#
 | 
						|
#
 | 
						|
# ==== Usage ====
 | 
						|
#
 | 
						|
# --let $rpl_server_count= <number>
 | 
						|
# --let $rpl_topology= <topology specification>
 | 
						|
# --let $masters= <list of masters>
 | 
						|
# [--let $rpl_diff_servers= <list of servers>]
 | 
						|
# --source extra/rpl_tests/rpl_test_framework.inc
 | 
						|
#
 | 
						|
# Parameters:
 | 
						|
#   $next_number
 | 
						|
#     The INSERT statement will insert $next_number into t1, and
 | 
						|
#     $next_number will increase by 1.
 | 
						|
#
 | 
						|
#   $rpl_server_count, $rpl_topology:
 | 
						|
#     See include/rpl_init.inc
 | 
						|
#
 | 
						|
#   $masters
 | 
						|
#     This should be a list of numbers, each identifying a server.
 | 
						|
#     The DELETE and INSERT statements will be executed on all servers
 | 
						|
#     in the list.
 | 
						|
#
 | 
						|
#   $rpl_diff_servers
 | 
						|
#     See include/rpl_diff.inc
 | 
						|
 | 
						|
--source include/rpl_init.inc
 | 
						|
--source include/rpl_generate_sync_chain.inc
 | 
						|
--echo rpl_sync_chain= '$rpl_sync_chain'
 | 
						|
 | 
						|
--inc $next_number
 | 
						|
 | 
						|
# Iterate over masters
 | 
						|
while ($masters)
 | 
						|
{
 | 
						|
  --let $master_i= `SELECT SUBSTRING_INDEX('$masters', ',', 1)`
 | 
						|
  --let $masters= `SELECT SUBSTRING('$masters', LENGTH('$master_i') + 2)`
 | 
						|
 | 
						|
  # Connect to master and execute statement
 | 
						|
  --let $rpl_connection_name= server_$master_i
 | 
						|
  --source include/rpl_connection.inc
 | 
						|
  DELETE FROM t1;
 | 
						|
  --eval INSERT INTO t1 VALUES ($next_number)
 | 
						|
}
 | 
						|
 | 
						|
--source include/rpl_sync.inc
 | 
						|
 | 
						|
# Compare all servers.
 | 
						|
--let $diff_tables= server_$rpl_server_count:t1
 | 
						|
--let $server_i= $rpl_server_count
 | 
						|
--dec $server_i
 | 
						|
while ($server_i)
 | 
						|
{
 | 
						|
  --let $diff_tables= server_$server_i:t1,$diff_tables
 | 
						|
  --dec $server_i
 | 
						|
}
 | 
						|
--source include/diff_tables.inc
 | 
						|
 | 
						|
--let $diff_servers=
 | 
						|
--let $masters=
 | 
						|
--source include/rpl_end.inc
 |