adding custom iso scripts and model deployment guides

Signed-off-by: Harika <codewith3@gmail.com>

Author: Harika

third_party/Dell/README.md

@@ -8,11 +8,38 @@ The solution cleanly separates:
 - Boot orchestration (Terraform)
 - Post-OS configuration and inference deployment
 
-It is designed for repeatable, resumable, and operator-friendly deployments.
+---
+
+## 0. Create Custom Ubuntu ISO (Optional but Recommended)
+
+**Script:** [custom-iso.sh](./iso/custom-iso.sh)
+
+Before mounting the Ubuntu ISO to iDRAC, you may optionally generate a custom Ubuntu 22.04.5 ISO designed for fully unattended installation.
+
+This enables a zero-touch, fully automated OS installation, eliminating manual input during setup and ensuring consistent, repeatable provisioning.
+
+**Host Your Custom ISO (Recommended for Automation)**
+
+After generating the ISO:
+
+1. Upload it to a web-accessible location (e.g., Firebase Hosting, internal web server, object storage, or any HTTP/HTTPS file server).
+
+2. Ensure the ISO is reachable via a public or internally accessible HTTP/HTTPS URL.
+
+3. Save this URL — it will be required in the next step when mounting the ISO using iDRAC Redfish Virtual Media.
+
+Example:
+```bash
+https://your-domain.com/ubuntu-22.04.5-custom.iso
+```
+
+If you already have a prebuilt ISO hosted and accessible via HTTP/HTTPS, you may skip this step and proceed to Step 1: Mount Ubuntu ISO.
+
+For detailed instructions on building a custom ISO, refer to: [ISO Creation Guide](./iso/README.md)
 
 ---
 
-### 1. Mount Ubuntu ISO (iDRAC Redfish)
+## 1. Mount Ubuntu ISO (iDRAC Redfish)
 
 **Script:** [iac/mount-iso.sh](./mount-iso.sh)
 
@@ -27,6 +54,19 @@ export IDRAC_IP=100.67.x.x
 export IDRAC_USER=root
 export IDRAC_PASS=calvin
 ```
+**Specify Custom ISO URL**
+
+If you created and hosted a custom ISO in above step, pass its HTTP/HTTPS URL using:
+```bash
+export ISO_URL=https://your-domain.com/ubuntu-22.04.5-custom.iso
+```
+
+This should be the URL you generated and hosted in the previous step.
+
+You may also use any internally hosted ISO that is reachable by iDRAC.
+
+> Note: If ISO_URL is not provided, the script will automatically use the default Ubuntu 22.04 Live Server ISO. it will Launch the standard installer and Prompt for manual user input during OS installation.
+
 **Mount ISO**
 ```bash
 chmod +x mount-iso.sh
@@ -40,15 +80,9 @@ chmod +x mount-iso.sh
 
 Terraform uses the **Dell Redfish provider** to configure a **one-time boot from Virtual Media (CD)** and **force a reboot**.
 
-Key Notes
-- ISO must already be mounted using mount-iso.sh
-- Boot override is set to Once
-- Power reset is forced using redfish_power
-- Boot mode (UEFI/Legacy) is not configurable on 17G servers
-
 **Terraform Installation (Client Machine)**
 
-> **Note:** Terraform is executed from a client machine (such as your laptop or a jump host), not from the target server or iDRAC.
+Terraform is executed from a client machine (such as your laptop or a jump host), not from the target server or iDRAC.
 
 Install Terraform on the machine where you will run the Terraform commands.
 
@@ -99,18 +133,6 @@ Once OS is installed, Download the deploy-enterprise-inference.sh script to your
 
 This script performs **all post-OS configuration** and deploys the **Enterprise Inference stack** on a **single node**.
 
-**Key Features**
-- Resume / checkpoint support
-- Safe to re-run after failure
-- CPU or Gaudi3 support
-- Automated configuration of:
-    - Packages
-    - Repo clone + branch checkout
-    - Inventory & config files
-    - Firmware & kernel tuning (Gaudi3)
-    - SSH, sudo, certificates
-    - Final inference stack deployment
-
 **Change permission to your file**
 
 ```bash
@@ -127,19 +149,24 @@ sudo ./deploy-enterprise-inference.sh \
 -a cluster-url \
 -m "1" \
 ```
- 
-| Option |	Description | 
-| -------| ------------ |
-| -u	| OS username |
-| -p    | OS userpassword |
-| -t	| Hugging Face token |
-| -g	| gaudi3 or cpu |
-| -m	| Choose model ID from [Pre-Integrated Models List](#pre-integrated-models-list) , based on your deployment type (gaudi or cpu) |
-| -b	| Repo branch (default: release-1.4.0) |
-| -a    | cluster -url  |
-| -r	| Resume from last checkpoint |
-| -d    | keycloak or genai, by default set to keycloak |
-| -o    | off or on, by default observability set to off |
+### Options & Defaults
+
+| Option | Required | Default | Description |
+|--------|----------|----------|-------------|
+| `-u, --username` | Yes (deploy & uninstall) | (none) | Enterprise Inference owner username. Must match the invoking (sudo) user. |
+| `-t, --token` | Yes (deploy only) | (none) | Hugging Face access token used to validate and download selected models. |
+| `-p, --password` | No | `Linux123!` | User sudo password used for Ansible become operations. |
+| `-g, --gpu-type` | No | `gaudi3` | Deployment target type: `gaudi3` or `cpu`. |
+| `-m, --models` | No | `""` (interactive mode) | Choose model ID from [Pre-Integrated Models List](#pre-integrated-models-list) , based on your deployment type (gaudi or cpu) . If not provided, deployment runs interactively. |
+| `-b, --branch` | No | `release-1.4.0` | Git branch of the Enterprise-Inference repository to clone. |
+| `-f, --firmware-version` | No | `1.22.1` | Gaudi3 firmware version (applies only when `-g gaudi3`). |
+| `-d, --deployment-mode` | No | `keycloak` | Deployment mode: `keycloak` (Keycloak + APISIX) or `genai` (GenAI Gateway). |
+| `-o, --observability` | No | `off` | Enable observability components: `on` or `off`. |
+| `-r, --resume` | No | Auto-detected | Resume deployment from last checkpoint if state file exists. |
+| `-s, --state-file` | No | `/tmp/ei-deploy.state` | Custom path for deployment state tracking file. |
+| `-a, --api-fqdn` | No | `api.example.com` | API Fully Qualified Domain Name used for `/etc/hosts` and TLS certificate generation. |
+| `uninstall` | Yes (for uninstall action) | (none) | Removes deployed Enterprise Inference stack and cleans up state. |
+
 
 **Resume After Failure**
 
@@ -269,6 +296,7 @@ if EI is deployed with apisix, follow [Testing EI model with apisix](../EI/singl
 if EI is deployed with genai, follow [Testing EI model with genai](../EI/single-node/user-guide-genai.md#5-test-the-inference) for generating api-key and testing the inference
 
 ---
+
 ## Additional Information
 
 ### Pre-Integrated Models List
@@ -321,5 +349,3 @@ Refer to the [Model Deployment guide](./model-deployment.md) and run the interac
 This repository provides a clean, deterministic, enterprise-grade deployment pipeline for:
 
 Bare-metal Ubuntu + Enterprise Inference (CPU/Gaudi3)
-
-

third_party/Dell/ubuntu-22.04/iac/README.md

@@ -0,0 +1,110 @@
+# Ubuntu Autoinstall ISO Builder
+
+This provides a single script (`custom-iso.sh`) that builds an Ubuntu Server autoinstall ISO. The script:
+
+- Generates `user-data` and `meta-data` on the fly from CLI options.
+- Accepts a local ISO file path or downloads an ISO from a URL.
+- Preserves boot settings from the input ISO so the output remains bootable.
+
+## Prerequisites
+
+### Linux
+- `bash`
+- `curl`
+- `rsync`
+- `xorriso`
+- `sudo`
+- `mount`/`umount`
+
+Example (Ubuntu/Debian):
+
+```bash
+sudo apt-get update
+sudo apt-get install -y curl rsync xorriso
+```
+
+### macOS
+- `bash` (default)
+- `curl` (default)
+- `rsync` (Homebrew recommended)
+- `xorriso` (Homebrew)
+
+Install on macOS:
+
+```bash
+brew install xorriso rsync
+```
+
+## Usage
+
+The script requires `--hostname`, `--username`, and `--password-hash`. All other values have defaults.
+
+Basic example using a local ISO:
+
+```bash
+./custom-iso.sh \
+  --hostname=ubuntu-server-001 \
+  --username=user \
+  --iso=./ubuntu-22.04.5-live-server-amd64.iso
+```
+
+Full example with all options:
+
+```bash
+./custom-iso.sh \
+  --hostname=ubuntu-server-001 \
+  --username=user \
+  --password-hash='$6$Sl0xydNgA3rBk1Uo$Pj7oVVI7smkdBh20V8EyLivWpKDHFueUhvrfwxundGp/DQrAuTHjIxnrCZIMVJ1zcTIJ7VgIWKu0mUZmiRsqv0' \
+  --ssh-key='' \
+  --timezone=America/Chicago \
+  --locale=en_US.UTF-8 \
+  --kbd-layout=us \
+  --kbd-variant='' \
+  --storage-layout=direct \
+  --instance-id=ubuntu-server-001 \
+  --packages='' \
+  --iso=./ubuntu-22.04.5-live-server-amd64.iso \
+  --iso-url=https://releases.ubuntu.com/jammy/ubuntu-22.04.5-live-server-amd64.iso \
+  --iso-name=ubuntu-22.04.5-live-server-amd64.iso \
+  --out-iso=ubuntu-22.04.5-autoinstall.iso \
+  --volid=Ubuntu-Server-22.04.5-AI
+```
+
+Notes:
+- If `--iso` is provided, `--iso-url` and `--iso-name` are ignored.
+- If `--ssh-key` is empty, no SSH key is embedded.
+- `--packages` is a comma-separated list (e.g., `--packages=openssh-server,curl`).
+- `--volid` must be 32 characters or fewer.
+
+## Options and Defaults
+
+| Option | Required | Default | Description |
+|---|---|---|---|
+| `--hostname` | Yes | (none) | Hostname for the installed system. |
+| `--username` | Yes | (none) | Primary user name. |
+| `--password-hash` | Yes | (none) | SHA-512 password hash for the user. |
+| `--ssh-key` | No | `""` | SSH public key (optional). |
+| `--timezone` | No | `America/Chicago` | System timezone. |
+| `--locale` | No | `en_US.UTF-8` | Locale. |
+| `--kbd-layout` | No | `us` | Keyboard layout. |
+| `--kbd-variant` | No | `""` | Keyboard variant (optional). |
+| `--storage-layout` | No | `direct` | Storage layout. Use `direct` for whole disk or `lvm`. |
+| `--instance-id` | No | `ubuntu-server-001` | Cloud-init instance ID. |
+| `--packages` | No | `""` | Comma-separated package list. |
+| `--iso` | No | `""` | Local ISO file path. |
+| `--iso-url` | No | Ubuntu 22.04.5 URL | Download ISO from URL. |
+| `--iso-name` | No | `ubuntu-22.04.5-live-server-amd64.iso` | Filename for downloaded ISO. |
+| `--out-iso` | No | `ubuntu-22.04.5-autoinstall.iso` | Output ISO filename. |
+| `--volid` | No | `Ubuntu-Server-22.04.5-AI` | ISO volume ID (max 32 chars). |
+
+## Output
+
+The script writes the rebuilt ISO to the path specified by `--out-iso` (default `ubuntu-22.04.5-autoinstall.iso`).
+
+## UTM Test Notes (macOS)
+
+If testing in UTM and you see a `Shell>` prompt:
+- On Apple Silicon, you must use **Emulate → x86_64** for this amd64 ISO.
+- In the UEFI shell, type `exit`, then select the CD/DVD boot entry.
+
+If the installer logs repeatedly mention networking updates, verify UTM’s network mode is set to **Shared** or **Bridged**.