# airec-netdevice

Part of **AIREC**

<!-- intent-backlink:auto -->

> 💡 **Path Selection**: This skill is one implementation path for [Configure network for AIRec deployment](../../intent/airec-configure-airec/SKILL.md). If you're unsure which path to take, check the routing skill first.

# AIRec Network Device Management Console Guide

## Operations Overview

| Operation | Console Entry | Prerequisites | Description |
|----------|---------------|---------------|-------------|
| Create Network Device List | Console > Network Planning > Create Network Device List | A network baseline version must be selected, Network baseline type must be configured, Access to the network planning module in the console | Compile a list of network devices by configuring baselines, calculating required hardware, and exporting device/IP lists |

## Step-by-Step Instructions

### Create Network Device List

**Navigation**: Console > Network Planning > Create Network Device List

**Prerequisites**:
- A network baseline version must be selected
- Network baseline type must be configured
- Access to the network planning module in the console

1. Select the network baseline version from the **Network Baseline Version** dropdown.
   - Element: **Network Baseline Version** (dropdown) — main content area

2. Select the network baseline type from the corresponding dropdown field.
   - Element: **Network Baseline Type** (dropdown) — main content area

3. Click the down-arrow button next to **Expand advanced options** to reveal additional configuration fields.
   - Element: **Expand advanced options** (button) — top-right corner

4. In the "Network Options for GE Access Switch" section, set the **Device Group Ratio** dropdown to "Not Required".
   - Element: **Device Group Ratio** (dropdown) — Network Options for GE Access Switch section
   - Notes: Default values are 0 for quantity adjustments and 48 for physical machine counts.

5. Adjust the number of GE access switches if needed using the **GE Access Switch Quantity Adjustment** field.
   - Element: **GE Access Switch Quantity Adjustment** (number_input) — under GE Access Switch options

6. Adjust the number of 10GE access switches if needed using the **10GE Access Switch Quantity Adjustment** field.
   - Element: **10GE Access Switch Quantity Adjustment** (number_input) — under 10GE Access Switch options

7. Optionally update the number of physical machines connected per GE or 10GE access switch port using the respective fields.
   - Element: **Number of physical machines in the lower port of ASW.GE in each group** (number_input)
   - Element: **Number of physical machines of lower port of each ASW.10GE** (number_input)

8. If using InfiniBand (IB) switches, adjust IBLeaf and IBSpine device counts as needed.
   - Element: **IBLeaf device quantity adjustment** (number_input)
   - Element: **IBSpine device adjustment** (number_input)

9. Click the **Calculate Network Devices** button to generate the device list.
   - Element: **Calculate Network Devices** (button) — center of the page
   - Notes: The result includes core devices, accessory devices, and detailed device information.

10. Optionally modify the manufacturer or quantity for core or accessory devices.
    - Element: **Core Device Manufacturer** (dropdown) — upper-right corner
    - Notes: When modifying quantity, a reason must be provided; otherwise, an error is returned.

11. Click **Complete planning and export equipment list** to proceed to the confirmation page.
    - Element: **Complete planning and export equipment list** (button) — bottom of the page

12. On the Planning proposal confirmation page, confirm the server software and network device lists, then click **Export IP address List**.
    - Element: **Export IP address List** (button) — main content area
    - Notes: Both exports are available on this page.

13. Click **Export Device List** to download the final device inventory.
    - Element: **Export Device List** (button) — main content area

| Parameter | Type | Required | Options/Values | Description |
|-----------|------|----------|----------------|-------------|
| Network Baseline Version | dropdown | Yes | — | Select the version of the network baseline to use for planning. |
| Network Baseline Type | dropdown | Yes | — | Choose the type of network baseline (e.g., standard, custom). |
| Device Group Ratio | dropdown | No | Required, Not Required | Defines whether device grouping is mandatory for access switches. |
| GE Access Switch Quantity Adjustment | number_input | No | — | Adjust the number of GE access switches. Default is 0. |
| 10GE Access Switch Quantity Adjustment | number_input | No | — | Adjust the number of 10GE access switches. Default is 0. |
| Number of physical machines in the lower port of ASW.GE in each group | number_input | No | — | Specifies how many physical machines connect to each GE access switch port. |
| Number of physical machines of lower port of each ASW.10GE | number_input | No | — | Specifies how many physical machines connect to each 10GE access switch port. |
| IBLeaf device quantity adjustment | number_input | No | — | Adjust the number of IBLeaf devices. Default is 0. |
| IBSpine device adjustment | number_input | No | — | Adjust the number of IBSpine devices. Default is 0. |

## FAQ

Q: Where can I find the option to export the device list after calculation?
A: After clicking "Complete planning and export equipment list", you are taken to the Planning proposal confirmation page, where both "Export IP address List" and "Export Device List" buttons are available in the main content area.

Q: What happens if I change the device quantity without providing a reason?
A: The system will return an error. A justification is required whenever you modify the calculated device quantity.

Q: Are the default values for physical machine counts per switch port configurable?
A: Yes, the fields "Number of physical machines in the lower port of ASW.GE in each group" and "Number of physical machines of lower port of each ASW.10GE" are editable number inputs with a default value of 48.

Q: Do modifications to device details after calculation affect billing?
A: No. Only the initial creation of the network device list (i.e., the calculation request) is billed. Modifications and exports do not incur additional charges.

Q: Can I skip the advanced options during device list creation?
A: Yes. The "Expand advanced options" section is optional. You can proceed directly to "Calculate Network Devices" using only the baseline version and type.

## Pricing & Billing

### Billing Model
Billing is based on a per-request model. Each creation of a network device list counts as one request.

### Price Reference
| Tier | Input Price | Output Price |
|------|-------------|--------------|
| standard | ¥0.001 per request | ¥0.002 per request |

### Free Tier
10 free requests per month.

### Billing Notes
Each creation of a network device list is counted as one request. Modification and export operations are not billed separately. There is a quota limit of 1,000 devices per calculation request.