Virtual Machine Installation

Owned by Nathaniel Halbrooks
Last updated: Mar 25, 2024 by Kelli Higdon
6 min read

Instructions on how to get started with Sangoma VM SBC

 

Download

The Wiki download page contains the latest Sangoma SBC ISO. 

  • SBC Downloads
    It is recommended that customers download the latest Sangoma SBC ISO.
    Only use the older versions if you are already in production and need to remain on the old version. 

 

Please download the latest Sangoma ISO on to your system.

 

Sangoma SBC VM License

Sangoma Sales will provide you with a: License Key

  • You will use this key the generate SBC License File and upload it to the Sangoma SBC GUI.  

If you do not have the Sangoma SBC License Key pleases contact Sangoma Sales. (sales@sangoma.com)

 

SBC VM Installation

  • Install Sangoma ISO on VM of choice

    • Supported VM Platforms

      • Vmware

      • XenServer

      • VirtualBox

      • Hyper-V

    • Requirements

      • Min:

        • 1 GIG memory

        • 1 CPU

        • Bridged Network Device

    • VM Benchmarks Reference

  • Follow the installation instructions.
    Next Step is to Log into the Sangoma SBC GUI 
     

  • Default WebGUI Login

    • http://<ipof VM box>

      • User: root

      • Pass: <specify password you used on install>

 

License File Generation

Once you have logged into the Sangoma SBC GUI.
One of the first steps is to install the correct license.

In order to generate the Sangoma SBC license file, you need the License Key.

  • Refer to licensing Key section above.

Step by Step Instructions

 

  • Specify above license key
     

  • Specify the MAC address of the Sangoma SBC VM eth0 device.

    • To determine your VM eth0macaddress: 

      • Navigate to Sangoma SBC GUI

      • Login

      • Click on Help -> About

        • The About page contains System Information table.

        • This table will contain the MAC address of your eth0 device.

  • Once you have filled out the MAC address and the Key
    Click generate a license
     

  • Download License to your computer.

 

Apply Sangoma SBC License

Navigate to Sangoma SBC GUI

  • Login

  • Click on System -> License

  • Click on Upload

  • Select downloaded license file

 

At this pointyourwill be ready to use the SBC.

 

Documentation

User Manual

  • Sangoma SBC Admin Manualwill provide extensive general SBC documentation

Getting Started

  • Wikiisusedas supplementary documentation

    • Specific configuration examples

    • Application notes 

  • No labels

1 Comment

  1. Shahin NAZIR

    Ubuntu Server + Virsh Virtual Server + OpenvSwitch

     

     

    Installation Ubuntu Server then necessary packages for Virsh and OpenVSwitch 

    sudo apt-get install qemu-kvm libvirt-bin ubuntu-vm-builder bridge-utils && apt-get install virtinst openvswitch-switch

     

    Backup for Network Card settings

     cp /etc/network/interfaces /etc/network/interfaces.backup

     

    Editing /etc/network/interfaces

    nano /etc/network/interfaces

    # This file describes the network interfaces available on your system
    # and how to activate them. For more information, see interfaces(5).

    # The loopback network interface
    auto lo
    iface lo inet loopback

    # The primary network interface
    #auto p2p1
    #iface p2p1 inet dhcp

    auto p2p1
    iface p2p1 inet manual
    up ifconfig $IFACE 0.0.0.0 up
    down ifconfig $IFACE 0.0.0.0 down
    post-up echo 1 > /proc/sys/net/ipv6/conf/$IFACE/disable_ipv6
    post-up ethtool -G $IFACE rx 4096; for i in rx tx sg tso ufo gso gro lro; do ethtool -K $IFACE $i off; done #

    auto vm-test-vlan2
    iface vm-test-vlan2 inet static
    address 10.XX.0.XX
    network 10.XX.0.0
    netmask 255.255.254.0
    broadcast 10.XX.1.254
    gateway 10.XX.0.XX
    dns-nameservers 10.XX.0.XX

     

    Creating Bridge to Physical Ethernet Port

    ovs-vsctl add-br br-int

    Checking 

    root@ubuntu-kvm-test:~# ovs-vsctl show 
    234f640c-1d44-4d6e-99da-9d53858b9120
    Bridge br-int
    Port br-int
    Interface br-int
    type: internal
    ovs_version: "2.0.2"

     

    Creating Port to Virtual Bridge.

     ovs-vsctl add-port br-int vm-test-vlan2 -- set interface vm-test-vlan2 type=internal 

    root@ubuntu-kvm-test:~# ovs-vsctl show 
    234f640c-1d44-4d6e-99da-9d53858b9120
    Bridge br-int
    Port "vm-test-vlan2"
    Interface "vm-test-vlan2"
    type: internal
    Port br-int
    Interface br-int
    type: internal
    ovs_version: "2.0.2"

     

    root@ubuntu-kvm-test:~# ifconfig
    br-int Link encap:Ethernet HWaddr 7e:24:84:68:b7:4c 
    inet6 addr: fe80::d09c:1eff:fe04:e374/64 Scope:Link
    UP BROADCAST RUNNING MTU:1500 Metric:1
    RX packets:8 errors:0 dropped:0 overruns:0 frame:0
    TX packets:8 errors:0 dropped:0 overruns:0 carrier:0
    collisions:0 txqueuelen:1 
    RX bytes:536 (536.0 B) TX bytes:648 (648.0 B)

    lo Link encap:Local Loopback 
    inet addr:127.0.0.1 Mask:255.0.0.0
    inet6 addr: ::1/128 Scope:Host
    UP LOOPBACK RUNNING MTU:65536 Metric:1
    RX packets:0 errors:0 dropped:0 overruns:0 frame:0
    TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
    collisions:0 txqueuelen:1 
    RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)

    p2p1 Link encap:Ethernet HWaddr fc:3f:db:5a:a1:f1 
    inet addr:10.XX.0.XX Bcast:10.XX.1.255 Mask:255.255.254.0
    inet6 addr: fe80::fe3f:dbff:fe5a:a1f1/64 Scope:Link
    UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
    RX packets:51230 errors:0 dropped:0 overruns:0 frame:0
    TX packets:10983 errors:0 dropped:0 overruns:0 carrier:0
    collisions:0 txqueuelen:1000 
    RX bytes:65081691 (65.0 MB) TX bytes:950088 (950.0 KB)

    virbr0 Link encap:Ethernet HWaddr 2e:8f:3a:e5:75:3d 
    inet addr:192.168.122.1 Bcast:192.168.122.255 Mask:255.255.255.0
    UP BROADCAST MULTICAST MTU:1500 Metric:1
    RX packets:0 errors:0 dropped:0 overruns:0 frame:0
    TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
    collisions:0 txqueuelen:1000 
    RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)

    vm-test-vlan2 Link encap:Ethernet HWaddr e2:ef:b5:85:32:6c 
    inet addr:10.XX.0.XX Bcast:10.XX.1.254 Mask:255.255.254.0
    inet6 addr: fe80::e0ef:b5ff:fe85:326c/64 Scope:Link
    UP BROADCAST RUNNING MTU:1500 Metric:1
    RX packets:0 errors:0 dropped:0 overruns:0 frame:0
    TX packets:8 errors:0 dropped:0 overruns:0 carrier:0
    collisions:0 txqueuelen:1 
    RX bytes:0 (0.0 B) TX bytes:648 (648.0 B)

     

    Connect Physical port To Virtual Openvswitch port 

    ovs-vsctl add-port br-int p2p1

     

    Reboot The System!  reboot

     

    View and Check final situation.

    root@ubuntu-kvm-test:~# ovs-vsctl show 
    234f640c-1d44-4d6e-99da-9d53858b9120
    Bridge br-int
    Port "p2p1"
    Interface "p2p1"
    Port "vm-test-vlan2"
    Interface "vm-test-vlan2"
    type: internal
    Port br-int
    Interface br-int
    type: internal
    ovs_version: "2.0.2"
    root@ubuntu-kvm-test:~#

     

    root@ubuntu-kvm-test:~# ifconfig
    br-int Link encap:Ethernet HWaddr fc:3f:db:5a:a1:f1 
    inet6 addr: fe80::6cdf:4eff:fea3:f8c5/64 Scope:Link
    UP BROADCAST RUNNING MTU:1500 Metric:1
    RX packets:2127 errors:0 dropped:0 overruns:0 frame:0
    TX packets:8 errors:0 dropped:0 overruns:0 carrier:0
    collisions:0 txqueuelen:1 
    RX bytes:277839 (277.8 KB) TX bytes:648 (648.0 B)

    lo Link encap:Local Loopback 
    inet addr:127.0.0.1 Mask:255.0.0.0
    inet6 addr: ::1/128 Scope:Host
    UP LOOPBACK RUNNING MTU:65536 Metric:1
    RX packets:18 errors:0 dropped:0 overruns:0 frame:0
    TX packets:18 errors:0 dropped:0 overruns:0 carrier:0
    collisions:0 txqueuelen:1 
    RX bytes:1360 (1.3 KB) TX bytes:1360 (1.3 KB)

    p2p1 Link encap:Ethernet HWaddr fc:3f:db:5a:a1:f1 
    UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
    RX packets:2377 errors:0 dropped:0 overruns:0 frame:0
    TX packets:158 errors:0 dropped:0 overruns:0 carrier:0
    collisions:0 txqueuelen:1000 
    RX bytes:342841 (342.8 KB) TX bytes:18219 (18.2 KB)

    virbr0 Link encap:Ethernet HWaddr 86:96:86:6a:af:d7 
    inet addr:192.168.122.1 Bcast:192.168.122.255 Mask:255.255.255.0
    UP BROADCAST MULTICAST MTU:1500 Metric:1
    RX packets:0 errors:0 dropped:0 overruns:0 frame:0
    TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
    collisions:0 txqueuelen:1000 
    RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)

    vm-test-vlan2 Link encap:Ethernet HWaddr f6:b0:d6:12:08:84 
    inet addr:10.30.0.31 Bcast:10.30.1.254 Mask:255.255.254.0
    inet6 addr: fe80::f4b0:d6ff:fe12:884/64 Scope:Link
    UP BROADCAST RUNNING MTU:1500 Metric:1
    RX packets:2321 errors:0 dropped:0 overruns:0 frame:0
    TX packets:161 errors:0 dropped:0 overruns:0 carrier:0
    collisions:0 txqueuelen:1 
    RX bytes:293889 (293.8 KB) TX bytes:18421 (18.4 KB)

     

    Creating Virtual Port on Openvswitch for FreePBX

     ovs-vsctl add-port br-int br-fpbx -- set interface br-fpbx type=internal

     

    root@ubuntu-kvm-test:~# ovs-vsctl show
    234f640c-1d44-4d6e-99da-9d53858b9120
    Bridge br-int
    Port "p2p1"
    Interface "p2p1"
    Port br-fpbx
    Interface br-fpbx
    type: internal
    Port "vm-test-vlan2"
    Interface "vm-test-vlan2"
    type: internal
    Port br-int
    Interface br-int
    type: internal
    ovs_version: "2.0.2"

     

    Creating Disk space for FreePBX

    root@ubuntu-kvm-test:~# vgdisplay 
    --- Volume group ---
    VG Name ubuntu-kvm-test-vg
    System ID 
    Format lvm2
    Metadata Areas 1
    Metadata Sequence No 3
    VG Access read/write
    VG Status resizable
    MAX LV 0
    Cur LV 2
    Open LV 2
    Max PV 0
    Cur PV 1
    Act PV 1
    VG Size 119.00 GiB
    PE Size 4.00 MiB
    Total PE 30464
    Alloc PE / Size 6627 / 25.89 GiB
    Free PE / Size 23837 / 93.11 GiB
    VG UUID sjwdaz-piR5-YbNZ-fDNV-fkfa-hKnS-nRdeKl

     

    lvcreate -n freepbx -L 15G ubuntu-kvm-test-vg 

    lvdisplay
    --- Logical volume ---
    LV Path /dev/ubuntu-kvm-test-vg/root
    LV Name root
    VG Name ubuntu-kvm-test-vg
    LV UUID KjDNhA-dKcx-mD2U-axAv-bKf8-pflt-1I1QPW
    LV Write Access read/write
    LV Creation host, time ubuntu-kvm-test, 2017-07-05 15:30:06 +0100
    LV Status available
    # open 1
    LV Size 13.97 GiB
    Current LE 3576
    Segments 1
    Allocation inherit
    Read ahead sectors auto
    - currently set to 256
    Block device 252:0

    --- Logical volume ---
    LV Path /dev/ubuntu-kvm-test-vg/swap_1
    LV Name swap_1
    VG Name ubuntu-kvm-test-vg
    LV UUID JSoFjf-uG07-eN38-mi4F-AiiB-yx0m-638gwH
    LV Write Access read/write
    LV Creation host, time ubuntu-kvm-test, 2017-07-05 15:30:06 +0100
    LV Status available
    # open 2
    LV Size 11.92 GiB
    Current LE 3051
    Segments 1
    Allocation inherit
    Read ahead sectors auto
    - currently set to 256
    Block device 252:1

    --- Logical volume ---
    LV Path /dev/ubuntu-kvm-test-vg/freepbx
    LV Name freepbx
    VG Name ubuntu-kvm-test-vg
    LV UUID TdyMIR-3e57-Q081-yLdd-j7LT-57LR-7UqXV1
    LV Write Access read/write
    LV Creation host, time ubuntu-kvm-test, 2017-07-05 16:10:57 +0100
    LV Status available
    # open 0
    LV Size 15.00 GiB
    Current LE 3840
    Segments 1
    Allocation inherit
    Read ahead sectors auto
    - currently set to 256
    Block device 252:2

     

    export EDITOR=nano

     

    Installing Virtual Machine 

    virt-install --name freepbx --hvm --noautoconsole --ram 1024 --nonetworks --vcpus=1 --graphics vnc,port=5911,listen=0.0.0.0 --os-type=linux --cdrom /home/isos/SNG7-FPBX-64bit-1706-1.iso --disk path=/dev/ubuntu-kvm-test-vg/freepbx

     

    virsh list --all
    Id Name State
    ----------------------------------------------------
    2 freepbx running

     

    Editing Virtual Machine

    virsh edit freepbx

     

    <boot dev='cdrom'/>

    <interface type='direct'>
    <source dev='br-fpbx' mode='passthrough'/>
    <model type='virtio'/>
    </interface>

     

    Starting to install FreePBX on VNC Viever

    virsh start freepbx --paused

    Attaching Image Disk to Virtual Machine
    virsh attach-disk --type cdrom --mode readonly freepbx /home/isos/SNG7-FPBX-64bit-1706-1.iso hdc

     

    virsh resume freepbx

    Now VNC viewer xxx.xxx.xxx.xxxx:5911 ( your Server IP address : VNC Port ) Then we are continue to install FreePBX on GUI.

     

    After finish installation we have to remove attached image disk on our virtual machine.

    virsh destroy freepbx

    Auto Start after reboot our Host Virtual Machine 
    virsh autostart freepbx
    virsh start freepbx

Return to Documentation Home I Return to Sangoma Support