updates to the hana cloud lake tutorials

Author: tracywai-sap

tutorials/hana-cloud-dl-clients-dot-net/hana-cloud-dl-clients-dot-net.md

@@ -109,7 +109,7 @@ In order for the shell to recognize that the .NET SDK is installed and for any `
     pico Program.cs
     ```
 
-5.  Replace the entire contents of `Program.cs` with the code below:  
+5.  Replace the entire contents of `Program.cs` with the code below. Update the host value in the connection string.
 
     ```C#
     using System;
@@ -162,11 +162,9 @@ In order for the shell to recognize that the .NET SDK is installed and for any `
 
     Save and close the `Program.cs` file after replacing the code.
 
-    The above app makes use of some of the data lake Relational Engine .NET driver  methods, such as [SAConnection](https://help.sap.com/docs/SAP_HANA_DATA_LAKE/a894a54d84f21015b142ffe773888f8c/3c0ff5b76c5f10148352aa573b2bc242.html).  Connection details for this class can be found at [Connection Properties](https://help.sap.com/docs/SAP_HANA_DATA_LAKE/a894a54d84f21015b142ffe773888f8c/9da0c496b1cc4245bae5f9cadf98e5fc.html).  See also the [.NET Driver](https://help.sap.com/docs/SAP_HANA_DATA_LAKE/a895964984f210158925ce02750eb580/aa95e60108104aac808272f210f52e19.html) in the SAP HANA Cloud, data Lake client interfaces guide.  Further .NET API details can be found in the [.NET API browser](https://docs.microsoft.com/en-us/dotnet/api/?view=net-6.0).
+    >The above app makes use of some of the data lake Relational Engine .NET driver  methods, such as [SAConnection](https://help.sap.com/docs/SAP_HANA_DATA_LAKE/a894a54d84f21015b142ffe773888f8c/3c0ff5b76c5f10148352aa573b2bc242.html).  Connection details for this class can be found at [Connection Properties](https://help.sap.com/docs/SAP_HANA_DATA_LAKE/a894a54d84f21015b142ffe773888f8c/9da0c496b1cc4245bae5f9cadf98e5fc.html).  See also the [.NET Driver](https://help.sap.com/docs/SAP_HANA_DATA_LAKE/a895964984f210158925ce02750eb580/aa95e60108104aac808272f210f52e19.html) in the SAP HANA Cloud, data Lake client interfaces guide.  Further .NET API details can be found in the [.NET API browser](https://docs.microsoft.com/en-us/dotnet/api/?view=net-6.0).
 
-6. Update the host value in the connection string.
-
-7.  Run the app:
+6.  Run the app.
 
     ```Shell
     dotnet run

tutorials/hana-cloud-dl-clients-golang/add-bin-to-path.png

@@ -31,31 +31,42 @@ go version
 
 ![go version linux](version2.png)
 
-If Go is installed, then it will return the currently installed version, such as 1.19.
+If Go is installed, then it will return the currently installed version, such as 1.20.4
 
 If it is not installed, download it from [Download Go](https://golang.org/dl/), run the installer, follow the provided instructions, and ensure that Go is in your path.
 
-On Linux, follow the instructions for the appropriate Linux version such as the [Installing Go for openSUSE](https://en.opensuse.org/SDB:Go).
+On Linux, follow the instructions for the appropriate Linux version: [Installing Go for openSUSE](https://en.opensuse.org/SDB:Go).
 
->In order for the shell to recognize that Go has been installed and for any go commands in future steps to be recognized, a new shell window needs to be opened.
+>Note: A new shell window must be opened for the system to recognize the Go installation and for executing any future Go commands. 
 
 ### Configure the environment
 
-The data lake Relational Engine Client interface for Go, like the other data lake Relational Engine client interfaces, except for JDBC, makes use of a C library named SQLDBC.  The Go driver loads the SQLDBC library  named `libdbcapiHDB` using [`cgo`](https://golang.org/cmd/cgo/).  For further information on the following steps, consult [Build the Go Driver](https://help.sap.com/docs/SAP_HANA_DATA_LAKE/a895964984f210158925ce02750eb580/0f3109338be048e187caa9646199e3db.html?state=DRAFT) in the SAP HANA Cloud, Data Lake Client Interfaces Reference Guide. In order to use the Go Driver, a 64-bit `gcc` compiler is required.
+The data lake Relational Engine Client interface for Go, like the other data lake Relational Engine client interfaces (except JDBC), makes use of a C library named SQLDBC.  
+
+The Go driver loads the SQLDBC library  named `libdbcapiHDB` using [`cgo`](https://golang.org/cmd/cgo/).  For further information on the following steps, consult [Build the Go Driver](https://help.sap.com/docs/SAP_HANA_DATA_LAKE/a895964984f210158925ce02750eb580/0f3109338be048e187caa9646199e3db.html?state=DRAFT) in the SAP HANA Cloud, Data Lake Client Interfaces Reference Guide. In order to use the Go Driver, a 64-bit `gcc` compiler is required.
 
 1. To check if a 64-bit `gcc` compiler is installed, run the following command:
 
     ```Shell
     gcc --version
     ```
 
-    For Windows (if it is not installed), it can be downloaded from [Download MinGW](https://www.mingw-w64.org/downloads/). Under **WinLibs.com**, you can install from [winlibs.com](https://winlibs.com/), by scrolling to the **Download** section and downloading the latest release version (UCRT runtime) of the ZIP archive for Win64 to install for the x86_64 architecture, and then extracting the folder.  
+    On Windows (if needed), download the compiler from [Download MinGW](https://www.mingw-w64.org/downloads/). Under **WinLibs.com**, follow the link to [winlibs.com](https://winlibs.com/), by navigating to the **Download** section. Find the latest release version of the Zip archive (UCRT runtime) for Win64 – x86_64. Then extract the folder. 
 
     ![download minGW from WinLibs](winLibsMinGW.png)
 
-    If command prompt isn't showing you the installed version after running the version check command, manually add the bin folder to your path by setting it in your environment variables.
+    If command prompt isn't displaying the installed version after running the version check command, manually add the `bin` folder to your path by setting it in your System environment variables.
+
+    >On Windows, search **Edit the System Environment Variables** and click on **Environment Variables...**.
+    >
+    ![Edit Environment Variables](editEnvironmentVariables.png)
+
+    Look for the `Path` environment variable and double click to edit. Select **Browse** and manually browse through your File Explorer to find the bin folder
+
+    ![Add bin to path](add-bin-to-path.png)  
 
-    On Linux, install the System GNU C compiler for your version of Linux. Note that if you are using openSUSE, minGW is included in the installation for Go through YaST.
+  On Linux, install the System GNU C compiler for your version of Linux. 
+    >Note: if you are using openSUSE, minGW is included in the installation for Go through YaST.
 
     ![gcc 64-bit](gccLinux.png)
 
@@ -70,12 +81,10 @@ The data lake Relational Engine Client interface for Go, like the other data lak
     GOPATH is set to a location such as `C:\Users\user\go` or `$HOME/go` and defines the root of your workspace which stores your codebase.
 
 3. Set the required environment variables.
-
-    On Windows, search **Edit the System Environment Variables** and click on **Environment Variables...**.
     
-    >Optionally, you can also use the **SETX** command in command prompt to set a Windows environment variable. For example, `SETX CGO_LDFLAGS C:\SAP\hdlclient\IQ-17_1\Bin64\dbcapi.dll`. Note that this will set a user variable, not a system variable. 
+    >On Windows, navigate to the start menu and search for **system** environment variables.    
+    Optionally, you can also use the **SETX** command in command prompt to set a Windows environment variable. For example, `SETX CGO_LDFLAGS C:\SAP\hdlclient\IQ-17_1\Bin64\dbcapi.dll`. Note that this will set a user variable, not a system variable. 
 
-    ![Edit Environment Variables](editEnvironmentVariables.png)
   
     On Linux, open the .bash_profile 
 
@@ -85,7 +94,7 @@ The data lake Relational Engine Client interface for Go, like the other data lak
 
 4. Set the `CGO_LDFLAGS` environment variable to point to the location of the HDLRE client library as shown below, and set the `LD_LIBRARY_PATH` if needed. 
 
-    On Windows, add the **NEW** System Variable. Set the variable name to **CGO_LDFLAGS** and the variable value to the location of `dbcapi` library: `C:\SAP\hdlclient\IQ-17_1\Bin64\dbcapi.dll`
+    On Windows, add a **NEW** System Variable. Set the variable name to **CGO_LDFLAGS** and the value as the location of `dbcapi` library: `C:\SAP\hdlclient\IQ-17_1\Bin64\dbcapi.dll`
 
     ![Set Environment Variables](setEnvVar.png)
 
@@ -97,7 +106,7 @@ The data lake Relational Engine Client interface for Go, like the other data lak
     ```
     ![.bash_profile contents](bashProfileAfterCGO.png)
 
-5. Go to the driver folder and create a go module.
+5. Navigate to the driver folder and create a Go module.
 
     ```Shell (Windows)
     cd C:\SAP\hdlclient\IQ-17_1\SDK\golang\SAP\go-hdlre\driver
@@ -120,7 +129,6 @@ The data lake Relational Engine Client interface for Go, like the other data lak
     mkdir %HOMEPATH%\DataLakeClientsTutorial\go
     cd %HOMEPATH%\DataLakeClientsTutorial\go
     notepad goQuery.go
-
     ```
 
     ```Shell (Linux)
@@ -147,7 +155,7 @@ The data lake Relational Engine Client interface for Go, like the other data lak
 
       fmt.Println("Connect String is " + connectString)
 
-      db, err := sql.Open("hdb", connectString)
+      db, err := sql.Open("hdlre", connectString)
       if err != nil {
         log.Fatal(err)
         return
@@ -197,12 +205,11 @@ The data lake Relational Engine Client interface for Go, like the other data lak
 
 4. Add the code below to `go.mod` under the go 1.19 (version) line:
     
-    >Make sure the path to the driver folder is correct and make any necessary changes.
+    >Make any necessary changes to ensure the path to the driver folder is correct.
 
     ```Code (Windows)
     replace SAP/go-hdlre/driver v0.1.0 => C:\SAP\hdlclient\IQ-17_1\SDK\golang\SAP\go-hdlre\driver   
     require SAP/go-hdlre/driver v0.1.0 
-
     ```
     
     ```Code (Linux)
@@ -248,7 +255,7 @@ Visual Studio Code provides plugins for Go and can be used to debug an applicati
 
     Notice that the program stops running at the breakpoint that was set.
 
-    Observe the variable values in the leftmost pane.  Step through code.
+    Observe the variable values in the leftmost pane.  Step through the code.
 
     ![Breakpoint](GoBreakpoint.png)  
 

tutorials/hana-cloud-dl-clients-golang/hana-cloud-dl-clients-golang.md

@@ -41,7 +41,7 @@ javac -version
 
 If these commands fail, ensure that the folder they are located in is included in your path.  
 
-The following command will install Java on openSUSE Leap 15.2.
+The following command will install Java on openSUSE Leap 15.4.
 
 ```Shell (Linux)
 sudo zypper install java-11-openjdk-devel
@@ -77,7 +77,7 @@ See [JDBC Drivers](https://help.sap.com/viewer/a894a54d84f21015b142ffe773888f8c/
     pico JavaQuery.java
     ```
 
-2. Copy the following code into `JavaQuery.java`:
+2. Copy the following code into `JavaQuery.java`. Update the `host` value in the connection string.
 
     ```Java
     import java.sql.*;
@@ -117,9 +117,7 @@ See [JDBC Drivers](https://help.sap.com/viewer/a894a54d84f21015b142ffe773888f8c/
     }
     ```
 
-3. Update the `host` value in the connection string.
-
-4. Compile the `.java` file into a `.class` file using the following command:
+3. Compile the `.java` file into a `.class` file using the following command:
 
     ```Shell (Microsoft Windows)
     javac -cp %IQDIR17%\Java\sajdbc4.jar;. JavaQuery.java
@@ -128,7 +126,7 @@ See [JDBC Drivers](https://help.sap.com/viewer/a894a54d84f21015b142ffe773888f8c/
     javac -cp $IQDIR17/java/sajdbc4.jar:. JavaQuery.java
     ```  
 
-5. Run `JavaQuery.class` and indicate where the JDBC driver is located.  
+4. Run `JavaQuery.class` and indicate where the JDBC driver is located.  
 
     ```Shell (Microsoft Windows)
     java -classpath %IQDIR17%\Java\sajdbc4.jar;. JavaQuery
@@ -184,15 +182,21 @@ The following steps demonstrate how to configure `DBeaver` to connect to data la
 
     ![Install DBeaver](dbeaver-install1.png)
 
-2. In `DBeaver`, select **Database | Driver Manager | New** to create a new driver configuration.
+2. In `DBeaver`, select **Database | Driver Manager | New** to create a new driver configuration. Name the driver **SAP HANA Cloud, data lake**
 
     ![New Driver](create-new-driver.png)
 
-3.  Under the **Libraries** tab, specify Java and native components that make up the driver.
+3.  Under the **Libraries** tab, add Java and native components by clicking Add File.
+
+    ![Libraries](create-new-drivers-libraries.png)
+
+    Press **OK** to save the new driver definition. 
+
+    ![Press OK](press-ok.png)
 
-    ![Libraries](create-new-driver-libraries.png)
+    Then edit the driver and select `sajdbc4.jar`. Choose Find Class and select the driver class.
 
-    Select `sajdbc4.jar` and choose Find Class and press **OK** to save the new driver definition.
+    ![Edit Driver library](edit-driver-class.png)
 
     >On Linux, if an error occurs indicating that the library cannot load,  ensure that source IQ.sh has been added to your environment as described at [Step 5: Install the data lake IQ client](hana-cloud-dl-clients-overview).
 
@@ -203,7 +207,7 @@ The following steps demonstrate how to configure `DBeaver` to connect to data la
 5. Provide the JDBC URL and credentials and press the **Test Connection** button.  An example of the URL is shown below.
 
     ```JDBC URL
-    jdbc:sqlanywhere:uid=HDLADMIN;pwd=MyPasword1;Host=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX.iq.hdl.trial-XXXX.hanacloud.ondemand.com:443;ENC='TLS{tls_type=rsa;direct=yes}'
+    jdbc:sqlanywhere:uid=USER1;pwd=Password1;Host=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX.iq.hdl.trial-XXXX.hanacloud.ondemand.com:443;ENC='TLS{tls_type=rsa;direct=yes}'
     ```
 
     ![Database connection main tab](create-new-driver-test.png)

tutorials/hana-cloud-dl-clients-jdbc/create-new-drivers-libraries.png

@@ -31,7 +31,7 @@ Ensure you have Node.js installed and check its version. Enter the following com
 node -v  
 ```  
 
-If Node.js is installed, the currently installed version is returned, such as v16.15.1.
+If Node.js is installed, the currently installed version is returned, such as v18.16.0.
 
 If Node.js is not installed, download the long-term support (LTS) version of Node.js from [Download Node.js](https://nodejs.org/en/download/).
 
@@ -160,7 +160,7 @@ In addition to the Node.js driver covered in this tutorial which is `@sap\iq-cli
     >node nodeQuery.js
     >```  
 
-    >```Shell (Linux or Mac)
+    >```Shell (Linux)
     >export DEBUG=*
     >node nodeQuery.js
     >```    

tutorials/hana-cloud-dl-clients-jdbc/edit-driver-class.png

@@ -30,11 +30,11 @@ The ODBC Data Source Administrator can be used to view the installed ODBC driver
 
     ![start ODBC Administrator](start-odbc.png)
 
-2. Click the **Drivers** tab and view the installed drivers.  
+2. Click the **Drivers** tab and view the installed drivers. The SAP IQ driver is visible. 
 
     ![odbc admin drivers](drivers-1.png)
 
-    The SAP IQ driver is visible.
+    
 
 3. Click the **User DSN** tab to view the data sources.  
 
@@ -97,7 +97,7 @@ For additional details see [Connection Properties](https://help.sap.com/viewer/a
 
     ```.odbc.ini
     [HC_DL]
-    driver=/home/dan/sap/dlclient/IQ-17_1/lib64/libdbodbc17.so
+    driver=/home/XXXXX/sap/dlclient/IQ-17_1/lib64/libdbodbc17.so
     encryption=TLS(trusted_certificates=*;direct=yes)
     host=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.iq.hdl.XXXX-XXXX.hanacloud.ondemand.com:443
     integrated=NO
@@ -111,15 +111,25 @@ For additional details see [Connection Properties](https://help.sap.com/viewer/a
     isql -v HC_DL USER1 Password1
     ```
 
-    DBISQL
+    **DBISQL**
+    
+    Some example queries you can run are listed below.
+
+    ```SQL
+    SELECT * FROM HOTEL.CUSTOMER;
+    ```
+
+    ```SQL
+    SELECT * FROM HOTEL.ROOM;
+    ```
 
     ![ODBC example with dbisql](ODBC-dbisql.png)
 
-    isql
+    **isql**
 
     ![isql query](isql-query.png)
 
-    > To exit dbisql or isql type quit.
+    > To exit dbisql or isql type `quit`.
 
     > ---
 
@@ -139,7 +149,6 @@ The following steps demonstrate how to use Microsoft Excel to query data in data
 1. Open Microsoft Excel.
 
 2.  In the **Data** tab, select **Get Data | From Other Sources | From ODBC**.
-
     ![Excel ODBC](ExcelODBC.png)
 
 3.  Select the previously created data source that contains the connection information to data lake Relational Engine.