Preparations

Virtual machines

Hint

Hyper-V

Here you will see how to configure the Satellite as a virtual machine in Hyper-V.

In order to find the satellite in the local network, it is recommended to use a virtual switch in bridged mode. If such a switch already exists, it can be used.

  1. Open the Virtual Switch Manager (via the Hyper-V Manager).

    sat1

  2. Configure a new external switch, if desired.

    sat2

  3. Configure the virtual switch.

    • The name can be assigned freely (here in the example External).

    • In the dropdown menu the own network card must be selected. Please select a real network card and not loopback adapters or similar.

    • When you press Ok, the network connection is briefly restarted. But it should be back after a few seconds.

    sat3

  4. Create a new virtual machine.

    sat4

  5. Click Next.

    sat5

  6. Assign a name and click Next.

    sat6

  7. Select Generation 2.

    sat7

  8. Select the size of the RAM (for recommended values regarding sizing, see the System requirements).

    Caution

    Please do not enable the Use Dynamic Memory for this virtual machine. option.

    sat8

  9. Select your virtual switch.

    sat9

  10. Select Use an existing virtual hard disk and point to the locally copied virtual hard disk C4BLinuxSatellite.vhdx.

    Hint

    You can download the satellite Linux image from www.c4b.com/en/download/satellite-v9/.

    sat10

  11. Check your settings and click Finish.

    sat11

  12. Switch to the virtual machine settings.

  13. Disable the Secure Boot

    sat12

  14. Configure the number of virtual processors according to System requirements.

    sat13

  15. Optional: You can permanently configure the MAC address so that the DHCP server always assigns the same IP to the satellite. Alternatively, you can manually configure a static IP address.

    sat14

  16. Start the virtual machine and open the console. You will see the following output:

    sat15

    Hint

    Among other things, you will also see the root password A1111!. This is only displayed after the first startup and if the password has not been changed yet. It is strongly recommended to change the root password during the Satellite setup.

  17. If you have not assigned the IP address via a DHCP using MAC address assignment, now configure a Static IP address and if necessary NTP server.

  18. After that configure the satellite in XPhone Server.

VM Ware

Hint

You can download the satellite Linux image from www.c4b.com/en/download/satellite-v9/.

  1. Create a new virtual machine.

    vmware1

  2. Enter a name and select the location.

    vmware2

  3. Select the Esxi.

    vmware3

  4. Select the data storage.

    vmware4

  5. Select ESXi 6.7 and later for compatibility.

    vmware5

  6. Choose as Guest OS Family = Linux and for Guest OS Version = Debian 10 (64-bit)

    vmware6

  7. Choose the size of memory and the number of CPUs (for recommended values regarding sizing, see the System requirements).

  8. Delete the existing hard disk and add an existing hard disk.

    vmware7

  9. Set the type SCSI-Controller 0.

    vmware8

    Hint

    All satellite images up to version V9.0.7 had to be configured as IDE. However, these existing satellites will continue to work. Only with a upgrade of the satellite the virtual hard disk must also be configured as SCSI.

  10. Select the firmware EFI in the boot options.

    vmware9

  11. If you have not assigned the IP address via a DHCP using MAC address assignment, now configure a Static IP address and if necessary NTP server.

  12. After that configure the satellite in XPhone Server.

IP address

Assign via DHCP

If you have given the virtual machine a MAC address, you can make a MAC address assignment in its DHCP to always the same IP.

You can then use this IP to configure the satellite in XPhone Connect Server.

Configure manually

If you prefer to assign a static IP address to the satellite, then the following configuration must be performed

  1. Open the console or connect to the satellite via SSH.

  2. Log in with the user root and the password A1111! (if you have not already changed this in the context of the Satellite setup):

    login as: root
    root@192.168.178.76's password:
    Linux C4BXCC2204061514 4.19.0-14-amd64 #1 SMP Debian 4.19.171-2 (2021-01-30) x86_64
    
    ################################################
    XPhone Call Controller - C4B Com For Business AG
    ################################################
    
    Satellite-Bridge Version: 9.0.150.1151
    
    The Satellite is not assigned to any XPhone Connect Server
    
    
    The programs included with the Debian GNU/Linux system are free software;
    the exact distribution terms for each program are described in the
    individual files in /usr/share/doc/*/copyright.
    
    Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
    permitted by applicable law.
    Last login: Thu Apr  7 07:35:29 2022 from 192.168.178.72
    root@C4BXCC2204061514:~#
    
  3. Run the satellite-bridge setip command and enter your information:

    root@C4BXCC2204061514:~# satellite-bridge setip
    ############################################
    Number 0 - NetworkInterface configuration
    
    allow-hotplug eth0
    iface eth0 inet dhcp
    
    ############################################
    Select a number (#) of the NetworkInterface you want to modify. Insert -1 to cancel
    0
    Insert 'address' - or leave empty
    192.168.178.76
    Insert 'broadcast' - or leave empty
    192.168.178.255
    Insert 'netmask' - or leave empty
    255.255.255.0
    Insert 'gateway' - or leave empty
    192.168.178.1
    Insert 'dns-nameserver' - or leave empty
    192.168.178.254
    Insert 'dns-nameserver 1' - or leave empty
    192.168.178.1
    Insert 'dns-nameserver 2' - or leave empty
    8.8.8.8
    ############################################
    
    Save the following configuration?
    
    
    allow-hotplug eth0
    iface eth0 inet static
    address 192.168.178.76
    broadcast 192.168.178.255
    netmask 255.255.255.0
    gateway 192.168.178.1
    dns-nameservers 192.168.178.254 192.168.178.1 8.8.8.8
    
    
    Y / N
    y
    ############################################
    root@C4BXCC2204061514:~#
    
  4. You can then use this IP to configure the satellite in XPhone Connect Server.

NTP Address (Time Server)

Hint

Always use the same NTP servers for the phone attachments (or SBCs) and XPhone Satellite.

Assign via DHCP

If the DHCP distributes the NTP addresses, these are also used automatically. A manual configuration is not necessary.

Configure manually

Attention

The configuration of the NTP server leads to a disconnection of all calls (e.g. meetings). Please do not configure during running sessions.

  1. Open the console or connect to the satellite via SSH.

  2. Log in with the user root and the password A1111! (if you have not already changed this in the course of the Satellite setup).

  3. Execute the following command satellite-bridge set-ntp <ntpServer1> [ntpServerN].

  4. Example of two NTP servers to be set:

    root@C4BXCC2204061514:~# satellite-bridge set-ntp 172.16.1.1 172.16.1.2
    

Hint

  • A few seconds to a few minutes may pass before the command is completed.

  • If the command is not finished after more than one minute, please abort the command with the key combination STRG + C.

    • Probably the NTP is not reachable - check firewalls between satellite and NTP.

    • The satellite must reach the NTP server on UDP port 123.

Have you found an mistake on this page?

Please send us a hint about this error by mail to doku@c4b.de. Thank you very much!