Archive Admin Bundle — ControlCenter Quick Tour¶
Introduced: v1.2 (PLAN-1614)
The Archive Admin Bundle is the consolidated ControlCenter view for all archive-related operations. It replaces the seven separate archive pages with a unified navigational shell and a live KPI dashboard.
Accessing the bundle¶
Navigate to ControlCenter → Archive (left nav). The bundle landing page is /Archive (the KPI dashboard). A persistent sticky secondary nav appears at the top of every archive page:
| Nav item | URL | Description |
|---|---|---|
| Dashboard | /Archive |
7-card KPI overview (live) |
| Archive Mode | /Archive/Mode |
Enable / disable archive mode per site |
| Identity | /Archive/Identity |
Identity resolution (user → archive mapping) |
| Import | /Archive/ImportProgress |
Per-farm import job progress |
| Audit Log | /Archive/AuditLog |
Live-tail event log with CSV export |
| Integrity | /Archive/Integrity |
Hash-walk status and mismatches |
| Retention | /Archive/Retention |
Retention anchor assignment and expiry |
| Legal Hold | /Archive/LegalHold |
Active holds, items under hold |
KPI Dashboard (/Archive)¶
The dashboard fetches GET /_api/archive/dashboard every 30 seconds and renders a card per section.
| Card | Key metrics shown |
|---|---|
| Archive Mode | Sites archived, recently-activated |
| Identity | Total principals resolved, pending |
| Import | Farms reporting, last import timestamp |
| Audit Log | Event rate (24 h), last event |
| Integrity | Items tracked, open mismatches |
| Retention | Items under retention, expiring in 7 d, blocked attempts (24 h) |
| Legal Hold | Active holds, items under hold, read-log mode |
All counts start at 0 for a fresh database — the card renders without error.
The SignalR hub at /signalr/archive-bundle streams SectionActivity messages. When any publisher (legal-hold, retention, integrity, audit-log) emits an event the corresponding card flashes briefly. The dashboard auto-reconnects on disconnect.
Legal Hold Audit page (/Archive/LegalHold/{holdId}/Audit)¶
Each legal hold listed on /Archive/LegalHold has a link to its audit trail. The audit page shows per-item read-access events with date-range filtering (from / to). Data comes from GET /_api/archive/legalhold/holds/{holdId}/read-access.
Import Progress page (/Archive/ImportProgress)¶
Shows per-farm import job progress. Polls GET /_api/archive/import-progress every 10 seconds. Displays farm name, total items, imported count, status, and last-updated timestamp. Handles empty state (no farms configured) gracefully.
Live updates (SignalR)¶
All bundle pages share the ArchiveBundleHub at /signalr/archive-bundle. The hub broadcasts to the archive-bundle-all group. Each page calls ArchiveBundle.setSectionRefresh(fn) to register a data-reload callback triggered on incoming SectionActivity messages that match the page's section.
Publishers that drive live updates:
- LegalHoldAuditPublisher — fires on hold applied / released / blocked access / read access
- RetentionAuditPublisher — fires on anchor assigned / delete blocked / window extended / expiry reached
- IntegrityAuditPublisher — fires on walk started / completed / mismatch / record created
- DurableAuditEventSink — fires on every audit-log emit
Related docs¶
- Archive Mode
- Archive Identity
- Archive Importer
- Archive Audit Log
- Archive Integrity
- Archive Retention
- Archive Legal Hold
See also: Archive Tools Operator Guide
See also: Tutorial G — SharePoint On-Premises Retirement Archive
See also: Cesivi Archive Variant A — Whitepaper
See also: Compliance Cookbook — HIPAA/GDPR/SOX/FRCP
See also: Archive Cluster Deployment Guide