suse / suse-best-practices Goto Github PK
View Code? Open in Web Editor NEWSUSE Best Practices documentation series
SUSE Best Practices documentation series
2.2 Server registration:
@jamesongithub reported that the Button "Copy Code" does not work throughout the paper.
Let's investigate what happened and how that can be fixed. Thanks!
Hi Bernd, Fabian,
I am currently editing the Multi-SID paper, and it seems that in chapter
=== Architecture Central Services
there is missing an image for:
.Integration of {sapS4} and {sapNW} into the Cluster Using the Cluster Connector
I cannot find it in the images folder unfortunately.
And, it also seems that the other images are missing image captions /titles - is that wanted?
Thanks very much,
Meike
Table 3: Description of important Resource Agent parameters :
Example 14: Simple backup for the system database and all tenants with one singe backup call :
https://documentation.suse.com/sbp/all/single-html/SLES4SAP-hana-scaleOut-PerfOpt-15/#id-1.9.7.4
:
I'm pretty sure this should read "Restart the HANA database (now secondary) on node 2 as root." rather than "node 1"
2 High Level Overview:
https://documentation.suse.com/sbp/all/html/SBP-CSP-UpdateInfra/index.html#sec-overview
The diagram contained in this page is very fuzzy and hard to read. Can we create an updated diagram that is more clear for users to view at a glance?
While I was able to solve some document internal problems regarding variable replacement we still
have two variables referenced by common_gfdl1.2_i.adoc. The missing variables are: {ldquo} and {rdquo}.
Hello,
while reading trought this Guide I was "struggeling" with this design.
Figure 2: One cluster for central services, one for SAP HANA SR :
SAP S/4 HANA - Enqueue Replication 2
The PAS and AAS instances are installed on the DB Cluster Node's.
In Chapter 3.2 I read following statment:
...The database and SAP dialog instances can be added to the cluster either by adding more nodes to the cluster or by installing the database on either of the existing nodes. However, it is recommended to install the database on a separate cluster.
Or at least give some hint's what are the benefit's of installing the PAS and AAS on the DB Cluster rather then on the ASCS Cluster.
2.2.5 Implementing cron.allow
:
Description: The cron.allow file specifies a whitelist of users that are allowed to execute jobs via the Linux cron system.
cron is not linux-specific, remove 'Linux' here.
(spottet by @jsegitz in SUSE/doc-sle#1013)
Hi Dario @dfaggioli
can you clarify the following sentence:
This should be considered when tuning for Non-Uniform Memory Architecture (NUMA) as all memory accesses are not necessarily to local memory incurring a variable access penalty.
should it be:
This should be considered when tuning for Non-Uniform Memory Architecture (NUMA) as all memory accesses are not necessarily incurring a variable access penalty to local memory.
or:
This should be considered when tuning for Non-Uniform Memory Architecture (NUMA) as all memory accesses are not necessary to local memory incurring a variable access penalty.
It is not completely clear currently. Thank you very much!
8.2.4 Check the Cluster for the First Time:
The paragraph "The command will show the "empty" cluster and will print something like the screen output below. The most interesting information in this output is that there are two nodes in the status "online" and the message "partition with quorum"." refers to "two nodes in the status online", there are 7 nodes in the status online in the code shown below.
Hi @jamborm
would you mind having a quick look at the following senctence:
suse-best-practices/xml/MAIN-SBP-GCC-10.xml
Line 747 in 003f5d1
Should it be
"Optimized compilers frequently make decisions according to which path through the code they consider most likely to be executed, how many times a loop is expected to iterate, and similar estimates."
or
"Optimizing compilers frequently makes decisions according to which path through the code they consider most likely to be executed, how many times a loop is expected to iterate, and similar estimates."
or something similar? The current sentence seems wrong to me.
Thanks!
Example 2: SAP NetWeaver 7.5 :
https://documentation.suse.com/sbp/all/single-html/SAP_NW740_SLE15_SetupGuide/#id-1.5.14.6
Should the following paths:
nfs1:/data/nfs/suseEnqReplNW740/HA1/sapmnt
nfs1:/data/nfs/suseEnqReplNW740/HA1/usrsapsys
contain NW750 rather than NW740 when Netweaver 7.5 is being used?
2.1 Kubernetes Distribution:
https://documentation.suse.com/sbp/all/single-html/SBP-Private-Registry/#_kubernetes_distribution
Any idea why we do not list RKE?
2.2.15 Changing Home Directory Permissions from 775 to 700:
Should read
from 755 to 700
@jsegitz spotted this during his review at SUSE/doc-sle#1010. I'll take care of this.
Example 12: Adding SAPHanaSR via global.ini :
https://documentation.suse.com/sbp/all/single-html/SLES4SAP-hana-sr-guide-PerfOpt-12/#id-1.9.6.6
On one node only or on all nodes? We should document this more in detail
11.1 Do’s and Don’ts:
I think the 4th bullet is really part of the 3rd bullet. Am I correct? See below. The language is also a little awkward, perhaps: Adding location rules for the clone, master/slave, or IP resource. Only location rules mentioned in this setup guide are allowed as 'migrating' or 'moving' resources in crm-shell, HAWK, or other tools would add client-prefer rules that would break the configuration developed in this document.
In your project, avoid:
Rapidly changing/changing back cluster configuration, such as: Setting nodes to standby and online again or stopping/starting the master/slave resource.
Creating a cluster without proper time synchronization or unstable name resolutions for hosts, users and groups
Adding location rules for the clone, master/slave or IP resource. Only location rules mentioned in this setup guide are allowed.
As "migrating" or "moving" resources in crm-shell, HAWK or other tools would add client-prefer location rules this activities are completely forbidden.
1.1 Security for SAP HANA:
Link to http://help.sap.com/hana/SAP_HANA_Security_Guide_en.pdf does not work.
The chapter Set Up SAP HANA HA/DR providers is incomplete, task 4 and 5 are missing in both guide for SLE12 and 15.
DC-SBP-SAP-MULTI-SID uses several AsciiDoc attributes that are not defined. Previous versions of DAPS did not check for that but with 3.1, this issue is actually detected.
Unfortunately, in the case of DC-SBP-SAP-MULTI-SID, I was not certain what to replace these undefined attributes with. The issue is with the following attributes being used but not defined:
vip-ascs2
vip-ascs3
Maybe these are just misspellings of the existing attribute :vip-asc2: 172.17.1.17
/ :vip-asc3: 172.17.1.27
?
Tagging @pirat013 with this, as you appear to be the main author of the document.
8.2.3 Cluster Configuration for All Other Cluster Nodes:
Current text is: "Than all needed configuration files are copied over."
The word "Than" should be "Then", e.g. "Then all needed configuration files are copied over."
7.4 Manual Test of SAP HANA SR Takeover:
Please give an example for each step.
3.2.4 Configure HTTP Proxies:
Hi There,
I can see a configuration to enable the proxy (section 3.2.4) by putting the http/https_proxy config under the user root (.bashrc)
What I have at the moment is connection to AWS using a proxy which is configured global configuration on the linux server.
What I have noticed is that the aws calls by the resource agent external/ec2 is not loading the proxy (even though we adjust the .bashrc profile on the root as suggested by the guide) I was able to test this by creating a code change to dump the env variable of the user to a file before before executing the 'aws describe' commands and didnt see the http proxy setting that is why i am getting a timeout error as per below.
Oct 05 13:02:25 [1446] HOSTNAME stonith-ng: warning: operation_finished: fence_legacy_monitor_1:23826 - timed out after 180000ms
Can you let me know where we can declare a proxy setting for the resource agents for the aws cli commands?
Cheers,
Chance
Example 13: Checking the Operation Mode :
https://documentation.suse.com/sbp/all/single-html/SLES4SAP-hana-sr-guide-PerfOpt-12/#id-1.9.7.5
Is with both "Check both global.ini files and add the operation mode if needed." the SYSTEMDB and TENANT refereed or the Node1 and Node2 (should be explained). Customers loose here a lot of time with guessing
4.2 Installing ASCS on valuga11:
https://documentation.suse.com/sbp/all/html/SAP_S4HA10_SetupGuide-SLE15/index.html#_installing_ascs_on_valuga11
and
4.3 Installing ERS on valuga12:
https://documentation.suse.com/sbp/all/html/SAP_S4HA10_SetupGuide-SLE15/index.html#_installing_ers_on_valuga12
Like the database installation, I think that clean-up
should be set to yes: Clean-up: select Yes, remove operating system users from the group sapinst
.
:
https://documentation.suse.com/sbp/all/html/SAP_HA740_SetupGuide_AWS/index.html#
Will there be an updated document for SLES 15?
1.1.4 The Concept of the Cost Optimized Scenario:
Word, 'example' misspelled as 'exaample' in the following sentence:
"In addition to the description of the concept in this best practice document, read the corresponding SAP documentation such as "Using Secondary Servers for Non-Productive systems". The section is available for exaample for SAP HANA 2.0 SPS05 at https://help.sap.com/viewer/6b94445c94ae495c83a19646e7c3fd56/2.0.05/en-US/5447545b91a04cf8a0d6133a026f2be5.html."
@chabowski Hi, we had Slade from the Web team review 404 links. The SBPs had 48 broken links. Note that some links may be false positives.
kvm-migration-ibmz-to-sles.html: http://www.redbooks.ibm.com/redbooks/pdfs/sg248332.pdf
optimizing-linux-for-amd-epyc-with-sle-12-sp3.html: http://developer.amd.com/wordpress/media/2012/10/LibNUMA-WP-fv1.pdf
sbp-drbd.html: https://www.linbit.com/en/p/services/support
sbp-drbd.html: https://www.suse.com/documentation/sle-ha-geo-12/singlehtml/art_ha_geo_quick/art_ha_geo_quick.html#sec.ha.geo.challenges
sbp-drbd.html: https://www.suse.com/documentation/sle_ha/singlehtml/book_sleha/book_sleha.html
sbp-drbd.html: sle_ha/book_sleha/data/sec_ha_geo_setup.html
sbp-drbd.html: sle-ha-geo-12/art_ha_geo_quick/data/art_ha_geo_quick.html
sbp-kmp-manual.html: http://www.uefi.org/specs
sbp-performance-tuning.html: https://haypo.github.io/intel-cpus.html
sbp-performance-tuning.html: http://www.hardwaresecretscom/everything-you-need-to-know-about-the-cpu-c-states-power-saving-modes/
sbp-quilting-osc.html: https://api.opensuse.org
sbp-rpm-packaging.html: http://openbuildservice.org/help/materials/
sbp-rpm-packaging.html: http://packman.links2linux.org/
sbp-rpm-packaging.html: https://en.wikipedia.org/wiki/Chrootor
sbp-sap-msazure-solution-templates.html: https://service.sap.com
sbp-scomusermanual.html: suse-manager-3/book_suma_reference_manual/data/book_suma_reference_manual.html
securitymodule.html: http://nvlpubs.nist.gov/nistpubs/SpecialPublications/NIST.SP.800-52r1.pdf
kvm-migration-ibmz-to-sles.html: http://www.redbooks.ibm.com/redbooks/pdfs/sg248332.pdf
optimizing-linux-for-amd-epyc-with-sle-12-sp3.html: http://developer.amd.com/wordpress/media/2012/10/LibNUMA-WP-fv1.pdf
sbp-drbd.html: https://www.linbit.com/en/p/services/support
sbp-drbd.html: https://www.suse.com/documentation/sle-ha-geo-12/singlehtml/art_ha_geo_quick/art_ha_geo_quick.html#sec.ha.geo.challenges
sbp-drbd.html: https://www.suse.com/documentation/sle_ha/singlehtml/book_sleha/book_sleha.html
sbp-drbd.html: sle_ha/book_sleha/data/sec_ha_geo_setup.html
sbp-drbd.html: sle-ha-geo-12/art_ha_geo_quick/data/art_ha_geo_quick.html
sbp-kmp-manual.html: http://www.uefi.org/specs
sbp-performance-tuning.html: https://haypo.github.io/intel-cpus.html
sbp-performance-tuning.html: http://www.hardwaresecretscom/everything-you-need-to-know-about-the-cpu-c-states-power-saving-modes/
sbp-quilting-osc.html: https://api.opensuse.org
sbp-rpm-packaging.html: http://openbuildservice.org/help/materials/
sbp-rpm-packaging.html: http://packman.links2linux.org/
sbp-rpm-packaging.html: https://en.wikipedia.org/wiki/Chrootor
sbp-sap-msazure-solution-templates.html: https://service.sap.com
sbp-scomusermanual.html: suse-manager-3/book_suma_reference_manual/data/book_suma_reference_manual.html
securitymodule.html: http://nvlpubs.nist.gov/nistpubs/SpecialPublications/NIST.SP.800-52r1.pdf
spb-oracleweblogic.html: http://www.oracle.com/technetwork/middleware/fusion- middleware/downloads/index.html
suse-best-practices-sap-hana-on-kvm-sles-for-sap-12-sp2.html: https://blogs.saphana.com/2017/09/20/tdi-phase-5-new-opportunities-for-cost-optimization-of-sap-hana-hardware/
suse-best-practices-sap-hana-on-kvm-sles-for-sap-12-sp2.html: https://help.sap.com/doc/eb3777d5495d46c5b2fa773206bbfb46/2.0.02/en-US/d4a122a7bb57101493e3f5ca08e6b039.html
suse-best-practices-sap-hana-on-kvm-sles-for-sap-12-sp2.html: https://websmp203.sap-ag.de/~sapidb/011000358700000050632013E
suse-best-practices-sap-hana-on-kvm-sles-for-sap-12-sp2.html: sles-12/sles-12-sp2/singlehtml/book_virt/book_virt.html
suse-best-practices-sap-hana-on-kvm-sles-for-sap-12-sp2.html: sles-12/sles-12-sp2/singlehtml/vt_best_practices_guide/vt_best_practices_guide.html
suse-best-practices-sap-hana-on-kvm-sles-for-sap-12-sp2.html: sles-for-sap-12/sles-for-sap-12-sp2/singlehtml/book_s4s/book_s4s.html
spb-oracleweblogic.html: http://www.oracle.com/technetwork/middleware/fusion- middleware/downloads/index.html
suse-best-practices-sap-hana-on-kvm-sles-for-sap-12-sp2.html: https://blogs.saphana.com/2017/09/20/tdi-phase-5-new-opportunities-for-cost-optimization-of-sap-hana-hardware/
suse-best-practices-sap-hana-on-kvm-sles-for-sap-12-sp2.html: https://help.sap.com/doc/eb3777d5495d46c5b2fa773206bbfb46/2.0.02/en-US/d4a122a7bb57101493e3f5ca08e6b039.html
suse-best-practices-sap-hana-on-kvm-sles-for-sap-12-sp2.html: https://websmp203.sap-ag.de/~sapidb/011000358700000050632013E
suse-best-practices-sap-hana-on-kvm-sles-for-sap-12-sp2.html: sles-12/sles-12-sp2/singlehtml/book_virt/book_virt.html
suse-best-practices-sap-hana-on-kvm-sles-for-sap-12-sp2.html: sles-12/sles-12-sp2/singlehtml/vt_best_practices_guide/vt_best_practices_guide.html
suse-best-practices-sap-hana-on-kvm-sles-for-sap-12-sp2.html: sles-for-sap-12/sles-for-sap-12-sp2/singlehtml/book_s4s/book_s4s.html
https://documentation.suse.com/sbp/all/single-html/SBP-SLES12SP1-SAP-migrationguide/
all edit source links seem to be broken
https://github.com/SUSE/suse-best-practices/blob/master/xml/MAIN-SBP-SLES12SP1-SAP-migrationguide.xmlMAIN-SBP-SLES12SP1-SAP-migrationguide.xml goes to github 404
In the ENSA1/ENSA2 and HANA SRA clustering best practices we describe how to start and stop an single "component" e.g. the HANA DB itself only.
Customers asked how to stop a complete multi-tiered clustered SAP system (DB, ASCS, PAS maybe AAS) and afterwards how to start in the right order. Currently we don't have a guide for this.
9.2.1 Cluster Bootstrap and More:
The SBD is formatted with
Timeout (watchdog) : 20
Timeout (allocate) : 2
Timeout (loop) : 1
Timeout (msgwait) : 40
So
stonith-timeout="150s"
should be 48s, right?
4.4.4 Adapting SAP Profiles to Match the SAP S/4-HA-CLU 1.0 Certification:
There are two errors in the filenames:
/usr/sap/EN2/SYS/profile/EN2ASCS00_sapen2as_
should be /usr/sap/EN2/SYS/profile/EN2_ASCS00_sapen2as
/usr/sap/EN2/SYS/profile/EN2ERS10_sapen2er_
should be /usr/sap/EN2/SYS/profile/EN2_ERS10_sapen2er
1.1.4 The Concept of the Performance Optimized Scenario:
Using the SAP HANA hook described in this document allows to inform the cluster immediately if the SAP HANA system replication brakes.
should be
Using the SAP HANA hook described in this document allows to inform the cluster immediately if the SAP HANA system replication breaks.
@fmherschel: Do you know how to insert a page break in an adoc document? The usual <<< does not work ... I would like to have the GFDL separated from the rest of the document, starting on an extra page, and also with a smaller font. But all I tried did not work out. It is just cosmetics, but still would be nice to have to be "in synch" with the other SUSE Best Practices written in DocBookXML.
See f.e.: https://www.suse.com/documentation/suse-best-practices/pdfdoc/suse-best-practices-sap-hana-on-kvm-sles-for-sap-12-sp2/suse-best-practices-sap-hana-on-kvm-sles-for-sap-12-sp2.pdf
ToC section 10
Example 7: Copy the KEY and KEY-DATA file from the primary to the secondary site :
https://documentation.suse.com/sbp/all/single-html/SLES4SAP-hana-sr-guide-PerfOpt-15/#id-1.8.8.4
This rsync example needs an overhaul, or should be replaced e.g. by scp or completely left of. In the current way it confuses the reader more than being helpful.
For html
and single-html
it would be nice to be able to link to a separate page for the legal notice and the gnu license content instead of having a "compile time" include. They are pretty long and take up a lot of space on the doc. e.g. https://documentation.suse.com/sbp/all/html/SBP-SLES12SP1-SAP-migrationguide/index.html -> roughly 75% of the doc is the legal notice and gnu license, whereas the actual content is only about 25% of the page. For pdf
you may or may not want the full content included.
:toc2:
attribute in adoc format formats the toc on the left margin instead of the top of the document. daps
seems to ignore this but renders as xhtml
(which is a supported backend for the toc2
attribute). Anyway to get this working?Here the $
character is copied
Btw the copy code button does not work on the html pages generated locally with daps
. Any idea?
7.5 Testing the hook integration:
There is a typo, the correct regex should be:
- suse01:ha1adm> awk '/ha_dr_SAPHanaSR.*crm_attribute/ \
+ suse01:ha1adm> awk '/ha_dr_SAPHanaSr.*crm_attribute/ \
Which output similar to:
2021-12-10 23:52:16.388254 ha_dr_SAPHanaSrM 2.0
2021-12-10 23:52:16.829596 ha_dr_SAPHanaSrM SOK
4.4.4 Adapting SAP Profiles to Match the SAP NW-HA-CLU 7.40 Certification:
According to: https://bugzilla.suse.com/show_bug.cgi?id=1184983#c24,, we need to tell customer to change Autostart to 0
Hi,
In the expectation section, after losing the secondary node the first expectation is:
I believe this to be incorrect. In the 2 node cluster as described in the doc, two_node is set to 1 in the corosync.conf which reduces the number of votes for quorum to 1. As the sole remaining node in the cluster, it will then retain quorum in this case. This is found in my tests also. The status remains "partition with quorum".
3.4 The Concept of the Performance Optimized Scenario:
Please double check if that is going to work on SLES-for-SAP 12, SAPHanaSR-ScaleOut version 0.16x.
AFAIK this breaks tracing of system replication with 0.16x. It needs multi-target support, which comes for SLES-for-SAP 15 with 0.180.
Example 28: Main SAP HANA Update procedure :
As a last step, remove the maintenance meta attribute with:
crm resource meta master-slave-resource delete maintenance
4.2 Installing ASCS on valuga11:
Like in 4.3 Installing ERS on valuga12
, the permissions on /usr/sap/EN2/ASCS00
need to be adjust during installation, like this:
If you get an error during the installation about permissions, change the ownership of the ASCS directory
# chown -R en2adm:sapsys /usr/sap/EN2/ASCS00
4.5 Installing Database on valuga01:
If I set the Instance Number to 00 as the doc said, then I have a Instance Number "00" is already in use by local SAP System EN2
error. As far as I understand each SAP instance should have a unique ID, so in that cas 00 is already used by ASCS, no? And as the /usr/sap/EN2/SYS
and sapmnt
directories are shared across all nodes (see here), then HANA DB installer detect it.
Or did I do something wrong?
2 Preparing the Installation:
We need to update this page with the new "Full" and "Online" Media starting with SP2.
Is it really "Enlightment of VMs"?? I am well aware that tech terms can be strange ;-) - but we had a discussion internally, and after doing some research, we got only "enlightenment" back as results in relation with virtualization.
Thanks very much for clarification!
Currently the GDL beginns with
"0. Preamble" but should be
"13.0" or "13.1" "Preamble"
The reason might be that the GDL is included without setting a section-indentation.
Or is that "0. Preamble" printed by plan?
If I look at the sources I see:
[float]
== 0. PREAMBLE
Example 11: Stop SAP HANA :
https://documentation.suse.com/sbp/all/single-html/SLES4SAP-hana-sr-guide-PerfOpt-15/#id-1.9.6.5
How can we verify that the hook is working correctly?
Example 1: Installing additional software for the HA cluster :
https://documentation.suse.com/sbp/all/single-html/SLES4SAP-hana-sr-guide-PerfOpt-15/#id-1.6.5.4.3
Please let us tell customer to install this package as well supportutils-plugin-ha-sap for all SAP HANA documentation
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.