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

--help
    show help.

--version
    show version.

--add <template-file>
    add the section given in the template file to configuration.

--remove <template-file>
    remove the section given in the template file from configuration.

--reconfigure
    not implemented yet, use 'hdbnsutil -reloadHADRProviders' instead.

--show --provider=<provider>
    show the section for given provider from configuration.

--sid=<SID>
    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 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/sbin/SAPHanaSR-manageProvider --show --provider=suschksrv"

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

    # cat /usr/share/SAPHanaSR/globa.ini
    # su - ha1adm -c "/usr/sbin/SAPHanaSR-manageProvider --add /usr/share/SAPHanaSR/globa.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/sbin/SAPHanaSR-manageProvider --show --provider=sustkover >sustkover.old
    ~> sed s/sustkover_timeout\ =\ 35/sustkover_timeout\ =\ 30/g <sustkover.old >sustkover.new
    ~> /usr/sbin/SAPHanaSR-manageProvider --add --provider=sustkover sustkover.new
    ~> hdbnsutil -reloadHADRProviders
    ~> cdtrace; grep susTkOver.init namerserver_*.trc

FILES

/usr/sbin/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/samples/ , /usr/share/SAPHanaSR-ScaleOut/samples/
    directory with samples of HADR provider sections.

setParameter.py
    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.
--reconfiure does not work yet.

SEE ALSO
SAPHanaSR-ScaleOut(7) , SAPHanaSR(7) , SAPHanaSR.py(7) , SAPHanaSrMultiTarget.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/all/?context=sles-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 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