Skip to content

Commit 3e56757

Browse files
committed
docs: Scaling: Update performance expectations
Remove the bogus time calculations - we've observed much, much faster. Update the number of provisioning heads that one competent person can service.
1 parent a8b439f commit 3e56757

File tree

1 file changed

+4
-34
lines changed

1 file changed

+4
-34
lines changed

docs/mass-provisioning-guidance/scaling.adoc

Lines changed: 4 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ USB connectivity is **mandatory** for all provisioning operations as it provides
1616

1717
* **Secure Boot Enablement**: USB connection is the only supported method for configuring secure boot on Raspberry Pi devices
1818
* **System Bootstrapping**: Initial system configuration and image deployment requires USB connectivity
19-
* **Security Isolation**: USB provides a controlled, isolated communication channel for sensitive provisioning operations
19+
* **Security Isolation**: Point-to-point USB provides a controlled, isolated communication channel for sensitive provisioning operations
2020

2121
Each provisioning head requires a dedicated USB connection to the target Raspberry Pi device.
2222

@@ -32,7 +32,7 @@ Ethernet connectivity is **optional** and provides **only one benefit**:
3232

3333
When utilizing Ethernet connectivity:
3434

35-
* **DHCPv4 Support**: Network must provide automatic DHCPv4 address assignment
35+
* **DHCPv4/v6 Support**: Network must provide automatic DHCPv4/v6 address assignment
3636
* **Routing**: Network must be routable to the machine running rpi-sb-provisioner
3737
* **Firewall**: Ensure provisioning service ports are accessible (refer to API endpoints documentation)
3838
* **Bandwidth**: Sufficient bandwidth to support concurrent image transfers during provisioning
@@ -77,7 +77,7 @@ This natural timing alignment means that once the pipeline is established, opera
7777
Based on Raspberry Pi Ltd testing with a **2.6GB system image**:
7878

7979
* **Provisioning Time**: Approximately **2.5 minutes per device** for a 2.6GB image
80-
* **Operator Capacity**: One operator can effectively service up to **5 provisioning heads**
80+
* **Operator Capacity**: One operator can effectively service up to **7 provisioning heads**
8181
* **Image Size Impact**: Larger system images will increase provisioning time proportionally
8282
* **Full-Disk Encryption**: Provisioning FDE-enabled systems will be slower than naked provisioning (where no encryption is performed)
8383
* **Transfer vs. Write Performance**: Ethernet can accelerate image transfer time but cannot reduce the time required to write data to storage
@@ -92,36 +92,6 @@ To maximize provisioning throughput:
9292
. **Network Optimization**: Configure low-latency, high-bandwidth network infrastructure
9393
. **Process Standardization**: Develop standardized operator procedures and workflows
9494

95-
== Scaling Recommendations
96-
97-
=== Small Scale Operations (1-50 devices)
98-
99-
* **Setup**: Single provisioning station with 2-3 heads
100-
* **Operators**: 1 operator
101-
* **Strategy**: Pipelined provisioning
102-
* **Expected Throughput**: ~24 devices per hour with optimal pipelined operation (2.5 min/device)
103-
* **Duration**: 1-2 days for complete deployment
104-
105-
=== Medium Scale Operations (50-500 devices)
106-
107-
* **Setup**: 2-3 provisioning stations with 3-5 heads each
108-
* **Operators**: 2-3 operators
109-
* **Strategy**: Pipelined provisioning with staggered start times
110-
* **Infrastructure**: Dedicated provisioning network segment
111-
* **Duration**: 1-2 weeks for complete deployment
112-
113-
=== Large Scale Operations (500+ devices)
114-
115-
* **Setup**: Multiple provisioning stations (5+ heads each)
116-
* **Operators**: 1 operator per 5 provisioning heads
117-
* **Strategy**: Coordinated pipelined provisioning across multiple stations
118-
* **Infrastructure**:
119-
- Dedicated provisioning network with redundancy
120-
- Centralized image and configuration management
121-
- Quality assurance checkpoints
122-
* **Monitoring**: Real-time provisioning status and error tracking
123-
* **Duration**: Varies based on scale and infrastructure
124-
12595
== Infrastructure Considerations
12696

12797
=== Hardware Requirements
@@ -190,4 +160,4 @@ Track key performance indicators:
190160

191161
Successful mass provisioning requires careful consideration of connection requirements, provisioning strategies, and infrastructure scaling. Pipelined provisioning with proper operator-to-head ratios provides optimal efficiency while maintaining security and quality standards.
192162

193-
For specific implementation questions or advanced scaling scenarios, consult the API endpoints and configuration variable documentation for detailed technical requirements.
163+
For specific implementation questions or advanced scaling scenarios, consult the API endpoints and configuration variable documentation for detailed technical requirements.

0 commit comments

Comments
 (0)