Sideloading bundles to SDDC Manager
search cancel

Sideloading bundles to SDDC Manager

book

Article ID: 399107

calendar_today

Updated On:

Products

VMware SDDC Manager

Issue/Introduction

During a darksite deployment of SDDC when an offline depot is unable to be configured, bundles may need to be loaded into the SDDC manager.  This article covers the basic steps required to load these bundles into SDDC.

Environment

5.2.1

Resolution

1. Identify the bundle IDs that will be required for the patch / upgrades.  Refer to the following documentation to make that identification.  

VMware Cloud Foundation - Upgrade Bundle Details

Applying individual product updates to VMware Cloud Foundation environments using Async Patch Tool (AP Tool)

In our example, we will use the NSX-T Manager 4.2.1 patch bundle:

bundle-133763.tar 
bundle-133763.manifest
bundle-133763.manifest.sig

 

2. On the SDDC Manager, create a sub-folder within the nfs-mount.  In this example, we will use an "offlineSideload" folder: 

mkdir /nfs/vmware/vcf/nfs-mount/offlineSideload/

Note: The syntax of the folder is important and must be kept consistent throughout the process.

 

3. SSH to the SDDC Manager and place all bundles / manifest files into the "offlineSideload" folder.

 

4. Modify the permissions for both the folder and all files within:

chmod 777 /nfs/vmware/vcf/nfs-mount/offlineSideload/
chmod 777 /nfs/vmware/vcf/nfs-mount/offlineSideload/*

 

5. From the SSH session on the SDDC manager, run the curl API to ingest the target bundles:

curl -X POST http://127.0.0.1/lcm/bundle/upload -d '{"bundle":"/nfs/vmware/vcf/nfs-mount/offlineSideload/bundle-133763.tar","manifest":"/nfs/vmware/vcf/nfs-mount/offlineSideload/bundle-133763.manifest","signature":"/nfs/vmware/vcf/nfs-mount/offlineSideload/bundle-133763.manifest.sig"}' -H 'Content-Type:application/json'

Note: During an ingestion of different bundles via the curl command, the process may fail.  It may be required that the bundles / manifest be ingested through the SDDC UI (developer center > manifest > post).

 

Once completed, the bundles should then be available in the Upgrade Planner and present within Bundle Management.