Install Yeastar P-Series Software Edition on VMware Workstation
VMware Workstation is a hosted hypervisor that can be installed as a software application on an operating system (either Windows or Linux). It provides the ability to create and run virtual machines. This topic describes how to create a virtual machine on VMware Workstation and install Yeastar P-Series Software Edition on the created virtual machine.
Prerequisites
- Check if the version of VMware Workstation is 17.0.0 or later.
- Download an image file of Yeastar P-Series Software Edition.Note: Yeastar P-Series Software Edition is supported on Ubuntu System and Debian System.
For Automatic Installation, you can install Yeastar PBX on Ubuntu System only; For Manual Installation, you can install Yeastar PBX on either Ubuntu System or Debian System.
Table 1. Item Automatic Installation Manual Installation Image File Name and Format Yeastar-P_SOFTWARE-auto-{version} -ubuntu.iso
Example: Yeastar-P_SOFTWARE-auto-83.15.0.22-ubuntu.iso
- Ubuntu: Yeastar-P_SOFTWARE-manual-{version}
-ubuntu.iso
Example: Yeastar-P_SOFTWARE-manual-83.15.0.22-ubuntu.iso
- Debian: Yeastar-P_SOFTWARE-manual-{version}
-debian.iso
Example: Yeastar-P_SOFTWARE-manual-83.15.0.22-debian.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
- Ubuntu: Yeastar-P_SOFTWARE-manual-{version}
Procedure
Video Tutorial
Step 1. Create a virtual machine
- Launch VMware Workstation, go to .
- Follow the wizard to create a virtual machine.
- Select the type of virtual machine that you want to create and
click Next.
In this example, select Typical.
- Select I will install the operating system later and click Next.
- Set Guest operating system to
Linux, set
Version to Ubuntu
64-bit
or
Debian
11.x 64-bit according to your
needs, then click Next.
In this example, we choose Ubuntu 64-bit.
- Specify a name to help you identify the virtual machine and specify a location to store the virtual machine files, then click Next.
- 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..
- Review configurations of the virtual machine to be created and click Finish.
- Select the type of virtual machine that you want to create and
click Next.
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).
- Set up the created virtual machine on a computer with single NIC
- Set up the created virtual machine on a computer with dual NIC
- Set up the created virtual machine on a computer with single NIC
-
- Select the created virtual machine, click Edit virtual machine settings.
- Check and ensure that there is only one hard disk on the virtual machine, or an installation error may occur.
- 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.- On the Hardware tab, select CD/DVD (SATA).
- In the Device status section, select the checkbox of Connect at power on.
- In the Connection section,
select Use ISO image file and browse to the
location of the
.iso
image file.
- 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.
- Go to .
- In the Network connection section, select Bridged: Connected directly to the physical network.
- Click OK.
- Set firmware type of the virtual machine to Basic Input Output
System (BIOS).
- Go to .
- In the Firmware type section, select BIOS.
- Click OK.
- Set up the created virtual machine on a computer with dual NIC
-
- Set virtual network as Bridged, and select the physical network
card to be paired with the virtual machine.
- Go to .
- Optional: If you don't run the PC as an administrator, you need to click Change Settings to modify network settings.
- Select VMnet0, then select Bridged (connect VMs directly to the external network).
- In the drop-down list of Bridged to, select a physical network card.
- Click OK.
- Set up virtual machine.
- Select the created virtual machine, click Edit virtual machine settings.
- Check and ensure that there is only one hard disk on the virtual machine, or an installation error may occur.
- 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.- On the Hardware tab, select CD/DVD (SATA).
- In the Device status section, select the checkbox of Connect at power on.
- In the Connection
section, select Use ISO image file and
browse to the location of the
.iso
image file.
- Configure network of the virtual machine as
Specific virtual network
and select the virtual network that you have
configured.
- Go to .
- In the Network connection section, select Custom: Specific virtual network.
- Select the virtual network to be connected. In this example, select VMnet0.
- Click OK.
- Set firmware type of the virtual machine to Basic
Input Output System (BIOS).
- Go to .
- In the Firmware type section, select BIOS.
- Click OK.
- Set virtual network as Bridged, and select the physical network
card to be paired with the virtual machine.
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
- Manually install Yeastar P-Series Software Edition on the created virtual machine
- Automatically install Yeastar P-Series Software Edition on the created virtual machine
-
- Select the created virtual machine, click Power on this virtual machine.
- Wait till the installation process is
not running, then press
Enter
.If
IPPBX login
is displayed and no errors likewait 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
-
- Select the created virtual machine, click Power on this virtual machine.
- Select Continue without updating or wait for seconds to check if there is a new version of installer.
- Select Custom storage layout and select Done.
- 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. - Select the local disk, then select Add GPT
Partition to add a
/swap
partition. - Select the local disk, then select Add GPT
Partition to add a
/
partition. - Select the local disk, 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.
- Select the local disk, then select Add GPT
Partition to add a
- Select Done.
- In the pop-up dialog box, select Continue to start installing P-Series Software Edition.
- Wait till the installation process is not running,
then press
Enter
.If a
IPPBX login
prompt is displayed and no errors likewait 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
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.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.
- Access the PBX via SSH.
- At the
IPPBX login
prompt, typesupport
and pressEnter
. - At the
Password
prompt, typeQhcyaxsGcywymg2022
and pressEnter
.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.
- At the
- Type
1
and pressEnter
to update the network configuration. - Change the IP address of Yeastar P-Series Software Edition as
follows.
- At the
Please enter IP address
prompt, type the desired IP address and pressEnter
.In this example, type
192.168.28.45
. - At the
Please enter netmask
prompt, type the subnet mask and pressEnter
.In this example, type
255.255.255.0
. - At the
Please enter gateway
prompt, type the gateway address and pressEnter
.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.
- At the
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
support
and the console password configured on PBX web
portal ( ).