Karios Forge - User Guide
0. Quick Overview
If you are new, use this section before the detailed goal-by-goal steps.
Karios Forge (BMO) is the management hub for bare-metal server provisioning and lifecycle management.
Canonical references in this guide:
Use 4.4. BMO Stage Flow from Dashboard for the lifecycle stage-to-action map.
Use 4.1. Read Summary Cards for the dashboard summary-card definitions.
Common workflows in this guide:
Add host with valid BMC details
Run
Hardware Revealfrom rowActionConfirm node enters
ReadyRun
Provisionfrom rowActionValidate management node details first
Validate server details from
Hardware InventoryOpen node
Consoleto monitor jobsRun
Unprovisiononly when recycling hardware
How to read this guide:
Treat 4.4. BMO Stage Flow from Dashboard as the only canonical lifecycle sequence.
Sections
5through11are task-based runbooks you use during that lifecycle or for maintenance; they are not extra lifecycle stages.Section
12is outcome-based troubleshooting.For a first-time node onboarding path, use
Access Forge -> Add Host -> Hardware Reveal -> Ready -> Provision -> Configured.
Common access checks
Use these checks when Forge does not open or the dashboard looks incomplete:
Confirm your current role can access Forge and run node lifecycle actions.
Refresh Control Center once and reopen Forge from the left navigation.
If cards or rows are still missing, verify that at least one node has been added and that your scope includes the target facility.
1. Overview
Karios Forge is the bare metal operations area used to onboard and manage physical nodes.
1.1. Core Terms (Read First)
BMC (Baseboard Management Controller): out-of-band management interface on the physical server used for remote power, console, and hardware control.
BMO (Baseboard Management Organization): management hub for bare-metal server provisioning and lifecycle management in Karios Forge.
Discovered: server is onboarded and reachable via BMC, but not yet provisioned.
Ready: server has completed hardware reveal and is ready for provision action.
Provision: server OS/platform state is deployed.
Configure: node is integrated and ready for production use.
For the canonical first-time lifecycle order, use 4.4. BMO Stage Flow from Dashboard.
1.2. What You Can Do from the Forge Dashboard
From the dashboard and node pages, you can:
Add/discover nodes
Open node details by lifecycle state
Run power actions (power on, power off, power cycle, force off)
Review management node Hardware Inventory, BIOS Config, and Firmware Updates
Run Hardware Reveal and validate server hardware inventory
Unprovision nodes when recycling hardware
Open node console directly for troubleshooting and boot visibility
1.3. Action Map by Node Stage
Use 4.4. BMO Stage Flow from Dashboard as the single lifecycle reference for stage-to-action mapping.
Note
Hardware Reveal is mandatory before first provisioning. Rerun it after BIOS, firmware, or hardware changes before final inventory validation.
2. Prerequisites
Before using Forge, confirm:
You have BMC IP, username, password
Target host is powered on and reachable on the BMC/management network before
Add Host
Warning
Invalid BMC details can prevent Forge workflows.
2.1. Required Access (RBAC)
Before running Forge workflows, confirm with your administrator that your account can access Forge and run these actions:
Add HostHardware RevealProvisionConfigureBIOS ConfigurationFirmware UpdatesConsoleUnprovision
3. Access Forge
When to Use:
Use this first before any node onboarding or maintenance workflow.
Purpose:
Open the Forge dashboard from the left navigation.
Steps:
Log in to Control Center.
Click the Forge icon in the left navigation.
Open the Forge dashboard.
Access Forge from the Control Center navigation.
What this screenshot shows:
Left sidebar navigation with the Forge entry icon.
What you can do from this screen:
Open Forge dashboard from navigation as the first step in all Forge workflows.
Expected Outcome:
Forge dashboard opens with summary cards and node table.
If this fails:
See Common access checks before retrying Forge access.
4. Understand the Dashboard (What to do first)
4.0. First Login Reality (Blank Dashboard)
When to Use:
Use this when Forge opens with no node rows visible.
Purpose:
Start node onboarding from an empty dashboard and reach Discovered state.
For first-time users, the Forge dashboard can be empty.
This is expected when no BMC endpoints are registered yet.
What to do next:
Click
Add Hoston the dashboard.Open the Add Host form.
Enter BMC details and submit.
Refresh dashboard and verify node appears in
Discovered.
Tip
If no nodes are visible, your first required action is adding BMC details using the form.
Expected Outcome:
A newly added node appears in
Discoveredand is ready forHardware Revealaction.
If this fails:
Confirm BMC IP, username, and password are valid.
Confirm BMC endpoint is reachable on management network.
Retry Add Host and refresh dashboard.
4.1. Read Summary Cards
When to Use:
Use this immediately after opening Forge dashboard.
Purpose:
Understand current lifecycle distribution before running actions.
Steps:
Open
Control Center -> Forge.Review each summary card value.
Use card values to choose the first node set to process.
All States: total nodes currently visible in Forge.
Discovered: node is reachable and discovered but not yet ready for provision action.
Ready: hardware reveal is complete and node is ready for provision action.
Provisioned: intermediate OS image-apply state.
Configured: node integrated and operational.
In Progress: background workflow is currently running.
Forge dashboard with lifecycle summary and nodes table.
What this screenshot shows:
Summary cards for lifecycle visibility:
All States,Discovered,Ready,Provisioned,Configured,In ProgressLifecycle filter cards that control table scope
Nodes table with key columns (for example
BMC IP,Vendor,Stage,Health,Console,Actions)
What you can do from this screen:
Select a lifecycle card to filter rows by stage.
Open node details from the node row (or eye icon).
Open node console from the
Consolecolumn.Start stage-appropriate action from node details (for example
Hardware Reveal) or the available node operation controls.
Expected Outcome:
You can identify which lifecycle stage requires action first.
If this fails:
Refresh dashboard data and recheck the summary cards.
Confirm nodes are visible in Forge and reload the page.
4.2. Use Lifecycle Filters (Cards)
When to Use:
Use this when you need to focus on one lifecycle stage at a time.
Purpose:
Filter the node table to the exact lifecycle stage you want to process.
Steps:
From the dashboard summary cards (shown in
4.1), select one lifecycle card:All,Discovered,Ready,Provisioned,Configured, orIn Progress.Confirm the table now shows only nodes in that stage.
Run the stage-appropriate action for those rows.
Expected Outcome:
Table rows match the selected lifecycle filter.
If this fails:
Clear and re-apply the filter.
Refresh the dashboard and retry.
4.2.2. Open Node Console from Dashboard
When to Use:
Use this when you need live boot/output visibility for a node before, during, or after lifecycle actions.
Purpose:
Open node console directly from the Forge dashboard without leaving table workflow.
Steps:
Open Forge dashboard.
Locate the node row in the table.
Click the icon in the
Consolecolumn.Observe boot/output state and return to dashboard for the next action.
Expected Outcome:
Console session opens for the selected node.
If this fails:
Refresh dashboard and retry from the same node row.
4.3. Open Dashboard Help
When to Use:
Use this when you need on-screen guidance for the Forge dashboard controls.
Purpose:
Open dashboard help content and review field/action definitions.
Steps:
Open
Control Center -> Forgedashboard.Click the help icon in the dashboard header.
Review definitions for summary cards, filters, and table actions.
Dashboard help view with operational guidance.
What this screenshot shows:
Help panel for dashboard cards, filters, and table actions.
On-screen definitions tied to dashboard UI elements.
What you can do from this screen:
Confirm the meaning of each dashboard card/filter before running lifecycle actions.
Validate action labels/intent before selecting row operations.
Expected Outcome:
Help content opens and explains dashboard elements before you proceed.
If this fails:
Refresh the page and reopen the dashboard.
4.4. BMO Stage Flow from Dashboard
When to Use:
Use this to run the BMO lifecycle in the correct order directly from dashboard stages.
Purpose:
Use the documented BMO lifecycle and map each stage to the dashboard action users should perform next.
Steps:
Start from
Discoverednodes.In the row
Actioncolumn, clickHardware Reveal.Monitor until the node moves to
Ready.In the row
Actioncolumn, clickProvision.Monitor until the node reaches
Configured.
Stage |
What It Means |
Action from Dashboard |
|---|---|---|
|
Server is discovered on network but not yet ready for provision action |
Run |
|
Hardware reveal has completed and server is ready for provisioning |
Run |
|
Provisioning or configuration job is currently running |
Monitor progress only; do not run concurrent disruptive actions on the same node |
|
Intermediate state where OS image is applied |
Continue monitoring and validate progression to |
|
Node is integrated and production-ready |
Validate final readiness and proceed with workload onboarding; use |
4.4.1. Move a Node from Discovered to Configured
When to Use:
Use this when a node is visible in Discovered stage and must be moved to production-ready Configured stage.
Purpose:
Use the canonical BMO lifecycle path and confirm the node reaches the expected end state.
Steps:
Confirm the server is present in
Discoveredwith valid BMC details.Follow 4.4. BMO Stage Flow from Dashboard without skipping stages.
Validate that the node reaches
Configuredand is ready for workload onboarding.
Expected Outcome:
Node reaches
Configuredstage and is ready for production workloads.
If this fails:
Server Not Discovered: verify power, BMC IP reachability, and IPMI port623path.Hardware Revealissue: retry the rowActionand monitor status progression.Provisioning start issue: recheck BMC credentials, Device ID, and IPAM prefix.
Provisioning completion issue: use node console to identify failed phase and retry only the failed step.
5. Goal 1 - Add a Node Successfully
5.1. Path
Forge -> Add Host -> Add Host form
5.2. Steps
When to Use:
Use this when a node is not yet visible in Forge and must be onboarded manually.
Purpose:
Start host onboarding from Forge and then use the Infrastructure add-host runbook as the canonical form guide.
Steps:
Click
Add Host.Use Add Host (Infrastructure canonical workflow) for the full
DetailsandReviewform procedure.Return to Forge and confirm the node appears in
Discovered.Continue the lifecycle using 4.4. BMO Stage Flow from Dashboard.
5.3. Expected Outcome
Node appears in table with
Discoveredstage and is ready forHardware Revealaction.
5.4. If this fails
Verify BMC IP is reachable
Verify username/password
Verify BMC network routing/firewall
If credentials are wrong, reopen the host entry flow and correct BMC details, then retry onboarding.
6. Goal 2 - Validate BMO Lifecycle Stage
6.1. Stage Map
When to Use:
Use this after opening Forge dashboard and before running stage workflows.
Purpose:
Validate each server is in the correct BMO stage and run the next stage action.
Steps:
Open
Control Center -> Forge.Identify the current stage in summary cards or the node table.
Run only the stage-appropriate action from the dashboard using 4.4. BMO Stage Flow from Dashboard.
Expected Outcome:
Servers follow the canonical stage-to-action mapping defined in 4.4. BMO Stage Flow from Dashboard.
If this fails:
Recheck current stage and action availability.
Confirm no conflicting workflow is already running.
6.2. Stage Checks
When to Use:
Use this when validating a specific stage before taking action.
Purpose:
Prevent wrong-stage actions and ensure the node follows the canonical lifecycle mapping.
Steps:
Identify the node’s current stage in the dashboard card or node table.
Use 4.4. BMO Stage Flow from Dashboard to determine the only valid next action.
Run that action or continue monitoring if the node is already in progress.
Expected Outcome:
Each node advances to the next expected stage without skipped prerequisites.
If this fails:
Re-run the failed stage action after correcting the root cause.
Use node console visibility for boot/progress troubleshooting.
6.3. Provision Inputs and Typical Timing
When to Use:
Use this before clicking Provision or when an operator asks what values and timeframes to expect.
Purpose:
Explain what the Provision action depends on, where node OS images come from, and how long common Forge actions usually take.
Provision input expectations:
OS / platform imagecomes from the environment’s approved bare-metal image catalog or release baseline. This is separate from VM templates and Boot Images used for virtual machines.Storageandresourcescome from the physical node inventory collected during 9.2. Standard Hardware Reveal Flow (Required in This Guide Path).Networkvalues depend on the site IPAM/prefix assignment and management-network policy used during onboarding.If the UI shows only one node image option, treat it as the site-approved default image for that environment.
If no valid image or network choice is available, stop and correct the catalog or site configuration before provisioning.
Typical operator timing guidance:
Action |
Typical Time |
Notes |
|---|---|---|
Add Host submission |
|
Form submission is quick; discovery visibility can take slightly longer after refresh. |
Hardware Reveal |
|
Depends on BMC responsiveness and hardware inventory size. |
Provision |
|
Depends on image transfer, storage speed, and network reachability. |
BIOS apply + reboot |
|
Management-node BIOS changes depend on vendor firmware behavior and POST time. |
Firmware update |
|
Management-node firmware updates are vendor- and version-dependent; always use a maintenance window. |
Hardware inventory refresh |
|
Run after reveal, BIOS changes, firmware changes, or hardware changes. |
Note
These are operator expectation ranges, not SLA guarantees. Firmware behavior, image download delays, or hardware validation can extend actual runtime.
7. Goal 3 - Review Management Node Details First
7.1. Path
Forge -> Dashboard -> Management server
Quick access:
Forge dashboard -> click the management node
Console quick access:
Forge table -> node row -> Console column icon
Use console when:
confirming boot device behavior
checking if node is responsive during power operations
7.2. Management Node Completion Check
Complete this check before reviewing server node details. The management node is the control-plane entry in Forge and should be validated first so server-node inventory is interpreted against the correct site and management context.
Steps:
Open the management node from the Forge dashboard or left node list.
Confirm the node is labeled as the management server.
Confirm power state, BMC address, vendor, and health are expected.
Complete the management-node Hardware Inventory, BIOS Config, and Firmware Updates checks below.
Return to the server node only after the management node details are correct.
Expected Outcome:
Management node details are reviewed and no unresolved health or identity mismatch remains before server-node inventory validation.
If this fails:
Refresh Forge and reopen the management node.
Verify BMC connectivity and management-network reachability.
Resolve management-node identity or health issues before continuing.
7.3. Management Node Hardware Inventory
When to Use:
Use this after opening the management node details page and before changing BIOS or firmware settings.
Purpose:
Confirm the management node inventory is current before applying configuration or maintenance changes.
Steps:
Open the management node details page.
Open
Hardware Inventory.Click
Get latest hardware.Review device, network, storage, and component information.
Management node hardware inventory.
Expected Outcome:
Management node inventory is current and matches the expected hardware.
7.4. Management Node BIOS Config
When to Use:
Use this when management-node BIOS values must be reviewed or adjusted before final validation.
Purpose:
Confirm required virtualization and boot-related BIOS values on the management node.
Steps:
Open the management node details page.
Open
BIOS Config.Review summary counts for total, enabled, disabled, and pending BIOS settings.
Review the
BIOS Configuration Managementpanel.Apply changes only during an approved maintenance window.
Restart the server if BIOS changes require activation.
Management node BIOS configuration.
Expected Outcome:
BIOS values are reviewed, required changes are applied, and the node returns to a stable state after any required reboot.
7.5. Management Node Firmware Updates
When to Use:
Use this when management-node BMC or BIOS firmware must be reviewed or updated.
Purpose:
Confirm current BMC/BIOS firmware versions and apply vendor-approved updates when required.
Steps:
Open the management node details page.
Open
Firmware Updates.Use
Firmware Downloadsto access the vendor firmware source.Review current BMC and BIOS firmware model/version values.
Upload only vendor-approved firmware for the exact server model.
Refresh and verify firmware status and audit history after update.
Management node firmware update overview.
Expected Outcome:
Firmware versions and health are verified, and any approved update completes successfully before server-node validation continues.
If this fails:
Re-check firmware file compatibility with the exact management-node model.
Confirm the management node is healthy before retrying the update.
Retry only inside an approved maintenance window.
7.6. Management Node Details Actions Reference
Location / Action |
What It Does |
When To Use |
|---|---|---|
Hardware Inventory -> |
Pulls the latest management-node inventory data. |
After reveal, BIOS changes, firmware changes, or physical hardware changes. |
BIOS Config -> |
Saves selected BIOS values as pending settings. |
After approved BIOS value changes. |
BIOS Config -> reboot/power action |
Restarts the node so BIOS updates take effect. |
When the UI indicates a reboot is required. |
Firmware Updates -> |
Reloads firmware version and health from the node. |
Before and after firmware work. |
Firmware Updates -> upload/update |
Uploads and applies vendor firmware binaries. |
Approved BMC or BIOS firmware maintenance. |
8. Goal 4 - Review Server Node Details
8.1. Path
Forge -> Node Details -> Hardware Inventory
Quick access:
Forge dashboard -> click target server node
8.2. Current Server Details Layout
The current server node details page exposes the Hardware Inventory tab only.
It does not show separate BIOS Config or Firmware Updates tabs.
Server node details with Hardware Inventory selected.
UI components in this screen:
Header: node breadcrumb, node name, power state, favorite, and
UnprovisionNode summary:
BMC IPandVendorActive tab:
Hardware InventoryGet latest hardwarebutton: refreshes inventory from the selected nodeDevice Information: device ID, name, type, manufacturer, status, role, and U height
Location Information: site, location, rack, and position
Network Interfaces: BMC, bridge, and physical interface rows with MAC, status, description, and IP data
Storage Devices: discovered disks with role, manufacturer, and description
Other Inventory Items: additional discovered hardware components
What this screenshot shows:
Server node details currently focus on hardware inventory validation.
The available detail tab is
Hardware Inventory.The header still provides power state visibility and the
Unprovisionlifecycle reset action.
What you can do from this screen:
Click
Get latest hardwareafter Hardware Reveal or hardware replacement.Confirm identity, BMC address, vendor, location, network interfaces, and storage devices.
Use
Unprovisiononly when recycling or re-onboarding the node.
Expected Outcome:
Node details match the physical server and site inventory records.
If this fails:
Refresh node details and click
Get latest hardwareagain.Verify BMC connectivity for the target node.
Re-run
Hardware Revealfrom the dashboard row action if inventory is stale.
8.3. Server Node Details Actions Reference (New User)
Use this section when you are already inside a node details page.
Location / Action |
What It Does |
When To Use |
Expected Result |
|---|---|---|---|
Dashboard Row -> |
Starts hardware reveal for discovered nodes. |
Immediately after node enters |
Node transitions to |
Hardware Inventory -> |
Pulls latest inventory data from the node. |
After reveal or hardware changes. |
Updated component data appears. |
Node Details -> |
Starts destructive reset to reusable state. |
Recycling host or re-onboarding. |
Node exits current configured/provisioned usage. |
9. Goal 5 - Run Hardware Reveal and Collect Data
9.1. Path
Forge -> Dashboard -> Discovered row -> Action -> Hardware Reveal
Quick access:
Forge table -> node row -> Action -> Hardware Reveal
Forge dashboard with row Action controls.
What this screenshot shows:
Lifecycle cards including
DiscoveredandReady.Actioncolumn in node rows.Hardware Revealaction available for discovered rows.
What you can do from this screen:
Select discovered rows and run
Hardware RevealfromAction.Monitor stage progression from
DiscoveredtoReady.
9.2. Standard Hardware Reveal Flow (Required in This Guide Path)
When to Use:
Use this after a node appears in Discovered and before running Provision.
Purpose:
Capture hardware facts required for provisioning and move node to Ready.
Filter dashboard to
Discovered.In the node row
Actioncolumn, clickHardware Reveal.Monitor operation status and use
Consoleif progress must be validated.Refresh dashboard and confirm node stage changes to
Ready.
Note
Hardware Reveal typically completes in 1-5 minutes. If the node has not
reached Ready after roughly 10 minutes, stop waiting passively and use
the troubleshooting checks below.
Expected Outcome:
Hardware data becomes available for the node.
Node stage changes from
DiscoveredtoReady.
If this fails:
Retry
Hardware Revealfrom the rowActionbutton.Verify node health/BMC connectivity.
Open the
Consolecolumn action and verify operation output.
10. Goal 6 - Validate Hardware Inventory
This step must follow the standard Hardware Reveal flow from Section 9.2.
10.1. Path
Control Center -> Forge -> Dashboard -> Select Node -> Hardware Inventory
Quick access:
Forge dashboard -> click target node -> Hardware Inventory
When to Use:
Use this immediately after completing Hardware Reveal or replacing server hardware.
Purpose:
Confirm discovered hardware and network inventory matches the physical server.
Steps:
Open the target node details page.
Click
Get latest hardware.Review device, location, network interface, storage device, and other inventory sections.
Use the server node details screen shown in Section 8.2.
What this screenshot shows:
Server node details with the
Hardware Inventorytab selected.Hardware sections shown include device information, location information, network interfaces, storage devices, and other inventory items.
Node details header actions include
Unprovisionfor lifecycle reset workflow.
What you can do from this screen:
Click
Get latest hardwareand review collected inventory for the selected node.Validate hardware details after a reveal run.
Use
Unprovisionfrom the header when the node must be reset/recycled.
UI components in this screen:
Get latest hardwarebutton: pulls latest inventory from the nodeDevice Information section
Location Information section
Network interfaces section
Storage Devices section
Other Inventory Items section
Unprovisionbutton in node details header
Hardware Inventory actions (what and why):
Get latest hardware: reloads latest inventory data for the node. Why: use after Hardware Reveal or physical hardware changes.
10.2. What to Validate
Device identity and vendor are correct
Location, rack, and position are correct
Network interface details are correct
Storage device details are correct
Other inventory items are present as expected
Expected Outcome:
Inventory matches physical server.
Action checklist on this page:
Click
Get latest hardwareafter Hardware Reveal completes.Verify timestamp updated.
Review device, location, network interface, storage device, and other inventory sections.
If mismatch is found, return to
Hardware Revealand rerun discovery.
If this fails:
Re-run Hardware Reveal
Verify the physical device and BMC target are correct
Click
Get latest hardwareagain after 5 minutes
11. Goal 7 - Unprovision Safely (When Needed)
11.1. Path
Forge -> Node details -> top-right Unprovision button
Quick access:
Forge -> click node -> Unprovision (top-right in node details)
UI components in this screen:
Unprovisionbutton: starts destructive reset workflowConfirmation dialog: final safety checkpoint before execution
Warning text: shows impact (OS/config/data removal)
11.2. Steps
When to Use:
Use this only when a node must be reset/recycled.
Purpose:
Safely remove OS/workload state and return node to intake lifecycle for re-onboarding.
Backup data.
Migrate workloads.
Confirm maintenance window.
Click
Unprovisionand confirm.
Expected Outcome:
Node returns to reusable intake lifecycle state
Discovered.
Warning
Unprovisioning is destructive for OS/workload data on the node.
If this fails:
Verify node is reachable in BMC console.
Reopen node details and retry
Unprovision.Confirm no conflicting workflow is currently running on the node.
12. Quick Troubleshooting by Outcome
12.1. Node cannot be added
Check BMC IP reachability
Check BMC credentials
Check management VLAN/firewall
12.2. Power actions fail
Validate BMC login directly
Retry after session refresh
Verify node/BMC is not in error state
Open node console from the
Consolecolumn icon to verify host responsiveness
12.3. Reveal has no data
Re-run
Hardware Revealfrom the rowActionbuttonVerify node is in
Discoveredbefore retryUse the console icon to confirm action progress/output
Refresh dashboard and confirm stage transition
12.4. Inventory incomplete
Re-run reveal
Verify the node details page points to the expected server
Click
Get latest hardwareand wait for refresh completion
13. Quick Action Map
Add host:
Forge -> Add HostOpen node:
Forge -> click nodeStage check:
Forge -> Discovered card/filter -> run Hardware Reveal (Action)Provision node:
Forge dashboard -> Ready row -> Action -> ProvisionReady-to-provision path:
Discovered -> Hardware Reveal (Action) -> Ready -> Provision (Action)Open console:
Forge table -> Console column iconReveal:
Forge table -> node row -> Action -> Hardware RevealInventory:
Node details -> Hardware InventoryUnprovision:
Node details -> Unprovision(top-right)
14. New User Journey (First Operational Run)
Use this checklist for your first node from start to configured-and-validated state.
14.1. First Run Sequence
Open
Forgeand filterDiscovered.If node is missing, use
Add Hostto add host with BMC details.Run
Hardware Revealfrom rowActionand confirm stage becomesReady.In node row
Action, runProvision.Wait and confirm node appears in
Configured.Open and complete the management node details checks from Sections
7.2through7.5.Open the server node details page from Section
8.2.Run required validation checks:
run standard Hardware Reveal flow from Section
9.2validate Hardware Inventory in Section
10
Open the
Consolecolumn icon and verify node boot/output health.Confirm health is green and inventory matches hardware.
14.2. Done Criteria (New User Success)
A node is ready for normal operations when all are true:
Stage is
ConfiguredHealth is green/OK
Hardware Reveal completed successfully
Hardware Inventory matches expected components
→ Next: Network