Scroll to navigation

SAPHanaSR-manageProvider(8) SAPHanaSR SAPHanaSR-manageProvider(8)

NAME

SAPHanaSR-manageProvider - adds, updates, removes or shows HADR provider sections for SAP HANA

SYNOPSIS

SAPHanaSR-manageProvider [ --help | --version ]
SAPHanaSR-manageProvider [ --sid=SID ] [--reconfigure] --add <template-file>
SAPHanaSR-manageProvider [ --sid=SID ] [--reconfigure] --remove <template-file>
SAPHanaSR-manageProvider [ --sid=SID ] --show --provider=<provider>

DESCRIPTION

SAPHanaSR-manageProvider allows to add (and update), to remove and show SAP HANA HADR provider sections. This is possible online and offline. It is possible on the primary as well as on the secondary.
The provider section name is case sensitive. Usually all lowercase is used for the section name. The provider hook script names are camelCase.
This script needs to be run as <sid>adm user.

OPTIONS

show help.
show version.
add the section given in the template file to configuration.
remove the section given in the template file from configuration.
apply change to running HANA, like 'hdbnsutil -reloadHADRProviders'.
show the section for given provider from configuration.
use SAP system ID <SID>. Should be autodetected, if there is only one SAP HANA instance installed on the local cluster node.

RETURN CODES

0 Successful program execution.
>0 Usage, syntax or execution errors.

EXAMPLES

* Show names of all HA/DR provider sections in global.ini.

Might be useful to see whether sections are named lower/upper/camel-case. SID is HA1.

# su - ha1adm -c "cdcoc; grep ^\[ha_dr_provider_ global.ini"

* Show the global.ini section ha_dr_provider_suschksrv, if available.

Example SID is HA1, the HADR provider script is susChkSrv.py. See also manual page susChkSrv.py(7).

# su - ha1adm -c "/usr/bin/SAPHanaSR-manageProvider --show --provider=suschksrv"

* Add section and activate the provider hook script susHanaSR.py.

Example SID is HA1, the HADR provider hook script is susHanaSR.py. See also manual page susHanaSR.py(7).
Note: 'hdbnsutil -reloadHADRProviders' loads everything from global.ini.

# cat /usr/share/SAPHanaSR/samples/global.ini
# su - ha1adm -c "/usr/bin/SAPHanaSR-manageProvider --add /usr/share/SAPHanaSR/samples/global.ini"
# su - ha1adm -c "hdbnsutil -reloadHADRProviders; echo rc=$?"
# su - ha1adm -c "cdtrace; grep SAPHanaSR.init nameserver_*.trc"

* Change timeout for HADR provider hook script susTkOver.py.

Example SID is HA1, timeout is changed from 35 to 30. The configuration is changed and applied to the running hook script. See also manual page susTkOver.py(7).

# su - ha1adm
~> /usr/bin/SAPHanaSR-manageProvider --show --provider=sustkover >sustkover.old
~> sed s/sustkover_timeout\ =\ 35/sustkover_timeout\ =\ 30/g <sustkover.old >sustkover.new
~> /usr/bin/SAPHanaSR-manageProvider --add --provider=sustkover sustkover.new
~> hdbnsutil -reloadHADRProviders
~> cdtrace; grep susTkOver.init nameserver_*.trc

FILES

/usr/bin/SAPHanaSR-manageProvider
the program itself.
/usr/sap/<SID>/SYS/global/hdb/custom/config/global.ini
the global.ini configuration on disk. Do not edit directly.
/usr/sap/<SID>/HDB<INO>/<VIRT_HOST>/trace/
directory with HANA trace files.
/usr/share/SAPHanaSR-angi/samples/
directory with samples of HADR provider sections.
the SAP python script to interact with global.ini.

BUGS

Command hangs, if it needs an input file and you do not specify the file.
In case of any problem, please use your favourite SAP support process to open a request for the component BC-OP-LNX-SUSE. Please report any other feedback and suggestions to feedback@suse.com.

SEE ALSO

SAPHanaSR-ScaleOut(7) , SAPHanaSR(7) , susHanaSR.py(7) , susHanaSrMultiTarget.py(7) , susCostOpt.py(7) , susTkOver.py(7) , susChkSrv.py(7) , SAPHanaSR_maintenance_examples(7) , SAPHanaSR-manageAttr(8) , cs_show_hana_info(8) ,
https://documentation.suse.com/sbp/sap/ ,
https://documentation.suse.com/sles-sap/ ,
https://www.susecon.com/doc/2015/sessions/TUT19921.pdf ,
https://www.susecon.com/archive-2020.html ,
https://www.susecon.com/archive-2021.html

AUTHORS

F.Herschel, L.Pinne.

COPYRIGHT

(c) 2022-2024 SUSE LLC
SAPHanaSR-manageProvider comes with ABSOLUTELY NO WARRANTY.
For details see the GNU General Public License at http://www.gnu.org/licenses/gpl.html

13 Jan 2024