# Pre-Include Binaries When Creating a Custom Package

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

1. Go to the Commvault Cloud Services Portal.

2. From the Command Center navigation pane, go to Manage > Settings > Advanced.

3. Click Custom package.

4. On the Profile tab, add or update profile information, and then click Next.

5. 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.

×

Loading...