Install Yeastar P-Series Software Edition on KVM

Kernel-based Virtual Machine (KVM) is an open source virtualization technology built into Linux, which allows you to run multiple virtual machines. This topic describes how to create a virtual machine on KVM and install Yeastar P-Series Software Edition on the created virtual machine.

Prerequisites

Procedure

  1. Launch Virtual Machine Manager, click the Create a new virtual machine icon at the top-left corner.

  2. Select the image file of P-Series Software Edition.
    1. Select Local install media (ISO image or CDROM), then click Forward.

    2. Select Use ISO image, click Browse to choose the image file of P-Series Software Edition, then click Forward.

  3. Set memory and CPU based on the Extensions (EXT) and Concurrent Calls (CC) of your PBX system, then click Forward.
    1-20 EXT

    (1-5 CC)

    		 21-50 EXT

    (6-13 CC)

    		 51-250 EXT

    (14-63 CC)

    		 251-500 EXT

    (64-125 CC)

    		 501-1000 EXT

    (126-250 CC)

    		 EXT > 1000

    (CC > 250)
    CPU 2 2 4 6 8 Contact Yeastar
    Memory 2048 MiB 4096 MiB 4096 MiB 8192 MiB 16384 MiB

  4. Specify disk space for the virtual machine , then click Forward.
    Important: Do NOT add extra hard disk before you finish the installation task, or an installation error may occur.

    1. Select the checkbox of Enable storage for this virtual machine.
    2. Select Create a disk image for the virtual machine, specify disk space based on the Extensions (EXT) and Concurrent Calls (CC) of your PBX system.
      1-20 EXT

      (1-5 CC)

      		 21-50 EXT

      (6-13 CC)

      		 51-250 EXT

      (14-63 CC)

      		 251-500 EXT

      (64-125 CC)

      		 501-1000 EXT

      (126-250 CC)

      		 EXT > 1000

      (CC > 250)
      Storage Call Recording Disabled 40 GB

      or higher

      		 40GB

      or higher

      		 50 GB

      or higher

      		 100GB

      or higher

      		 200 GB

      or higher

      		 Contact Yeastar
      Call Recording Enabled 1 GB of storage holds approximately 1000 minutes of recorded calls. You can set up the storage based on your recording usage.
  5. Verify the above configurations and configure network for the virtual machine.

    1. In the Name field, enter a name to help you identify the virtual machine.
    2. Extend Network selection menu, select the network card to be paired with the virtual machine, and set Source mode as Bridge.
    3. Review your configurations.
    4. Click Finish.

      The system starts creating the virtual machine and install Yeastar P-Series Software Edition.

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

  7. Select Custom storage layout and select Done.

  8. In the AVAILABLE DEVICES section, select the free disk space, then select Add GPT Partition.
  9. In the pop-up window, partition the hard disk according to your needs.
    Note: The following partitions are required. You can also add other partitions.
    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.

  10. Select Done.
  11. In the pop-up dialog box, select Continue.

  12. Create a user account, then press Done.

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

  14. 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 with default IP address 192.168.5.150.

  15. Optional: 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 using one of the following methods:

Complete setup via Web GUI using the installation wizard
  1. Open a web browser, enter the PBX's IP address and port in the address bar (e.g. https://192.168.28.45:8088), and press Enter.

  2. Activate and initially set up Yeastar P-Series Software Edition following the installation wizard.
Complete setup via SSH using a prepared XML file

Upload a prepared XML file to the PBX via SSH. This method allows you to complete the initial setup and apply additional supported PBX settings, such as creating extensions, trunks, inbound routes, and more.

  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.

Note: If you want to access the PBX via SSH, you can use one of the following accounts:
  • Root Account: Username is root, and password is the credential configured in XML configuration file.

  • Support Account: Username is support, and password is the credential configured in PBX web portal (Path: Security > Security Settings > Console/SSH Access > Console Password) or in XML configuration file.
    Figure 1. Support password in PBX web portal
    Figure 2. Support password in XML configuration file
  • Custom Account: Username and password are the credentials configured during installation process.