WMS ID: 11641 - Hands-On: Oracle Exadata Database Service on Exascale…

… Infrastructure [HOL2952] (#56)

* added workshops folder

* added all  OCW HOL

* updated compartment

* Update discover-env-details-api.md

* Update discover-env-details-api.md

* added updates for the HOL

* added updates for the OCW HOL

* added changes for PR

* added changes

* added changes after lint check

* added changes

* added changes for OCW

* added final changes

* added the changes to just make "Estimated Time" for labs 1-5

* added date change and updates for Estimated Time

* added changes for Lab 5

* added changes to last updated date

* updated last updated date for lab 3

* added changes for lab1 task 4

* added changes to lab5 task 1

* added changes

* added changes for Lab 5

* added changes for get started

* added changes

* added updates to change ocw23 folder to ocw23-tenancy

* added changes to introduction

* added changes for lab1

* added changes to lab 5

* added changes to lab 5

* added updates for Lab 5

* added the updated index.html

* added updated index.html

* added changes for the updated help email for exadata

* added updates for help email [email protected]

* added changes to clean folder structure

* create exacc masterclass workshop

* delete workshop

* added exacc masterclass workshop

* added Lab 5-7 to the exadbcc masterclass workshop

* added Labs 1-4 to the workshop

* added lab 5 to exadbcc masterclass workshop

* added lab 11 to OCW ExaDBCC Masterclass

* added updates for the workshop index.html

* added changes to lab 2 of OCW ExaDBCC Masterclass

* added updates for Lab3

* added updated screenshots for lab 3

* added updates

* added changes

* added changes to masterclass

* added changes for ExaDB-C@C Masterclass

* added changes to HOL and Masterclass

* added updates and changes for ExaDBCC Masterclass for the approved flows related to current Infrastructure build

* added updates for lab 10 based on the OCW ExaDBCC Masterclass Infrastructure build

* added updates for lab 10 based on Current OCW ExaDBCC Masterclass Infrastructure build

* added updates for Lab2 of ExaDBCC Masterclass

* added updates for lab 6

* added changes to masterclass

* added changes to masterclass lab 8 and HOL lab 5

* added changes to masterclass

* added changes to masterclass

* added changes to HOL

* added changes to masterclass

* added changes to HOL lab 6

* added changes to masterclass

* added new screenshots for Lab1 for Masterclass and HOL

* added changes to the HOL

* added learn more links for Masterclass

* Update manifest.json

* Adding Lab 4 & Lab 5 for HOL

Adding Lab 4 & Lab 5 for HOL

exadata-database-service-on-cc-masterclass/workshops/ocw23-tenancy/manifest.json

@@ -1,5 +1,5 @@
 {
-    "workshoptitle": "Deliver Exadata Database Performance and Scale with Oracle Cloud Master Class",
+    "workshoptitle": "Exadata Database Service on Cloud@Customer Masterclass",
 
     "help": "[email protected]",
 

exadata-database-service-xs/configure-notifications-for-exascale-ecpu/configure-notifications-for-exascale-ecpu.md

@@ -1,82 +1,117 @@
 
 
 
-# Configure Notifications for Enabled OCPU or License Type change
+# Configure & Validate Notifications for Monitoring ECPU Scaling changes
 
 
 ## Introduction
 
-This lab walks you through the steps to configure notifications to get notified for VM Cluster Event Types such as Enabled OCPU or License Type change.
+The OCI Notifications service communicates when something happens with your resources in Oracle Cloud Infrastructure.
+
+**How Notifications Work?**
+
+The Notifications service lets you to set up communication channels for publishing messages using topics  and subscriptions. When a message is published to a topic, the Notifications service sends the message to all of the topic's subscriptions.
+
+![Introduction Notifications](./images/notifications-events-intro.png "Introduction Notifications")
+
+**Notifications Concepts**
+
+The following concepts are essential to working with OCI Notifications Service:
+
+***Notification*** - A configuration for sending messages, such as an alarm or event rule. Each message is sent to subscriptions in the specified topic.
+
+***Subscription*** - An endpoint for a topic. Published messages are sent to each subscription for a topic. 
+
+   You can get human-readable messages through supported subscription protocols:
+
+   * **Email**
+   * **Function**
+   * **HTTPS (Custom URL)**
+   * **PagerDuty**
+   * **Slack**
+   * **SMS**
+
+***Topic*** - A communication channel for sending messages to subscriptions. Each topic name is unique across the tenancy.  
+
+***Event Rules*** - When triggered, an event rule sends an event message to the configured topic. Notifications then deliver the message to active subscriptions.
+
+***Database Service Events***  - Database Service Events enables you to be notified about health issues with your Oracle Databases or other components on the Database Cloud Service. 
+
+**Create Events Rule to Create Notification Automation for Database Service Events**
+
+The Database Service Events feature implementation generates events for Data Plane operations and conditions and Notifications by leveraging the existing OCI Events service and Notification service. Users can subscribe to the Database Service Events and receive notifications. To receive notifications, subscribe to the Database Service Events and get notified using the Oracle Notification service.
+
+This lab walks you through the steps to configure & validate notifications for monitoring ECPU Scaling changes.
 
 Estimated Lab Time: 15 minutes
 
-<!-- Watch the video below for a quick walk-through of the lab.
-[Create an Exadata Database Service on Cloud@Customer Infrastructure](youtube:DCrivNA5bs8)
--->
+Watch the video below for a quick walk-through of the lab.
+[Configure & Validate Notifications for Monitoring ECPU Scaling changes](youtube:"placeholder")
+
 ### Objectives
 
--   After completing this lab, you should be able to configure notifications and events rules for Exadata Database Service on Cloud@Customer
+-   After completing this lab, you should be able to configure notifications and events rules for monitoring ECPU Scaling changes for Exadata Database Service on Exascale Infrastructure
 
 ### Prerequisites
 
 This lab requires completion of the following:
 
 * Completion of **Lab1**
 
-## Task 1: Configure Notification Topic and Subscription for Enabled OCPU or License Type change
+## Task 1: Configure Notification Topic and Subscription for Enabled ECPU change
 
 1. Open the navigation menu and click **Developer Services**. Under **Application Integration**, click **Notifications**.
 
    ![Navigate to Notifications](./images/navigate-notifications.png " ")
 
-2. **Topics** page is selected by default, select your ***Assigned Compartment*** and Click **Create Topic**.
+2. The **Topics** page is selected by default, select your ***Assigned Compartment*** and Click **Create Topic**.
 
    ![Click Create Topic](./images/create-topic.png " ")
 
-3. Provide the Topic name. For this lab, use ***MyExaDBCCTopic*** for the Topic name. 
+3. Provide the Topic name. For this lab, use ***MyExaDBXSTopic*** for the Topic name. 
 
    ![Provide Topic display name and Create Topic](./images/create-topic-name.png " ")
 
 4. Click **Create**.
 
    ![Click Create Topic](./images/click-create-topic.png " ")
 
-   Once Topic has been created you will see the created Topic with the state of ***Active***
+   Once the Topic has been created, you will see the created Topic with the state of ***Active***.
 
    ![Display Topic Status](./images/create-topic-active.png " ")
 
-5. Click the name of the Topic you created to open the **Topic Details** page 
+5. Click the name of the Topic you created to open the **Topic Details** page. 
 
    ![Click on Created Topic](./images/click-on-created-topic.png " ")
 
 6. On the Topic Details page, click **Create Subscription**.
 
    ![Click Create Subscription](./images/create-subscriptions.png " ")
 
-7. In the Create Subscription panel, for **Protocol**, select ***Email***. Provide your ***assigned Email Address*** then Click **Create**
+7. In the Create Subscription panel, for **Protocol**, select ***Email***. Provide your ***assigned Email Address***, then Click **Create**
 
    ![Create Subscription](./images/click-create-subscription.png " ")
 
     >**Note:** Notifications creates the email subscription and sends a confirmation URL to your assigned email address. 
    
-   The subscription is ***pending*** until confirmation is received
+   The subscription is ***pending*** until confirmation is received.
 
    ![Subscription Pending Status](./images/subscription-pending-status.png " ")
 
-8. Open your assigned Email, Check for the ***OCI Notifications Service Subscription Confirmation*** email and Click on the ***Confirm subscription*** link
+8. Open your assigned Email, Check for the ***OCI Notifications Service Subscription Confirmation*** email, and Click the ***Confirm subscription*** link.
 
    ![Confirm Subscription](./images/confirm-subscription.png " ")
 
-   By clicking the confirmation link, it will launch a browser displaying subscription has been confirmed and that you have subscribed your assigned Email to the Topic you have selected. 
+   By clicking the confirmation link, it will launch a browser displaying that the subscription has been confirmed and that you have subscribed your assigned Email to the Topic you selected. 
 
    ![Subscription Confirmation Display](./images/subscription-confirmation-page.png " ")
 
-   You can now see the subscription is now ***Active*** 
+   You can now see that the subscription is ***Active***. 
 
     ![Subscription Active](./images/subscription-active.png " ")
 
 
-## Task 2: Create Events Rule to create notification automation based on Enabled OCPU or License Type change 
+## Task 2: Create Events Rule to Create Notification Automation for Enabled ECPU Change
 
 1. Open the navigation menu and click **Observability & Management**. Under **Events Service**, click **Rules**.
 
@@ -86,42 +121,124 @@ This lab requires completion of the following:
 
     ![Click Create Rule](./images/click-create-rule.png " ")
 
-3. In the Create Rule panel, provide the Rule name. For this lab, use ***MyExaDBCCEventsRule***.
+3. In the Create Rule panel, provide the Rule name. For this lab, use ***MyExaDBXSEventsRule***.
 
     ![Create Events Rule](./images/create-events-rule.png " ")
 
 4. Configure **Rule Conditions**:
 
       * In the **Rule Conditions** section, For Condition, Select ***Event Type***. 
       * For **Service Name**, select ***Database*** 
-      * For **Event Type**, Select ***VM Cluster - Update Begin*** and ***VM Cluster - Update End***
+      * For **Event Type**, Select ***Exadb VM Cluster - Update Begin*** and ***Exadb VM Cluster - Update End***
 
     ![Configure Rule Conditions](./images/configure-rule-conditions.png " ")
 
 5. Configure **Actions**:
 
       * In the **Actions** section, For **Action Type**, Select ***Notifications***. 
       * For **Notifications Compartment**, select your ***Assigned Compartment*** 
-      * For **Topic**, Select ***MyExaDBCCTopic*** 
+      * For **Topic**, Select ***MyExaDBXSTopic*** 
+
 
     ![Configure Actions](./images/configure-actions.png " ")
 
 6. Click **Create Rule**
 
     ![Create Rule](./images/create-rule.png " ")
 
+## Task 3: Validate the Current VM Cluster Resource Allocation and Scale up the Enabled ECPUs  using the Console 
+
+1. Open the navigation menu. Under **Oracle Database**, click **Exadata Database Service on Exascale Infrastructure**.
+
+2. Select your ***Assigned Compartment***, and Click your assigned **VM Cluster** named ***MyDemoVMClusterXX***.
+
+   ![Navigate to the VM Cluster ](./images/navigate-vmcluster.png "Navigate to the VM Cluster")
+
+    The VM Cluster Details page displays information about the selected VM cluster. Under the **Resource allocation**, pay attention to the number of ***Enabled ECPUs:*** 
+
+   ![Navigate to the Resource allocation](./images/resource-allocation.png "Navigate to the Resource allocation")
+
+3. In the VM Cluster Details page, Click **Scale VM Cluster**. 
+
+   ![Scale VM Cluster](./images/scale-vmcluster.png "Scale VM Cluster")
+
+   ![View Enabled ECPU](./images/current-ecpu.png "View Enabled ECPU")
+
+   Scale Up the number of ***ECPUs enabled per VM*** from ***8 ECPU*** to ***12 ECPU***
+
+   ![Scale Up ECPU](./images/scale-ecpu.png "Scale Up ECPU")
+
+      
+4. Click **Save Changes**
+
+   >**Note:** ECPU scaling activities are done online with no downtime. Once the scale up operation is complete, the VM Cluster status changes from ***Updating*** to ***Available***.
+
+## Task 4: List VM Cluster Configuration using CLI 
+
+To use OCI CLI for this lab, we will be using the ***OCI Cloud Shell tool***. 
+
+1. In the VM Cluster Details page, Copy the VM Cluster OCID by clicking on the ***copy*** button in the ***OCID*** field under the **General Information** section. 
+
+   ![copy vmcluster ocid](./images/copy-vmcluster-ocid.png "copy vmcluster ocid")
+
+   Paste the VM Cluster OCID to a text editor.
+
+2. Click the **Developer tools** icon in the console header and select ***Cloud Shell*** from the drop-down menu. 
+
+   ![navigate to oci cloudshell](./images/oci-cloud-shell.png "navigate to oci cloudshell")
+
+   This displays the Cloud Shell in a "drawer" at the bottom of the console:
+
+   ![oci cloudshell launch](./images/cloudshelllaunch.png "oci cloudshell launch")
+
+3. Run the OCI CLI Command to get the VM Cluster Configuration.
+
+      >**Note:** Replace ***{VMClusterId}*** with VM Cluster OCID copied from *(Task 4 Step 1)*
 
+    ```
+    <copy>
 
-You may now **proceed to the next lab**
+      oci db exadb-vm-cluster get --exadb-vm-cluster-id {VMClusterID} --query 'data.{DisplayName:"display-name", EnabledECPU:"enabled-e-cpu-count",LifecycleState:"lifecycle-state"}'
+
+    </copy>
+    ```
+
+   After running the command, you will see similar output below.
+
+   ![show new enabled ecpus](./images/show-new-enabled-ecpu-ocicli.png "show new enabled ecpus")
+
+   You can see the new ***Enabled ECPU*** for the VM Cluster and with the ***Lifecycle State*** of ***Available***. 
+
+## Task 5: Confirm Notifications output in the notification email that was configured
+
+1. Open your assigned email. You should be receiving two notification emails. 
+   
+   Review the details of the following notification email events:
+   
+      * Start of the ECPU scale up operation - ***(updateexadbvmcluster.begin)*** 
+   
+      ![Image showing sample notification email for update vm cluster begin](./images/begin-notification.png "Image showing sample notification email for update vm cluster begin")
+
+      * End of the ECPU scale up operation ***(updateexadbvmcluster.end)*** 
+  
+      ![Image showing sample notification email for update vm cluster begin](./images/end-notification.png "Image showing sample notification email for update vm cluster begin")
+
+   The Notification email for the Update VM Cluster Events shows the before and After VM Cluster ECPU Allocation. 
+   
+   Pay attention to the following fields from the notification email message: 
+      * ***CPU Core Count*** 
+      * ***Reserved CPU Core Count***
+      * ***Enabled ECPU Core Count*** 
+      * ***Reserved ECPU Core Count***
 
 ## Learn More
 
-* Click [here](https://docs.oracle.com/en/engineered-systems/exadata-cloud-at-customer/ecccm/ecc-customer-events.html#GUID-1BDBB213-B153-48F9-BE06-D85CAD6386B8) to learn more about Exadata Database Service on Cloud@Customer Events.
+* Click [here](https://docs.oracle.com/en-us/iaas/exadb-xs/doc/exadata-cloud-infrastructure-events.html) to learn more about Oracle Exadata Database Service on Exascale Infrastructure Events.
 
 ## Acknowledgements
 
 * **Author** - Leo Alvarado, Eddie Ambler, Product Management
 
 * **Contributors** - Tammy Bednar, Product Management
 
-* **Last Updated By** - Leo Alvarado, Product Management, September 2023.
+* **Last Updated By** - Leo Alvarado, Product Management, August 2024.