====== Install Mac OS X High Sierra in Virtual Box ======

To install //Mac OS X High Sierra// in Virtual Box you need to things: An installation media of High Sierra and Virtual Box.
We assume, you are running any Version of Mac OS X.
===== Get the needed Files =====

First, start with Mac OS X High Sierra:

To get //Mac OS X High Sierra// download it in the [[https://itunes.apple.com/de/app/macos-high-sierra/id1246284741?ls=1&mt=12 | Mac App Store]]. After the download has completed, either the installer launches or //High Sierra// can not be installed, because it is too old. In the first case, quitt the in installer and do not proceed. In the second case do nothing. In both cases, you will find the installer in the application folder named //macOS High Sierra installieren// as shown in fig 1.

<imgcaption 1 | Mac OS X Applikation Folder>{{:network_protocol_programming_lab:applicationfolder_highsierra.png?500%}}</imgcaption>

We need this file later.

Next, we need //Virtual Box// from //Oracle// at https://www.virtualbox.org. You need the //VirtualBox 6.1.4 platform package// and //VirtualBox 6.1.4 Oracle VM VirtualBox Extension Pack//. Download and install both.

===== Create an Installation Image of Mac OS X High Sierra =====

In the previous step, we downloaded file //macOS High Sierra installieren//. We use this file to create a DVD image file of the operation system, that will be used to install a new virtual machine in //Virtual Box//.

Let us start. First, launch //Terminal App// as shown in Fig 2

<imgcaption 2 | Terminal App>{{:network_protocol_programming_lab:Terminal App.png?500%}}</imgcaption>

Now we create a hard disk image with the name //HighSierra.sparseimage// by entering 

<code bash>
hdiutil create -o HighSierra -size 8G -layout SPUD -fs HFS+J -type SPARSE
</code>

in //Terminal App//.

In the next step, we mount this image:

<code bash>
hdiutil attach HighSierra.sparseimage -noverify -mountpoint /Volumes/install_build
</code>

An icon of the hard disk //install_build// image will appear on the desktop folder.

Now, we copy the installer files of //Mac OS X High Sierra// in the new create image file //install_build// and we make the image file bootable:

<code bash>
sudo /Applications/Install\ macOS\ High\ Sierra.app/Contents/Resources/createinstallmedia --volume /Volumes/install_build
</code>

Notice, that the program "createinstallmedia" is part pf the package //Install macOS High Sierra.app//, that we downloaded as
file //macOS High Sierra installieren// from the Apple server.

Next, we unmount the disk image:

<code bash>
hdiutil detach /Volumes/Install\ macOS\ High\ Sierra/
</code>

Finally, we convert the disk image to a DVD image:

<code bash>
hdiutil convert HighSierra.sparseimage -format UDTO -o HighSierra.iso
</code>

and move the DVD image to the desktop folder.

<code bash>
mv HighSierra.iso.cdr ~/Desktop/HighSierra.iso
</code>

And do not forget to erase the no more needed disk image:

<code bash>
rm HighSierra.sparseimage
</code>

This new created DVD image will be used to install //Mac OS X High Sierra// in //Virtual Box//.


===== Create a Virtual Machine of Mac OS X High Sierra using Virtual Box =====

Now, we can start building a virtual machine of //Mac OS X High Sierra// using //Virtual Box//. This procedure has only been tested using Mac OS X. What you need, is the //Virtual Box App// and a DVD image of //Mac OS X High Sierra//. How to create this DVD image was explained in the previous chapter. 

Now, launch the //Virtual Box App// and create a virtual machine by pressing the **New**-button. A new window opens that guides you through the creation process (see Fig 3).

<imgcaption 3 | Virtual Machine Creation>{{:network_protocol_programming_lab:HighSierra_create.png?500%}}</imgcaption>

Give the virtual machine a meaningful name, select //Mac OS X// as the desired operating system and //macOS 10.13 High Sierra (64 bit)// as the operating system version. If you have finished, press continue.

In the next window (see Fig. 4), enter the amount of RAM. Choose 4096 MByte and go to the next window.

<imgcaption 4 | Virtual Machine Creation>{{:network_protocol_programming_lab:HighSierra_ram.png?500%}}</imgcaption>

You will now be asked, which hard disk you like to use. Choose creation of a new hard disk for the virtual machine (see Fig. 5) and proceed.

<imgcaption 5 | Virtual Machine Hard Disk>{{:network_protocol_programming_lab:HighSierra_disk.png?500%}}</imgcaption>

The type of the hard disk should be a VDI (Virtual Box Image). The size of the disk should be dynamically adjustable and at least 25 GByte.

After creating the hard disk the creation of the virtual machine is finished. An overview window is shown in Fig. 6.

<imgcaption 6 | Virtual Machine Overview>{{:network_protocol_programming_lab:HighSierra_overview.png?500%}}</imgcaption>

The overview depicted in Fig.6 look different from your settings. Adjust the following parameters by freeing the **//modify//**-button at the top of the Window:

  * Number of CPUs will be 2,
  * Size of graphics memory will be 128 MByte,,
  * If Enabled, disable the SSD option if the hard disk
  * Disable the floppy disk drive,
  * and disable sound.

And most important choose for optical drive (SATA-Port 1) the //HighSierra.iso// file.

Now, start the virtual machine. After some cryptical message shown in th escreen, the boot process of Mac OS X start (look at Fig. 7).

<imgcaption 7 | Max OS X Boot>{{:network_protocol_programming_lab:HighSierra_boot.png?500%}}</imgcaption>

At the end of the boot process the Mac OS X Installer launches as shown in Fig. 8.

<imgcaption 8 | Max OS X Installer>{{:network_protocol_programming_lab:HighSierra_installer.png?500%}}</imgcaption>

Now, open //Festplattendienstprogramm// (Disk Utility). A new window, shown in Fig. 9 opens. Choose "show all" in the Menu //Darstellung// and select //VBOX HARDDISK MEDIA//. 

<imgcaption 9 | Festplattendienstprogramm>{{:network_protocol_programming_lab:HighSierra_diskutility.png?500%}}</imgcaption>

Asyou can see in Fig. 9, the disk ist not initialized. Press the **Löschen**-Button. A new window opens, as shown in Fig. 10.

<imgcaption 10 | Erase Disk>{{:network_protocol_programming_lab:HighSierra_erase_disk.png?500%}}</imgcaption>

Fill out needed parameters as shown in Fig 10. and quit //Festplattendienstprogramm//.

Back in the main window (see Fig. 11) of the installer, //choose macOS installieren//.

<imgcaption 11 | Installer Main Window>{{:network_protocol_programming_lab:HighSierra_main.png?500%}}</imgcaption>

After license agreements and prompting for hard disk name, the installation process will start. It should be mentioned, that the installation will be cancelled with the error "installation program is corrupted. In this case try changing the computer date with the command

<code bash>
date 0308143015
</code>

using the Terminal app.

But everything is fine, the installation will start (see Fig. 12).

<imgcaption 11 | Mac OS X installation>{{:network_protocol_programming_lab:HighSierra_installation.png?500%}}</imgcaption>

After the installation is completed, you will see the Mac OS X Desktop of High Sierra. It is a good advice to install now the //Virtual Box Guest Additions//. For this, you have to eject the installation image of High Sierra and to choose then Item //Insert Guest CD Image// of the //Device// menu. This menu is only visible after start of a virtual machine. After the image has been mounted, the Desktop is similar as shown in Fig. 12.

<imgcaption 12 | Mac OS X installation>{{:network_protocol_programming_lab:HighSierra_guest.png?500%}}</imgcaption>

Open and Install the package VBoxDarwinAdditions.pkg. After the installation is finished, you are ready to use Mac OS X High Sierra.

Not go back to [[2_1_access_via_usb]] to continue connecting the BeagleBone Black to the USB interface.