Skip to content

shanyungyang/esxi-unlocker

Repository files navigation

macOS Unlocker V3.0.2 for VMware ESXi

1. Introduction

Unlocker 3 for ESXi is designed for VMware ESXi 6.5, 6.7 and 7.0

The patch code carries out the following modifications dependent on the product being patched:

  • Fix vmware-vmx to allow macOS to boot
  • Fix libvmkctl to allow vSphere to control the guest

The code is written in Python as it makes the Unlocker easier to run and maintain on ESXi.

IMPORTANT: |

Always uninstall the previous version of the Unlocker before using a new
version. Failure to do this could render VMware unusable.

2. Installation

Copy the latest release file to the ESXi host datastore using scp or some other data transfer system. If you want to use the source version (i.e. from GIT) see "5. Building" fist.

Decompress the file from the ESXi console or via SSH:

tar xzvf esxi-unlocker-xxx.tgz

(xxx - will be the version number, for example, 3.0.0)

Run the command from the terminal:

./esxi-install.sh

Finally reboot the server.

3. Uninstallation

Open the ESXi console or login via SSH and change to the folder where the files were extracted.

Run the command from the terminal:

./esxi-uninstall.sh

Finally reboot the server.

4. Notes

A. There is a command added called esxi-smctest.sh which can show if the patch is successful. It must be run from a terminal or SSH session. The output should be:

/bin/vmx smcPresent = true custom.vgz false 32486592 B

Note: The uncompressed size reported for custom.vgz will vary depending on the ESXi version.

B. The unlocker can be temporarily disabled during boot by editing the boot options and adding "nounlocker".

5. Building

If you want to use a version which is not available as a distribution (e.g. the code from "master" branch) you need to first build the package. You can build locally on a Mac or via a github workflow.

Local Build

Checkout the repository:

git clone https://github.com/shanyungyang/esxi-unlocker.git

(if you don't have git installed you can download ZIP archive from GitHub instead)

Enter the directory and build:

cd esxi-unlocker
./esxi-build.py

If everything went correctly the ouput should be:

ESXi-Build for macOS

Timestamping files...

Creating unlocker.tgz...
etc/
etc/rc.local.d/
etc/rc.local.d/unlocker.py

Creating esxi-unlocker-301.tgz...
unlocker.tgz
esxi-install.sh
esxi-uninstall.sh
esxi-smctest.sh
readme.txt

The package you need to copy in the example above is esxi-unlocker-301.tgz (NOT unlocker.tgz!).

Github Build

Triggered

If you add a tag to any commit in the semver format *.*.* a triggered build will run and create a release.

Manual

Fork the repository, click on actions, select manual CI and then run.

This will build a new draft release for you which you can upload to your esxi using curl or wget.

If you add a tag in the format *.*.* a triggered build will run without needing

6. Thanks

Thanks to Zenith432 for originally building the C++ unlocker and Mac Son of Knife (MSoK) for all the testing and support.

Thanks also to Sam B for finding the solution for ESXi 6 and helping me with debugging expertise. Sam also wrote the code for patching ESXi ELF files and modified the unlocker code to run on Python 3 in the ESXi 6.5 environment.

History

26/09/18 3.0.0 - First release

01/05/20 3.0.1 - Fix for ESXi 7.0

10/18/20 3.0.2 - Fix for ESXi 7.0 U1 (7.0.1)

10/29/20 3.0.3 - Release process automated

(c) 2011-2018 Dave Parsons