# Deploying ProSBC on VMware

### Launching an instance using ESXi web interface

1. Log in using the Vmware web interface
2. Select 'Virtual Machines' from the left menu

<br>

<figure><img src="https://docs.telcobridges.com/w/images/thumb/8/88/Vmware_web_virtual_machines.png/200px-Vmware_web_virtual_machines.png" alt=""><figcaption></figcaption></figure>

3. Click on 'Create / Register VM'<br>

   <figure><img src="https://docs.telcobridges.com/w/images/thumb/e/e5/Vmware_web_create.png/600px-Vmware_web_create.png" alt=""><figcaption></figcaption></figure>

4. Select 'Deploy a virtual machine from an OVF or OVA file' then press 'next'<br>

   <figure><img src="https://docs.telcobridges.com/w/images/thumb/f/f7/Vmware_web_select_type.png/800px-Vmware_web_select_type.png" alt=""><figcaption></figcaption></figure>

5. Enter the name. Drag the file or browse to the location of the FreeSBC-SW image obtained from TelcoBridges. 'Click 'Next'

<figure><img src="https://docs.telcobridges.com/w/images/thumb/8/89/Vmware_web_browse_ova.png/800px-Vmware_web_browse_ova.png" alt=""><figcaption></figcaption></figure>

6. Select a datastore (if more than one are available) then click 'Next'

<figure><img src="https://docs.telcobridges.com/w/images/thumb/a/a8/Vmware_web_select_storage.png/800px-Vmware_web_select_storage.png" alt=""><figcaption></figcaption></figure>

7. Choose your network. Select 'Thick' disk provisioning. Uncheck 'Power on automatically'. Click 'Next'

<figure><img src="https://docs.telcobridges.com/w/images/thumb/b/b0/Vmware_web_deployment_options.png/800px-Vmware_web_deployment_options.png" alt=""><figcaption></figcaption></figure>

8. Click 'Next'

<figure><img src="https://docs.telcobridges.com/w/images/thumb/e/ed/Vmware_web_ready_to_complete.png/800px-Vmware_web_ready_to_complete.png" alt=""><figcaption></figcaption></figure>

9. Do not refresh your browser and wait until the machine is deployed.<br>

<figure><img src="https://docs.telcobridges.com/w/images/thumb/9/93/Vmware_web_installing.png/800px-Vmware_web_installing.png" alt=""><figcaption></figcaption></figure>

10. Once deployed, edit the VM<br>

<figure><img src="https://docs.telcobridges.com/w/images/thumb/3/32/Vmware_web_edit_settings.png/800px-Vmware_web_edit_settings.png" alt=""><figcaption></figcaption></figure>

11. Edit network adapters to connect on proper networks. Make sure that at least one of the adapter connects to the private management network of the setup from which WebPortal access will be granted. Do not press the 'Save' button yet.<br>

<figure><img src="https://docs.telcobridges.com/w/images/0/0d/Vmware_web_network.png" alt=""><figcaption></figcaption></figure>

12.

* If system requires 1+1 configuration or more network interfaces follow these steps: [How to add VMware Network Interfaces](https://prosbcdocs.telcobridges.com/initial-installation/1.-instructions-by-platform/virtual-self-hosted-installation/virtual-vmware/adding-network-interfaces-in-vmware)
* If system requires high performance, Passthrough interface can be configured. See [Configuring VMware Passtrough interfaces](https://prosbcdocs.telcobridges.com/initial-installation/1.-instructions-by-platform/virtual-self-hosted-installation/virtual-vmware/configuring-passtrough-interfaces-on-vmware)

13. Click on 'CPU' to open the details. Set 'Shares' to 'high', enter the maximum number of MHz corresponding to your number of CPU cores in 'Reservation' (See [Calculating Reserved CPU](#calculating-reserved-cpu-mhz)) and make sure the 'Unlimited' option is selected. Do not press the 'Save' button yet.<br>

<figure><img src="https://docs.telcobridges.com/w/images/4/44/Vmware_web_cpu.png" alt=""><figcaption></figcaption></figure>

14. Open the 'Memory' details and check-mark the 'Reserve all guest memory (All locked)' option, set Limit to 'Unlimited' and Shares to 'High'. Do not press the 'Save' button yet.<br>

<figure><img src="https://docs.telcobridges.com/w/images/4/48/Vmware_web_memory.png" alt=""><figcaption></figcaption></figure>

15. Open the 'Hard disk 1' details and set the 'Shares' to 'High'. Do not press the 'Save' button yet.

<figure><img src="https://docs.telcobridges.com/w/images/4/41/Vmware_web_disk_res.png" alt=""><figcaption></figcaption></figure>

16. Click on the second tab 'VM Options', expand 'Advanced' and set 'Latency Sensitivity' to 'High' then press the 'Save' button.

<figure><img src="https://docs.telcobridges.com/w/images/b/b8/Vmware_web_latency.png" alt=""><figcaption></figcaption></figure>

17. Back to the main screen, click on "Power On" to start the new VM.

<figure><img src="https://docs.telcobridges.com/w/images/thumb/9/91/Vmware_web_poweron.png/800px-Vmware_web_poweron.png" alt=""><figcaption></figcaption></figure>

18. Once the VM had completely booted, its assigned DHCP IPs will be displayed in General Information -> Networking. Note this IP address to access the Web Portal configuration interface later.

<figure><img src="https://docs.telcobridges.com/w/images/thumb/6/68/Vmware_web_ip.png/800px-Vmware_web_ip.png" alt=""><figcaption></figcaption></figure>

#### Calculating Reserved CPU MHz

To get the MHz per core, you need to figure out the total number of available MHz that your system has and divide by the total number of cores.

1. Select 'Host' on the left menu<br>

   <figure><img src="https://docs.telcobridges.com/w/images/thumb/4/43/Vmware_web_host.png/200px-Vmware_web_host.png" alt=""><figcaption></figcaption></figure>
2. Take note of the number of cores this system has. (In this example: 12) Also take a look at the 'CAPACITY', but is is not precise down to the MHz (In this example 36.7 GHz)<br>

   <figure><img src="https://docs.telcobridges.com/w/images/thumb/d/df/Vmware_web_total_cpus.png/800px-Vmware_web_total_cpus.png" alt=""><figcaption></figcaption></figure>
3. When editing the VM, in the disk details, expand the 'Reservation' combobox. There should be a number in exact MHz for the maximum capacity of the system (In this example: 36708)<br>

   <figure><img src="https://docs.telcobridges.com/w/images/c/c9/Vmware_web_total_mhz.png" alt=""><figcaption></figcaption></figure>
4. Calculate your VM CPU MHz Reservation requirement

mhz\_per\_core = total\_system\_mhz / total\_system\_cpus (In this example: 3059 = 36708 / 12 )vm\_reserved\_mhz = vm\_cpus \* mhz\_per\_core (In this example: 12236 = 3059 \* 4 )