Install Yeastar P-Series Software Edition on VMware Workstation using Ubuntu ISO

You can install Yeastar P-Series Software Edition on Ubuntu in VMware Workstation, 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 VMware Workstation is 15.1.0 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. Create a virtual machine

  1. Launch VMware Workstation, go to File > New Virtual Machine.
  2. Follow the wizard to create a virtual machine.
    1. Select the type of virtual machine that you want to create and click Next.

      In this example, select Typical.

    2. Select I will install the operating system later and click Next.

    3. Set Guest operating system to Linux, set Version to Ubuntu 64-bit.

    4. Specify a name to help you identify the virtual machine and specify a location to store the virtual machine files, then click Next.

    5. Specify capacity of the virtual disk, specify the way you want the disk space to be allocated, and click Next.
      Note: Specify a value greater than 40 GB, or an installation error may occur..

    6. Review configurations of the virtual machine to be created and click Finish.

Step 2. Set up the created virtual machine

To ensure that P-Series Software Edition can be installed and accessed successfully, you need to configure network of the virtual machine as Bridged and set its firmware type to Basic Input Output System (BIOS).

Follow the instructions below based on your computer's network environment.
Set up the created virtual machine on a computer with single NIC
  1. Select the created virtual machine, click Edit virtual machine settings.

  2. Check and ensure that there is only one hard disk on the virtual machine, or an installation error may occur.

  3. Configure the CD/DVD (SATA) in the virtual machine to point to the .iso image file of P-Series Software Edition and configure the drive to connect at power on.

    1. On the Hardware tab, select CD/DVD (SATA).
    2. In the Device status section, select the checkbox of Connect at power on.
    3. In the Connection section, select Use ISO image file and browse to the location of the .iso image file.
  4. Configure network of the virtual machine as Bridged.
    Note: After you create the virtual machine, it is configured to use the default NAT network. With NAT, the virtual machine and your PC share a single network identity, which would cause the connection failure between the virtual machine and devices on the external network.

    1. Go to Hardware > Network Adapter.
    2. In the Network connection section, select Bridged: Connected directly to the physical network.
    3. Click OK.
  5. Set firmware type of the virtual machine to Basic Input Output System (BIOS).

    1. Go to Options > Advanced.
    2. In the Firmware type section, select BIOS.
    3. Click OK.
Set up the created virtual machine on a computer with dual NIC
  1. Set virtual network as Bridged, and select the physical network card to be paired with the virtual machine.
    1. Go to Edit > Virtual Network Editor.

    2. Optional: If you don't run the PC as an administrator, you need to click Change Settings to modify network settings.

    3. Select VMnet0, then select Bridged (connect VMs directly to the external network).
    4. In the drop-down list of Bridged to, select a physical network card.

    5. Click OK.
  2. Set up virtual machine.
    1. Select the created virtual machine, click Edit virtual machine settings.

    2. Check and ensure that there is only one hard disk on the virtual machine, or an installation error may occur.

    3. Configure the CD/DVD (SATA) in the virtual machine to point to the .iso image file of P-Series Software Edition and configure the drive to connect at power on.

      1. On the Hardware tab, select CD/DVD (SATA).
      2. In the Device status section, select the checkbox of Connect at power on.
      3. In the Connection section, select Use ISO image file and browse to the location of the .iso image file.
    4. Configure network of the virtual machine as Specific virtual network and select the virtual network that you have configured.

      1. Go to Hardware > Network Adapter.
      2. In the Network connection section, select Custom: Specific virtual network.
      3. Select the virtual network to be connected. In this example, select VMnet0.
      4. Click OK.
    5. Set firmware type of the virtual machine to Basic Input Output System (BIOS).

      1. Go to Options > Advanced.
      2. In the Firmware type section, select BIOS.
      3. Click OK.

Step 3. Install Yeastar P-Series Software Edition on the created 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 created virtual machine
  1. Select the created virtual machine, click Power on this virtual machine.

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

  3. 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 created virtual machine
  1. Select the created virtual machine, click Power on this virtual machine.

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

  3. Select Custom storage layout and select Done.

  4. 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.

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

  7. Create a user account, then press Done.

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

  9. 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 4. 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 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.