src/modules/get_pcmk_properties_db.py [16:181]: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - try: from ansible.module_utils.sap_automation_qa import ( SapAutomationQA, TestStatus, Parameters, ) from ansible.module_utils.commands import CIB_ADMIN except ImportError: from src.module_utils.sap_automation_qa import ( SapAutomationQA, TestStatus, Parameters, ) from src.module_utils.commands import CIB_ADMIN DOCUMENTATION = r""" --- module: get_pcmk_properties_db short_description: Validates Pacemaker cluster configurations for SAP HANA description: - Validates Pacemaker cluster configurations against predefined standards for SAP HANA deployments - Checks basic cluster properties, resource configurations, and constraints - Verifies OS parameters and global.ini settings - Provides detailed validation results for each parameter options: sid: description: - SAP HANA database SID type: str required: true instance_number: description: - SAP HANA instance number type: str required: true ansible_os_family: description: - Operating system family (redhat, suse, etc.) type: str required: true virtual_machine_name: description: - Name of the virtual machine type: str required: true fencing_mechanism: description: - Type of fencing mechanism used type: str required: true os_version: description: - Operating system version type: str required: true pcmk_constants: description: - Dictionary of constants for validation type: dict required: true author: - Microsoft Corporation notes: - Module requires root privileges to execute cluster management commands - Relies on cibadmin to query Pacemaker configuration - Validates configurations against predefined standards in pcmk_constants requirements: - python >= 3.6 - Pacemaker cluster environment """ EXAMPLES = r""" - name: Validate Pacemaker cluster configuration for SAP HANA get_pcmk_properties_db: sid: "HDB" instance_number: "00" ansible_os_family: "{{ ansible_os_family|lower }}" virtual_machine_name: "{{ ansible_hostname }}" fencing_mechanism: "sbd" os_version: "{{ ansible_distribution_version }}" pcmk_constants: "{{ pcmk_validation_constants }}" register: pcmk_validation_result - name: Display cluster validation results debug: var: pcmk_validation_result - name: Fail if cluster configuration is invalid fail: msg: "Pacemaker cluster configuration does not meet requirements" when: pcmk_validation_result.status == 'ERROR' """ RETURN = r""" status: description: Status of the validation returned: always type: str sample: "SUCCESS" message: description: Descriptive message about the validation results returned: always type: str sample: "HA Parameter Validation completed successfully." details: description: Detailed validation results returned: always type: dict contains: parameters: description: List of validated parameters returned: always type: list elements: dict contains: category: description: Category of the parameter type: str sample: "crm_config" id: description: ID of the parameter type: str sample: "cib-bootstrap-options-stonith-enabled" name: description: Name of the parameter type: str sample: "stonith-enabled" value: description: Actual value found type: str sample: "true" expected_value: description: Expected value for comparison type: str sample: "true" status: description: Result of the comparison type: str sample: "SUCCESS" """ class HAClusterValidator(SapAutomationQA): """ Validates High Availability cluster configurations. This class validates Pacemaker cluster configurations against predefined standards for SAP HANA deployments. It checks both basic cluster properties and resource-specific configurations. Attributes: BASIC_CATEGORIES (Dict): Mapping of basic configuration categories to their XPaths RESOURCE_CATEGORIES (Dict): Mapping of resource types to their XPaths """ BASIC_CATEGORIES = { "crm_config": (".//cluster_property_set", "CRM_CONFIG_DEFAULTS"), "rsc_defaults": (".//meta_attributes", "RSC_DEFAULTS"), "op_defaults": (".//meta_attributes", "OP_DEFAULTS"), } CONSTRAINTS_CATEGORIES = (".//*", "CONSTRAINTS_DEFAULTS") RESOURCE_CATEGORIES = { "sbd_stonith": ".//primitive[@type='external/sbd']", "fence_agent": ".//primitive[@type='fence_azure_arm']", - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - src/modules/get_pcmk_properties_scs.py [16:189]: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - try: from ansible.module_utils.sap_automation_qa import ( SapAutomationQA, TestStatus, Parameters, ) from ansible.module_utils.commands import CIB_ADMIN except ImportError: from src.module_utils.sap_automation_qa import ( SapAutomationQA, TestStatus, Parameters, ) from src.module_utils.commands import CIB_ADMIN DOCUMENTATION = r""" --- module: get_pcmk_properties_scs short_description: Validates Pacemaker cluster configurations for SAP ASCS/ERS description: - Validates Pacemaker cluster configurations against predefined standards for SAP Application Tier ASCS/ERS deployments - Checks basic cluster properties, resource configurations, constraints, and OS parameters - Provides detailed validation results for each parameter - Supports different configurations based on operating system and fencing mechanism options: sid: description: - SAP System ID (SID) type: str required: true ascs_instance_number: description: - SAP ASCS instance number type: str required: true ers_instance_number: description: - SAP ERS instance number type: str required: true ansible_os_family: description: - Operating system family (redhat, suse, etc.) type: str required: true virtual_machine_name: description: - Name of the virtual machine type: str required: true pcmk_constants: description: - Dictionary of constants for validation type: dict required: true fencing_mechanism: description: - Type of fencing mechanism used type: str required: true nfs_provider: description: - NFS provider type (e.g., AFS, ANF) type: str required: false default: "" author: - Microsoft Corporation notes: - Module requires root privileges to execute cluster management commands - Relies on cibadmin to query Pacemaker configuration - Validates configurations against predefined standards in pcmk_constants requirements: - python >= 3.6 - Pacemaker cluster environment """ EXAMPLES = r""" - name: Validate Pacemaker cluster configuration for SAP ASCS/ERS get_pcmk_properties_scs: sid: "S4D" ascs_instance_number: "00" ers_instance_number: "10" ansible_os_family: "{{ ansible_os_family|lower }}" virtual_machine_name: "{{ ansible_hostname }}" pcmk_constants: "{{ pcmk_validation_constants }}" fencing_mechanism: "sbd" register: pcmk_validation_result - name: Display cluster validation results debug: var: pcmk_validation_result - name: Fail if cluster configuration is invalid fail: msg: "Pacemaker cluster configuration does not meet requirements" when: pcmk_validation_result.status == 'ERROR' """ RETURN = r""" status: description: Status of the validation returned: always type: str sample: "SUCCESS" message: description: Descriptive message about the validation results returned: always type: str sample: "HA Parameter Validation completed successfully." details: description: Detailed validation results returned: always type: dict contains: parameters: description: List of validated parameters returned: always type: list elements: dict contains: category: description: Category of the parameter type: str sample: "crm_config_meta_attributes" id: description: ID of the parameter type: str sample: "cib-bootstrap-options-stonith-enabled" name: description: Name of the parameter type: str sample: "stonith-enabled" value: description: Actual value found type: str sample: "true" expected_value: description: Expected value for comparison type: str sample: "true" status: description: Result of the comparison type: str sample: "SUCCESS" """ class HAClusterValidator(SapAutomationQA): """ Validates High Availability cluster configurations. This class validates Pacemaker cluster configurations against predefined standards for SAP HANA deployments. It checks both basic cluster properties and resource-specific configurations. Attributes: BASIC_CATEGORIES (Dict): Mapping of basic configuration categories to their XPaths RESOURCE_CATEGORIES (Dict): Mapping of resource types to their XPaths """ BASIC_CATEGORIES = { "crm_config": (".//cluster_property_set", "CRM_CONFIG_DEFAULTS"), "rsc_defaults": (".//meta_attributes", "RSC_DEFAULTS"), "op_defaults": (".//meta_attributes", "OP_DEFAULTS"), } CONSTRAINTS_CATEGORIES = (".//*", "CONSTRAINTS_DEFAULTS") RESOURCE_CATEGORIES = { "sbd_stonith": ".//primitive[@type='external/sbd']", "fence_agent": ".//primitive[@type='fence_azure_arm']", - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -