NAME¶

sapservices-move - hiding sapservices file from sapinit service at system boot.

SYNOPSYS¶

sapservices-move [ --help | --version | --hide | --unhide ]

DESCRIPTION¶

sapservices-move is called by systemd services sapping and sappong for temporarily hiding the sapservices file from sapinit service at system boot.
- sapping is hiding the sapservices file from sapinit service at system boot.
- sappong is unhiding the sapservices file after sapinit service has been started.

Hiding the sapservices file from sapinit is necessary in certain HA cluster setups. Affected are HA clusters for SAP enqueue replication where cluster nodes have concurrent access to all instance working directories, e.g. by simplified NFS mount structure. In such environments sapstartsrv needs to be started specific for each SAP instance (e.g. ASCS/ERS), to avoid side effects with other instances.

The sapinit service takes not into account such environments, but starts sapstartsrv for all instances listed in the sapservices profile definition file. This could damage the working directory content of already running instances, even on remote cluster nodes.

The script is intended to be called at boot time. Administrative use during regular operations is not intended. Consequently calling the sapinit script during regular operation will cause trouble in an above mentioned HA cluster, even on remote nodes.

For details on concept and requirements see ocf_suse_SAPStartSrv(8).

OPTIONS¶

--help

show help

--version

show version

--hide

hide sapervices file from sapinit

--unhide

unhide previously hidden sapservices file

EXAMPLES¶

* enable both services at boot time

# systemctl enable sapping sappong

* show status of service sapping, including content of moved sapservices file

# systemctl status sapping

* show journal log entries for service sapping since 2020-02-02 20:20:20

# journalctl --unit=sapping --since="2020-02-02 20:20:20"

EXIT STATUS¶

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

FILES¶

/usr/sbin/sapservices-move

systemd service executable

/usr/lib/systemd/system/sapping.service , /usr/lib/systemd/system/sappong.service

systemd service definitions

/usr/sap/sapservices

SAP profiles definition file, used by sapstartsrv et al.

/usr/sap/$SID/SYS/profile/$SID_ASCS$nr_$virhost , /usr/sap/$SID/SYS/profile/$SID_ERS$nr_$virhost

SAP instance profiles

/etc/init.d/sapinit

System V SAP init script to enable SAP start framework, including sapstartsrv service for all entries in the sapservices file

BUGS¶

Please report feedback and suggestions to feedback@suse.com.

SEE ALSO¶

ocf_heartbeat_SAPStartSrv(7) , sapping(7) , systemctl(1)

AUTHORS¶

F.Herschel, L.Pinne

COPYRIGHT¶

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