Backing up the ESXi host configuration is essential for maintaining a stable VMware vSphere environment. The host’s settings—network, storage, security, and resource configurations—are crucial to its operation. In the event of a failure, restoring these configurations manually can be both time-consuming and error prone. Having a backup ensures quick recovery without having to set up a new ESXi server from scratch we would be able to recover the hosts quickly if we maintain a copy of config file. This process is valid for hosts with no TPM chip on it so here’s a guide to help you efficiently backup and restore your ESXi host configuration. The ESXi configuration is saved automatically to the /bootbank/state.tgz file every hour.
ESXi utilizes two key partitions:
- /bootbank: This partition stores the current ESXi image, including a compressed file named s.v00, which is essential during the boot process.
- /altbootbank: This partition is initially empty but is filled with the previous image during an upgrade so treat it as a backup location.
Identify the ESXi UUID
|
1 2 3 |
<span class="line"><span style="color: #000000"># </span><span style="color: #001080">Commmand</span><span style="color: #000000"> </span><span style="color: #001080">to</span><span style="color: #000000"> </span><span style="color: #001080">display</span><span style="color: #000000"> </span><span style="color: #001080">the</span><span style="color: #000000"> </span><span style="color: #0070C1">UUID</span><span style="color: #000000"> </span><span style="color: #0000FF">of</span><span style="color: #000000"> </span><span style="color: #001080">ESXi</span><span style="color: #000000"> </span><span style="color: #001080">host</span></span> <span class="line"><span style="color: #000000">[</span><span style="color: #001080">root</span><span style="color: #000000">@</span><span style="color: #001080">vcf</span><span style="color: #000000">-</span><span style="color: #001080">esx01</span><span style="color: #000000">:~] </span><span style="color: #001080">esxcfg</span><span style="color: #000000">-</span><span style="color: #001080">info</span><span style="color: #000000"> -</span><span style="color: #001080">u</span></span> <span class="line"></span> |
Identify the ESXi build and version
|
1 |
<span class="line"><span style="color: #000000">[</span><span style="color: #001080">root</span><span style="color: #000000">@</span><span style="color: #001080">vcf</span><span style="color: #000000">-</span><span style="color: #001080">esx01</span><span style="color: #000000">:~] </span><span style="color: #001080">vmware</span><span style="color: #000000"> -</span><span style="color: #001080">vl</span></span> |
The backup process of an ESXi involves saving the current configuration file from its default location under /scratch to an alternate location. ESXi by default does a config dump each hour to a location under the /scratch to preserve the state of its config, thus it was the need the scratch logs be moved to a shared datastore. If our scratch is not yet from its default to a shared datastore, we will need to copy the file from /scratch/downloads to a shared datastore path as that will be replaced every hour or so as ESXi does is config backups again each hour or so.
To create a new copy of the config file,
Flush the current ESXi configuration to persistent storage by running the command.
|
1 |
<span class="line"><span style="color: #001080">vim</span><span style="color: #000000">-</span><span style="color: #001080">cmd</span><span style="color: #000000"> </span><span style="color: #001080">hostsvc</span><span style="color: #000000">/</span><span style="color: #001080">firmware</span><span style="color: #000000">/</span><span style="color: #001080">sync_config</span></span> |
To back up the ESXi host configuration,
|
1 2 |
<span class="line"><span style="color: #001080">vim</span><span style="color: #000000">-</span><span style="color: #001080">cmd</span><span style="color: #000000"> </span><span style="color: #001080">hostsvc</span><span style="color: #000000">/</span><span style="color: #001080">firmware</span><span style="color: #000000">/</span><span style="color: #001080">backup_config</span></span> <span class="line"></span> |
The archive file generated has a Manifest file that lists the version and build of each host that is backed up which is useful for doing restores as these have to match always . A copy of the archive file is stored in /scratch/downloads and this is the configuration backup of ESXI host and will need to be copied across to an alternate path
Once the backup is generated, you can download it via your browser. The bundle is saved as a .tgz file, which you can access by navigating to a web browser or using winscp
If the above file can’t be downloaded via weblink, copy the file from /scratch/downloads to an alternate datastore path as that will be replaced every hour or so as ESXi does its config backups again on its own
|
1 |
<span class="line"><span style="color: #001080">find</span><span style="color: #000000"> /</span><span style="color: #001080">scratch</span><span style="color: #000000">/</span><span style="color: #001080">downloads</span><span style="color: #000000">/ -</span><span style="color: #001080">name</span><span style="color: #000000"> \*.</span><span style="color: #001080">tgz</span><span style="color: #000000"> -</span><span style="color: #001080">exec</span><span style="color: #000000"> </span><span style="color: #001080">cp</span><span style="color: #000000"> {} /</span><span style="color: #001080">vmfs</span><span style="color: #000000">/</span><span style="color: #001080">volumes</span><span style="color: #000000">/66</span><span style="color: #001080">ed5f36</span><span style="color: #000000">-</span><span style="color: #098658">4e749006</span><span style="color: #000000">-65</span><span style="color: #001080">f1</span><span style="color: #000000">-005056</span><span style="color: #001080">a3cddd</span><span style="color: #000000">/</span><span style="color: #795E26">ESXi_config_backup_$</span><span style="color: #000000">(</span><span style="color: #001080">date</span><span style="color: #000000"> +’%</span><span style="color: #0070C1">Y</span><span style="color: #000000">%</span><span style="color: #001080">m</span><span style="color: #000000">%</span><span style="color: #001080">d_</span><span style="color: #000000">%</span><span style="color: #0070C1">H</span><span style="color: #000000">%</span><span style="color: #0070C1">M</span><span style="color: #000000">%</span><span style="color: #0070C1">S</span><span style="color: #000000">’).</span><span style="color: #001080">tgz</span><span style="color: #000000"> \;</span></span> |