Configuration
Create new satellite
Navigate to: System settings > Telephony & Meetings > Satellites
Click on the New Satellite button.
The Create new satellite dialog box opens. Enter the following values:
Name
Select a unique Name for the satellite.
IP
Enter the IP address of the satellite. This can be read from the console.
Root password
Enter a new root password for the satellite’s Debian operating system.
Caution
In the factory setting, the password is
A1111!
and it will be changed during initial configuration.Remember the root password. The XPhone Server does not know your root password for security reasons.
A later change of the root password is only possible via the console of the satellite via:
root passwd
Save your configuration.
The process can take a few seconds, as the connection to the satellite is established here and certificates are exchanged.
You can see the connection status in the list overview:
Assigned
Highlight the entry in the list and press the Start button.
When the satellite is launched, the software components are also installed or updated if necessary, which can take up to 15 minutes depending on the network.
The status changes to:
First
UpdatingComponents
Then
WaitingForConnect
You may not see this status as it is temporary.
The status displayed on the page is automatically updated.
Finally, the display changes to status:
Running
Outsourcing the XCC
It is recommended to deactivate the XCC and all gateways connected to it before outsourcing.
Navigate to System settings > Telephony & Meetings > Telephony > SIP > XCC.
Select the XCC entry and click Edit.
Activate the Disabled checkbox.
Click the Save button and wait until the XCC deactivated
shows.
Proceed in exactly the same way with all SIP trunks that have been set up.
Open the XCC again.
Select the radio button Use outsourced XCC on a Linux satellite and select the satellite in the selection list.
Then activate the XCC again.
Hint
If the XCC does not work properly or, for example, “localhost” is still displayed as IP in the diagnostics, disabling and re-enabling often helps.
Configure SIP Gateways
Hint
This is mainly about the offloading of the XCC to the Linux satellite. The previous connection instructions are still valid, although the IP addresses of the satellite must be configured as targets in the telephone systems. Please also refer to the chapter XPhone Call Controller - XCC.
Navigate to System settings > Telephony & Meetings > Telephony > SIP. Select an existing SIP gateway here, or create a new SIP gateway object with the New SIP gateway button.
When making the settings, it must be ensured that the IP address of the XPhone Call Controller corresponds to that of the outsourced Linux satellite.
Tip
All other XCC settings can be found in the chapter: XPhone Call Controller - XCC.
Satellite console tool
Usually you do not need to administrate the satellite manually. Especially for the satellite there is the script satellite-bridge
. The following options can be called after satellite-bridge
.
Command |
Description |
---|---|
|
Runs the gRPC Server. |
|
Performs actions required to prepare a new system that is being commissioned for the first time. |
|
Legt die IP-Adresse fest. |
|
Resets the Linux computer to status on deliver< and shuts it down for delivery to the customer. |
|
Show log file. |
|
Removes the assignment of the satellite. |
|
Shows the message of the day. |
|
Switch on or off gRPC logging. |
|
Start or stop satellite monitoring. |
|
Configure NTP servers. |
|
Shows NTP configuration. |
|
Show more information on certain command. |
|
Show version information. |
Here is an example of satellite-bridge help
(also equivalent to satellite-bridge
):
root@C4BXCC2204061514:~# satellite-bridge help
SatelliteBridge 9.0.25.0
© C4B Com For Business AG. Alle Rechte vorbehalten.
run-server Runs the gRPC Server.
first-run Execute all of the steps necessary for configuring a new
system the first time it starts.
setip Sets the IP address
factory-reset Resets the Linux computer to status on deliver< and shuts it
down for delivery to the customer.
show-log Show log file.
unassign Unassigns the satellite.
motd Shows the login message
grpc-logging Switch on or off gRPC logging.
monitoring Switch satellite monitoring on or off.
set-ntp Configure NTP servers.
get-ntp Shows NTP configuration.
disable-ntp Disable NTP server.
help Show more information on certain command.
version Show version information.
Hint
Here you will learn how to configure a static IP address.
NTP query
Here you will learn how to interpret the NTP query with satellite-bridge get-ntp
:
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!