In secure or offline environments, installations can fail when required media cannot be downloaded. Common symptoms include the following:
- Roles Configuration unable to complete
- Failed to download required binaries
- Unable to reach Commvault Download Center
The Pre-include binaries to create package option embeds all required binaries directly in the custom package, allowing installation to complete without external downloads. This option is intended for restricted, air-gapped, and dark-site environments.
When enabled, Commvault does the following:
- Collects all binaries needed for the selected roles (for example, Databases/SQL Server, MediaAgent, cloud app agents, File Server).
- Bundles these binaries into the package so no downloads are required during installation.
- Ensures successful installation in dark sites, offline networks, and environments without Software Cache or Download Center access.
Behavior Comparison
| Feature | Without Pre-Include | With Pre-Include |
|---|---|---|
| Internet required at install | Yes | No |
| Downloads during install | Yes | None |
| Package size | Smaller | Larger |
| Dark-site friendly | Not supported | Fully supported |
| Success rate in restricted networks | Low | Very high |
Important
Enabling this option increases package size, especially when database components are included.
Use Pre-include binaries for the following:
- Air-gapped or offline environments
- Dark-site deployments
- Highly restricted or government networks
Avoid using it for internet-connected endpoints where downloads are permitted.
Prerequisites and Considerations
- Confirm whether the environment has internet or software cache access.
- Select the roles (File Server, SQL Server, MediaAgent, etc.) to include in the package.
- Account for the larger package size when pre-including binaries.
Procedure
-
Go to the Commvault Cloud Services Portal.
-
From the Command Center navigation pane, go to Manage > Settings > Advanced.
-
Click Custom package.
-
On the Profile tab, add or update profile information, and then click Next.
-
On the Roles tab, select Pre-include binaries to create package.
What to Do Next
Continue configuring the package by selecting the required roles and options. For more information, see Creating a Custom Package for a Server.