### Example Installation Command

Source: https://docs.oracle.com/en-us/iaas/management-agents/doc/install-management-agent-chapter.html

A concrete example of the installation command, specifying the path to the response file and the desired service identifier.

```bash
sudo ./installer.sh /tmp/input.rsp mgmt_agent-oc1_phx-abc123
```

--------------------------------

### Example: Install Kubernetes Metrics Server Add-on

Source: https://docs.oracle.com/en-us/iaas/Content/ContEng/Tasks/contengworkingwithmetricsserver_cluster-add-on.htm

An example of the install command with a specific cluster OCID and configuration file path.

```bash
oci ce cluster install-addon --addon-name KubernetesMetricsServer --from-json file://./enablemetrics-server.json --cluster-id ocid1.cluster.oc1.iad.aaaaaaaam______dfr
```

--------------------------------

### Example Output of 'apt list --installed'

Source: https://docs.oracle.com/en-us/iaas/osmh/doc/ubuntu-updates.htm

This is an example of the output format when generating an installed package list using 'apt list --installed' on an Ubuntu instance.

```text
adduser/jammy,now 3.118ubuntu5 all [installed]
apt/jammy-updates,now 2.4.12 amd64 [installed]
base-files/jammy-updates,now 12ubuntu4.9 amd64 [installed]
base-passwd/jammy,now 3.5.52 amd64 [installed]
bash/jammy,now 5.1-6ubuntu1 amd64 [installed]
bsdutils/jammy-updates,now 1:2.37.2-4ubuntu3.4 amd64 [installed]
...
```

--------------------------------

### Initiate Pre-Upgrade Setup via CLI

Source: https://docs.oracle.com/en-us/iaas/private-cloud-appliance/pca/upg-setup.htm

Use this command to start the installation of the latest Upgrader version and set up new appliance software sources. The 'type=ISO' parameter indicates that required files will be retrieved from unpacked ISO images.

```bash
PCA-ADMIN> preUpgrade type=ISO
Status: Running
JobId: aa33246e-fd79-460f-a191-cc97f8be04be
Data: in progress
```

--------------------------------

### Start Agent with Example Volume Path

Source: https://docs.oracle.com/en-us/iaas/Content/access-governance/agent-administration.htm

Example command to start the Oracle Access Governance Agent, specifying the persistent volume path.

```bash
curl https://raw.githubusercontent.com/oracle/docker-images/main/OracleIdentityGovernance/samples/scripts/agentManagement.sh -o agentManagement.sh ; sh agentManagement.sh 
--volume /access-governance/agent-management/volume 
--start
```

--------------------------------

### Create VM with Kickstart Installation

Source: https://docs.oracle.com/en-us/iaas/oracle-linux/oci/index.htm

Example of creating a VM and performing a kickstart installation using a specified kickstart file.

```bash
oci-kvm create --domain kvm_vm_002 --pool vm_pool_001 --disk-size=24 --net ens5 \
--virt --vcpus 2 --memory 8192 --boot cdrom,hd --location /isos/OracleLinux.iso --nographics \
--console pty,target_type=serial --console pty,target_type=virtio --noautoconsole --os-variant=ol7.9 \
--initrd-inject /root/kvm_vm_002_ks.cfg --extra-args="ks=file:kvm_vm_002_ks.cfg console=ttyS0,115200n8"
```

--------------------------------

### Example RPM Installation Command

Source: https://docs.oracle.com/en-us/iaas/management-agents/doc/install-management-gateway-main.html

An example of the command to install the Management Gateway RPM, replacing placeholders with actual values.

```shell
sudo rpm -ivh                   oracle.mgmt_gateway-<VERSION>.rpm
```

--------------------------------

### Install Cluster Autoscaler Add-on Example

Source: https://docs.oracle.com/en-us/iaas/Content/ContEng/Tasks/contengusingclusterautoscaler_topic-Working_with_Cluster_Autoscaler_as_Cluster_Add-on.htm

Example command for installing the Cluster Autoscaler add-on with a specific configuration file and cluster OCID.

```bash
oci ce cluster install-addon --addon-name ClusterAutoscaler --from-json file://./cluster-autoscaler-add-on.json --cluster-id ocid1.cluster.oc1.iad.aaaaaaaam______dfr
```

--------------------------------

### Install Management Agent on Solaris using ZIP - Example

Source: https://docs.oracle.com/en-us/iaas/management-agents/doc/install-management-agent-chapter.html

This is an example of the output during the Management Agent installation on Solaris using a ZIP file and a response file. It shows prerequisite checks, installation steps, and configuration process.

```text
sudo ./installer.sh <user_home_directory>/input.rsp 
Checking pre-requisites
    Checking if any previous agent service exists
    Checking if OS has systemd or initd
    Checking available disk space for agent install
    Checking if /opt/oracle/mgmt_agent directory exists
    Checking if 'mgmt_agent' user exists
    Checking Java version
        JAVA_HOME is not set or not readable to root
        Trying default path /usr/bin/java
        Java version: 1.8.0_282 found at /usr/bin/java
    Checking agent version

Executing install
    Unpacking software zip
    Copying files to destination dir (/opt/oracle/mgmt_agent)
    Initializing software from template
    Creating 'mgmt_agent'daemon
    Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0

Agent install successful

Executing configure

    Parsing input response file
    Validating install key
    Generating communication wallet
    Generating security artifacts
    Registering Management Agent

Starting agent...
Agent started successfully


Agent setup completed and the agent is running.
In the future agent can be started by directly running: sudo systemctl start mgmt_agent 

```

--------------------------------

### Successful GET Response Body for Users

Source: https://docs.oracle.com/en-us/iaas/Content/Identity/api-getstarted/OCISResponseBody.htm

This example shows the results of a GET search on Users, filtered by usernames starting with 'd'. It includes the ListResponse structure with total results and an array of user resources.

```json
{
    "schemas": [
        "urn:ietf:params:scim:api:messages:2.0:ListResponse"
    ],
    "totalResults": 3,
    "Resources": [
        {
            "idcsCreatedBy": {
                "type": "User",
                "display": "dennis@example.com",
                "value": "OCI User",
                "ocid": "<user-ocid>",
                "$ref": "https://<domainURL>/admin/v1/Users/OCI User"
            },
            "id": "<user-id>",
            "urn:ietf:params:scim:schemas:oracle:idcs:extension:user:User": {
                "isFederatedUser": false
            },
            "meta": {
                "created": "2023-08-15T20:48:12.736Z",
                "lastModified": "2023-08-15T20:48:12.736Z",
                "version": "087a80ea35614663b05ea69b24b425a7",
                "resourceType": "User",
                "location": "https://<domainURL>/admin/v1/Users/<user-id>"
            },
            "active": true,
            "displayName": "Dean",
            "idcsLastModifiedBy": {
                "value": "OCI User",
                "display": "dean@example.com",
                "ocid": "<user-ocid>",
                "type": "User",
                "$ref": "https://<domainURL>/admin/v1/Users/OCI User"
            },
            "name": {
                "givenName": "Dean",
                "familyName": "",
                "formatted": "Dean"
            },
            "urn:ietf:params:scim:schemas:oracle:idcs:extension:userState:User": {
                "locked": {
                    "on": false
                }
            },
            "ocid": "<user-ocid>",
            "userName": "dean@example.com",
            "emails": [
                {
                    "secondary": false,
                    "verified": false,
                    "type": "recovery",
                    "primary": false,
                    "value": "dean@example.com"
                },
                {
                    "secondary": false,
                    "verified": false,
                    "type": "work",
                    "primary": true,
                    "value": "dean@example.com"
                }
            ],
            "schemas": [
                "urn:ietf:params:scim:schemas:core:2.0:User",
                "urn:ietf:params:scim:schemas:oracle:idcs:extension:userState:User",
                "urn:ietf:params:scim:schemas:oracle:idcs:extension:user:User"
            ],
            "domainOcid": "<domain-ocid>",
            "compartmentOcid": "<compartment-ocid>",
            "tenancyOcid": "<tenancy-ocid>",
            "urn:ietf:params:scim:schemas:oracle:idcs:extension:capabilities:User": {
                "canUseApiKeys": true,
                "canUseAuthTokens": true,
                "canUseConsolePassword": true,
                "canUseCustomerSecretKeys": true,
                "canUseOAuth2ClientCredentials": true,
                "canUseSmtpCredentials": true,
                "canUseDbCredentials": true
            }
        },
        {
            "idcsCreatedBy": {
                "type": "User",
                "display": "joel@example.com",
                "value": "OCI User",
                "ocid": "<user-ocid>",
                "$ref": "https://<domainURL>/admin/v1/Users/OCI User"
            },
            "id": "<user-id>",
            "urn:ietf:params:scim:schemas:oracle:idcs:extension:user:User": {
                "isFederatedUser": false
            },
            "meta": {
                "created": "2023-07-19T18:23:28.381Z",
                "lastModified": "2023-08-09T16:22:41.590Z",
                "version": "0ecbeddb823247d8a24a67739b006892",
                "resourceType": "User",
                "location": "https://<domainURL>/admin/v1/Users/<user-id>"
            },
            "active": true,
            "displayName": "Dennis",
            "urn:ietf:params:scim:schemas:oracle:idcs:extension:mfa:User": {
                "preferredDevice": {
                    "value": "<device-id>",
                    "$ref": "https://<domainURL>/admin/v1/Devices/<device-id>"
                },
                "loginAttempts": 0,
                "mfaStatus": "ENROLLED",
                "preferredAuthenticationFactor": "PUSH"
            },
            "idcsLastModifiedBy": {
                "value": "<app-id>",
                "display": "idcssso",
                "ocid": "<app-ocid>",
                "type": "App",
                "$ref": "https://<domainURL>/admin/v1/Apps/<app-id>"
            },
            "name": {
                "givenName": "Dennis",
                "familyName": "",
                "formatted": "Dennis"
            }
        }
    ]
}
```

--------------------------------

### Example pip install output

Source: https://docs.oracle.com/en-us/iaas/autonomous-database-serverless/doc/connecting-python-prepare.html

This is an example of the output you might see when installing or upgrading the python-oracledb driver. It shows the packages being collected and installed.

```text
Collecting oracledb
  Downloading oracledb-1.0.3-cp310-cp310-win_amd64.whl (1.0 MB)
     ---------------------------------------- 1.0/1.0 MB 1.8 MB/s eta 0:00:00
Collecting cryptography>=3.4
  Downloading cryptography-37.0.4-cp36-abi3-win_amd64.whl (2.4 MB)
     ---------------------------------------- 2.4/2.4 MB 3.5 MB/s eta 0:00:00
Collecting cffi>=1.12
  Downloading cffi-1.15.1-cp310-cp310-win_amd64.whl (179 kB)
     ---------------------------------------- 179.1/179.1 kB 5.4 MB/s eta 0:00:00
Collecting pycparser
  Downloading pycparser-2.21-py2.py3-none-any.whl (118 kB)
     ---------------------------------------- 118.7/118.7 kB 7.2 MB/s eta 0:00:00
Installing collected packages: pycparser, cffi, cryptography, oracledb
Successfully installed cffi-1.15.1 cryptography-37.0.4 oracledb-1.0.3 pycparser-2.21
```

--------------------------------

### Installation Log Output Example

Source: https://docs.oracle.com/en-us/iaas/roving-edge-infrastructure/rvr/self-provisioning.htm

This snippet shows a sample of the last lines from the installation log, indicating the status of tasks and a summary of the play recap. It's useful for monitoring the installation progress.

```text
 These are the last 20 lines from the installation log:
=============================================================
tuesday 03 february 2026  00:12:59 +0000 (0:00:00.361)       0:00:03.843 ********
changed: [100.96.2.33]

task [add the reprovision complete lock for this node] *************************
tuesday 03 february 2026  00:13:00 +0000 (0:00:00.468)       0:00:04.311 ********
skipping: [100.96.2.33]

play recap *********************************************************************
100.96.2.33                : ok=6    changed=3    unreachable=0    failed=0    skipped=1    rescued=0    igno0
```

--------------------------------

### Example: Get Artifact Details by OCID

Source: https://docs.oracle.com/en-us/iaas/Content/artifacts/get-artifact.htm

An example of how to use the 'get' command with a sample artifact OCID.

```bash
oci artifacts repository get --artifact-id ocid1.genericartifact.oc1..xxx...
```

--------------------------------

### Get Help for Start Replication Command using OCI CLI

Source: https://docs.oracle.com/en-us/iaas/Content/cloud-migration/cloud-migration-perform-manual-replication.htm

Retrieve detailed help information for the `start-replication` command within the OCI CLI. This provides syntax, parameters, and usage examples for the command.

```bash
oci cloud-migrations migration-asset start_replication -h
```

--------------------------------

### Example of Management Agent Installation Output

Source: https://docs.oracle.com/en-us/iaas/management-agents/doc/install-management-agent-chapter.html

This is an example of the output you can expect when the management agent installation is successful. It shows the progress of checks, installation, configuration, and agent startup.

```shell
Checking pre-requisites
    Checking if any previous agent service exists
    Checking if OS has systemd or initd
    Checking available disk space for agent install
    Checking if /opt/oracle/mgmt_agent directory exists
    Checking if 'mgmt_agent' user exists
    Checking Java version
        Trying /tmp/java/jdk8u372-b07
        Java version: 1.8.0_372 found at /tmp/java/jdk8u372-b07/bin/java
    Checking agent version

Executing install
    Unpacking software zip
    Copying files to destination dir (/opt/oracle/mgmt_agent)
    Initializing software from template
    Checking if JavaScript engine is available to use       
    Creating mgmt_agent daemon
    Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0

Agent install successful

Executing configure

    Parsing input response file
    Validating install key
    Generating communication wallet
    Generating security artifacts
    Registering Management Agent

Starting agent...
0513-059 The mgmt_agent Subsystem has been started. Subsystem PID is 16122232.
Agent started successfully


Agent setup completed and the agent is running.
In the future agent can be started by directly running: sudo startsrc -s mgmt_agent 

Please make sure that you delete <user_home_directory>/input.rsp or store it in secure location.
```

--------------------------------

### Display Help for Installation Script

Source: https://docs.oracle.com/en-us/iaas/jms/doc/using-installation-script-premise-mac.html

Run the --help command to view the description of all available options for the installation script.

```bash
sudo sh ./agentinstall.sh --help
```

--------------------------------

### View Installation Script Help and Options

Source: https://docs.oracle.com/en-us/iaas/jms/doc/using-installation-script-linux-oci.html

Run the '--help' command on the installation script to view a description of all available options, including those for enabling/disabling user name tracking, proxy settings, and FIPS mode.

```bash
sudo /path/to/installation/script --help
```

--------------------------------

### Example Output of SCSI GET LBA STATUS Command

Source: https://docs.oracle.com/en-us/iaas/Content/Block/Tasks/restoringdeltabetweenbackups.htm

This output shows the provisioning status of mapped and deallocated blocks on a volume. Each line represents a range of blocks with their starting LBA, count, and provisioning status.

```text
Completion condition=3
RTP=1
0x0000000000000060  0x10  3  0
0x0000000000000070  0x8  1  0
0x0000000000000078  0x10  3  0
0x0000000000000088  0x8  1  0
0x0000000000000090  0x10  3  0
0x00000000000000a0  0xfff60  1  0
```

--------------------------------

### View Installation Script Help

Source: https://docs.oracle.com/en-us/iaas/jms/doc/using-installation-script-premise-linux.html

Use the --help command to display a list of all available options for the installation script, including those for enabling/disabling features like user name collection, proxy settings, and FIPS mode.

```bash
sudo ./install.sh --help
```

--------------------------------

### Example Management Gateway Setup Output

Source: https://docs.oracle.com/en-us/iaas/management-agents/doc/install-management-gateway-main.html

This output shows a successful configuration and startup of the Management Gateway, including plugin deployment.

```text
sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=<user_home_directory>/gateway.rsp

Executing configure
       Parsing input response file
       Validating install key
       Generating communication wallet
       Generating security artifacts
       Registering Management Gateway
               Found service plugin(s): [GatewayProxy]

Starting gateway...
Gateway started successfully

Starting plugin deployment for: [GatewayProxy]
Deploying service plugin(s)......Done.
        GatewayProxy : Successfully deployed external plugin

Gateway setup completed and the gateway is running.
In the future gateway can be started by directly running: sudo systemctl start mgmt_gateway

Please make sure that you delete <user_home_directory>/gateway.rsp or store it in secure location.

Creating Wallets
Wallets created successfully
Waiting for Gateway to start...
Gateway Proxy started successfully

```

--------------------------------

### Install and Start Node.js Server

Source: https://docs.oracle.com/en-us/iaas/digital-assistant/doc/deploy-component-package-service.html

After packaging, run these commands to install dependencies and start your Node.js server with the component package.

```bash
npm install

npm start
```

--------------------------------

### Kernel Boot Parameters Example

Source: https://docs.oracle.com/en-us/iaas/Content/Compute/References/updatingkernel.htm

Example of kernel boot parameters from a grub.cfg file, highlighting the parameters to be uploaded to the cmdline URL.

```shell
kernel /boot/vmlinuz-4.1.12-37.5.1.el6uek.x86_64 

                        ro root=UUID=8079e287-53d7-4b3d-b708-c519cf6829c8 rd_NO_LUKS  KEYBOARDTYPE=pc KEYTABLE=us netroot=iscsi:@169.254.0.2::3260:iface1:eth0::iqn.2015-02.oracle.boot:uefi rd_NO_MD SYSFONT=latarcyrheb-sun16 ifname=eth0:90:e2:ba:a2:e3:80 crashkernel=auto iscsi_initiator=iqn.2015-02. rd_NO_LVM ip=eth0:dhcp rd_NO_DM LANG=en_US.UTF-8 console=tty0 console=ttyS0,9600 iommu=on
                    
                
```

--------------------------------

### Example: Initialize Project

Source: https://docs.oracle.com/en-us/iaas/oracle-linux/xfs/xfs-managing-quotas-on-an-xfs-file-system.htm

An example command to define a managed tree for the project `testproj` in the `/mnt` file system.

```bash
sudo xfs_quota -x -c 'project -s testproj' /mnt
```

--------------------------------

### User ID Example: GUID

Source: https://docs.oracle.com/en-us/iaas/analytics-cloud/doc/audit-and-diagnostic-logs-oracle-analytics-cloud.html

Example of a user ID represented as a GUID in Oracle Identity Cloud. This format is used by default.

```json
"userId": "aa11bb22cc33dd44ee55ff66gg77hh88"
```

--------------------------------

### Exadata Agent Installation Example Output

Source: https://docs.oracle.com/en-us/iaas/Content/knownissues.htm

This is an example of the output you might see after successfully installing the Exadata agent using the rpm command. It shows the package installation progress and service status.

```bash
[root@<node_n>~]# rpm -ivh dbcs-agent-2.5-3.x86_64.rpm
Preparing...                ########################################### [100%]
Checking for dbaastools_exa rpm on the system
Current dbaastools_exa version = dbaastools_exa-1.0-1+18.1.4.1.0_180725.0000.x86_64
dbaastools_exa version dbaastools_exa-1.0-1+18.1.4.1.0_180725.0000.x86_64 is good. Continuing with dbcs-agent installation
   1:dbcs-agent             ########################################### [100%]
initctl: Unknown instance:
initctl: Unknown instance:
initzookeeper start/running, process 85821
initdbcsagent stop/waiting
initdbcsadmin stop/waiting
initdbcsagent start/running, process 85833
initdbcsadmin start/running, process 85836


```

--------------------------------

### Start an Instance using the CLI

Source: https://docs.oracle.com/en-us/iaas/Content/Compute/Tasks/restartinginstance-start-instance.htm

Use the instance action command with the required parameters to start an instance. For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

```bash
oci compute instance action --instance-id <instance_OCID> --action START
```

--------------------------------

### Start a VM Instance using OCI CLI

Source: https://docs.oracle.com/en-us/iaas/Content/Compute/Tasks/howto-start-stop-instance.htm

Use the `compute instance action` command with the `START` action to start a VM instance. Replace `--instance-id` with the actual instance OCID.

```bash
oci compute instance action --action START --instance-id
```

--------------------------------

### Example: Create an Instance Pool with Load Balancing

Source: https://docs.oracle.com/en-us/iaas/compute-cloud-at-customer/cmn/compute/creating-an-instance-pool.htm

An example command to create an instance pool, including optional display name, instance configuration, placement configurations, load balancers, and pool size.

```bash
$ oci compute-management instance-pool create --compartment-id ocid1.compartment.unique_ID --display-name support-pool --instance-configuration-id ocid1.instanceConfiguration.unique_ID --placement-configurations file://./placement_configurations.json --load-balancers file://./load_balancers.json --size 10
```

--------------------------------

### Example Get ObjectCollectionRule Command

Source: https://docs.oracle.com/en-us/iaas/log-analytics/doc/collect-logs-from-your-oci-object-storage-bucket-deprecated-steps.html

An example of the get command, showing how to specify the namespace and the object collection rule OCID to fetch its details.

```bash
oci log-analytics object-collection-rule get --namespace-name “My Namespace” --object-collection-rule-id ocid1.loganalyticsobjectcollectionrule.oc1..exampleuniqueID
```

--------------------------------

### Example of Windows Management Gateway Configuration

Source: https://docs.oracle.com/en-us/iaas/management-agents/doc/install-management-gateway-main.html

An example of running the setupGateway.bat script with a specific response file path.

```batch
C:\Oracle\mgmt_agent\agent_inst\bin\setupGateway.bat c:\tmp\input.rsp
```

--------------------------------

### GET Request Example for User

Source: https://docs.oracle.com/en-us/iaas/Content/Identity/api-getstarted/OCISRequestBody.htm

Use this example to list a user by their ID. It shows the structure of a GET request to the Identity Domains API.

```shell
GET {{HOST}}/admin/v1/Users/{{userid}}
```

--------------------------------

### Set Up CEC Source Folder and Install Dependencies

Source: https://docs.oracle.com/en-us/iaas/content-management/doc/install-oracle-content-management-toolkit-your-vm-compute-instance.html

Creates a new directory named 'cec', changes into it, and then uses the 'cec install' command to set up a source tree and fetch its dependencies. This prepares the environment for developing with the toolkit.

```bash
cd
mkdir cec
cd cec
cec install
```

--------------------------------

### Example: Setup OUD Exporter

Source: https://docs.oracle.com/en-us/iaas/stack-monitoring/doc/promotion-and-discovery.html

An example of setting up the OUD exporter with specific OCI compartment, resource names, ports, and Java Home.

```bash
./manage_exporter.sh setup --type oud --compartment ocid.compartment1.abcdef1234 --name oud_one --instName oud_one --ldap 0 --ldaps 0 --oracleHome /scratch/oud12c --adminPort 4444 --metricPort 1888 --javaHome /scratch/install/jdk1.8.0_381/ -D muser -j /scratch/exporter/oud_exporter/.pw
```

--------------------------------

### Example Installation Log Output

Source: https://docs.oracle.com/en-us/iaas/jms/doc/oci-linux---oma-installer.html

This output indicates the successful completion of the agent installation and removal of temporary files. The detailed log can be found in the specified directory.

```text
Removed:
python3-arrow-1.1.1-1.el8.noarch 
python3-importlib-metadata-1.7.0-1.el8.noarch 
python3-jmespath-0.10.0-1.el8.noarch 
python3-prompt-toolkit-3.0.29-1.0.2.el8.noarch 
python3-terminaltables-3.1.10-1.0.1.el8.noarch 
python3-typing-extensions-3.7.4.2-1.el8.noarch 
python3-wcwidth-0.2.5-3.el8.noarch 
python3-zipp-0.5.1-3.el8.noarch 
python36-oci-cli-3.43.1-1.el8.noarch
Complete!
A copy of this installation log can be found at/var/log/oracle/JMSInstallScript/JMSInstallScriptLogs-<date>.log
Removing the temporary files.
```

--------------------------------

### Install and Enable mcstrans Service

Source: https://docs.oracle.com/en-us/iaas/oracle-linux/selinux/selinux-extending-selinux-policies-with-multi-category-security.htm

Install the `mcstrans` package and enable it to start on boot, then start it immediately. This service translates MCS values to human-readable labels.

```bash
sudo dnf install -y mcstrans
sudo systemctl enable --now mcstrans
```

--------------------------------

### Example ZIP Agent Installation and Configuration Output

Source: https://docs.oracle.com/en-us/iaas/management-agents/doc/install-management-agent-chapter.html

This output demonstrates a successful installation and configuration process for the management agent using the ZIP file method.

```text
sudo ./installer.sh <user_home_directory>/input.rsp 
Checking pre-requisites
    Checking if any previous agent service exists
    Checking if OS has systemd or initd
    Checking available disk space for agent install
    Checking if /opt/oracle/mgmt_agent directory exists
    Checking if 'mgmt_agent' user exists
    Checking Java version
        JAVA_HOME is not set or not readable to root
        Trying default path /usr/bin/java
        Java version: 1.8.0_282 found at /usr/bin/java
    Checking agent version

Executing install
    Unpacking software zip
    Copying files to destination dir (/opt/oracle/mgmt_agent)
    Initializing software from template
    Creating 'mgmt_agent'daemon
    Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0

Agent install successful

Executing configure

    Parsing input response file
    Validating install key
    Generating communication wallet
    Generating security artifacts
    Registering Management Agent

Starting agent...
Agent started successfully

```

--------------------------------

### Install SCAP Security Guide

Source: https://docs.oracle.com/en-us/iaas/oracle-linux/oci/stig-rescan-instance.htm

Install the SCAP Security Guide package, which provides the SSG 'stig' profile. This is needed when using OpenSCAP with the 'stig' profile.

```bash
sudo yum install scap-security-guide
```

--------------------------------

### Example Cloud-init Script

Source: https://docs.oracle.com/en-us/iaas/Content/ContEng/Tasks/contengcloudinitforselfmanagednodes.htm

This is an example of a completed cloud-init script, showing how to substitute the placeholder values with actual endpoint and certificate information.

```bash
#!/usr/bin/env bash
bash /etc/oke/oke-install.sh \
  --apiserver-endpoint "10.0.103.170" \
  --kubelet-ca-cert "LS0t______UtLS0tLQo="
```

--------------------------------

### Install Dependencies and Start Component Service

Source: https://docs.oracle.com/en-us/iaas/digital-assistant/doc/implement-custom-components.html

Run these commands in the terminal from the top-level folder to install project dependencies and start the local development service for custom components.

```bash
npm install
npm start
```

--------------------------------

### Example: Create Container Instance with Specific Configurations

Source: https://docs.oracle.com/en-us/iaas/compute-cloud-at-customer/cmn/compute/creating-a-container-instance.htm

This example demonstrates creating a container instance with a flex shape, specifying OCPUs and memory, and defining the subnet ID for the virtual network interface.

```bash
oci container-instances container-instance create --availability-domain AD-1 --compartment-id ocid1.compartment. _unique_ID_ --containers file://_container_config_.json --shape CI.Standard.E5.Flex --shape-config '{"ocpus": 2,"memoryInGBs": 2}' --vnics '[{"subnetId": "ocid1.subnet._unique_ID_"}]'
```

--------------------------------

### GET Response Example for User

Source: https://docs.oracle.com/en-us/iaas/Content/Identity/api-getstarted/OCISRequestBody.htm

This is an example of a successful JSON response when retrieving user details using a GET request. It includes user attributes, metadata, and capabilities.

```json
{
    "idcsCreatedBy": {
        "type": "App",
        "display": "Confidential App",
        "value": "<app_id>",
        "ocid": "ocid1.domainapp.oc1.<unique_id>",
        "$ref": "https://<domain_url>/admin/v1/Apps/<app_id>"
    },
    "id": "<user_id>",
    "urn:ietf:params:scim:schemas:oracle:idcs:extension:user:User": {
        "isFederatedUser": false,
        "preferredUiLandingPage": "MyApps"
    },
    "meta": {
        "created": "2024-10-24T19:07:26.810Z",
        "lastModified": "2024-10-24T19:07:26.810Z",
        "version": "ddf2b4979d704f3d813e2636630da678",
        "resourceType": "User",
        "location": "https://<domain_url>/admin/v1/Users/ocid1.user.oc1..<unique_id>"
    },
    "active": true,
    "displayName": "Barbara Jensen",
    "idcsLastModifiedBy": {
        "value": "<app_id>",
        "display": "Confidential App",
        "ocid": "ocid1.domainapp.oc1.<unique_id>",
        "type": "App",
        "$ref": "https://<domain_url>/admin/v1/Apps/<app_id>"
    },
    "name": {
        "givenName": "Barbara",
        "familyName": "Jensen",
        "formatted": "Barbara Jensen"
    },
    "urn:ietf:params:scim:schemas:oracle:idcs:extension:userState:User": {
        "locked": {
            "on": false
        }
    },
    "ocid": "ocid1.user.oc1..<unique_id>",
    "userName": "bjensen",
    "emails": [
        {
            "value": "bjensen@exmple.com",
            "type": "work",
            "secondary": false,
            "verified": false,
            "primary": true
        },
        {
            "value": "bjensen@exmple.com",
            "type": "recovery",
            "secondary": false,
            "verified": false,
            "primary": false
        }
    ],
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User",
        "urn:ietf:params:scim:schemas:oracle:idcs:extension:userState:User",
        "urn:ietf:params:scim:schemas:oracle:idcs:extension:user:User"
    ],
    "domainOcid": "ocid1.domain.oc1..<unique_id>",
    "compartmentOcid": "ocid1.compartment.oc1..<unique_id>",
    "tenancyOcid": "ocid1.tenancy.oc1..<unique_id>",
    "urn:ietf:params:scim:schemas:oracle:idcs:extension:capabilities:User": {
        "canUseApiKeys": true,
        "canUseAuthTokens": true,
        "canUseConsolePassword": true,
        "canUseCustomerSecretKeys": true,
        "canUseOAuth2ClientCredentials": true,
        "canUseSmtpCredentials": true,
        "canUseDbCredentials": true
    }
}
```

--------------------------------

### Install Kiali Add-on

Source: https://docs.oracle.com/en-us/iaas/Content/ContEng/Tasks/contengistio-intro-topic.htm

Applies the basic sample installation for Kiali with Istio.

```bash
kubectl apply -f samples/addons/kiali.yaml
```

--------------------------------

### Example curl Command with GET Method

Source: https://docs.oracle.com/en-us/iaas/Content/APIGateway/Tasks/apigatewayinvokingdeployedapi.htm

An example of a curl command using the GET method to call a specific API route. This demonstrates a concrete usage of the command structure.

```bash
curl -k -X GET https://lak...sjd.apigateway.us-phoenix-1.oci.customer-oci.com/marketing/hello/
```

--------------------------------

### Install Zipkin Add-on

Source: https://docs.oracle.com/en-us/iaas/Content/ContEng/Tasks/contengistio-intro-topic.htm

Applies the basic sample installation for Zipkin with Istio.

```bash
kubectl apply -f samples/addons/extras/zipkin.yaml
```

--------------------------------

### Install Optional Perftest Package

Source: https://docs.oracle.com/en-us/iaas/oracle-linux/uek/7/uek7.0-installation-and-availability.htm

Install the perftest package if it is required for your RDMA setup.

```bash
sudo dnf install perftest
```

--------------------------------

### Diagnostic Failed Output Example

Source: https://docs.oracle.com/en-us/iaas/jms/doc/using-installation-script-premise-mac.html

Example output when diagnostic checks fail, indicating issues that need to be resolved before proceeding with the installation. It highlights missing components like the Management Agent installer.

```text
======================================================================================================
Diagnostic Summary
======================================================================================================
User has sudo/root privileges? : Yes
Certified OS? : Yes
Meets minimum disk requirements? : Yes
Meets minimum memory requirements? : Yes
Able to reach OCI endpoint? : Yes
Certificate verification has been passed? : Yes
Is clock sync with OCI platform? : Yes
Available Java for agent installation ? : Yes
Management Agent installer available? : No
	Script JMS_YourFleetName_macos.sh can't find the Management Agent installer /kkk.
	Check if the path /kkk exists and check the '--use-agent-installer-path' parameter.
Existing Management Agent has been detected? : No
================================================================================
Diagnostics have failed. Please resolve all issues and run script JMS_YourFleetName_macos.sh again.
Please refer troubleshooting guide https://docs.oracle.com/en-us/iaas/jms/doc/troubleshooting.html for more details.

A copy of this installation log can be found at /Library/Oracle/JMSInstallScript/JMSInstallScriptLogs-<date>.log

```

--------------------------------

### CLI Example for Multipart Download

Source: https://docs.oracle.com/en-us/iaas/compute-cloud-at-customer/cmn/object/performing-a-multi-part-download.htm

This example demonstrates downloading the first 50 bytes of 'MyObject.mp4' to a local file. It shows the command execution and a sample output indicating download progress.

```bash
oci os object get    \
--namespace-name examplenamespace    \
--bucket-name MyBucket    \
--name MyObject.mp4    \
--file c:\\workspace\\Downloads\\MyObject.mp4    \
--range bytes=0-50
cusobjstorenamespace --range bytes=0-50
Downloading object [#-----------------------------------] 3%

# ls -l
total 12
-rw-r--r-- 1 root root 1363 Jun 1 17:56 abc.mp41
-rw-r--r-- 1 root root 51 Jun 1 21:50 def.mp4
-rw-r--r-- 1 root root 1363 Jun 1 21:40 ghi.mp4
-rw-r--r-- 1 root root 0 Jun 1 20:42 jkl.mp4
-rw-r--r-- 1 root root 0 Jun 1 20:42 mno.mp4
-rw-r--r-- 1 root root 0 Jun 1 20:42 pqr.mp4
```

--------------------------------

### GET Request and Response Example

Source: https://docs.oracle.com/en-us/iaas/Content/Identity/api-getstarted/OCISRequestBody.htm

This example demonstrates a GET request to retrieve user details and its corresponding JSON response. It highlights the structure of user information within the Identity Domains API.

```APIDOC
## GET /admin/v1/Users/{userid}

### Description
Retrieves the details of a specific user identified by their user ID.

### Method
GET

### Endpoint
/admin/v1/Users/{{userid}}

### Request Body
This method does not require a request body.

### Response
#### Success Response (200)
- **id** (string) - The unique identifier for the user.
- **displayName** (string) - The display name of the user.
- **userName** (string) - The username of the user.
- **emails** (array) - A list of email addresses associated with the user.
- **active** (boolean) - Indicates if the user account is active.
- **meta** (object) - Metadata about the user resource, including creation and modification times.
- **idcsCreatedBy** (object) - Information about the entity that created the user.
- **idcsLastModifiedBy** (object) - Information about the entity that last modified the user.
- **name** (object) - The name components of the user.
- **urn:ietf:params:scim:schemas:oracle:idcs:extension:user:User** (object) - Oracle specific user extensions.
- **urn:ietf:params:scim:schemas:oracle:idcs:extension:userState:User** (object) - Oracle specific user state extensions.
- **urn:ietf:params:scim:schemas:oracle:idcs:extension:capabilities:User** (object) - Oracle specific user capabilities extensions.

### Response Example
```json
{
    "idcsCreatedBy": {
        "type": "App",
        "display": "Confidential App",
        "value": "<app_id>",
        "ocid": "ocid1.domainapp.oc1.<unique_id>",
        "$ref": "https://<domain_url>/admin/v1/Apps/<app_id>"
    },
    "id": "<user_id>",
    "urn:ietf:params:scim:schemas:oracle:idcs:extension:user:User": {
        "isFederatedUser": false,
        "preferredUiLandingPage": "MyApps"
    },
    "meta": {
        "created": "2024-10-24T19:07:26.810Z",
        "lastModified": "2024-10-24T19:07:26.810Z",
        "version": "ddf2b4979d704f3d813e2636630da678",
        "resourceType": "User",
        "location": "https://<domain_url>/admin/v1/Users/ocid1.user.oc1..<unique_id>"
    },
    "active": true,
    "displayName": "Barbara Jensen",
    "idcsLastModifiedBy": {
        "value": "<app_id>",
        "display": "Confidential App",
        "ocid": "ocid1.domainapp.oc1.<unique_id>",
        "type": "App",
        "$ref": "https://<domain_url>/admin/v1/Apps/<app_id>"
    },
    "name": {
        "givenName": "Barbara",
        "familyName": "Jensen",
        "formatted": "Barbara Jensen"
    },
    "urn:ietf:params:scim:schemas:oracle:idcs:extension:userState:User": {
        "locked": {
            "on": false
        }
    },
    "ocid": "ocid1.user.oc1..<unique_id>",
    "userName": "bjensen",
    "emails": [
        {
            "value": "bjensen@exmple.com",
            "type": "work",
            "secondary": false,
            "verified": false,
            "primary": true
        },
        {
            "value": "bjensen@exmple.com",
            "type": "recovery",
            "secondary": false,
            "verified": false,
            "primary": false
        }
    ],
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User",
        "urn:ietf:params:scim:schemas:oracle:idcs:extension:userState:User",
        "urn:ietf:params:scim:schemas:oracle:idcs:extension:user:User"
    ],
    "domainOcid": "ocid1.domain.oc1..<unique_id>",
    "compartmentOcid": "ocid1.compartment.oc1..<unique_id>",
    "tenancyOcid": "ocid1.tenancy.oc1..<unique_id>",
    "urn:ietf:params:scim:schemas:oracle:idcs:extension:capabilities:User": {
        "canUseApiKeys": true,
        "canUseAuthTokens": true,
        "canUseConsolePassword": true,
        "canUseCustomerSecretKeys": true,
        "canUseOAuth2ClientCredentials": true,
        "canUseSmtpCredentials": true,
        "canUseDbCredentials": true
    }
}
```
```

--------------------------------

### Create API Deployment with Example Values

Source: https://docs.oracle.com/en-us/iaas/Content/APIGateway/Tasks/apigatewaycreatingdeployment.htm

An example of the create deployment command with sample values for compartment OCID, display name, gateway OCID, path prefix, and specification file location.

```bash
oci api-gateway deployment create --compartment-id ocid1.compartment.oc1..aaaaaaaa7______ysq --display-name "Marketing Deployment" --gateway-id ocid1.apigateway.oc1..aaaaaaaab______hga --path-prefix "/marketing" --specification file:///Users/jdoe/work/deployment.json
```

--------------------------------

### Example Cloud-Init File Reference

Source: https://docs.oracle.com/en-us/iaas/Content/ContEng/Tasks/contengusingcustomcloudinitscripts.htm

An example showing how to reference a local cloud-init file within the `--node-metadata` parameter. Replace 'my-custom-cloud-init.yaml' with your actual file name.

```bash
--node-metadata '{"user_data": "'$(cat my-custom-cloud-init.yaml | base64)'"}'
```