This tutorial is provided by Jeff from Gentek Labs. Gentek Labs is specialized in providing virtualized server environments for businesses. They’ve been installing AskoziaPBX in Hyper-V environments for some time and were so nice to create this tutorial for us. Thanks again for all the hard work you’ve put into this! Enjoy.
Hyper-V is a Server virtualization environment created by Microsoft with the intent of running Multiple Virtual Servers on a single server platform, reducing overhead costs of IT resources, while allowing businesses to achieve their goal. Hyper-V is an Enterprise Virtual Environment, allowing for optimized performance, including the capability to run a PBX in a virtual environment, pending proper hardware is used. There are only a few known PBX’s that run in virtual environments, and Askozia after 8 solid months has proven to work reliably in the right virtual environment.
The environment used to test Askozia for an 8-month period is the following:
Order of Steps to setup and deploy Virtual PBX:
In virtual environments, it is good practice to run your virtual machine and other shared network resources from a Drive or an Array separate from that which your operating system runs on. This allows for better performance, but also reduces the possibility of the Local OS processes from effecting the quality and performance of your virtual machines. In this step, we will create a folder on the Data drive, where we will store the virtual machines. In this folder will create a folder where we will save the virtual machine files for the Askozia PBX. If you are already using Hyper-V and know where you store your Virtual Machines, you can skip this step
1. Open Windows Explorer by clicking “Start,” and selecting “Computer.”
2. Identify the Data Drive, and open it. In this exercise, the Data drive is Drive F.
3. In the F Drive “Data Drive”, if you don’t already have a place to store Virtual Machine files, create a new folder in the root directory and name it. In this exercise the folder we create will be named “Virtual Machines.”
4. Open up the new folder you created.
5. Now you will create a new folder that the Askozia PBX virtual machine files will be saved in. Give the Folder a name that corresponds with what the virtual machine will be. In this exercise, the folder will be named Askozia.
Next you will open the Hyper-V Manager. Hyper-V can be located in the “control panel”, under “Administrative Tools.” (Control Panel\Administrative Tools\Hyper-V Manager)
Note: If you can’t find the Hyper-V Manager in Administrative tools, than you will need to install the Hyper-V Role. To install the Hyper-V Role, you will need to open the “server manager” located in “Administrative Tools” in the “Control Panel.” In the server Manager, Right-Click “Roles”, and select “Add Roles.” The Add Roles Wizard will open. Select “Next” to go to the next screen. You will now see a list of Roles to install. Place a check in the box next to “Hyper-V”, and select “Next” to continue. Continue to click “Next” on all the menus until you are prompted to “Install”. Click “Install”, which will begin installing the “Hyper-V” Role. Once Installed, you will need to reboot.
In the Hyper-V Manager, you will first create a virtual network to interface with your physical network.
1. In the Actions pain, Select “Virtual Network Manager”
2. In the Virtual Network Manager, Select “External” for the type of Virtual Network to create, and then Click “Add”
3. In the New Virtual Network Wizard you will do the following:
Now your Virtual Network will be completed.
Now you will create the Virtual Machine which will host the PBX. It is important to follow each step for optimal productivity.
1. In The Hyper-V Manager, under “Actions,” click “New,” and select “Virtual Machine.”
2. The “New Virtual Machine Wizard” will open. Select “Next” to continue.
3. In the “Specify Name and Location” section of the wizard you will name the Virtual machine and choose the location to save the virtual machine. Start by naming the Virtual Machine. In this exercise, the Virtual Machine will be named Askozia. Next, check the box “Store the Virtual Machine in a different Location.” Now the location field will be available. Click “Browse,” and select the location to save the Virtual Machine to. Once done with the name and location, select “Next,” to continue.
4. Next in the “Assign Memory” section of the wizard, you will set the amount of memory from the physical memory of your server to be dedicated to your Virtual Machine. In this exercise we will set the memory to 256MB, and then select “Next” to continue.
5. In the “Configure Networking” section of the wizard, leave the connection as “Not Connected” and select “Next” to continue.
6. In the “Connect Virtual Hard Disk” section of the wizard you will create the first Virtual Hard Drive, which will be intended for the Askozia PBX software. In a later step, you will create a second Virtual Hard Drive intended for the Media (Voicemail, Fax, Hold Music). First you will select the radial button “Create a Virtual Hard Disk.” The name and location should reflect the name of the Virtual Machine chosen earlier as well as the location of the Virtual Machine which too was chosen earlier. Behind the name of the Virtual Hard Disk, add an identifier to let you know that this will be used for the Askozia PBX software. In this exercise we will name the Virtual Machine “AskoziaOS.vhd.” Next, under the field “Size,” you will set the Virtual Hard Drive size. In this exercise we will set the Virtual Hard Drive size to 16GB. Once the options are setup, select “Next” to continue.
7. In the “Installations Options” you will select the media which you will install Askozia PBX from. In this Exercise we use the ISO image included with the PBX software. Select the radial button for “Install an operating system from boot CD/DVD-ROM.” Next slect the radial button for “Image File (.iso).” Click browse, and then locate the location of the saved ISO. Please note that you can use physical media in addition to an ISO image. Once you have selected your installation media, select “Next” to continue.
8. Now in the “Completing the New Virtual Machine Wizard,” you will see a review of the options you chose for the Virtual Machine. If everything looks good, select “Finish.” If you need to make any changes, you can select “Previous” to go back.
9. There is still more options to configure for the Virtual Machine, which you will do in the “settings” for the Virtual Machine you created. In the Hyper-V Manager console, click on the Virtual Machine you created, and then on the right in the Actions pain, select “Settings.”
10. First you will create the Second Virtual Hard Drive intended for the Media (Voicemail, Fax, Hold Music). Select “IDE Controller 0” in the Hardware pain on the left. Next in the right column, select “Hard Drive,” and then click “Add.”
11. Now in the “Hard Drive” pain on the right, select “New” to create a new Virtual Hard Drive.
12. The “New Virtual Hard Disk Wizard” will open. Select “Next” to continue.
13. In the “Choose Disk Type” section of the wizard, keep the default setting “Fixed Size,” and select “Next” to continue.
14. In the “Specify Name and Location” section of the wizard, name the Virtual Hard Drive with a name which will identify its intent. In this exercise the Virtual Hard Drive will be named “AskoziaMedia.vhd.” Next select “Browse” and specify the location to save the new Virtual Hard Drive. Select “Next” to continue.
15. In the “Configure Disk” section of the wizard, you will set the size of the new Virtual Hard Drive. In this exercise we will set the size to 16GB. Once you set the size, select “Next” to continue.
16. Review the settings you chose for the New Virtual Hard Drive. If everything looks good, select “Finish.”
17. The Virtual Network Adapter that is included with the Virtual Machine is intended for Microsoft Windows Virtual Machines. In the next few steps, you will delete the default Network Adapter intended for Windows, and Add a Legacy Adapter that is intended for Linux Operating systems which is needed for the Askozia PBX to run in a Hyper-V environment. Back in the “Settings” menu for the New Virtual Machine, select “Network Adapter” in the Hardware pain on the left. In the Network Adapter pain on the right, select “Remove.”
18. Now you will add the Legacy Network Adapter. In the “Settings” menu for the New Virtual Machine, select “Add Hardware” in the Hardware pain on the left. In the “Add Hardware” pain on the right, select “Legacy Network Adapter,” and select “Add.”
19. In the “Settings” menu for the New Virtual Machine, select “Legacy Network Adapter” in the Hardware pain on the left. In the “Legacy Network Adapter” pain on the right, click on the drop down menu under “Network,” and select the Virtual Network you created earlier.
20. You are now done configuring the New Virtual Machine. Select “OK” to complete your setting.
1. Now you will start up the New Virtual Machine, and begin setting up the Askozia PBX. In the Hyper-V Manager Console, select the Virtual Machine, and select “Start” and then “Connect” in the Actions pain on the right.
2. The Virtual Machine will now start up, and load the install media as it typically would. Select “8” to install on Hard Drive followed by pressing “Enter” on your keyboard.
3. You will now chose which Virtual Hard Drive to install Askozia PBX on. You will use the first drive in the series, which is intended for the OS. Type “had” followed by pressing “Enter” on your keyboard.
4. You will be prompted with a warning explaining the actions that will take place, as well as the option to reboot after installation. Enter “Y” and then press “Enter” on your keyboard to continue and reboot. Askoza PBX will now install on the OS Virtual Hard Drive and Reboot.
5. Now you need to remove the install media, which in the case of this exercise was an ISO, so that your PBX can boot from the OS Hard Drive. Select “Media” from the menu, and then under “DVD Drive” select “Eject.” Now enter “5” in the PBX Console, and press “Enter” to reboot and boot from the Virtual Hard Drive.
Now Askozia PBX is installed in Hyper-V, with the best optimal configuration. From this point the rest of the install will be the same as if you were installing on a physical PC. You will be able to set the IP Address of the PBX, and access the Web GUI as you would from any other install.