Merge pull request #24079 from danielva/master

Updates to the SAP HANA Cloud tutorials

Author: rbrainey

tutorials/data-lake-file-containers-hdlfscli/data-lake-file-containers-hdlfscli.md

@@ -118,7 +118,6 @@ Some HDLFSCLI help documentation should appear if it is successfully installed a
 
 [OPTION END]
 
-
 ### Generate Certificates
 
 To connect the HDLFSCLI to an SAP HANA, data lake Files container, a certificate will need to be generated to make a secure connection. Below are the steps required to create a self-signed certificate to get started using the HDLFSCLI. You will require an installation of OpenSSL. Use your preferred Linux package installer to install OpenSSL if it is not already installed. If you're using a Windows machine, then Windows Subsystem for Linux (WSL) will have OpenSSL installed. Alternatively, OpenSSL can be installed for Windows from [here](https://slproweb.com/products/Win32OpenSSL.html).
@@ -127,6 +126,18 @@ Then, follow these steps to creating your self-signed certificate.
 
 Make sure the certificate fields are not all exactly the same between the Certificate Authority (CA) and client certificates. Otherwise, it is assumed to be a self-signed cert and the cert validation below will fail.
 
+Create a folder.
+
+```Shell (Microsoft Windows)
+mkdir %HOMEPATH%\certs
+cd %HOMEPATH%\certs
+```
+
+```Shell (Linux or Mac)
+mkdir -p $HOME/certs
+cd $HOME/certs
+```
+
 Create a private key for the CA (2048 bits).
 
 ```Shell
@@ -141,7 +152,7 @@ openssl req -x509 -new -key ca.key -days 200 -out ca.crt
 
 Create a signing request for the client certificate.
 
-Provide at least a common name and fill other fields as desired. Also, leave the email-Id field blank.
+Provide at least a common name and fill other fields as desired.  Leave the email-Id field blank. The Common Name must be different from the one used for the CA public certificate.
 
 ```Shell
 openssl req -new -nodes -newkey rsa:2048 -out client.csr -keyout client.key

tutorials/hana-clients-choose-hana-instance/hana-clients-choose-hana-instance.md

@@ -7,17 +7,21 @@ primary_tag: software-product>sap-hana-cloud
 ---
 
 # Choose an SAP HANA Database
+
 <!-- description --> Learn about SAP HANA Cloud and SAP HANA, express edition and choose one that will be used with the SAP HANA client interfaces in subsequent tutorials.
 
 ## Prerequisites
- - A Microsoft Windows, Linux, or Mac computer
- - A machine that can run SAP HANA, express edition if the SAP HANA Cloud trial or free tier is not used
+
+- A Microsoft Windows, Linux, or Mac computer
+- A machine that can run SAP HANA, express edition if SAP HANA Cloud free tier is not used
 
 ## You will learn
-  - How to create an instance of SAP HANA Cloud or SAP HANA, express edition
-  - How to connect to a SAP HANA Cloud or an SAP HANA, express edition database
+
+- How to create an instance of SAP HANA Cloud or SAP HANA, express edition
+- How to connect to a SAP HANA Cloud or an SAP HANA, express edition database
 
 ## Intro
+
 This tutorial will provide tips and pointers on setting up an instance of [SAP HANA](https://www.sap.com/products/hana.html) running in the cloud or on-premise so that it can then be connected to using a few of the [SAP HANA Client](https://help.sap.com/docs/SAP_HANA_CLIENT) interfaces.  
 
 For more information on SAP HANA, consult [What Is SAP HANA](https://help.sap.com/docs/SAP_HANA_PLATFORM/eb3777d5495d46c5b2fa773206bbfb46/d3b1adcdbb571014a93eff11ad9a1d89.html).
@@ -40,6 +44,7 @@ For more information on SAP HANA, consult [What Is SAP HANA](https://help.sap.co
 ---
 
 ### Overview of SAP HANA Cloud and SAP HANA On-premise
+
 There are multiple versions of SAP HANA.  The information below is a list of links for the documentation of each version.
 
 |  Version     | Notes
@@ -50,38 +55,39 @@ There are multiple versions of SAP HANA.  The information below is a list of lin
 
 
 ### SAP HANA Cloud
-Here are a few benefits of using SAP HANA Cloud:
 
-  * Software updates are automatically applied by SAP.
+Here are a few benefits of using SAP HANA Cloud:
 
-  * Hardware is managed by a cloud provider (e.g. AWS, Azure, or GCP).
+- Software updates are automatically applied by SAP.
 
-  * Many data center locations to choose from as listed in the [SAP Discovery Center](https://discovery-center.cloud.sap/serviceCatalog/sap-hana-cloud?region=all&tab=service_plan)
+- Hardware is managed by a cloud provider (e.g. AWS, Azure, or GCP).
 
-  * [Backups](https://help.sap.com/docs/hana-cloud/sap-hana-cloud-administration-guide/backup-and-recovery) are automatic and recovery can be initiated in SAP HANA Cloud Central.    
+- Many data center locations to choose from as listed in the [SAP Discovery Center](https://discovery-center.cloud.sap/serviceCatalog/sap-hana-cloud?region=all&tab=service_plan)
 
-  * The memory, compute and storage settings can be changed as your needs change.  Note a few operations can be performed using [service requests](https://help.sap.com/docs/hana-cloud/sap-hana-cloud-administration-guide/service-requests).
+- [Backups](https://help.sap.com/docs/hana-cloud/sap-hana-cloud-administration-guide/backup-and-recovery) are automatic and recovery can be initiated in SAP HANA Cloud Central.    
 
-  * The ability is provided to expand data storage from in-memory, to native storage extensions, to a data lake, while providing a common access layer that enables you to have further control over performance and cost.  See also [Lower Your Data Management Costs With SAP HANA Cloud](https://blogs.sap.com/2019/10/29/lower-your-data-management-costs-with-sap-hana-cloud/).
+- The memory, compute and storage settings can be changed as your needs change.  Note a few operations can be performed using [service requests](https://help.sap.com/docs/hana-cloud/sap-hana-cloud-administration-guide/service-requests).
 
+- The ability is provided to expand data storage from in-memory, to native storage extensions, to a data lake, while providing a common access layer that enables you to have further control over performance and cost.  See also [Lower Your Data Management Costs With SAP HANA Cloud](https://blogs.sap.com/2019/10/29/lower-your-data-management-costs-with-sap-hana-cloud/).
 
-  Here are a few differences between SAP HANA Cloud and an on-premise version:  
 
-  * Every SAP HANA Cloud instance is one SAP HANA database.  SAP HANA Cloud as of 2024 QRC 4 offers [multitenancy](https://help.sap.com/docs/hana-cloud/sap-hana-cloud-multitenancy/introducing-sap-hana-cloud-multitenancy) support.  For further details see [The next step towards cost-effectiveness and scalability with SAP HANA Cloud Multitenancy](https://community.sap.com/t5/technology-blog-posts-by-sap/the-next-step-towards-cost-effectiveness-and-scalability-with-sap-hana/ba-p/13885564).  On-premise SAP HANA also has a concept of  tenant databases (a system database and one or more tenant databases) but in a different manner from SAP HANA Cloud.  For further details see [SAP HANA Tenant Databases](https://help.sap.com/docs/SAP_HANA_PLATFORM/eb3777d5495d46c5b2fa773206bbfb46/0baadba82dd9407cbb852ae98f49f6bd.html).  
+Here are a few differences between SAP HANA Cloud and an on-premise version:  
 
-  * Connections to an SAP HANA Cloud instance must be secure and require a minimum SAP HANA client version of 2.4.167.
+- Every SAP HANA Cloud instance is one SAP HANA database.  SAP HANA Cloud as of 2024 QRC 4 offers [multitenancy](https://help.sap.com/docs/hana-cloud/sap-hana-cloud-multitenancy/introducing-sap-hana-cloud-multitenancy) support.  For further details see [The next step towards cost-effectiveness and scalability with SAP HANA Cloud Multitenancy](https://community.sap.com/t5/technology-blog-posts-by-sap/the-next-step-towards-cost-effectiveness-and-scalability-with-sap-hana/ba-p/13885564).  On-premise SAP HANA also has a concept of  tenant databases (a system database and one or more tenant databases) but in a different manner from SAP HANA Cloud.  For further details see [SAP HANA Tenant Databases](https://help.sap.com/docs/SAP_HANA_PLATFORM/eb3777d5495d46c5b2fa773206bbfb46/0baadba82dd9407cbb852ae98f49f6bd.html).  
 
-  * The administration user for SAP HANA Cloud is named DBADMIN while for an SAP HANA 2.0 database it is SYSTEM.  For additional details see [Predefined Users](https://help.sap.com/docs/hana-cloud-database/sap-hana-cloud-sap-hana-database-security-guide/predefined-users), [SAP HANA Cloud Administrator DBADMIN](https://help.sap.com/docs/hana-cloud-database/sap-hana-cloud-sap-hana-database-administration-guide/user-management-with-sap-hana-database-administrator-dbadmin), and [Predefined Users in HANA 2.0](https://help.sap.com/docs/SAP_HANA_PLATFORM/b3ee5778bc2e4a089d3299b82ec762a7/de4ee8bbbb5710148a04f023da147c8d.html).  
+- Connections to an SAP HANA Cloud instance must be secure and require a minimum SAP HANA client version of 2.4.167.
 
-  Information on the instance size steps for SAP HANA Cloud, SAP HANA databases can be found at [Create an SAP HANA Database Instance Using SAP HANA Cloud Central](https://help.sap.com/docs/hana-cloud/sap-hana-cloud-administration-guide/create-sap-hana-database-instance-using-sap-hana-cloud-central).  Service plan, pricing and data center availability can be found at [SAP HANA Cloud Service (SAP Discovery Center)](https://discovery-center.cloud.sap/serviceCatalog/sap-hana-cloud?region=all&tab=service_plan).  Details on limitations can be found at [System Limitations](https://help.sap.com/docs/hana-cloud-database/sap-hana-cloud-sap-hana-database-sql-reference-guide/system-limitations).  Compatibility information can be found at [Compatibility with Other SAP HANA Versions](https://help.sap.com/docs/hana-cloud/sap-hana-cloud-migration-guide/compatibility-with-other-sap-hana-versions).  Additional details can be found at [What is SAP HANA?](https://www.sap.com/products/technology-platform/hana/what-is-sap-hana.html).
+- The administration user for SAP HANA Cloud is named DBADMIN while for an SAP HANA 2.0 database it is SYSTEM.  For additional details see [Predefined Users](https://help.sap.com/docs/hana-cloud-database/sap-hana-cloud-sap-hana-database-security-guide/predefined-users), [SAP HANA Cloud Administrator DBADMIN](https://help.sap.com/docs/hana-cloud-database/sap-hana-cloud-sap-hana-database-administration-guide/user-management-with-sap-hana-database-administrator-dbadmin), and [Predefined Users in HANA 2.0](https://help.sap.com/docs/SAP_HANA_PLATFORM/b3ee5778bc2e4a089d3299b82ec762a7/de4ee8bbbb5710148a04f023da147c8d.html).  
 
+Information on the instance size steps for SAP HANA Cloud, SAP HANA databases can be found at [Create an SAP HANA Database Instance Using SAP HANA Cloud Central](https://help.sap.com/docs/hana-cloud/sap-hana-cloud-administration-guide/create-sap-hana-database-instance-using-sap-hana-cloud-central).  Service plan, pricing and data center availability can be found at [SAP HANA Cloud Service (SAP Discovery Center)](https://discovery-center.cloud.sap/serviceCatalog/sap-hana-cloud?region=all&tab=service_plan).  Details on limitations can be found at [System Limitations](https://help.sap.com/docs/hana-cloud-database/sap-hana-cloud-sap-hana-database-sql-reference-guide/system-limitations).  Compatibility information can be found at [Compatibility with Other SAP HANA Versions](https://help.sap.com/docs/hana-cloud/sap-hana-cloud-migration-guide/compatibility-with-other-sap-hana-versions).  Additional details can be found at [What is SAP HANA?](https://www.sap.com/products/technology-platform/hana/what-is-sap-hana.html).
 
 ### Connect to SAP HANA Cloud
+
 >To complete the tutorials in the mission, an SAP HANA instance is needed. Step 3 and 5 in this tutorial provide two different, free options that can be used to set up an SAP HANA instance.  Only one of these steps needs to be completed if you currently do not have access to an SAP HANA instance.
 
-The instructions on how to setup a free SAP HANA Cloud trial or free tier within the SAP Business Technology Platform (SAP BTP), are well covered in a number of other sources listed below.  Trial is only available on the US10 landscape and is in a separate SAP BTP trial account whereas free tier is available in multiple production SAP BTP accounts and provides a seamless transition from a free tier to a paid plan.
+The instructions on how to setup a free SAP HANA Cloud instance within the SAP Business Technology Platform (SAP BTP) are well covered in a number of other sources listed below.  The SAP BTP Trial is available on the US10 and AP21 landscapes.  When using the free SAP HANA Cloud service in productive landscapes, there is an option to transition the service from free tier to a paid service.
 
-* [Set Up Your SAP HANA Cloud, SAP HANA Database (free tier or trial) and Understand the Basics](group.hana-cloud-get-started-1-trial)
+* [Set Up Your SAP HANA Cloud, SAP HANA Database and Understand the Basics](group.hana-cloud-get-started-1-trial)
 
 * [SAP Learning Journey - Provisioning and Administering Databases in SAP HANA Cloud](https://learning.sap.com/learning-journey/provision-and-administer-databases-in-sap-hana-cloud)
 
@@ -99,7 +105,7 @@ For more information on SAP BTP see the following product pages and help documen
 * [https://help.sap.com/docs/btp](https://help.sap.com/docs/btp)
 
 
-Continue with this tutorial once you have created an SAP HANA Cloud trial or free tier instance as shown below.
+Continue with this tutorial once you have created an SAP HANA Cloud instance as shown below.
 
 ![SAP HANA Cloud Trial instance](hana-cloud-instance.png)
 
@@ -108,7 +114,7 @@ Continue with this tutorial once you have created an SAP HANA Cloud trial or fre
 
     ![SQL Endpoint](SQLEndpoint.png)
 
-    >The SAP HANA Cloud, HANA database free tier or trial instances are shut down on a nightly basis and will need to be restarted before working with them the next day.  
+    >The SAP HANA Cloud, HANA database free tier instances are shut down on a nightly basis and will need to be restarted before working with them the next day.  
 
 2. Open a SQL console for your database instance from SAP HANA Cloud Central.
 
@@ -153,7 +159,7 @@ Congratulations! You have connected to SAP HANA Cloud and performed a few querie
 
 
 ### SAP HANA, express edition
->This step only needs to be completed if you currently do not have access to an SAP HANA Instance and did not setup an SAP HANA instance through the SAP HANA Cloud Trial or free tier as explained in step 3.
+>This step only needs to be completed if you currently do not have access to an SAP HANA Instance and did not setup an SAP HANA instance through the SAP HANA Cloud free tier as explained in step 3.
 
 SAP provides a free streamlined version of SAP HANA that runs on developer laptops called [SAP HANA, express edition](https://www.sap.com/products/technology-platform/hana/express-trial.html).  
 
@@ -169,7 +175,7 @@ At this point, you should have a running instance of SAP HANA, express edition.
 
 
 ### Connect to SAP HANA, express edition
->This step only needs to be completed if you currently do not have access to an SAP HANA Instance and did not setup an SAP HANA instance through the SAP HANA Cloud Trial or free tier as explained in step 3.
+>This step only needs to be completed if you currently do not have access to an SAP HANA Instance and did not setup an SAP HANA instance using the SAP HANA Cloud free tier as explained in step 3.
 
 A default installation will contain one [system](https://help.sap.com/docs/SAP_HANA_PLATFORM/6b94445c94ae495c83a19646e7c3fd56/39da3d057f56427ab1bb7f738ca9e7ce.html) database named **SYSTEMDB** and one [tenant](https://help.sap.com/docs/SAP_HANA_PLATFORM/6b94445c94ae495c83a19646e7c3fd56/623afd167e6b48bf956ebb7f2142f058.html) database named **HXE**.
 

tutorials/hana-clients-hdbsql/hana-clients-hdbsql.md

@@ -72,7 +72,7 @@ This step demonstrates how to connect to a SAP HANA instance using [HDBSQL](http
 
         An example of configuring this setting is shown in [Allow connections to SAP HANA Cloud instance from selected IP addresses — using the command line](https://blogs.sap.com/2020/10/30/allow-connections-to-sap-hana-cloud-instance-from-selected-ip-addresses-using-the-command-line/).
 
-    - The SAP HANA Cloud, HANA database trial instance will be automatically stopped overnight.   That means you need to restart your instance before working with it each new day.
+    - The SAP HANA Cloud, HANA database free tier instance will be automatically stopped overnight.   That means you need to restart your instance before working with it each new day.
 
 
     - Connections to a HANA Cloud instance must use encryption.  The default encryption library on Windows is mscrypto and on Linux and macOS it is OpenSSL.  The following example demonstrates how one could use the SAP provided conmmoncrypto library instead of the default encryption library.  Note, the following steps require that the SAP HANA Client be downloaded from the SAP Software Downloads as the download includes the SAP Common Crypto library (libsapcrypto).  Note that the environment variables can also be set by running source hdbclienv.sh or hdbclienv.bat.

tutorials/hana-cloud-automation-rest/hana-cloud-automation-rest.md

@@ -70,15 +70,15 @@ The API's can be invoked using a tool such as the [REST Client](https://marketpl
     #From the clientsecret field in the service binding.  
     @clientsecret =
 
+    #Instance ID of a SAP HANA Cloud instance in the same subaccount as the service manager instance
+    @instanceid = 
+
     #Generated by the request bearer token call.  Copy the access_token value from the result without the quotes
     @bearer =
 
-    #Instance ID of a SAP HANA Cloud instance in the same subaccount as the service manager instance
-    @instanceid = 
-  
     #Authorization REST API call --------------------
 
-    #Request bearer token
+    #Request bearer token and paste result into the bearer variable above
     #See also https://help.sap.com/docs/service-manager/sap-service-manager/retrieve-oauth2-access-token
     #Note that by default the token expires after 1799 seconds or 30 minutes as seen in the response in the expires_in field
     GET {{uaa_url}}/{{oauth}}
@@ -89,7 +89,7 @@ The API's can be invoked using a tool such as the [REST Client](https://marketpl
     #Service plan query
     #See also https://help.sap.com/docs/service-manager/sap-service-manager/filtering-parameters-and-operators
     #See also https://api.sap.com/api/APIServiceManager/resource/Service_Plans
-    GET {{uri}}/v1/service_plans?fieldQuery=name eq 'hana'
+    GET {{uri}}/v1/service_plans?fieldQuery=name contains 'hana'
     Authorization: Bearer {{bearer}}
 
     ###