Understanding Versions with Update Server #
The DMSI Update Server extension builds on core DDLS's Versions system to add software update delivery capabilities.
What This Extension Adds #
Core DMSI-DDLS lets you create versions and track downloads from the customer portal. With DMSI Update Server, each version also holds a release file, rollout percentage, channel assignment, and compatibility requirements — so your customers' software can automatically check for and receive updates without visiting the portal.
What Is New in the Versions Screen #
When the extension is active, the Versions screen gains two new columns:
| Column | Description |
|---|---|
| Rollout | The staged rollout percentage for this version (e.g., "25%" or "100%") |
| Downloads | Auto-update download count (separate from portal downloads) |
The "Downloads" column shows how many times clients downloaded this version through the Update Server API, not through the customer portal.
The Complete Version Lifecycle with Update Server #
1. Create version in DDLS > Versions
2. Extension sets defaults: channel=stable, rollout=100%
3. Configure Update Server Settings on the version edit form:
- Assign channel (stable / beta / alpha)
- Set rollout percentage (1-100)
- Upload release ZIP file
- Set compatibility requirements
- Toggle email notification
4. Publish version
5. If email notification is on: emails queue for all active license holders
6. Clients with installed software check API -> receive update notification
7. Clients download file via HMAC-signed token
8. Version Tracking table updates: records which version each license is running
For Licensed Products Only #
The Update Server API requires a valid license key on every request. It does not serve updates for non-licensed products. Non-licensed products continue to use core DDLS downloads only.