Merge pull request #226 from fmherschel/angi-ScaleOut-newComparators

Angi+Tester new versions

.gitignore

@@ -1,3 +1,5 @@
 *.tgz
 *.tar.gz
 osc
+ibs
+test.log

SAPHanaSR-angi.spec

@@ -21,7 +21,7 @@ License:        GPL-2.0
 Group:          Productivity/Clustering/HA
 AutoReqProv:    on
 Summary:        Resource agents to control the HANA database in system replication setup
-Version:        1.2.3
+Version:        1.2.4
 Release:        0
 Url:            https://www.suse.com/c/fail-safe-operation-of-sap-hana-suse-extends-its-high-availability-solution/
 

SAPHanaSR-tester.spec

@@ -19,7 +19,7 @@ License:        GPL-2.0
 Group:          Productivity/Clustering/HA
 AutoReqProv:    on
 Summary:        Test suite for SAPHanaSR clusters
-Version:        1.2.7
+Version:        1.2.8
 Release:        0
 Url:            https://www.suse.com/c/fail-safe-operation-of-sap-hana-suse-extends-its-high-availability-solution/
 

man-tester/SAPHanaSR-testCluster.8

@@ -3,7 +3,7 @@
 .TH SAPHanaSR-testCluster 8 "20 Nov 2023" "" "SAPHanaSR-angi"
 .\"
 .SH NAME
-SAPHanaSR-testCluster \- Run functional testing for SAPHanaSR clusters.
+SAPHanaSR-testCluster \- Run functional tests for SAPHanaSR clusters.
 .PP
 .\"
 .SH SYNOPSIS
@@ -78,7 +78,8 @@ Usage, syntax or execution errors.
 The functional test "nop" is performed on the Linux cluster defined in
 properties_q42.json, nodes are node1 and node2.
 A dedicated working directory and logfile for this test is used.
-See also manual page SAPHanaSR-tester(7) and SAPHanaSR-tests-syntax(7).
+See also manual page SAPHanaSR-tester(7), SAPHanaSR-tests-syntax(5),
+SAPHanaSR-tests-angi-ScaleUp(7) and SAPHanaSR-tests-description(7).
 .PP
 .RS 2
 # mkdir ~/test_nop; cd ~/test_nop
@@ -148,7 +149,9 @@ TODO
 .\"
 .SH REQUIREMENTS
 .\"
-See the REQUIREMENTS section in SAPHanaSR-tester(7).
+See the REQUIREMENTS section in SAPHanaSR-tester(7) and SAPHanaSR-angi(7).
+Of course, HANA database and Linux cluster have certain requirements.
+Please refer to the product documentation.
 .PP
 .\"
 .SH BUGS
@@ -158,7 +161,8 @@ Please report any other feedback and suggestions to [email protected].
 .PP
 .\"
 .SH SEE ALSO
-\fBSAPHanaSR-tester\fP(7) , \fBSAPHanaSR-tests-syntax\fP(7) ,
+\fBSAPHanaSR-tester\fP(7) , \fBSAPHanaSR-tests-syntax\fP(5) ,
+\fBSAPHanaSR-tests-description\fP(7) ,
 \fBSAPHanaSR-tests-angi-ScaleUp\fP(7) , \fBSAPHanaSR-tests-angi-ScaleOut\fP(7) ,
 \fBSAPHanaSR-angi\fP(7) , \fBSAPHanaSR-showAttr\fP(8) ,
 \fBcrm_mon\fP(8) , \fBcrm\fP(8) , \fBcs_clusterstate\fP(8)
@@ -169,7 +173,7 @@ F.Herschel, L.Pinne.
 .PP
 .\"
 .SH COPYRIGHT
-(c) 2023 SUSE Linux GmbH, Germany.
+(c) 2023 SUSE LLC
 .br
 The package SAPHanaSR-tester comes with ABSOLUTELY NO WARRANTY.
 .br

man-tester/SAPHanaSR-tester.7

@@ -63,14 +63,14 @@ See manual page SAPHanaSR-tests-syntax(5) for details, see also example below.
 \fB*\fP Processing:
 
 .\" TODO SAPHanaSR-testCluster
-.\" TODO shell scripts shiped with SAPhanaSR-tester, e.g. test_
+.\" TODO shell scripts shiped with SAPhanaSR-tester, e.g. sct_test_
 .\" TODO custom scripts and test automation frameworks
-See manual page SAPHanaSR-testCluster(8).
+See manual page SAPHanaSR-testCluster(8) and SAPHanaSR-tests-description(7).
 
 \fB*\fP Output: Test results 
 
 .\" TODO output of SAPHanaSR-testCluster
-See manual page SAPHanaSR-testCluster(8).
+See manual page SAPHanaSR-testCluster(8) and SAPHanaSR-tests-description(7).
 .PP
 .\"
 .SH EXAMPLES
@@ -146,8 +146,9 @@ Note: Never do this on production systems.
 \fB*\fR Showing predefined functional scale-up test cases.
 .PP
 The predefined functional tests for the SAPHanaSR-angi scale-up scenario are
-shown. See manual page SAPHanaSR-tests-angi-ScaleUp(7) and
-SAPHanaSR-testCluster(8) for how to run this tests.
+shown. See also manual page SAPHanaSR-tests-angi-ScaleUp(7). See manual page
+SAPHanaSR-tests-description(7) and SAPHanaSR-testCluster(8) for how to run this
+tests.
 .PP
 .RS 2
 # ls /usr/share/SAPHanaSR-tester/json/angi-ScaleUp/*.json | \\
@@ -236,6 +237,7 @@ Please report any other feedback and suggestions to [email protected].
 .\"
 .SH SEE ALSO
 \fBSAPHanaSR-testCluster\fP(8) , \fBSAPHanaSR-tests-syntax\fP(5) ,
+\fBSAPHanaSR-tests-description\fP(7) ,
 \fBSAPHanaSR-tests-angi-ScaleUp\fP(7) , \fBSAPHanaSR-tests-angi-ScaleOut\fP(7) ,
 \fBSAPHanaSR-angi\fP(7) , \fBSAPHanaSR-showAttr\fP(8) , \fBcrm_mon\fP(8) ,
 \fBssh-keygen\fP(1) , \fBssh-copy-id\fP(1) ,
@@ -252,7 +254,7 @@ F.Herschel, L.Pinne.
 .PP
 .\"
 .SH COPYRIGHT
-(c) 2023 SUSE Linux GmbH, Germany.
+(c) 2023 SUSE LLC
 .br
 The package SAPHanaSR-tester comes with ABSOLUTELY NO WARRANTY.
 .br

man-tester/SAPHanaSR-tests-angi-ScaleOut.7

@@ -1,116 +1,140 @@
 .\" Version: 1.001
 .\"
-.TH SAPHanaSR-tests-angi-ScaleOut 7 "20 Nov 2023" "" "SAPHanaSR-angi"
+.TH SAPHanaSR-tests-angi-ScaleOut 7 "20 Dec 2023" "" "SAPHanaSR-angi"
 .\"
 .SH NAME
 SAPHanaSR-tests-angi-ScaleOut \- Functional tests for SAPHanaSR Scale-Out.
 .PP
 .\"
 .SH DESCRIPTION
 .PP
-Functional test are shipped for scale-out scenarios. This tests could be run
-out-of-the-box. The test cases are defined in dedicated files.
-See manual page SAPHanaSR-tests-syntax(5) for syntax details.
+Functional test are shipped for the scale-out ERP scenario. This tests could
+be run out-of-the-box. The test cases are defined in dedicated files.
+See manual page SAPHanaSR-tests-syntax(5) for syntax details. Details like
+performed steps or expected behaviour of cluster and HANA are explained in
+SAPHanaSR-tests-description(7).
 
-Entry point for all predefined tests is a clean and idle Linux cluster and a
-clean HANA pair in sync. Same is true for the final state.
-See manual page SAPHanaSR_maintenance_examples(7) for detecting the correct
-status and watching changes near real-time.
+Each test can be executed by running the command SAPHanaSR-testCluster with
+appropriate parameters. See manual page SAPHanaSR-testCluster(8).
 .PP
-Predefined functional tests for scale-out overwiev
+Predefined functional tests for scale-out ERP overwiev:
 .TP
-block_manual_takeover
-blocked manual takeover, for susTkOver.py
+\fBblock_manual_takeover\fP
+Blocked manual takeover, for susTkOver.py.
 .TP
-block_sr_and_freeze_prim_master_nfs
-block HANA SR and freeze HANA NFS on primary master node
+\fBblock_sr_and_freeze_prim_master_nfs\fP
+Block HANA SR and freeze HANA NFS on primary master node (not yet implemented).
 .TP
-block_sr_and_freeze_prim_site_nfs
-block HANA SR and freeze HANA NFS on primary site
+\fBblock_sr_and_freeze_prim_site_nfs\fP
+Block HANA SR and freeze HANA NFS on primary site (not yet implemented).
 .TP
-free_log_area
-free HANA log area on primary site
+\fBfree_log_area\fP
+Free HANA log area on primary site.
 .TP
-freeze_prim_master_nfs
-freeze HANA NFS on primary master node
+\fBfreeze_prim_master_nfs\fP
+Freeze HANA NFS on primary master node.
 .TP
-freeze_prim_site_nfs
-freeze HANA NFS on primary site
+\fBfreeze_prim_site_nfs\fP
+Freeze HANA NFS on primary site.
 .TP
-kill_prim_indexserver
-Kill primary master indexserver, for susChkSrv.py
+\fBfreeze_secn_site_nfs\fP
+Freeze HANA NFS on secondary site (not yet implemented).
 .TP
-kill_prim_inst
-Kill primary master instance
+\fBkill_prim_indexserver\fP
+Kill primary master indexserver, for susChkSrv.py.
 .TP
-kill_prim_node
-Kill primary master node
+\fBkill_prim_inst\fP
+Kill primary master instance.
 .TP
-kill_prim_worker_indexserver
-Kill primary worker indexserver, for susChkSrv.py
+\fBkill_prim_node\fP
+Kill primary master node.
 .TP
-kill_prim_worker_inst
-Kill primary worker instance
+\fBkill_prim_site\fP
+Kill secondary site nodes (not yet implemented).
 .TP
-kill_prim_worker_node
-Kill primary worker node
+\fBkill_prim_worker_indexserver\fP
+Kill primary worker indexserver, for susChkSrv.py.
 .TP
-kill_secn_indexserver
-Kill secondary master indexserver, for susChkSrv.py
+\fBkill_prim_worker_inst\fP
+Kill primary worker instance.
 .TP
-kill_secn_inst
-Kill secondary master instance
+\fBkill_prim_worker_node\fP
+Kill primary worker node.
 .TP
-kill_secn_node
-Kill secondary master node
+\fBkill_secn_indexserver\fP
+Kill secondary master indexserver, for susChkSrv.py.
 .TP
-kill_secn_worker_inst
-Kill secondary worker instance
+\fBkill_secn_inst\fP
+Kill secondary master instance.
 .TP
-kill_secn_worker_node
-Kill secondary worker node
+\fBkill_secn_node\fP
+Kill secondary master node.
 .TP
-maintenance_cluster_turn_hana
-maintenance procedure, manually turning HANA sites 
+\fBkill_secn_worker_inst\fP
+Kill secondary worker instance.
 .TP
-maintenance_with_standby_nodes
-standby+online secondary then standby+online primary
+\fBkill_secn_worker_node\fP
+Kill secondary worker node.
 .TP
-nop
-no operation - check, wait and check again (stability check)
+\fBkill_secn_site\fP
+Kill secondary site nodes (not yet implemented).
 .TP
-restart_cluster
-
+\fBmaintenance_cluster_turn_hana\fP
+Maintenance procedure, manually turning HANA sites.
 .TP
-restart_cluster_hana_running
-
+\fBmaintenance_with_standby_nodes\fP
+Maintenance procedure, standby+online secondary then standby+online primary (not yet implemented).
 .TP
-restart_cluster_turn_hana
-
+\fBnop\fP
+No operation - check, wait and check again (stability check).
+.TP
+\fBregister_prim_cold_hana\fP
+Stop cluster, do manual takeover, leave former primary down and unregistered, start cluster
+(not yet implemented).
+.TP
+\fBrestart_cluster\fP
+Stop and restart cluster and HANA
+.TP
+\fBrestart_cluster_hana_running\fP
+Stop and restart cluster, keep HANA running.
 .TP
-standby_primary_node TODO
-standby primary node (and online again)
+\fBrestart_cluster_turn_hana\fP
+Stop cluster and HANA, takeover HANA, start cluster.
 .TP
-standby_secondary_node TODO
-standby secondary node (and online again)
+\fBstandby_prim_node\fP
+Standby primary master node and online again.
+.TP
+\fBstandby_secn_node\fP
+Standby secondary master node and online again.
+.TP
+\fBstandby_secn_worker_node\fP
+Standby secondary worker node and online again.
 .RE
 .PP
 .\"
 .SH EXAMPLES
 .PP
+* List tests for SAPHanaSR-angi scale-out ERP scenarios
+.PP
+.RS 2
+# ls /usr/share/SAPHanaSR-tester/json/angi-ScaleOut/
+.RE
+.PP
 .\"
 .SH FILES
 .TP
-/usr/share/SAPHanaSR-tester/json/angi-ScaleOu/
-functional tests for SAPHanaSR-angi scale-out scenarios.
+/usr/share/SAPHanaSR-tester/json/angi-ScaleOut/
+functional tests for SAPHanaSR-angi scale-out ERP scenarios.
 .TP
 /usr/bin/sct_test_*
 shell scripts for un-easy tasks on the cluster nodes.
 .PP
 .\"
 .SH REQUIREMENTS
 .PP
-See the REQUIREMENTS section in SAPHanaSR-tester(7).
+See the REQUIREMENTS section in SAPHanaSR-tester(7) and SAPHanaSR-angi(7).
+Of course, HANA database and Linux cluster have certain requirements.
+Please refer to the product documentation.
 .\"
 .SH BUGS
 In case of any problem, please use your favourite SAP support process to open
@@ -120,7 +144,8 @@ Please report any other feedback and suggestions to [email protected].
 .\"
 .SH SEE ALSO
 \fBSAPHanaSR-tester\fP(7) , \fBSAPHanaSR-testCluster\fP(8) ,
-\fBSAPHanaSR-tests-angi-ScaleUp\fP(7) ,  \fBSAPHanaSR-tests-syntax\fP(5) ,
+\fBSAPHanaSR-tests-description\fP(7) , \fBSAPHanaSR-tests-syntax\fP(5) ,
+\fBSAPHanaSR-tests-angi-ScaleUp\fP(7) ,
 \fBSAPHanaSR-angi\fP(7) , \fBSAPHanaSR-showAttr\fP(8)
 .PP
 .\"
@@ -129,7 +154,7 @@ F.Herschel, L.Pinne.
 .PP
 .\"
 .SH COPYRIGHT
-(c) 2023 SUSE Linux GmbH, Germany.
+(c) 2023 SUSE LLC
 .br
 The package SAPHanaSR-tester comes with ABSOLUTELY NO WARRANTY.
 .br