Install Yeastar P-Series Software Edition on VMware ESXi

VMware ESXi is a bare metal hypervisor that can be installed directly onto your physical server, without the need of an operating system. It provides the ability to create and run virtual machines. This topic describes how to create a virtual machine on VMware ESXi and install Yeastar P-Series Software Edition on the created virtual machine.

Prerequisites

  • Check if the version of VMware ESXi is 6.0 or later.
  • Download an image file of Yeastar P-Series Software Edition.
    Note: Based on the difference in installation methods, Yeastar provides two kinds of image file for P-Series Software Edition. Refer to the following table for details.
    Table 1.
    Item Automatic Installation Manual Installation
    Image File Name and Format Yeastar-P_SOFTWARE-auto-{version}.iso

    Example: Yeastar-P_SOFTWARE-auto-83.9.0.18.iso

    Yeastar-P_SOFTWARE-manual-{version}.iso

    Example: Yeastar-P_SOFTWARE-manual-83.9.0.18.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

Step 1. Upload ISO image of Yeastar P-Series Software Edition to VMware ESXi

  1. Log in to the management console of VMware ESXi.
  2. On the left navigation bar, click Storage.

  3. Click Datastores tab, then select the datastore where you want to store the ISO image.

  4. Upload the ISO image of Yeastar P-Series Software Edition.
    1. Click Datastore browser.

    2. At the top-left corner of the pop-up window, click Upload to select the ISO image of Yeastar P-Series Software Edition.

      Wait a few minutes for the upload to complete.

      Tip: You can view the uploading progress in the progress bar at the top-right corner.

      When done, the ISO image is displayed on the datastore.

    3. Click Close.

Step 2. Create a virtual machine

  1. On the left navigation bar, click Virtual Machines, then click Create / Register VM.

  2. On the Select creation type page, select Create a new virtual machine, then click Next.

  3. On the Select a name and guest OS page, complete the following settings.
    1. Specify a name and OS.

      • Name: Enter a name to help you identify the virtual machine.
      • Compatibility: Select ESXi virtual machine higher than 6.0.
      • Guest OS family: Select Linux.
      • Guest OS version: Select Ubuntu Linux (64-bit).
    2. Click Next.
  4. On the Select storage page, select the datastore where you want to store the configuration and disk files, then click Next.

  5. On the Customize Settings page, click Virtual Hardware tab to complete the following settings.
    1. Refer to the following table to set up CPU, Memory, and Hard Disk 1 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)

      vCPU 2 2 4 6 8 Contact Yeastar
      Memory 2 GB 4 GB 4 GB 8 GB 16 GB
      Storage Call Recording Disabled 40 GB

      or higher

      40GB

      or higher

      50 GB

      or higher

      100GB

      or higher

      200 GB

      or higher

      Call Recording Enabled Recommended: 1 TB
      Tip: 1 GB of storage holds approximately 1000 minutes of recorded calls. You can set up the storage based on your recording usage.

    2. Mount the ISO image of Yeastar P-Series Software Edition to the virtual machine.
      1. Click Add other device, then select CD/DVD drive.

      2. In the drop-down list of New CD/DVD Drive, select Datastore ISO file.

      3. In the pop-up window, select the ISO image of Yeastar P-Series Software Edition, then click Select.

    3. Click Next.
  6. On the Ready to complete page, review the settings, then click Finish.

    The virtual machine is created and displayed on Virtual Machines list.

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

Automatically install Yeastar P-Series Software Edition on the created virtual machine
  1. Select the created virtual machine, then click Power on.

  2. Open the console to view the installation process.

  3. Wait till the installation process is not 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, then click Power on.

  2. Open the console to view the installation process.

  3. Select Continue without updating or wait for seconds to check if there is a new version of installer.

  4. Select Custom storage layout and select Done.

  5. In the AVAILABLE DEVICES section, select the local disk, then select Add GPT Partition.

  6. 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.
    Table 2.
    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.

  7. Select Done.
  8. In the pop-up dialog box, select Continue to start installing P-Series Software Edition.

  9. Wait till the installation process is not 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. Access the PBX via SSH.
    1. At the IPPBX login prompt, type support and press Enter.

    2. At the Password prompt, type QhcyaxsGcywymg2022 and 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.

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

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

Open a web browser, enter the PBX's IP address in the address bar, and press Enter.

What to do next

Yeastar P-Series Software Edition is inactivated and not ready for use. To activate the PBX, see Activate and Initially Set up Yeastar P-Series Software Edition.
Important: With P-Series Software Edition activated, next time you want to access the PBX via SSH, you should use the username support and the console password configured on PBX web portal (Security > Security Settings > Console/SSH Access > Console > Console Password).