Configuration

Create new satellite

  1. Navigate to: System settings > Telephony & Meetings > Satellites

  2. Click on the New Satellite button.

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

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

      • status-grey Assigned

  5. 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 activityindicator UpdatingComponents

      • Then status-yellow 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:

      • status-green Running

Outsourcing the XCC

It is recommended to deactivate the XCC and all gateways connected to it before outsourcing.

  1. Navigate to System settings > Telephony & Meetings > Telephony > SIP > XCC.

  2. Select the XCC entry and click Edit.

  3. Activate the Disabled checkbox.

  4. Click the Save button and wait until the XCC deactivated deactivated shows.

  5. Proceed in exactly the same way with all SIP trunks that have been set up.

  6. Open the XCC again.

  7. Select the radio button Use outsourced XCC on a Linux satellite and select the satellite in the selection list.

    xcc-outsourcing

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

xcc-outsourcing

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

run-server

Runs the gRPC Server.

first-run

Performs actions required to prepare a new system that is being commissioned for the first time.

setip

Legt die IP-Adresse fest.

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

Removes the assignment of the satellite.

motd

Shows the message of the day.

grpc-logging

Switch on or off gRPC logging.

monitoring

Start or stop satellite monitoring.

set-ntp

Configure NTP servers.

get-ntp

Shows NTP configuration.

help

Show more information on certain command.

version

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!