Install Yeastar P-Series Software Edition on Hyper-V using Ubuntu ISO

sales@starmount.co.ke
+254729608662
Lonrho house, Second floor, standard street
hyper-v
by Yeastar_KE
on May 13, 2025

Install Yeastar P-Series Software Edition on Hyper-V using Ubuntu ISO

You can install Yeastar P-Series Software Edition on Ubuntu in Hyper-V, during which you can choose to let the installation program automatically perform disk partitioning or manually partition disk according to your needs.

Prerequisites

  • Check if the version of Hyper-V is 10.0.17134.1 or later.
  • Download the Ubuntu ISO of Yeastar P-Series Software Edition.
    Note:Based on the difference in installation methods, Yeastar provides two kinds of Ubuntu ISO for Yeastar P-Series Software Edition. Refer to the following table for details.
    Item Automatic Installation Manual Installation
    Image File Name and Format Yeastar_P-Series_Software_Edition_ISO_Auto.iso Yeastar_P-Series_Software_Edition_ISO_Manual_Ubuntu.iso
    Hard Disk Size Minimum 40 GB Minimum 40 GB
    Partition Method Automatic Manual
    Partition Rule

    The system automatically partitions a hard disk as follows:

    • /: 10 GB
    • /swap: 10 GB
    • /home: Remaining Free Space after space for / partition and /swap partition is excluded from the total size.
    		 You need to manually create the following required partitions, and then you can create others according to your needs.

    • /
    • /swap
    • /home

Procedure

Video Tutorial

 

Step 1. Enable Hyper-V on your PC

  1. On the desktop, right click  and click Apps and Features.
  2. On the right of Settings page, click Programs and Features.

  3. On the left navigation bar, click Turn Windows Features on or off.
  4. In the pop-up window, select Hyper-V and click OK.

  5. Restart your computer after the installation is completed.

Step 2. Create a virtual switch

Create an external switch to share your computer’s network with the virtual machine running on it. Based on your computer’s network environment, you need to create one or two virtual switches.

Create a virtual switch on a computer with single NIC
  1. On your desktop, go to  > Windows Administrative Tools > Hyper-V Manager.
  2. On Hyper-V Manager, click Action > Virtual Switch Manager to create a virtual switch.
  3. Create a virtual switch.

    1. Click New virtual network switch.
    2. In the What type of virtual switch do you want to create? section, select External.
    3. Click Create Virtual Switch.
  4. Set up the virtual switch.

    1. In the Name field, enter a name to help you identify the virtual switch.
    2. In the Connection type section, select External network, and select the physical network card to be paired with the virtual switch.
      Note:The network card must be the one that is physically connected to the network.
    3. Click Apply and Yes to create the virtual switch.
    4. Click OK to close the Virtual Switch Manager window.
Create two virtual switches on a computer with dual NIC
  1. On your desktop, go to  > Windows Administrative Tools > Hyper-V Manager.
  2. On Hyper-V Manager, click Action > Virtual Switch Manager to create a virtual switch.
  3. Create a virtual switch.

    1. Click New virtual network switch.
    2. In the What type of virtual switch do you want to create? section, select External.
    3. Click Create Virtual Switch.
  4. Set up the virtual switch.

    1. In the Name field, enter a name to help you identify the virtual switch.
    2. In the Connection type section, select External network, and select the physical network card to be paired with the virtual switch.
      Note:The network card must be the one that is physically connected to the network.
    3. Click Apply and Yes to create the virtual switch.
  5. Repeat Step 3 and Step 4 to create another virtual switch, and select the other physical network card.

Step 3. Create a virtual machine

  1. On Hyper-V Manager, go to Action > New > Virtual Machine.
  2. Review the Before You Begin content and click Next.
  3. Specify a name to help you identify the virtual machine, choose a location to store configuration files of the virtual machine, and click Next.

  4. Select Generation 1, then click Next.

  5. Set the Startup Memory, select the checkbox of Use Dynamic Memory for this virtual machine, and click Next.

  6. In the drop-down list of Connection, select the virtual switch created for the virtual machine, and click Next.
    Note:If you computer has dual NIC, you just select either one of the virtual switches that you have created, as you will need to add another network adapter for the other virtual switch later.

  7. Specify a name for the virtual hard disk, select a location, specify a size, and click Next.

  8. Select Install an operating system from a bootable CD/DVD-ROM, select an .iso file, and then click Finish.

    The virtual machine is created and displayed on the virtual machine list.

  9. Right click the virtual machine, then click Settings to check and ensure that there is only one hard disk on the virtual machine, or an installation error may occur.

  10. If your computer has dual NIC, you need to add another network adapter for the other virtual switch.
    1. Click Add Hardware, select Network Adapter, then click Add.

      The network adapter is added successfully.

    2. In the Virtual switch drop-down list, select the other virtual switch, then click Apply and OK.

Step 4. Install Yeastar P-Series Software Edition on the virtual machine

Follow the instructions below based on different installation methods to install P-Series Software Edition.

Automatically install Yeastar P-Series Software Edition on the virtual machine
  1. Right click the virtual machine, click Start to start the virtual machine.

  2. Right click the virtual machine, click Connect to connect to the virtual machine.

  3. Select Try or Install Ubuntu Server, then press Enter.

  4. Wait 5 to 10 minutes until the installation process is no longer running, then press Enter.

    If IPPBX login is displayed and no errors like wait for basicsrv run ok occur, it indicates that P-Series Software Edition is installed.

Manually install Yeastar P-Series Software Edition on the virtual machine
  1. Right click the virtual machine, click Start to start the virtual machine.

  2. Right click the virtual machine, click Connect to connect to the virtual machine.

  3. Select Try or Install Ubuntu Server, then press Enter.

  4. Select Custom storage layout and select Done.

  5. In the AVAILABLE DEVICES section, create the required partitions and custom partitions according to your needs.
    Note:The following partitions are required.

    Partition Name Description Format Recommended Partition Space
    /swap This is where you extend the system memory by dedicating part of the hard drive to it. swap Minimum 10 GB
    / The slash / alone stands for the root of the file system tree. ex4 Minimum 10 GB
    /home This holds all the home directories for the users. ex4 Remaining Free Space after other partitions created or second drive.
    1. Select the free disk space, then select Add GPT Partition to add a /swap partition.

    2. Select the free disk space, then select Add GPT Partition to add a / partition.

    3. Select the free disk space, then select Add GPT Partition to add a /home partition.

    Partitions are created successfully and displayed on the FILE SYSTEM SUMMARY list, as shown below.

  6. Select Done.
  7. In the pop-up dialog box, select Continue.

  8. Create a user account, then press Done.

  9. When you see the following prompt, press Enter to continue.

  10. Wait 5 to 10 minutes until the installation process is no longer running, then press Enter.

    If a IPPBX login prompt is displayed and no errors like wait for basicsrv run ok occur, it indicates that P-Series Software Edition is installed.

(Optional) Step 5. Change the default IP address of Yeastar P-Series Software Edition

Now Yeastar P-Series Software Edition is installed with default IP address 192.168.5.150. If you prefer another IP address or your PC is on a different network segment such as 192.168.28.X, you can change the PBX’s default IP address.

Important:PBX’s IP address MUST be on the same network segment as your PC, or you can NOT access the PBX from your PC.

We assume that your PC is on the network segment 192.168.28.X and your desired PBX IP address is 192.168.28.45. Refer to the following instructions to change the PBX’s IP address.

  1. At the IPPBX login prompt, type support and press Enter.

  2. At the Password prompt, type loginpbx (if the PBX firmware version is 83.18.0.59 or later) or QhcyaxsGcywymg2022 (if the PBX firmware version is 83.18.0.18 or earlier), then press Enter.

    Note:Generally, you will NOT get any visual feedback from the screen when you type the password.

    You are presented with a prompt, displaying the Ubuntu information and system information. In the meanwhile, you are given the option to ping an IP address, view or update current network configuration, and log out the support account. You can type a specific number to run the command of the corresponding number.

  3. Type 1 and press Enter to update the network configuration.

  4. Change the IP address of Yeastar P-Series Software Edition as follows.

    1. At the Please enter IP address prompt, type the desired IP address and press Enter.

      In this example, type 192.168.28.45.

    2. At the Please enter netmask prompt, type the subnet mask and press Enter.

      In this example, type 255.255.255.0.

    3. At the Please enter gateway prompt, type the gateway address and press Enter.

      In this example, type 192.168.28.1.

      It takes about two minutes to change the PBX’s IP address from 192.168.5.150 to your desired IP address.

Result

Yeastar P-Series Software Edition is installed successfully.

What to do next

Activate and set up Yeastar P-Series Software Edition to make it ready for use. You can do this in either one of the following ways:

Access PBX via Web GUI to complete the initial setup
  1. Open a web browser, enter the PBX’s IP address in the address bar, and press Enter.

  2. Activate and initially set up Yeastar P-Series Software Edition following the installation wizard.
    Note:With Yeastar P-Series Software Edition activated, next time you want to access the PBX via SSH, you can log in using either the support account or the custom account.

    • For support account: The username is support, and the password can be obtained from PBX web portal (Path: Security > Security Settings > Console/SSH Access > Console Password).

    • For custom account: The username and password are what you have configured during installation process.
Access PBX via SSH to complete the setup
  1. Download the XML configuration file and edit it as needed.
  2. Upload the XML configuration file to the designated directory and reboot the PBX to take effect.

    For more information, see Activate and Set up Yeastar P-Series Software Edition Using XML Configuration File.

author avatar
Yeastar_KE
See Full Bio

Categories:

ConfigurationP-Series Updates

Tags:

No Tag

No responses yet

Leave a Reply

Your email address will not be published. Required fields are marked *

© 2025 Yeastar PBX Kenya. Created for free using WordPress and Colibri