diff --git a/java-management-oac-integration/build-custom-inventory-dashboard/build-custom-inventory-dashboard.md b/java-management-oac-integration/build-custom-inventory-dashboard/build-custom-inventory-dashboard.md new file mode 100644 index 000000000..fefb82415 --- /dev/null +++ b/java-management-oac-integration/build-custom-inventory-dashboard/build-custom-inventory-dashboard.md @@ -0,0 +1,54 @@ +# Lab 6: Build a Custom Inventory Dashboard + +## Introduction + +In this lab, you will open the imported JMS inventory workbook in Oracle Analytics Cloud (OAC) and learn how to customize the dashboard to better visualize and analyze your Java inventory data. + +*Estimated Time:* 10 minutes + +### Objectives + +* View the imported inventory workbook and understand its components. +* Customize the dashboard by modifying visuals, filters, or layout to meet your analysis needs. + +### Prerequisites + +* JMS inventory template imported into your OAC environment. +* Access to your OAC instance with permissions to view and edit dashboards. +* Connection to your Autonomous Database has been established. + +## Task 1: View the Imported Inventory Workbook + +1. Log in to your Oracle Analytics Cloud (OAC) environment. +2. From the home page, click **Catalog** in the navigation menu. + ![OAC Catalog](../common/images/analytics-cloud-config-catalog.png) +3. Find and open the JMS Inventory workbook you previously imported and click on it. + ![Open Inventory Workbook](../common/images/catalog-jms-data-viewer.png) +4. Explore the dashboard tabs, visualizations, and filters provided in the default template. + ![Sample Default Dashboard](./images/catalog-jms-data-dashboard.png) + +## Task 2: Customize the Inventory Dashboard + +1. With the inventory workbook open, click **Edit** to enter dashboard editing mode. + ![Edit Workbook](./images/catalog-jms-data-viewer-edit.png) +2. Modify or add new visualizations (charts, tables, maps) to highlight metrics important to your use case. +3. Change filters, dashboard layout, colors, or visual properties to match your organization’s style or focus. +4. Save your changes as a new version or overwrite the existing workbook as needed. + ![Save Customized Dashboard](./images/catalog-jms-data-viewer-save.png) + +## Next Steps + +* Continue refining your dashboards and analytics based on feedback from stakeholders. +* Explore OAC’s advanced features, such as calculations, data flows, or automated insights. +* Proceed to the next lab for publishing and scheduling dashboards if available. + +Congratulations, you completed the lab! You may now [proceed to the next lab](#next). + +## Learn More + +* [Build Reports and Dashboards](https://docs.oracle.com/en/cloud/paas/analytics-cloud/build-reports-and-dashboards.html) + +## Acknowledgements + +* **Author** - Maria Antonia Merino, Java Management Service +* **Last Updated By/Date** - Maria Antonia Merino, January 2026 diff --git a/java-management-oac-integration/build-custom-inventory-dashboard/images/catalog-jms-data-dashboard.png b/java-management-oac-integration/build-custom-inventory-dashboard/images/catalog-jms-data-dashboard.png new file mode 100644 index 000000000..a1700d542 Binary files /dev/null and b/java-management-oac-integration/build-custom-inventory-dashboard/images/catalog-jms-data-dashboard.png differ diff --git a/java-management-oac-integration/build-custom-inventory-dashboard/images/catalog-jms-data-viewer-edit.png b/java-management-oac-integration/build-custom-inventory-dashboard/images/catalog-jms-data-viewer-edit.png new file mode 100644 index 000000000..b4dc3e02b Binary files /dev/null and b/java-management-oac-integration/build-custom-inventory-dashboard/images/catalog-jms-data-viewer-edit.png differ diff --git a/java-management-oac-integration/build-custom-inventory-dashboard/images/catalog-jms-data-viewer-save.png b/java-management-oac-integration/build-custom-inventory-dashboard/images/catalog-jms-data-viewer-save.png new file mode 100644 index 000000000..9bbcc6e53 Binary files /dev/null and b/java-management-oac-integration/build-custom-inventory-dashboard/images/catalog-jms-data-viewer-save.png differ diff --git a/java-management-oac-integration/common/files/jms_data_viewer.dva b/java-management-oac-integration/common/files/jms_data_viewer.dva new file mode 100644 index 000000000..21cf12029 Binary files /dev/null and b/java-management-oac-integration/common/files/jms_data_viewer.dva differ diff --git a/java-management-oac-integration/common/images/analytics-cloud-config-catalog.png b/java-management-oac-integration/common/images/analytics-cloud-config-catalog.png new file mode 100644 index 000000000..5e7f1dd5b Binary files /dev/null and b/java-management-oac-integration/common/images/analytics-cloud-config-catalog.png differ diff --git a/java-management-oac-integration/common/images/analytics-cloud-config-data-connection.png b/java-management-oac-integration/common/images/analytics-cloud-config-data-connection.png new file mode 100644 index 000000000..d20db47f5 Binary files /dev/null and b/java-management-oac-integration/common/images/analytics-cloud-config-data-connection.png differ diff --git a/java-management-oac-integration/common/images/analytics-instance-details.png b/java-management-oac-integration/common/images/analytics-instance-details.png new file mode 100644 index 000000000..4bc5f2ff3 Binary files /dev/null and b/java-management-oac-integration/common/images/analytics-instance-details.png differ diff --git a/java-management-oac-integration/common/images/analytics-instances-list.png b/java-management-oac-integration/common/images/analytics-instances-list.png new file mode 100644 index 000000000..ce0f5fbdb Binary files /dev/null and b/java-management-oac-integration/common/images/analytics-instances-list.png differ diff --git a/java-management-oac-integration/common/images/catalog-jms-data-viewer.png b/java-management-oac-integration/common/images/catalog-jms-data-viewer.png new file mode 100644 index 000000000..afcfe98f2 Binary files /dev/null and b/java-management-oac-integration/common/images/catalog-jms-data-viewer.png differ diff --git a/java-management-oac-integration/common/images/configure-analytics-cloud.png b/java-management-oac-integration/common/images/configure-analytics-cloud.png new file mode 100644 index 000000000..78397ad7d Binary files /dev/null and b/java-management-oac-integration/common/images/configure-analytics-cloud.png differ diff --git a/java-management-oac-integration/common/images/configure-autonomous-ai-database.png b/java-management-oac-integration/common/images/configure-autonomous-ai-database.png new file mode 100644 index 000000000..4c988b507 Binary files /dev/null and b/java-management-oac-integration/common/images/configure-autonomous-ai-database.png differ diff --git a/java-management-oac-integration/common/images/configure-fleets.png b/java-management-oac-integration/common/images/configure-fleets.png new file mode 100644 index 000000000..a4f88e928 Binary files /dev/null and b/java-management-oac-integration/common/images/configure-fleets.png differ diff --git a/java-management-oac-integration/common/images/configure-policies.png b/java-management-oac-integration/common/images/configure-policies.png new file mode 100644 index 000000000..b44bb751a Binary files /dev/null and b/java-management-oac-integration/common/images/configure-policies.png differ diff --git a/java-management-oac-integration/common/images/create-policy-step1.png b/java-management-oac-integration/common/images/create-policy-step1.png new file mode 100644 index 000000000..462e1a89f Binary files /dev/null and b/java-management-oac-integration/common/images/create-policy-step1.png differ diff --git a/java-management-oac-integration/common/images/create-policy-step2.png b/java-management-oac-integration/common/images/create-policy-step2.png new file mode 100644 index 000000000..a33548893 Binary files /dev/null and b/java-management-oac-integration/common/images/create-policy-step2.png differ diff --git a/java-management-oac-integration/common/images/create-policy-step3.png b/java-management-oac-integration/common/images/create-policy-step3.png new file mode 100644 index 000000000..891b82c8f Binary files /dev/null and b/java-management-oac-integration/common/images/create-policy-step3.png differ diff --git a/java-management-oac-integration/common/images/select-compartment.png b/java-management-oac-integration/common/images/select-compartment.png new file mode 100644 index 000000000..bc7458ef1 Binary files /dev/null and b/java-management-oac-integration/common/images/select-compartment.png differ diff --git a/java-management-oac-integration/common/images/select-fleet.png b/java-management-oac-integration/common/images/select-fleet.png new file mode 100644 index 000000000..58f9d98d3 Binary files /dev/null and b/java-management-oac-integration/common/images/select-fleet.png differ diff --git a/java-management-oac-integration/common/images/user-access.png b/java-management-oac-integration/common/images/user-access.png new file mode 100644 index 000000000..15a85ce87 Binary files /dev/null and b/java-management-oac-integration/common/images/user-access.png differ diff --git a/java-management-oac-integration/connect-oac-to-atp/connect-oac-to-atp.md b/java-management-oac-integration/connect-oac-to-atp/connect-oac-to-atp.md new file mode 100644 index 000000000..c67102fd5 --- /dev/null +++ b/java-management-oac-integration/connect-oac-to-atp/connect-oac-to-atp.md @@ -0,0 +1,86 @@ +# Lab 7: Connect Oracle Analytics Cloud (OAC) to Autonomous AI Database + +## Introduction + +In this lab, you will configure Oracle Analytics Cloud (OAC) to connect to your Autonomous AI Database. This connection enables real-time analytics, dashboards, and reporting using data from your Autonomous AI Database instance. + +*Estimated Time:* 10 minutes + +### Objectives + +* Configure OAC to securely connect to your Autonomous AI Database. +* Test the database connection from OAC. + +### Prerequisites + +* Autonomous AI Database instance available with appropriate privileges and credentials. +* Oracle Analytics Cloud (OAC) instance, set up in the prior labs. +* OAC user account with data modeling or connection privileges. + +## Task 1: Prepare Autonomous AI Database Connection Credentials + +1. In the Oracle Cloud Console, open the navigation menu, click **Oracle AI Database**, then select **Autonomous AI Database** . + ![Configure Autonomous AI Database](../common/images/configure-autonomous-ai-database.png) +2. In the database list, locate your Autonomous AI Database and click the name to view its details. + ![Database List](./images/database-list.png) +3. Click **Database Connection** + ![DB Connection](./images/database-connection.png) +4. Click **Download Wallet** to start the download for the client credentials zip file. + ![DB Connection Wallet Download](./images/database-connection-download-wallet.png) +5. When prompted, create and enter a strong password in **Password** and **Confirm password** fields. + *(You will use this password to access the wallet when configuring the OAC connection.)* +6. Click **Download** to save the wallet (.zip) file to your computer. + ![Final Wallet Download](./images/database-connection-download-wallet-details.png) + +*Keep your downloaded wallet and password safe. You will use these in the next steps to connect OAC to your Autonomous AI Database.* + +## Task 2: Create a Database Connection in OAC + +1. On the OAC home page, click page menu in the upper left side. +2. Select **Data**. + ![Import template menu](../common/images/analytics-cloud-config-data-connection.png) +3. Over the imported connection, on the right side, click actions menu and click **Inspect** to view details. + ![Select Autonomous AI Database Connection](./images/analytics-cloud-data-connection-inspect.png) +4. Complete the connection form: + * **Connection Name**: Enter a name (e.g., `JMS_AAID_EXPORT`). + * **Description**: (Optional) Add a brief description. + * **Username**: Enter your database user (e.g., `JMS_EXPORT` or schema user). + * **Password**: Enter your database user’s password. + * **Client Credentials**: Upload the wallet (.zip) you downloaded earlier. + * **Wallet Password**: Enter the password you set when downloading the wallet. + * **Service Name**: Select the appropriate TNS alias for your workload (`HIGH`, `LOW`, or `TP`). + ![Connection details form](images/analytics-cloud-data-connection.png) +5. Click **Save** to create the connection. + + +## Task 3: Verify connection to AI Database reloading data + +1. Go to Datasets. +2. Over the imported dataset, on the right side, click actions menu and click **Inspect** to view details. + ![Dataset inspection](images/analytics-cloud-dataset-inspect.png) +3. On the left panel click **Reload Data**. +4. Click the button **Run Now**. + ![Dataset reload data](images/analytics-cloud-dataset-reload-data.png) +5. The Dataset is queued for reloading and will complete in the background. Click **Close**. + ![Dataset close reload_data](images/analytics-cloud-dataset-reload-data-close.png) +6. On the left panel click **History**. The Status could be **In Queue** or **Running**. + ![Dataset close reload_data](images/analytics-cloud-dataset-reload-data-inqueue.png) +7. Wait until the execution ends and the status is **Completed**. + ![Dataset close reload_data](images/analytics-cloud-dataset-reload-data-completed.png) + +## Next Steps + +* Use the established connection to create interactive workbooks and dashboards. +* Explore available Autonomous AI Database tables and columns to design your analytics. +* Proceed to the next lab to further refine and customize your analytics environment. + +Congratulations, you completed the lab! You may now [proceed to the next lab](#next). + +## Learn More + +* [Connect to Oracle Autonomous AI Transaction Processing](https://docs.oracle.com/en/cloud/paas/analytics-cloud/acsds/connect-oracle-autonomous-transaction-processing.html) + +## Acknowledgements + +* **Author** - Maria Antonia Merino, Java Management Service +* **Last Updated By/Date** - Maria Antonia Merino, January 2026 diff --git a/java-management-oac-integration/connect-oac-to-atp/images/analytics-cloud-data-connection-inspect.png b/java-management-oac-integration/connect-oac-to-atp/images/analytics-cloud-data-connection-inspect.png new file mode 100644 index 000000000..68ad9b440 Binary files /dev/null and b/java-management-oac-integration/connect-oac-to-atp/images/analytics-cloud-data-connection-inspect.png differ diff --git a/java-management-oac-integration/connect-oac-to-atp/images/analytics-cloud-data-connection.png b/java-management-oac-integration/connect-oac-to-atp/images/analytics-cloud-data-connection.png new file mode 100644 index 000000000..419e8a8a4 Binary files /dev/null and b/java-management-oac-integration/connect-oac-to-atp/images/analytics-cloud-data-connection.png differ diff --git a/java-management-oac-integration/connect-oac-to-atp/images/analytics-cloud-dataset-inspect.png b/java-management-oac-integration/connect-oac-to-atp/images/analytics-cloud-dataset-inspect.png new file mode 100644 index 000000000..a58178524 Binary files /dev/null and b/java-management-oac-integration/connect-oac-to-atp/images/analytics-cloud-dataset-inspect.png differ diff --git a/java-management-oac-integration/connect-oac-to-atp/images/analytics-cloud-dataset-reload-data-close.png b/java-management-oac-integration/connect-oac-to-atp/images/analytics-cloud-dataset-reload-data-close.png new file mode 100644 index 000000000..1a653a566 Binary files /dev/null and b/java-management-oac-integration/connect-oac-to-atp/images/analytics-cloud-dataset-reload-data-close.png differ diff --git a/java-management-oac-integration/connect-oac-to-atp/images/analytics-cloud-dataset-reload-data-complete.png b/java-management-oac-integration/connect-oac-to-atp/images/analytics-cloud-dataset-reload-data-complete.png new file mode 100644 index 000000000..8bb6b47ff Binary files /dev/null and b/java-management-oac-integration/connect-oac-to-atp/images/analytics-cloud-dataset-reload-data-complete.png differ diff --git a/java-management-oac-integration/connect-oac-to-atp/images/analytics-cloud-dataset-reload-data-inqueue.png b/java-management-oac-integration/connect-oac-to-atp/images/analytics-cloud-dataset-reload-data-inqueue.png new file mode 100644 index 000000000..f6772a1f7 Binary files /dev/null and b/java-management-oac-integration/connect-oac-to-atp/images/analytics-cloud-dataset-reload-data-inqueue.png differ diff --git a/java-management-oac-integration/connect-oac-to-atp/images/analytics-cloud-dataset-reload-data.png b/java-management-oac-integration/connect-oac-to-atp/images/analytics-cloud-dataset-reload-data.png new file mode 100644 index 000000000..f93e496c9 Binary files /dev/null and b/java-management-oac-integration/connect-oac-to-atp/images/analytics-cloud-dataset-reload-data.png differ diff --git a/java-management-oac-integration/connect-oac-to-atp/images/database-connection-download-wallet-details.png b/java-management-oac-integration/connect-oac-to-atp/images/database-connection-download-wallet-details.png new file mode 100644 index 000000000..450ccf620 Binary files /dev/null and b/java-management-oac-integration/connect-oac-to-atp/images/database-connection-download-wallet-details.png differ diff --git a/java-management-oac-integration/connect-oac-to-atp/images/database-connection-download-wallet.png b/java-management-oac-integration/connect-oac-to-atp/images/database-connection-download-wallet.png new file mode 100644 index 000000000..3732780be Binary files /dev/null and b/java-management-oac-integration/connect-oac-to-atp/images/database-connection-download-wallet.png differ diff --git a/java-management-oac-integration/connect-oac-to-atp/images/database-connection.png b/java-management-oac-integration/connect-oac-to-atp/images/database-connection.png new file mode 100644 index 000000000..1b3135cf3 Binary files /dev/null and b/java-management-oac-integration/connect-oac-to-atp/images/database-connection.png differ diff --git a/java-management-oac-integration/connect-oac-to-atp/images/database-list.png b/java-management-oac-integration/connect-oac-to-atp/images/database-list.png new file mode 100644 index 000000000..c611aae03 Binary files /dev/null and b/java-management-oac-integration/connect-oac-to-atp/images/database-list.png differ diff --git a/java-management-oac-integration/import-jms-oac-template/images/analytics-cloud-import-workbook-details-ok.png b/java-management-oac-integration/import-jms-oac-template/images/analytics-cloud-import-workbook-details-ok.png new file mode 100644 index 000000000..276887ead Binary files /dev/null and b/java-management-oac-integration/import-jms-oac-template/images/analytics-cloud-import-workbook-details-ok.png differ diff --git a/java-management-oac-integration/import-jms-oac-template/images/analytics-cloud-import-workbook-details.png b/java-management-oac-integration/import-jms-oac-template/images/analytics-cloud-import-workbook-details.png new file mode 100644 index 000000000..53ecb201c Binary files /dev/null and b/java-management-oac-integration/import-jms-oac-template/images/analytics-cloud-import-workbook-details.png differ diff --git a/java-management-oac-integration/import-jms-oac-template/images/analytics-cloud-import-workbook-select.png b/java-management-oac-integration/import-jms-oac-template/images/analytics-cloud-import-workbook-select.png new file mode 100644 index 000000000..029625540 Binary files /dev/null and b/java-management-oac-integration/import-jms-oac-template/images/analytics-cloud-import-workbook-select.png differ diff --git a/java-management-oac-integration/import-jms-oac-template/images/analytics-cloud-import-workbook.png b/java-management-oac-integration/import-jms-oac-template/images/analytics-cloud-import-workbook.png new file mode 100644 index 000000000..3669e2056 Binary files /dev/null and b/java-management-oac-integration/import-jms-oac-template/images/analytics-cloud-import-workbook.png differ diff --git a/java-management-oac-integration/import-jms-oac-template/import-jms-oac-template.md b/java-management-oac-integration/import-jms-oac-template/import-jms-oac-template.md new file mode 100644 index 000000000..1dbebf13f --- /dev/null +++ b/java-management-oac-integration/import-jms-oac-template/import-jms-oac-template.md @@ -0,0 +1,65 @@ +# Lab 4: Import JMS OAC Template + +## Introduction + +In this lab, you will connect to your Oracle Analytics Cloud (OAC) environment and import a pre-built analytics workbook template that accelerates your analysis of Java Management Service (JMS) data. + +*Estimated Time:* 5 minutes + +### Objectives + +* Import the provided JMS OAC analytics template. + +### Prerequisites + +* All previous labs completed, especially [Lab 3: Oracle Analytics Cloud Instance Setup](?lab=oac-instance-setup) (OAC instance, user, and custom role must be set up). +* Credentials for an OAC user who has the "Author" (or equivalent) application role assigned which enables importing and editing workbooks. +* Access to the JMS OAC template file (`.DVA` or `.zip`) provided. + +## Task 1: Access Your OAC Instance + +1. In the Oracle Cloud Console, open the navigation menu, click **Analytics & AI**, then under **AI Data Platform** select **Analytics Cloud**. + ![OAC Console Navigation](../common/images/configure-analytics-cloud.png) +2. On the Analytics Cloud page, select your OAC instance. + ![OAC Instance List](../common/images/analytics-instances-list.png) +3. Under **Access Information**, click the OAC instance URL to launch OAC in your browser. + ![OAC URL Access](../common/images/analytics-instance-details.png) +4. Sign in with the user created and assigned the appropriate role in [Lab 3: Oracle Analytics Cloud Instance Setup](?lab=oac-instance-setup). + ![User Account Access](../common/images/user-access.png) + +## Task 2: Download the JMS OAC Template + +You must download the JMS Data Viewer OAC template to your local computer. + +[Download JMS Data Viewer](../common/files/jms_data_viewer.dva) + +The JMS Data Viewer (.dva) file provides pre-built dashboards for visualizing Java Management Service data in Oracle Analytics Cloud. Save it in an accessible location to use in the next step. + +## Task 3: Import the JMS OAC Workbook Template + +1. On the OAC home page, locate and click the **Page Menu** (three dots or lines, usually upper-right). +2. Select **Import Workbook/Flow**. + ![OAC Import Menu](./images/analytics-cloud-import-workbook.png) +3. Click **Select File**, then locate and select the provided JMS OAC template file (`.DVA` or `.zip`). + ![OAC Import Menu](./images/analytics-cloud-import-workbook-select.png) +4. Click **Import**. + ![Select Template File](./images/analytics-cloud-import-workbook-details.png) +5. When the "Import successful" message appears, click **OK**. + ![Select Template File](./images/analytics-cloud-import-workbook-details-ok.png) + +## Next Steps + +You have now imported the JMS OAC workbook template. You can: + +* Update the data connection settings to point to your own Autonomous Database instance or schema. + +Congratulations, you completed the lab! You may now [proceed to the next lab](#next). + +## Learn More + +* [Import, Export, and Share](https://docs.oracle.com/en/cloud/paas/analytics-cloud/acubi/import-export-and-share.html) + +## Acknowledgements + +* **Author** - Maria Antonia Merino, Java Management Service +* **Last Updated By/Date** - Maria Antonia Merino, January 2026 diff --git a/java-management-oac-integration/introduction/introduction.md b/java-management-oac-integration/introduction/introduction.md new file mode 100644 index 000000000..196b5e594 --- /dev/null +++ b/java-management-oac-integration/introduction/introduction.md @@ -0,0 +1,45 @@ +# Introduction + +## About Java Management Service and Oracle Analytics + +Java Management Service (JMS) is a reporting and management infrastructure integrated with Oracle Cloud Infrastructure Platform services to observe and manage your use of Java SE (on-premise or in the Cloud). + +Oracle Analytics Cloud is a scalable and secure Oracle Cloud service that provides a full set of capabilities to explore and perform collaborative analytics for you, your workgroup, and your enterprise. + +As a customer, you can: +* Create interactive workbooks in Oracle Analytics Cloud (OAC) by integrating Java Management Service (JMS) data exports to visualize and track Java SE usage across multiple OCI regions and hybrid environments, including managed instances, Java runtimes, applications, IP addresses, and host names in a centralized view. + + +## About this Workshop + +This workshop is a follow up workshop to the [Manage Java Runtimes, Applications and Managed Instances Inventory with Java Management Service](https://livelabs.oracle.com/pls/apex/dbpm/r/livelabs/view-workshop?wid=912) workshop, which we recommend to be completed before beginning this workshop about Integrating Oracle Analytics Cloud with Java Management Service. + +This workshop guides you through connecting JMS to Oracle Analytics Cloud, exporting Java inventory and usage data, and building real-time dashboards with data from multiple regions. + +*Estimated Time*: 90 minutes + +### Objectives + +* Understand core concepts of JMS integration with OAC for Java SE monitoring and analytics. +* Export JMS inventory data to Autonomous AI Database for centralized storage. +* Provision and connect an OAC instance to Autonomous AI Database for secure data access. +* Build interactive workbooks and real-time dashboards in OAC using prebuilt templates. +* Automate periodic data refreshes to maintain up-to-date visualizations of Java usage across regions and hybrid environments. + +### Prerequisites + +* This workshop requires an Oracle Cloud account. You may use your **own cloud account** or you can get a **Free Trial** account as described in [Get Started](?lab=cloud-login). +* Have access to the cloud environment with the resources configured by following the steps in the workshop [Manage Java Runtimes, Applications and Managed Instances Inventory with Java Management Service](https://livelabs.oracle.com/pls/apex/dbpm/r/livelabs/view-workshop?wid=912). + +## Learn More + +* [Java Management Service](https://docs.oracle.com/en-us/iaas/jms/index.html) +* [Oracle Analytics Cloud](https://docs.oracle.com/en/cloud/paas/analytics-cloud/index.html) +* [Autonomous AI Database Serverless](https://docs.oracle.com/en-us/iaas/autonomous-database-serverless/index.html) +* [Oracle University](https://mylearn.oracle.com/ou/home) + + +## Acknowledgements + +* **Author** - Maria Antonia Merino, Java Management Service +* **Last Updated By/Date** - Maria Antonia Merino, January 2026 diff --git a/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/configure-jms-data-export-to-autonomous-ai-database.png b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/configure-jms-data-export-to-autonomous-ai-database.png new file mode 100644 index 000000000..af6bd8508 Binary files /dev/null and b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/configure-jms-data-export-to-autonomous-ai-database.png differ diff --git a/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-autonomous-ai-database-details1.png b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-autonomous-ai-database-details1.png new file mode 100644 index 000000000..719a2f41b Binary files /dev/null and b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-autonomous-ai-database-details1.png differ diff --git a/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-autonomous-ai-database-details2.png b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-autonomous-ai-database-details2.png new file mode 100644 index 000000000..81bb8d56a Binary files /dev/null and b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-autonomous-ai-database-details2.png differ diff --git a/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-autonomous-ai-database-details3.png b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-autonomous-ai-database-details3.png new file mode 100644 index 000000000..458abe84f Binary files /dev/null and b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-autonomous-ai-database-details3.png differ diff --git a/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-database-user-details-save.png b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-database-user-details-save.png new file mode 100644 index 000000000..fd467cd79 Binary files /dev/null and b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-database-user-details-save.png differ diff --git a/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-database-user-details.png b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-database-user-details.png new file mode 100644 index 000000000..ca16093fc Binary files /dev/null and b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-database-user-details.png differ diff --git a/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-database-user.png b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-database-user.png new file mode 100644 index 000000000..98556d2a6 Binary files /dev/null and b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-database-user.png differ diff --git a/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-policy-details-save.png b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-policy-details-save.png new file mode 100644 index 000000000..c39c14730 Binary files /dev/null and b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-policy-details-save.png differ diff --git a/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-policy-details.png b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-policy-details.png new file mode 100644 index 000000000..f6c80089f Binary files /dev/null and b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/create-policy-details.png differ diff --git a/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/database-actions-menu-sql.png b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/database-actions-menu-sql.png new file mode 100644 index 000000000..826204491 Binary files /dev/null and b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/database-actions-menu-sql.png differ diff --git a/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/database-actions-sql.png b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/database-actions-sql.png new file mode 100644 index 000000000..ad5f6b3cb Binary files /dev/null and b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/database-actions-sql.png differ diff --git a/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/database-actions-users.png b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/database-actions-users.png new file mode 100644 index 000000000..6c89a2e20 Binary files /dev/null and b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/database-actions-users.png differ diff --git a/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/database-actions-view-all.png b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/database-actions-view-all.png new file mode 100644 index 000000000..5d1ac64c3 Binary files /dev/null and b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/database-actions-view-all.png differ diff --git a/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/database-available.png b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/database-available.png new file mode 100644 index 000000000..a7732135e Binary files /dev/null and b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/database-available.png differ diff --git a/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/database-user-permissions.png b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/database-user-permissions.png new file mode 100644 index 000000000..958c43d5d Binary files /dev/null and b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/database-user-permissions.png differ diff --git a/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/development-tab-schedulling.png b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/development-tab-schedulling.png new file mode 100644 index 000000000..e1547a4c7 Binary files /dev/null and b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/development-tab-schedulling.png differ diff --git a/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/scheduled-pipelines.png b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/scheduled-pipelines.png new file mode 100644 index 000000000..46ba16375 Binary files /dev/null and b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/scheduled-pipelines.png differ diff --git a/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/select-schema.png b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/select-schema.png new file mode 100644 index 000000000..fa429d689 Binary files /dev/null and b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/select-schema.png differ diff --git a/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/user-schema-tables.png b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/user-schema-tables.png new file mode 100644 index 000000000..591f5e470 Binary files /dev/null and b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/user-schema-tables.png differ diff --git a/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/users-list.png b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/users-list.png new file mode 100644 index 000000000..151e9f894 Binary files /dev/null and b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/images/users-list.png differ diff --git a/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/jms-data-export-to-autonomous-ai-database.md b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/jms-data-export-to-autonomous-ai-database.md new file mode 100644 index 000000000..24fbacc82 --- /dev/null +++ b/java-management-oac-integration/jms-data-export-to-autonomous-ai-database/jms-data-export-to-autonomous-ai-database.md @@ -0,0 +1,154 @@ +# Lab 2: JMS Data Export Integration with Autonomous AI Database + +## Introduction + +In this lab, you will configure Java Management Service (JMS) on Oracle Cloud Infrastructure (OCI) to export inventory, Java runtime, application, and managed instance data to an Autonomous AI Database. This database is essential for integrating with Oracle Analytics Cloud (OAC) in subsequent labs. + +*Estimated Time:* 15 minutes + +### Objectives + +* Provision an Autonomous AI Database instance. +* Create a database user/schema for JMS export. +* Download Autonomous AI Database credentials and wallet. +* Configure JMS to export data to Autonomous AI Database. +* Validate and troubleshoot the export process. + +### Prerequisites + +* JMS Fleet and Managed Instance setup complete. +* Permissions to create/modify Autonomous AI Database and access OCI resources. +* Access to Oracle Cloud Console and SQL Developer/Database Actions. + +## Task 1: Provision an Autonomous AI Database + +1. In the Oracle Cloud Console, open the navigation menu, click **Oracle AI Database**, then select **Autonomous AI Database** . + ![Configure Autonomous AI Database](../common/images/configure-autonomous-ai-database.png) +2. Click **Create Autonomous AI Database**. In the form, fill out: + * **Display Name**: Enter a unique, descriptive name for your database (e.g., `jmsexporttargetdb`) + * **Database Name**: Use the same or a similarly concise name (e.g., `jmsexporttargetdb`) + * **Compartment**: Select the compartment where the database should be created + * **OCPU Count**: Choose the number of CPUs (e.g., `1 OCPU`) + * **Storage**: Specify the storage size (e.g., `1 TB`) + * **Workload Type**: Select **Transaction Processing** + ![Database creation form - Basic information](./images/create-autonomous-ai-database-details1.png) + * Continue by filling in additional configuration options displayed in the wizard. + ![Database creation form - Additional configuration](./images/create-autonomous-ai-database-details2.png) + * Review and click **Create**. + ![Database creation review and confirmation](./images/create-autonomous-ai-database-details3.png) +3. Wait until the status of your Autonomous AI Database is **Available**. + ![Database available](./images/database-available.png) + +## Task 2: Create a Database User for JMS Export + +1. Go to your Autonomous AI Database instance page. Click **Database Actions** and then select **Database Users**. + ![Launch Users from Database Actions](./images/database-actions-users.png) +2. Click on **Create User**. + ![Create User form](./images/create-database-user.png) +3. In the User tab, complete the form: + * **User Name**: enter a clear, lowercase username (e.g., `jms_export`) + * **Password**: supply a strong password + * **Confirm Password**: enter it again + * **Quota on tablespace DATA**: enter `unlimited` or your organization’s policy + * (Optional advanced) Enable: + * **Graph**: checked if you want graph features + * **OML**: for Oracle Machine Learning + * **REST, GraphQL, MongoDB API, Web access**: check as needed + ![User details example](./images/create-database-user-details.png) +4. Click **Create User**. + ![User details save](./images/create-database-user-details-save.png) +5. Confirm your user appears in the **User Management** listing. + ![User now appears in list](./images/users-list.png) + +## Task 3: Grant permissions and modify some config settings for the user previously created + +1. Go to your Autonomous AI Database instance page. Click **Database Actions** > **SQL** to access the SQL Worksheet. + ![Launch SQL worksheet from Database Actions](./images/database-actions-sql.png) +2. Connect using the **ADMIN** account. +3. Run the following SQL code to create the export user: + + ```sql + + GRANT EXECUTE ON DBMS_CLOUD_PIPELINE TO [database_user]; + GRANT READ,WRITE ON DIRECTORY DATA_PUMP_DIR TO [database_user]; + GRANT CREATE JOB TO [database_user]; + EXEC DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL(username => '[database_user]'); + + ``` + + > Replace `[database_user]` for the username previously created. + + ![Database user permissions](./images/database-user-permissions.png) + +## Task 4: Create policy for database to read CSV files from bucket + +* You can follow [Export Data to Autonomous Database](https://docs.oracle.com/en-us/iaas/jms/doc/set-and-run-load-pipelines-exported-data.html#GUID-3A872067-D563-406B-BF7A-AD716A7FEFA2) and create a dynamic group with policies (steps 3 and 4). +* If you have no permissions to create groups, you can create a policy in a root compartment for concrete autonomous database by OCID. + +1. In the Console, open the navigation menu, click **Identity & Security**. Under Identity, click **Policies**. + ![Click Policies](../common/images/configure-policies.png) +2. Click **Create policy**. In the form, fill out: + * **Name**: Type a concise, memorable policy name (e.g., `jms_export`) + * **Description**: Clearly state the policy's intent, such as: `Policy required for JMS Fleets to export data to object storage` + * **Compartment**: Pick the same compartment where your database and export bucket reside + ![Enter Policy Info](../common/images/create-policy-step1.png) +3. Click **Show Manual Editor**. + ![Show Manual Editor screen](../common/images/create-policy-step1.png) +4. Copy and paste the following policy (edit placeholders accordingly): + + ```text + + ALLOW any-user TO READ objects IN compartment [compartment_name] where request.principal.id='[ocid_autonomous_ai_database]' + + ``` + > Replace `[compartment_name]` which the compartment name where is the bucket where configure the JMS data exports and `[ocid_autonomous_ai_database]` with the ocid of the autonomous AI database previously created. + + ![Policy Details](./images/create-policy-details.png) +5. Click **Create**. + ![Policy Details](./images/create-policy-details-save.png) + +## Task 5: Configure JMS Data Export to Autonomous AI Database + +1. Go to your Autonomous AI Database instance page. Click **Database Actions** > **SQL** to access the SQL Worksheet. + ![Launch SQL worksheet from Database Actions](./images/database-actions-sql.png) +2. Connect using the **[database_user]** account, where `[database_user]` is the username of the database user previously created. +3. Open the Autonomous Database load pipeline script you downloaded in **Integrating Oracle Analytics Cloud with Java Management Service**, on the last step of [Task 4](?lab=jms-fleet-data-to-object-storage#Task4:ConfigureDataExportforyourfleet): **Configure Data Export for your fleet**. +4. Copy the script onto the SQL worksheet and execute it. + ![Configure jms data export to autonomous ai database](./images/configure-jms-data-export-to-autonomous-ai-database.png) + +## Task 6: Validate Export Configuration + +1. Go to your Autonomous AI Database instance page. Click **Database Actions** and select **View All Database Actions** to check your pipelines were created successfully. + ![Launch View All Database Actions from Database Actions](./images/database-actions-view-all.png) +2. Navigate to the **Development** tab. +3. Click on **Scheduling** + ![Launch Schedule on Development tab](./images/development-tab-schedulling.png) + * Your pipelines (named in the format PIPELINE$xxx) + ![Launch Schedule Pipelines](./images/scheduled-pipelines.png) +4. Click Selector to display the navigation menu. Under Development, select **SQL** + ![Launch SQL From Database Actions menu](./images/database-actions-menu-sql.png) +5. On Navigator tab select your schema, it was created in [Task 2](#Task2:CreateaDatabaseUserforJMSExport) (e.g, `jms_export`) + ![Select Schema on Navigator tab](./images/select-schema.png) + * It will display saved objects for the selected schema. + * Pipeline script created 3 new tables: + * JMS\_MANAGED\_INSTANCE\_JAVA_RUNTIME\_APPLICATION\_V3 + * JMS\_MANAGED\_INSTANCE\_JAVA\_RUNTIME\_V3 + * JMS\_MANAGED\_INSTANCE\_V3 + ![User Schema Tables on Navigator tab](./images/user-schema-tables.png) + * Ensure values are present in the table associate with the export option. If you selected resources **Managed instances, Java runtimes, applications** your date will be present on table JMS\_MANAGED\_INSTANCE\_JAVA\_RUNTIME\_APPLICATION\_V3. + * Check that are not issue on $BAD, $STATUS and $LOG tables that are identified by your user. + +## Learn More + +* [Export Data to Autonomous Database](https://docs.oracle.com/en-us/iaas/jms/doc/set-and-run-load-pipelines-exported-data.html) + +## Next Steps + +Set up Oracle Analytics Cloud (OAC) and connect it to the exported JMS data in Autonomous AI Database. + +Congratulations, you completed the lab! You may now [proceed to the next lab](#next). + +## Acknowledgements + +* **Author** - Maria Antonia Merino, Java Management Service +* **Last Updated By/Date** - Maria Antonia Merino, January 2026 diff --git a/java-management-oac-integration/jms-fleet-data-to-object-storage/images/bucket-list.png b/java-management-oac-integration/jms-fleet-data-to-object-storage/images/bucket-list.png new file mode 100644 index 000000000..e19df91b8 Binary files /dev/null and b/java-management-oac-integration/jms-fleet-data-to-object-storage/images/bucket-list.png differ diff --git a/java-management-oac-integration/jms-fleet-data-to-object-storage/images/buckets-create-bucket.png b/java-management-oac-integration/jms-fleet-data-to-object-storage/images/buckets-create-bucket.png new file mode 100644 index 000000000..1fbae5a67 Binary files /dev/null and b/java-management-oac-integration/jms-fleet-data-to-object-storage/images/buckets-create-bucket.png differ diff --git a/java-management-oac-integration/jms-fleet-data-to-object-storage/images/configure-buckets.png b/java-management-oac-integration/jms-fleet-data-to-object-storage/images/configure-buckets.png new file mode 100644 index 000000000..6e266c857 Binary files /dev/null and b/java-management-oac-integration/jms-fleet-data-to-object-storage/images/configure-buckets.png differ diff --git a/java-management-oac-integration/jms-fleet-data-to-object-storage/images/configure-export-details-save.png b/java-management-oac-integration/jms-fleet-data-to-object-storage/images/configure-export-details-save.png new file mode 100644 index 000000000..a9c6b2a4e Binary files /dev/null and b/java-management-oac-integration/jms-fleet-data-to-object-storage/images/configure-export-details-save.png differ diff --git a/java-management-oac-integration/jms-fleet-data-to-object-storage/images/configure-export-details.png b/java-management-oac-integration/jms-fleet-data-to-object-storage/images/configure-export-details.png new file mode 100644 index 000000000..b82303d4f Binary files /dev/null and b/java-management-oac-integration/jms-fleet-data-to-object-storage/images/configure-export-details.png differ diff --git a/java-management-oac-integration/jms-fleet-data-to-object-storage/images/configure-export.png b/java-management-oac-integration/jms-fleet-data-to-object-storage/images/configure-export.png new file mode 100644 index 000000000..1bc58cf3d Binary files /dev/null and b/java-management-oac-integration/jms-fleet-data-to-object-storage/images/configure-export.png differ diff --git a/java-management-oac-integration/jms-fleet-data-to-object-storage/images/create-bucket-save.png b/java-management-oac-integration/jms-fleet-data-to-object-storage/images/create-bucket-save.png new file mode 100644 index 000000000..96918c260 Binary files /dev/null and b/java-management-oac-integration/jms-fleet-data-to-object-storage/images/create-bucket-save.png differ diff --git a/java-management-oac-integration/jms-fleet-data-to-object-storage/images/create-bucket.png b/java-management-oac-integration/jms-fleet-data-to-object-storage/images/create-bucket.png new file mode 100644 index 000000000..de863abba Binary files /dev/null and b/java-management-oac-integration/jms-fleet-data-to-object-storage/images/create-bucket.png differ diff --git a/java-management-oac-integration/jms-fleet-data-to-object-storage/images/download-script.png b/java-management-oac-integration/jms-fleet-data-to-object-storage/images/download-script.png new file mode 100644 index 000000000..e7887b55f Binary files /dev/null and b/java-management-oac-integration/jms-fleet-data-to-object-storage/images/download-script.png differ diff --git a/java-management-oac-integration/jms-fleet-data-to-object-storage/jms-fleet-data-to-object-storage.md b/java-management-oac-integration/jms-fleet-data-to-object-storage/jms-fleet-data-to-object-storage.md new file mode 100644 index 000000000..53d396cec --- /dev/null +++ b/java-management-oac-integration/jms-fleet-data-to-object-storage/jms-fleet-data-to-object-storage.md @@ -0,0 +1,104 @@ +# Export JMS Fleet Data to Object Storage + +## Introduction + +This comprehensive lab guides you through: + +* Create an Object Storage bucket. +* Configure data export from JMS Fleet to Object Storage. + +Export JMS fleet data to Object Storage allows for easy analysis and collaboration, especially with administrators who do not have direct access to OCI or JMS. This feature streamlines data sharing and enables convenient loading of exported data into an Autonomous Database for further processing. + +*Estimated Time:* 15 minutes + +### Objectives + +* Create and verify an Object Storage bucket for exports. +* Configure Fleet export policies and export settings. +* Validate the setup with troubleshooting steps. + +### Prerequisites + +* OCI account with required permissions. +* Access to necessary compartments for JMS, Object Storage, and policy management. +* (Optional) Management Agent deployed on instance. + +## Task 1: Create a Bucket + +1. In the Oracle Cloud Console, open the navigation menu, click **Storage**, then select **Buckets** under **Object Storage & Archive Storage**. + ![Buckets section in OCI Console](./images/configure-buckets.png) +2. Choose the compartment where you wish to store JMS export data (e.g., `Fleet_Compartment`). + ![Compartment selection in OCI](./images/buckets-create-bucket.png) +3. Click the **Create bucket** button. +4. In the form, enter a **Bucket name** following your team's naming policy (e.g., jms-export) + ![Bucket creation form in OCI Console](./images/create-bucket.png) +5. Click **Create bucket** to confirm creation. + ![Create bucket confirmation in OCI Console](./images/create-bucket-save.png) + +## Task 2: Verify Bucket Creation + +1. Ensure your new bucket appears in the bucket listing for the selected compartment. + ![List of buckets in OCI Console](./images/bucket-list.png) + +## Task 3: Set up Policies for Fleet Data Export + +1. In the Console, open the navigation menu, click **Identity & Security**. Under Identity, click **Policies**. + ![Click Policies](../common/images/configure-policies.png) +2. Click **Create policy** and complete: + * **Name:** a descriptive name for your export (e.g., export-storage-bucket). + * **Description:** a brief description of the policy (e.g., Policy required for JMS Fleets to export data to object storage). + * **Compartment:** Select your own compartment. +3. Click **Show Manual Editor**. + ![Enter Policy Info](../common/images/create-policy-step1.png) +4. Copy and paste the following policy (edit placeholders accordingly): + ![Show Manual Editor screen](../common/images/create-policy-step2.png) + + ```text + + Allow RESOURCE jms server-components TO MANAGE objects in compartment [compartment_name] where target.bucket.name = [bucket_name] + Allow RESOURCE jms server-components TO READ buckets in compartment [compartment_name] where target.bucket.name = [bucket_name] + + ``` + + > Replace `[compartment_name]` and `[bucket_name]` as appropriate. + + ![Paste Policy](../common/images/create-policy-step3.png) +5. Click **Create**. + +## Task 4: Configure Data Export for your fleet + +1. In the Console, open the navigation menu, click **Observability & Management**, and then **Fleets** under **Java Management**. + ![Open Fleets](./../common/images/configure-fleets.png) +2. Select the compartment for JMS resources. + ![Select compartment](./../common/images/select-compartment.png) +3. Select your fleet. + ![Select Fleet](./../common/images/select-fleet.png) +4. In the **Fleet properties** tab, go to **Data Export Settings**. + * If export settings are unconfigured, click the **Configure** link. + ![Configure export](./images/configure-export.png) +5. In the export settings, configure: + * **Enable Export Settings** + * **Resources:** Managed instances, Java runtimes, applications + * **Duration:** 30, 60, or 90 days + * **Target:** Select the previously created object storage bucket + * **Schedule:** Daily, Weekly, or Monthly + ![Configure export details](./images/configure-export-details.png) +6. Click **Save changes**. + ![Save changes](./images/configure-export-details-save.png) +7. Download the pipeline script from Fleet settings (if prompted) to help automate or process exported data. + ![Download Pipeline Script](./images/download-script.png) + +## Learn More + +* [Configure Data Export Settings](https://docs.oracle.com/en-us/iaas/jms/doc/configure-export-settings.html) + +## Next Steps + +* If not already done, proceed to set up an Autonomous Database for deeper integration and export options. + +Congratulations, you completed the lab! You may now [proceed to the next lab](#next). + +## Acknowledgements + +* **Author** - Maria Antonia Merino, Java Management Service +* **Last Updated By/Date** - Maria Antonia Merino, January 2026 diff --git a/java-management-oac-integration/oac-instance-setup/images/analytics-cloud-add-selected-application-roles.png b/java-management-oac-integration/oac-instance-setup/images/analytics-cloud-add-selected-application-roles.png new file mode 100644 index 000000000..4aea09f73 Binary files /dev/null and b/java-management-oac-integration/oac-instance-setup/images/analytics-cloud-add-selected-application-roles.png differ diff --git a/java-management-oac-integration/oac-instance-setup/images/analytics-cloud-add-users.png b/java-management-oac-integration/oac-instance-setup/images/analytics-cloud-add-users.png new file mode 100644 index 000000000..c2122b12f Binary files /dev/null and b/java-management-oac-integration/oac-instance-setup/images/analytics-cloud-add-users.png differ diff --git a/java-management-oac-integration/oac-instance-setup/images/analytics-cloud-console-button.png b/java-management-oac-integration/oac-instance-setup/images/analytics-cloud-console-button.png new file mode 100644 index 000000000..c55b547f9 Binary files /dev/null and b/java-management-oac-integration/oac-instance-setup/images/analytics-cloud-console-button.png differ diff --git a/java-management-oac-integration/oac-instance-setup/images/analytics-cloud-create-application-role-details.png b/java-management-oac-integration/oac-instance-setup/images/analytics-cloud-create-application-role-details.png new file mode 100644 index 000000000..40cb258ee Binary files /dev/null and b/java-management-oac-integration/oac-instance-setup/images/analytics-cloud-create-application-role-details.png differ diff --git a/java-management-oac-integration/oac-instance-setup/images/analytics-cloud-create-application-role.png b/java-management-oac-integration/oac-instance-setup/images/analytics-cloud-create-application-role.png new file mode 100644 index 000000000..4001b756b Binary files /dev/null and b/java-management-oac-integration/oac-instance-setup/images/analytics-cloud-create-application-role.png differ diff --git a/java-management-oac-integration/oac-instance-setup/images/analytics-cloud-roles-permissions.png b/java-management-oac-integration/oac-instance-setup/images/analytics-cloud-roles-permissions.png new file mode 100644 index 000000000..4b7c41b12 Binary files /dev/null and b/java-management-oac-integration/oac-instance-setup/images/analytics-cloud-roles-permissions.png differ diff --git a/java-management-oac-integration/oac-instance-setup/images/analytics-create-instance.png b/java-management-oac-integration/oac-instance-setup/images/analytics-create-instance.png new file mode 100644 index 000000000..b0b21f950 Binary files /dev/null and b/java-management-oac-integration/oac-instance-setup/images/analytics-create-instance.png differ diff --git a/java-management-oac-integration/oac-instance-setup/images/configure-identity-domain.png b/java-management-oac-integration/oac-instance-setup/images/configure-identity-domain.png new file mode 100644 index 000000000..a1e845944 Binary files /dev/null and b/java-management-oac-integration/oac-instance-setup/images/configure-identity-domain.png differ diff --git a/java-management-oac-integration/oac-instance-setup/images/create-analytics-instance-details.png b/java-management-oac-integration/oac-instance-setup/images/create-analytics-instance-details.png new file mode 100644 index 000000000..1e81222e2 Binary files /dev/null and b/java-management-oac-integration/oac-instance-setup/images/create-analytics-instance-details.png differ diff --git a/java-management-oac-integration/oac-instance-setup/images/identity-domain-create-user-details.png b/java-management-oac-integration/oac-instance-setup/images/identity-domain-create-user-details.png new file mode 100644 index 000000000..8592969f8 Binary files /dev/null and b/java-management-oac-integration/oac-instance-setup/images/identity-domain-create-user-details.png differ diff --git a/java-management-oac-integration/oac-instance-setup/images/identity-domain-create-user-email.png b/java-management-oac-integration/oac-instance-setup/images/identity-domain-create-user-email.png new file mode 100644 index 000000000..9c75397d6 Binary files /dev/null and b/java-management-oac-integration/oac-instance-setup/images/identity-domain-create-user-email.png differ diff --git a/java-management-oac-integration/oac-instance-setup/images/identity-domain-list-compartments.png b/java-management-oac-integration/oac-instance-setup/images/identity-domain-list-compartments.png new file mode 100644 index 000000000..a8b691029 Binary files /dev/null and b/java-management-oac-integration/oac-instance-setup/images/identity-domain-list-compartments.png differ diff --git a/java-management-oac-integration/oac-instance-setup/images/identity-domain-list-users.png b/java-management-oac-integration/oac-instance-setup/images/identity-domain-list-users.png new file mode 100644 index 000000000..336bdc3b7 Binary files /dev/null and b/java-management-oac-integration/oac-instance-setup/images/identity-domain-list-users.png differ diff --git a/java-management-oac-integration/oac-instance-setup/images/identity-domain-list.png b/java-management-oac-integration/oac-instance-setup/images/identity-domain-list.png new file mode 100644 index 000000000..1641cfbef Binary files /dev/null and b/java-management-oac-integration/oac-instance-setup/images/identity-domain-list.png differ diff --git a/java-management-oac-integration/oac-instance-setup/oac-instance-setup.md b/java-management-oac-integration/oac-instance-setup/oac-instance-setup.md new file mode 100644 index 000000000..90a483fdf --- /dev/null +++ b/java-management-oac-integration/oac-instance-setup/oac-instance-setup.md @@ -0,0 +1,115 @@ +# Lab 3: Oracle Analytics Cloud Instance Setup + +## Introduction + +In this lab, you will provision and configure Oracle Analytics Cloud (OAC) to securely connect with your Autonomous Database instance containing Java Management Service (JMS) export data. +This integration enables you to build interactive dashboards in OAC for real-time visualization of managed Java environments, supporting centralized visibility and streamlined management. + +*Estimated Time:* 15 minutes + +### Objectives + +* Provision an Oracle Analytics Cloud (OAC) instance in Oracle Cloud Infrastructure (OCI). +* Configure OAC to securely connect to the Autonomous AI Database containing JMS export data. + +### Prerequisites + +* All prior labs (Autonomous AI Database, bucket configuration, JMS export) completed. +* Privileges to create Oracle Analytics Cloud instances in your OCI tenancy. +* Access to Oracle Cloud Console. +* OAC license or trial available in your region. +* An Identity Domain for users, roles and authentication settings. + +## Task 1: Provision an Oracle Analytics Cloud (OAC) Instance + +1. In the Oracle Cloud Console, open the navigation menu, click **Analytics & AI**, then under **AI Data Platform** select **Analytics Cloud**. + ![Configure Analytics Cloud](../common/images/configure-analytics-cloud.png) +2. Click **Create Instance**. + ![Create Instance in Analytics](./images/analytics-create-instance.png) +3. Complete the form: + * **Name**: Name your instance (e.g., `jms-oac`) + * **Description**: Brief description (e.g., `Enterprise analytics for JMS exports`) + * **Compartment**: Choose target compartment + * **Edition**: Select based on your subscription (for JMS Professional Edition is enough): + * Enterprise Edition: Includes modeling, reporting, data visualization + * Professional Edition: Data visualization only + * **Capacity**: Set OCPU and memory as needed + * **Licensing**: Choose based on your entitlement (Oracle/Non-Oracle) + * **Software Updates**: Select Early or Regular + ![OAC Instance Details](./images/create-analytics-instance-details.png) +4. Click **Create**. Wait for your OAC instance to reach **Active** status. + ![OAC Instance Active](../common/images/analytics-instances-list.png) +5. Once active, note the **URL** under Access Information for browser access. + ![OAC Instance Details](../common/images/analytics-instance-details.png) + +## Task 2: (Optional) Create a User for Oracle Analytics + +To allow additional users to access Oracle Analytics Cloud (OAC), you'll create a user in your Oracle Identity Domain and assign the necessary group(s). **You must have Identity Domain administrator privileges to complete this task.** + +1. In the Oracle Cloud Console, open the navigation menu, click **Identity & Security**, then under **Identity** select **Domains**. + ![Configure Identity Domain](./images/configure-identity-domain.png) +2. Use the **Compartment** filter to select your target compartment (the one containing your OAC instance). + ![Identity Domains List Compartments](./images/identity-domain-list-compartments.png) +3. From the list, click the name of the relevant Domain to open it. + ![List Identity Domains](./images/identity-domain-list.png) +4. In the left menu, click the **User management** tab. + ![Identity Domains List Users](./images/identity-domain-list-users.png) +5. Click **Create** to add a new user. +6. Complete the user details form: + * **First name** and **Last name** + * **Username / Email** (an activation email will be sent to this address) + * **Groups**: Assign at least one group needed for OAC access (for example, `oracle-analytics-users`). + *Ask your administrator which groups are required if unsure.* + ![Create User Details](./images/identity-domain-create-user-details.png) +7. Click **Create**. The user will receive an activation email to finish setting up their password and account. + ![User Activation Email](./images/identity-domain-create-user-email.png) +8. After the user activates their account, sign in as that user at the given login URL to confirm access. + ![User Account Access](../common/images/user-access.png) + +**Tip:** If you do not see the activation email, check your spam or junk folder. + +## Task 3: Create a Custom Role in Oracle Analytics + +To grant users specific privileges and streamline access control in Oracle Analytics Cloud (OAC), you can create a custom application role and assign it to individuals or groups. +**Note:** Only OAC administrators may perform these steps. + +1. In the Oracle Cloud Console, open the navigation menu, click **Analytics & AI**, then under **AI Data Platform** select **Analytics Cloud**. + ![Configure Analytics Cloud](../common/images/configure-analytics-cloud.png) +2. In the Oracle Analytics Cloud page, select your OAC instance (e.g., the one you created earlier). + ![Analytics Cloud List](../common/images/analytics-instances-list.png) +3. Locate and open the **URL** under Access Information to launch the OAC console in your browser. + ![Analytics Cloud Instance Details](../common/images/analytics-instance-details.png) +4. Log in with an OAC account that has administrative privileges. + ![Analytics Cloud User Access](../common/images/user-access.png) +5. In the OAC interface, click the **Navigator** menu (upper left), then select **Console**. + ![Analytics Cloud Console](./images/analytics-cloud-console-button.png) +6. Click **Roles & Permissions**. + ![Analytics Cloud Roles & Permissions](./images/analytics-cloud-roles-permissions.png) +7. Click **Create Application Role**. + ![Create Application Role](./images/analytics-cloud-create-application-role.png) +8. Complete the "Create Application Role" form: + * **Name**: Enter a technical name for your role (e.g., `DV_JMS_Content_Author`). Use underscores for readability and to distinguish from display names. + * **Display Name**: Enter a meaningful label for display in user interfaces (e.g., "JMS Content Author"). This is what administrators and users will typically see. + * **Description**: Provide a concise summary of the role’s purpose and allowed actions (e.g., "Allows data visualization and content authoring for JMS exports."). + ![Role Details](./images/analytics-cloud-create-application-role-details.png) +9. Click **Create**. +10. Select your new application role to configure permissions. + * In the right pane, go to **Memberships** → **Application Roles**. + * Click **Add Application Roles**, find and select **DV Content Author** (this grants standard data visualization authoring capabilities), then click **Add Selected**. + ![Add Application Roles](./images/analytics-cloud-add-selected-application-roles.png) +11. Assign the role to users or groups: + * In **Application Roles**, select your new role. + * On the right, go to **Members → Users**. + * Click **Add User**, select the appropriate user(s), and click **Add Selected**. + ![Add Users](./images/analytics-cloud-add-users.png) + +## Next Steps + +You have successfully set up Oracle Analytics Cloud instance . Proceed to the next lab to Access the OAC Environment to start building advanced dashboards and automate analytics workflows using OAC with your integrated JMS data. + +Congratulations, you completed the lab! You may now [proceed to the next lab](#next). + +## Acknowledgements + +* **Author** - Maria Antonia Merino, Java Management Service +* **Last Updated By/Date** - Maria Antonia Merino, January 2026 diff --git a/java-management-oac-integration/schedule-jms-export/images/analytics-cloud-data-connection-new-schedule.png b/java-management-oac-integration/schedule-jms-export/images/analytics-cloud-data-connection-new-schedule.png new file mode 100644 index 000000000..083a54ee6 Binary files /dev/null and b/java-management-oac-integration/schedule-jms-export/images/analytics-cloud-data-connection-new-schedule.png differ diff --git a/java-management-oac-integration/schedule-jms-export/images/analytics-cloud-data-connection-schedule-details.png b/java-management-oac-integration/schedule-jms-export/images/analytics-cloud-data-connection-schedule-details.png new file mode 100644 index 000000000..04b23d163 Binary files /dev/null and b/java-management-oac-integration/schedule-jms-export/images/analytics-cloud-data-connection-schedule-details.png differ diff --git a/java-management-oac-integration/schedule-jms-export/images/analytics-cloud-data-jobs-schedule-history.png b/java-management-oac-integration/schedule-jms-export/images/analytics-cloud-data-jobs-schedule-history.png new file mode 100644 index 000000000..c462d0e8e Binary files /dev/null and b/java-management-oac-integration/schedule-jms-export/images/analytics-cloud-data-jobs-schedule-history.png differ diff --git a/java-management-oac-integration/schedule-jms-export/images/analytics-cloud-data-jobs-schedules-inspect.png b/java-management-oac-integration/schedule-jms-export/images/analytics-cloud-data-jobs-schedules-inspect.png new file mode 100644 index 000000000..1bb6a2ded Binary files /dev/null and b/java-management-oac-integration/schedule-jms-export/images/analytics-cloud-data-jobs-schedules-inspect.png differ diff --git a/java-management-oac-integration/schedule-jms-export/images/analytics-cloud-data-jobs-schedules.png b/java-management-oac-integration/schedule-jms-export/images/analytics-cloud-data-jobs-schedules.png new file mode 100644 index 000000000..2eb914e7d Binary files /dev/null and b/java-management-oac-integration/schedule-jms-export/images/analytics-cloud-data-jobs-schedules.png differ diff --git a/java-management-oac-integration/schedule-jms-export/images/analytics-cloud-data-jobs.png b/java-management-oac-integration/schedule-jms-export/images/analytics-cloud-data-jobs.png new file mode 100644 index 000000000..352da04a8 Binary files /dev/null and b/java-management-oac-integration/schedule-jms-export/images/analytics-cloud-data-jobs.png differ diff --git a/java-management-oac-integration/schedule-jms-export/schedule-jms-export.md b/java-management-oac-integration/schedule-jms-export/schedule-jms-export.md new file mode 100644 index 000000000..6318672ba --- /dev/null +++ b/java-management-oac-integration/schedule-jms-export/schedule-jms-export.md @@ -0,0 +1,62 @@ +# Lab 7: Schedule JMS Export to Execute Periodically + +## Introduction + +In this lab, you will schedule the Java Management Service (JMS) export process to run automatically on a periodic basis, ensuring up-to-date Java inventory and usage data flows to downstream analytics. + +*Estimated Time:* 10 minutes + +### Objectives + +* Configure scheduled execution for JMS export using Oracle Cloud Infrastructure (OCI) tools. +* Validate successful schedule and confirm automatic runs. + +### Prerequisites + +* Completed prior labs, including initial JMS export configuration. +* OCI permissions to manage schedules for JMS or associated services. +* An existing JMS export job you want to schedule. + +## Task 1: Schedule the JMS Export + +1. On the OAC home page, click page menu in the upper left side. +2. Select **Data**. + ![Import template menu](../common/images/analytics-cloud-config-data-connection.png) +3. Over the imported connection, on the right side, click actions menu and click **New Schedule**. + ![Select Autonomous AI Database Connection](./images/analytics-cloud-data-connection-new-schedule.png) +4. Specify schedule details to run dataset: + * **Name** + * **Start**, **Time** and **End** + * **Repeat** (e.g., daily, weekly, ...), **Every**. + ![Create Export Schedule](./images/analytics-cloud-data-connection-schedule-details.png) +5. Click **OK** to schedule it. + +## Task 2: Validate the Scheduled Export + +1. Wait for the next scheduled interval and monitor the activity. +2. On the OAC home page, click page menu in the upper left side. +3. Select **Jobs**. + ![Scheduled Export Enabled](./images/analytics-cloud-data-jobs.png) +4. Select **Schedules** and localize your schedule. +5. Go to actions menu and click **Inspect**. + ![Scheduled Export Enabled](./images/analytics-cloud-data-jobs-schedules-inspect.png) +6. On left side select **History** and check the status of the runs. + ![Scheduled Export Enabled](./images/analytics-cloud-data-jobs-schedule-history.png) + +## Task 3: Validate the data + +1. Log in to your Oracle Analytics Cloud (OAC) environment. +2. From the home page, click **Catalog** in the navigation menu. + ![OAC Catalog](../common/images/analytics-cloud-config-catalog.png) +3. Find and open the JMS Inventory workbook you previously imported,let's double-click on it or click, select actions menu and then **Open**. + ![Open Inventory Workbook](../common/images/catalog-jms-data-viewer.png) + +## Next Steps + +* Monitor exports regularly and adjust the schedule as needed for your analytics SLAs. +* Continue refining automation and monitoring according to organizational requirements. + +## Acknowledgements + +* **Author** - Maria Antonia Merino, Java Management Service +* **Last Updated By/Date** - Maria Antonia Merino, January 2026 \ No newline at end of file diff --git a/java-management-oac-integration/workshops/tenancy/index.html b/java-management-oac-integration/workshops/tenancy/index.html new file mode 100644 index 000000000..806cc9069 --- /dev/null +++ b/java-management-oac-integration/workshops/tenancy/index.html @@ -0,0 +1,63 @@ + + + + + + + + + Oracle LiveLabs + + + + + + + + + + + + + +
+
+
+
+
+
+
+
+ + + + + \ No newline at end of file diff --git a/java-management-oac-integration/workshops/tenancy/manifest.json b/java-management-oac-integration/workshops/tenancy/manifest.json new file mode 100644 index 000000000..b34ef914c --- /dev/null +++ b/java-management-oac-integration/workshops/tenancy/manifest.json @@ -0,0 +1,58 @@ +{ + "workshoptitle": "Integrating Oracle Analytics Cloud with Java Management Service", + "include": {}, + "variables": [], + "help": "autonomous_java-dev_us_grp@oracle.com", + "tutorials": [ + { + "title": "Introduction", + "description": "Overview, objectives, and prerequisites for the workshop.", + "filename": "../../introduction/introduction.md" + }, + { + "title": "Get Started", + "description": "This is the prerequisites for customers using Free Trial and Paid tenancies, and Always Free accounts (if applicable). The title of the lab and the Contents Menu title (the title above) match for Prerequisite lab. This lab is always first.", + "filename": "https://oracle-livelabs.github.io/common/labs/cloud-login/cloud-login.md" + }, + { + "title": "Lab 1: Export JMS Fleet Data to Object Storage", + "description": "Create or use an Object Storage bucket and configure JMS Fleet to export Java data for analysis.", + "filename": "../../jms-fleet-data-to-object-storage/jms-fleet-data-to-object-storage.md" + }, + { + "title": "Lab 2: Export JMS Data to Autonomous AI Database", + "description": "Configure JMS to export inventory and usage data to an Autonomous AI Database for analytics.", + "filename": "../../jms-data-export-to-autonomous-ai-database/jms-data-export-to-autonomous-ai-database.md" + }, + { + "title": "Lab 3: Oracle Analytics Cloud Instance Setup", + "description": "Provision and configure Oracle Analytics Cloud (OAC) and connect it with the database containing exported JMS data.", + "filename": "../../oac-instance-setup/oac-instance-setup.md" + }, + { + "title": "Lab 4: Import JMS OAC Template", + "description": "Access the OAC environment and import a pre-built template for Java Management Service analytics.", + "filename": "../../import-jms-oac-template/import-jms-oac-template.md" + }, + { + "title": "Lab 5: Connect OAC to Autonomous AI Database", + "description": "Configure and validate a secure connection from Oracle Analytics Cloud to the Autonomous AI Database.", + "filename": "../../connect-oac-to-atp/connect-oac-to-atp.md" + }, + { + "title": "Lab 6: Build a Custom Inventory Dashboard", + "description": "View and customize dashboards and visualizations in OAC using imported Java inventory data.", + "filename": "../../build-custom-inventory-dashboard/build-custom-inventory-dashboard.md" + }, + { + "title": "Lab 7: Schedule JMS Data Refresh", + "description": "Set up and validate an automated, scheduled export of JMS data from OCI for ongoing analytics.", + "filename": "../../schedule-jms-export/schedule-jms-export.md" + }, + { + "title": "Need Help?", + "description": "Solutions to common problems and directions for receiving Live Help.", + "filename": "https://oracle-livelabs.github.io/common/labs/need-help/need-help-freetier.md" + } + ] +}