VCF on VxRail: Collect Configuration Information for Upgrade Scheduling
Summary: The following KB article was created to assist with the steps to collect information required for VCF on VxRail upgrade duration estimate. There is a direct correlation between environment size and upgrade duration. Providing this information in advance enables the scheduling team to estimate upgrade duration. ...
Instructions
Each VCF on VxRail instance requires a Service Request of type Upgrade (Maintenance Services). To create a Service Request, go to the Dell Support site, login and perform a search using any serial of any node. Use this to create an Upgrade Service Request.
To collect the required information, you must:
- Run the below commands.
- Capture the full output from
get-vcf-summaryin a notepad text file. - Attach the text file to the Service Request.
- Attach the
vcf-verify.zip to the Service Request.
This information assists the Dell team with:
- Sizing the environment
- Estimating the upgrade duration
- Aligning resources for the duration of the upgrade.
Run 'get-vcf-summary' Command
- Log in to SDDC Manager using vcf credentials
- Elevate to root privileges.
- Run this command:
/opt/vmware/sddc-support/sos --get-vcf-summary
- Record the outputs in a notepad document and include the Service Request number to avoid confusion.
- If the command fails due to an ongoing workflow, wait a few mins and rerun it.
- In some case, you must add the '
--force' parameter to display the information.
- Inform the Dell Scheduling Team.
Note: All upgrade estimates are based on upgrading VxRail clusters in parallel (max 5 at a time per Workload Domain).
This reduces the overall upgrade duration but excludes any stopping points for troubleshooting and remediation.
An example output is below:
/opt/vmware/sddc-support/sos --get-vcf-summary
Welcome to Supportability and Serviceability(SoS) utility!
Summary : /var/log/vmware/vcf/sddc-support/summary-2022-06-30-09-45-18-2512
Summary log : /var/log/vmware/vcf/sddc-support/summary-2022-06-30-09-45-18-2512/sos.log
SDDC Manager
CEIP
Status: ENABLED
Id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx
Domains
mgmt
Name: mgmt
Domain Type: MANAGEMENT
Status: ACTIVE
Domain Id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Clusters
mgmt-1
Datacenter: mgmt
Datastore: VMFS, VMFS, VMFS, VMFS
Primary Datastore Type: VSAN
Cluster Id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Status: ACTIVE
FTT: 1
Stretched Cluster: False
# of Hosts: 4
Resource Utilization
CPU usage in THz: 10 %
Memory usage in TB: 15 %
Storage usage in TB: 10 %
WCP Status: DISABLED
vLCM Status: DISABLED
vCENTER Version: 7.0.2.00500-18455184
vCENTER Id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Esxi Version: 7.0.1-17551050
NSX-Type: NSX-T
NSX-T Version: 3.1.2.0.0-17883596
PROD
Name: pdc-w2-nonprod
Domain Type: VI
Status: ACTIVE
Domain Id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Clusters
PROD-1
Datacenter: PROD-1
Datastore: VMFS, VSAN, VMFS, VMFS, VMFS, VMFS
Primary Datastore Type: VSAN
Cluster Id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Status: ACTIVE
FTT: 1
Stretched Cluster: False
# of Hosts: 10
Resource Utilization
CPU usage in THz: 15 %
Memory usage in TB: 91 %
Storage usage in TB: 16 %
WCP Status: DISABLED
vLCM Status: DISABLED
vCENTER Version: 7.0.2.00500-18455184
vCENTER Id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Esxi Version: 7.0.1-17551050
NSX-Type: NSX-T
NSX-T Version: 3.1.2.0.0-17883596
Host Details
Free Hosts: 0
Active Hosts: 14
Dirty Hosts: 0
Licensing Details
VMware SDDC Manager License
Product Type: SDDC_MANAGER
Total: 100
Used: 100
license Unit: CPU Packages
Key: XXXXX-XXXXX-XXXXX-XXXXX-XXXXX
VMware vSAN License
Product Type: VSAN
Total: 50
Used: 90
license Unit: CPU Packages
Key: XXXXX-XXXXX-XXXXX-XXXXX-XXXXX
VMware NSX-T Data Center License
Product Type: NSXT
Total: 50
Used: None
license Unit: CPU Packages
Key: XXXXX-XXXXX-XXXXX-XXXXX-XXXXX
VMware vSphere License
Product Type: ESXI
Total: 20
Used: 14
license Unit: CPU Packages
Key: XXXXX-XXXXX-XXXXX-XXXXX-XXXXX
vCenter Standard
Product Type: VCENTER
Total: 1
Used: 0
license Unit: Server
Key: XXXXX-XXXXX-XXXXX-XXXXX-XXXXX
SDDC Manager Status: ACTIVE
SDDC Version: 4.2.1.0-18016307
SDDC Manager Id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
VCF Services
OPERATIONS_MANAGER
Version: 4.2.1-vcf4210RELEASE-18016089
Memory Utilized: 2.0G
COMMON_SERVICES
Version: 4.2.1-vcf4210RELEASE-18016089
Memory Utilized: 1.0G
SDDC_MANAGER_UI
Version: 4.2.1-vcf4210RELEASE-18016088
Memory Utilized: 100.0M
DOMAIN_MANAGER
Version: 4.2.1-vcf4210RELEASE-18153716
Memory Utilized: 900.0M
LCM
Version: 4.2.1-vcf4210RELEASE-18016089
Memory Utilized: 2.0G
MULTI_SITE_SERVICE
Version: 1.5.14-vcf4210RELEASE-533
Progress : 100%, Completed tasks : [VCF-SUMMARY]
Run vcfverify Script.
1. Go to https://central.dell.com/solutions/VCF_Verify and download the latest version of the VCFverify script.
2. Log in to SDDC Manager using vcf credentials
3. Elevate to root privileges.
4. Create /tmp/vcfv directory if it does not already exist.
mkdir /tmp/vcfv
5. Set the permissions to unrestricted.
mkdir -m 777 /tmp/vcfv
cd /tmp/vcfv
6. Copy the VCFverify .zip file into /tmp/vcfv and extract the file:
unzip vcfverify_x-xx-xxx.zip
7. Run vcfverify using the following command:
On VCF 3.x
./vcfverify.sh
On VCF 4.x:
sudo ./vcfverify.sh -u priv_user@vsphere.local
- A privileged-username and password must be used to unpack the other account credentials, so these must be specified either with -u and supplying the password when prompted.
- The privileged-username should be a member of the group "
Sddc_secured_access," which is necessary for running the 'lookup_passwords' utility (used byVCF-Verifyto provide and test all the credentials for VxRM and VC).
The file "/tmp/vcf-verify.zip" is created when the VCFverify script completes.
Upload this zipped logfile to the Service Request, to ensure that there are no delays in scheduling your VCF upgrade.