Install Yeastar P-Series Software Edition on Mini PC via Command Line

This topic describes how to install Yeastar P-Series Software Edition on Ubuntu in a mini PC via command line.

Requirements

Make sure that your mini PC meets the minimum system requirements according to the extensions and concurrent calls covered by your PBX license.

1-19 EXT

(1-4 CC)

 20-40 EXT

(5-8 CC)

 41-69 EXT

(9-16 CC)

 70-130 EXT

(17-32 CC)
vCPU 2 2 4 4
CPU Frequency 2.4 GHz 2.4 GHz 2.4 GHz 2.4 GHz
CPU Family Intel i3 (Gen.8)

or equivalent

 Intel i3 (Gen.8)

or equivalent

 Intel i5 (Gen.8)

or equivalent

 Intel i5 (Gen.8)

or equivalent
Memory 2 GB 4 GB 4 GB 4 GB
Storage Call Recording Disabled 40 GB 40 GB 50 GB 50 GB
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.

Procedure

Step 1. Write Ubuntu 24.04 Image to a USB Drive

  1. Download Ubuntu 24.04 ISO image.
  2. Format your USB drive with FAT32.
  3. Open the Ubuntu ISO image via Rufus.

    1. In the Device drop-down list, select your USB drive.
    2. In the Boot selection section, click SELECT to select the Ubuntu ISO image.
  4. Write Ubuntu ISO image to the USB drive.
    1. Click START.

    2. In the pop-up window, select Write in ISO Image mode, then click OK.

    3. In the pop-up window, click OK.

      If the status shows "READY", it indicates that the process of writing ISO image is completed.

Step 2. Install Ubuntu 24.04 LTS

  1. Connect the USB drive to the USB port on mini PC.
  2. Press the power button to power on mini PC, and immediately press a key to enter the "Aptio Setup".
    Note: The key to enter the setup depending on your computer manufacturer and model.

  3. Set the mini PC to boot from the USB drive.
    1. Go to Boot tab, then set Boot Option #1 to boot from the USB drive.

    2. Go to Save & Exit tab, then select Save Changes and Exit and confirm the operation.

  4. Select Try or Install Ubuntu Server.

  5. Select your preferred installation language.

  6. Select your preferred keyboard layout, then select Done.

  7. Select your preferred installation type, then select Done.

  8. Set an interface for network and internet connection.
    1. Select an active network interface, then select Edit IPv4.

    2. Set IPv4 Method to Manual.

    3. Fill in the IP details, then select Save.

    4. Select Done to confirm the setting.

  9. Set proxy as needed, then select Done.

    The installer will perform a mirror test by updating the package index.

  10. Once the mirror test is complete, select Done.

  11. Configure disk partitions as needed, then select Continue to write the changes to disk.

  12. Create a user account, then select Done.

  13. Select whether to enable Ubuntu Pro, then select Continue.

  14. Select to install the OpenSSH server, then select Done.

  15. Select whether to install some featured applications in the form of snaps, then select Done.

    The installer will copy all the files from the USB drive and configure all the required settings.

  16. Select Reboot Now to reboot.

  17. When you see the following prompt, remove the USB drive from mini PC, then press Enter to continue.

Step 3. Install Yeastar P-Series Software Edition

  1. Log in as the root user.
    1. Log in to the user account.

    2. Run sudo -i, then enter the password of the user account, so as to switch to root.

  2. Run the following commands to check the NIC name.
    1. Run apt install net-tools.
    2. Run ifconfig.

    If the NIC name is enp1s0, proceed to install PBX.

    Note: If the NIC name is NOT enp1s0, run the following commands to modify the network.
    1. Run cd /etc/netplan/, then run ls to check the name of the YAML configuration file.

    2. Run sed -i's/{nic_name}/eth0/g' /etc/netplan/{name_of_yaml_configuration_file}.yaml.

    3. Run netplan apply to apply the updated network configuration.
    4. Run cd to return to the home directory.
  3. Run the following commands to install Yeastar P-Series Software Edition.

    1. wget https://update-ys2015-alicloud.oss-cn-hongkong.aliyuncs.com/YeastarSupport/pseinstallscripts/enp1s0_static/enp1s0_ubuntu_static.sh
    2. chmod +x enp1s0_ubuntu_static.sh

    3. ./enp1s0_ubuntu_static.sh

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