7/29/2019 ReadmeCZXV
1/2
Mac OS X Unlocker for VMware============================
1. Introduction---------------
The package is a combination of the Unlocker code written by
Zenith432 plus somescripts written by myself that wrap the actual
unlocker code.
It has been tested against:
* Workstation 8/9 on Windows and Linux (32 & 64-bit
versions)* Player 4/5 on Windows and Linux (32 & 64-bit
versions)* Fusion 4/5 on Snow Leopard, Lion and Mountain Lion* ESXi
5.0/5.1
The patch code carries out the following modifications dependent
on the productbeing patched:
* Fix vmware-vmx and derivatives to allow Mac OS X to boot* Fix
vmwarebase .dll or .so to allow Apple to be selected during
creation* Copy darwin.iso if needed to VMware folder
Note that not all products recognise the darwin.iso via install
tools menu item.
You will have to manually mount the darwin.iso for example on
Workstation.
Also Player is missing vmware-vmx-debug and vmware-vmx-stats
files and so anerror is shown during patching as the files are not
found. This can be safelyignored.
In all cases make sure VMware is not running, and any background
guests havebeen shutdown.
2. Windows----------On Windows you will need to either run
cmd.exe as Administrator or usingExplorer right click on the
command file and select "Run as administrator".
install.cmd - patches VMware and copies darwin.iso tools image
to VMwareuninstall.cmd - restores VMware and removes darwin.iso
tools image from VMware
3. Linux---------On Linux you will need to be either root or use
sudo to run the scripts.
You may need to ensure the contents of the linux folder have
execute permissionsby running chmod +x against the 4 files.
install.sh - patches VMware and copies darwin.iso tools image to
VMwareuninstall.sh - restores VMware and removes darwin.iso tools
image from VMware
4. Mac OS X-----------On Mac OS X you will need to be either
root or use sudo to run the scripts.This is really only needed if
you want to use client versions of Mac OS X.
You may need to ensure the contents of the osx folder have
execute permissionsby running chmod +x against the 3 files.
install.sh - patches VMware
7/29/2019 ReadmeCZXV
2/2
uninstall.sh - restores VMware
5. ESXi-------ESXi has to be patched using the scripts, as the
unlocker is used to overlaythe ESXi firmware at runtime. You will
need to transfer the files to theESXi host either using vSphere
client or SCP.
Once uploaded you will need to either use the ESXi support
console or use SSH torun the commands. Please note that you will
need to reboot the host for thepatches to become active.
>
You may need to ensure the contents of the esxi folder have
execute permissionsby running chmod +x against the 3 files.
install.sh - patches VMwareuninstall.sh - restores VMware
6. Zenith432's Unlocker-----------------------
In all cases the unlocker can be run without the scripts but you
would need to
carry out additional actions which the scripts encapsulate for
you especially onESXi. If you want to run the unlocker directly the
parameters are:
Usage: ./Unlocker.Linux64 [-h] [-u] [target_directory]-h: print
help-u: remove the patchtarget_directory: customize location of vmx
executables
On all platforms you must run it with administrator or root
privileges.The source code is provided and Zenith432 makes it
freely available formodification. In 1.1.1 I have modified the code
and it is availableas per Zenith432's original statement.
Thanks to Zenith432 for building the unlocker and Mac Son of
Knife for allthe testing and support.
History-------11/10/11 1.0.0 - First release07/11/11 1.0.1 -
Fixed typo in Windows command files07/12/11 1.0.2 - Updated patcher
and tools for latest release WKS 8.0.1 & FUS 4.1.110/05/12
1.1.0 - Changed the patching mechanism for vmwarebase .dll or
.so
& tested against ESXi 5.0 U1 and Tech Previews.
13/07/13 1.1.1 - Changed ESXi scripts to ensure not deleting
root /bin folder- Fixed vmwarebase patching on 32-bit Linux- Some
other code clean-up in Unlocker.cpp
(c) 2011-2013 Dave Parsons
