Giter VIP home page Giter VIP logo

suse-best-practices's Issues

Missing image in Multi-SID paper

@pirat013 @fmherschel

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

[doc] Figure 2: One cluster for central services, one for SAP HANA SR

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
image

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.

So that is my understanding:
image

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.

Clarifiy sentences in suse-best-practices/xml/MAIN-SBP-AMD-EPYC-3-SLES15SP2.xml

the <quote>distance</quote>. This should be considered when tuning for <emphasis

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!

[doc] 8.2.4 Check the Cluster for the First Time

8.2.4 Check the Cluster for the First Time:

https://documentation.suse.com/sbp/all/single-html/SLES4SAP-hana-scaleOut-PerfOpt-12/#_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.

GCC10 paper: Sentence seems to be wrong

Hi @jamborm
would you mind having a quick look at the following senctence:

<para> Optimizing compilers frequently make decisions according to which path through the code

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!

[doc] 11.1 Do’s and Don’ts

11.1 Do’s and Don’ts:

https://documentation.suse.com/sbp/all/html/SLES4SAP-hana-sr-guide-PerfOpt-12/index.html#_dos_and_donts

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.

DC-SBP-SAP-MULTI-SID broken after DAPS 3.1 update

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.

[doc] 3.2.4 Configure HTTP Proxies

3.2.4 Configure HTTP Proxies:

https://documentation.suse.com/sbp/all/html/SAP_HA740_SetupGuide_AWS/index.html#_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

[doc] 1.1.4 The Concept of the Cost Optimized Scenario - misspelled word

1.1.4 The Concept of the Cost Optimized Scenario:

https://documentation.suse.com/sbp/all/single-html/SLES4SAP-hana-sr-guide-CostOpt-12/#id-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."

Broken links in SBPs

@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

[Documenation, SAP BP/WP] How to start and stop a complete SAP System

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.

[doc] 4.4.4 Adapting SAP Profiles to Match the SAP S/4-HA-CLU 1.0 Certification

4.4.4 Adapting SAP Profiles to Match the SAP S/4-HA-CLU 1.0 Certification:

https://documentation.suse.com/sbp/all/html/SAP_S4HA10_SetupGuide-SLE15/index.html#_adapting_sap_profiles_to_match_the_sap_s4_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

[doc] 1.1.4 The Concept of the Performance Optimized Scenario

1.1.4 The Concept of the Performance Optimized Scenario:

https://documentation.suse.com/sbp/all/single-html/SLES4SAP-hana-sr-guide-PerfOpt-12/#id-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.

Page break and smaller font in ADOC?

@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

Feature: Separate doc page for Legal Notice and GNU Free Documentation License

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.

Render adoc toc2 and code copy functionality in html

  1. The :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?

expected:
image

actual:
image

  1. Is there anyway to have the copy code block ignore the shell prompt characters? Perhaps we can escape it? Currently the prompt characters are copied.

e.g.
image

Here the $ character is copied

Btw the copy code button does not work on the html pages generated locally with daps. Any idea?

[doc] Incorrect Expectation - Section 10.1.9

Hi,

In the expectation section, after losing the secondary node the first expectation is:

  • The cluster detects the failed secondary node (node 2) and declares it UNCLEAN and sets the primary node (node 1) to status "partition WITHOUT quorum".

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".

https://documentation.suse.com/sbp/all/html/SLES4SAP-hana-sr-guide-PerfOpt-12/index.html#id-1.11.6.12.2.5

[doc] 3.4 The Concept of the Performance Optimized Scenario

3.4 The Concept of the Performance Optimized Scenario:

https://documentation.suse.com/sbp/all/single-html/SLES4SAP-hana-scaleOut-PerfOpt-12/#id-the-concept-of-the-performance-optimized-scenario

You can configure the level of automation by setting the parameter AUTOMATED_REGISTER. If automated registration is activated the cluster will also automatically register a former failed primary to get the new secondary.

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.

[doc] 4.5 Installing Database on valuga01: Instance Number issue?

4.5 Installing Database on valuga01:

https://documentation.suse.com/sbp/all/html/SAP_S4HA10_SetupGuide-SLE15/index.html#_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?

Gnu document license does not fit in section structure

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

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.