Preparations

Virtual machines

Hint

For satellite outsourcing, Hyper-V and VM Ware are supported.
Please refer to the System requirements for virtual machine sizing for your environment.
You can download the satellite Linux image from www.c4b.com/en/download/satellite-v9/.

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.

Open the Virtual Switch Manager (via the Hyper-V Manager).
Configure a new external switch, if desired.
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.
Create a new virtual machine.
Click Next.
Assign a name and click Next.
Select Generation 2.
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.
Select your virtual switch.
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/.
Check your settings and click Finish.
Switch to the virtual machine settings.
Disable the Secure Boot
Configure the number of virtual processors according to System requirements.
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.
Start the virtual machine and open the console. You will see the following output:

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.
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.
After that configure the satellite in XPhone Server.

VMware

Create a new virtual machine

Hint

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

Create a new virtual machine.
Enter a name and select the location.
Select the Esxi.
Select the data storage.
Select ESXi 6.7 and later for compatibility.
Choose as Guest OS Family = Linux and for Guest OS Version = Debian 10 (64-bit)
Choose the size of memory and the number of CPUs (for recommended values regarding sizing, see the System requirements).
Delete the existing hard disk and add an existing hard disk.
Set the type SCSI-Controller 0.

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.
Select the firmware EFI in the boot options.
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.
After that configure the satellite in XPhone Server.

Install VMware Tools

The installation can be called up in the vSphere Client for the respective virtual machine via the menu Install/Update VMware Tools. Here you can see the installation of the necessary packages as well as the manual start of the installation, as this is not started automatically in the virtual machine. In this example, the Debian 10 64-bit runs on an ESXi 6.7.0 host:

mount /dev/cdrom /mnt
cp /mnt/VMwareTools-8.6.0-425873.tar.gz /root/
cd /root/
tar xzf VMwareTools-8.6.0-425873.tar.gz
cd vmware-tools-distrib/
./vmware-install.pl -d -f

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

Open the console or connect to the satellite via SSH.

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:~#

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:~#

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 PBS’s (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.

Open the console or connect to the satellite via SSH.
Log in with the user root and the password A1111! (if you have not already changed this in the course of the Satellite setup).
Execute the following command satellite-bridge set-ntp <ntpServer1> [ntpServerN].

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.
  Also consult the port overview.

Have you found a mistake on this page?

Or is something not formulated well or too vague? Then we look forward to receiving an e-mail, preferably with a suggestion for improvement, to doku@c4b.de. Thank you very much!