Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chilcote/vfuse
Convert bootable DMG images for use in VMware Fusion
https://github.com/chilcote/vfuse
macadmin python vmware
Last synced: 27 days ago
JSON representation
Convert bootable DMG images for use in VMware Fusion
- Host: GitHub
- URL: https://github.com/chilcote/vfuse
- Owner: chilcote
- Created: 2014-11-12T21:33:36.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2022-04-09T04:04:35.000Z (over 2 years ago)
- Last Synced: 2024-08-03T04:09:16.103Z (4 months ago)
- Topics: macadmin, python, vmware
- Language: Python
- Homepage:
- Size: 207 KB
- Stars: 400
- Watchers: 40
- Forks: 48
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-macadmin-tools - https://github.com/chilcote/vfuse
README
vfuse (Deprecated)
====> Note: Big Sur guests are not supported due to the changes Apple made to the system volume. Additionally, because Apple has changed the anatomy of the installer application, AutoDMG [cannot](https://github.com/MagerValp/AutoDMG/issues/254) create a never-booted DMG for Big Sur or above. And finally, Apple Silicon doesn't even support virtualizing macOS. As a result, I won't be updating this script any longer. My heartfelt thanks to everyone who contributed code or issues. This community is amazing.
---
This script takes a never-booted DMG and converts it to a VMware Fusion VM.
The germ of this idea came about, as all good ideas, and germs, do: while drinking beer. Specifically, I was tossing back drinks and tossing around ideas with [Gilbert Wilson](https://www.linkedin.com/in/wilsongilbert/), and he mentioned that he uses the VMware CLI tools to convert DMGs to VMDKs based on a [blog post](http://hazenet.dk/2013/07/17/creating-a-never-booted-os-x-template-in-vsphere-5-1/6/) he'd read. Intrigued, I asked Gil to email me the specifics. After seeing how potentially cool this was, I wrapped it up in this here terribly illegible, queasingly unpythonic script.
> Note: Big Sur guests are not supported. Because Apple has changed the anatomy of the installer application, AutoDMG [most likely won't be able to](https://github.com/MagerValp/AutoDMG/issues/254) create a never-booted DMG for Big Sur. And since that is a dependency for vfuse, we are currently out of luck.
> Note: Version 3.0 requires python3. If you wish to continue using vfuse with Apple's system python2, you should use the vfuse 2.2.6 release. However, at some point in the not-too-distant future, Apple is going to remove python completely from macOS, and you'll need to roll your own python3 to be able to use vfuse.
Options for installing python3:
1. Install the pkg downloaded directly from [python.org](https://www.python.org/downloads).
2. Install Apple's CL Tools (either by downloading the pkg from Apple's [developer site](https://developer.apple.com/download/more), or by invoking the shim at `/usr/bin/python3`).
3. Build your own copy of python (E.g. Greg Neagle's [relocatable python](https://github.com/gregneagle/relocatable-python) tools). You'll need to ensure that this custom python is the default python in your `$PATH`.Requirements
------------+ VMware Fusion 11.5.1 Professional or above
+ OS X 10.15+
+ Python 3+
+ A never-booted image created with [AutoDMG](https://github.com/magervalp/autodmg).
+ (optional) [Packer](https://packer.io) 1.1.1 (or above) for building a vagrant box.
+ (optional) [qemu-img](https://en.wikibooks.org/wiki/QEMU/Installing_QEMU)Usage
-----usage: vfuse [-h] [--version] [-i INPUT] [-o OUTPUT] [-n NAME] [-w HW_VERSION]
[-m MEM_SIZE] [-s [SERIAL]] [-t TEMPLATE] [-e]
[--disk_type DISK_TYPE] [-p PACKER] [-d D] [--hw-model HW_MODEL]
[--board-id BOARD_ID] [--use-qemu [USE_QEMU]] [--recovery]
[--snapshot] [--snapshot-name SNAPSHOT_NAME] [-c CHECKSUM]
[--list-templates] [--list-cache] [--clear-cache]Create VM from source DMG.
optional arguments:
-h, --help show this help message and exit
--version show the version number
-i INPUT, --input INPUT
/path/to/dmg
-o OUTPUT, --output OUTPUT
/path/to/output/dir
-n NAME, --name NAME Use a custom name
-w HW_VERSION, --hw-version HW_VERSION
VMware hardware version
-m MEM_SIZE, --mem-size MEM_SIZE
Memory Size in MB
-s [SERIAL], --serial [SERIAL]
Custom Serial number
-t TEMPLATE, --template TEMPLATE
Use a template
-e, --esx Create pre-allocated ESX-type VMDK
-p PACKER, --packer PACKER
Populate a packer template
-d D Path to CD/DVD ISO path
--hw-model HW_MODEL Custom hardware model
--board-id BOARD_ID Custom hardware board id
--use-qemu [USE_QEMU]
Use qemu-img intead of the Fusion CLI tools [/path/to
/qemu-img]
--recovery Boot into Recovery HD
--snapshot Create initial snapshot
--snapshot-name SNAPSHOT_NAME
Custom name for the initial snapshot
-c CHECKSUM, --checksum CHECKSUM
Generate checksum of a DMG
--list-templates Return list of available templates
--list-cache Return list of cached disk images
--clear-cache Clear cached disk imagesCreating a VM
-------------Running `vfuse` does not necessarily require sudo rights, but if you don't want to be prompted in the GUI for an admin password, run it with `sudo`. (Escalated privileges is required to run the `vmware-vdiskmanager` binary, which `vfuse` uses.)
The only required argument is `-i` aka `--input`. Run thusly, it will create a vm called `macos-vm.vmwarevm` in the current working directory:
/usr/local/vfuse/bin/vfuse -i /path/to/dmg
See the [wiki](https://github.com/chilcote/vfuse/wiki) for more on how to use `vfuse`.
Caveats
-------`vfuse` is meant to be used with never-booted disk images created with [AutoDMG](https://github.com/magervalp/autodmg). Using `vfuse` with a dmg created with Disk Utility is not something that has been tested, so you're on your own there. Likely, it's even more of a longshot with APFS.
License
-------Copyright 2016-Present Joseph Chilcote
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License athttp://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.