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 started, the components are also installed or updated.

    • The status changes to:

      • First activityindicator UpdatingComponents

      • Then status-yellow WaitingForConnect

        They may not see this status because it lasts only a short time.

      • The displayed state on the page updates itself. This can take 5-15min depending on network load etc.

    • Finally, the status changes to:

      • 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 appears.

  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.

run-server

Runs the gRPC server.

first-run

Runs actions that are necessary in order to prepare a new system that is being run for the first time

setip

Sets the IP address

factory-reset

Resets and shuts down the Linux installation to a state that can be shipped to a customer

show-log

Show log file.

unassign

Removes the assignment of the satellite.

motd

Shows the message of the day.

grpc-logging

Aktivieren oder Deaktivieren der gRPC-Protokollierung

monitoring

Start or stop satellite monitoring.

set-ntp

Configure NTP servers.

help

Display more information on a specific command.

version

Display 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        Runs actions that are necessary in order to prepare a new
                 system that is being run for the first time

setip            Sets the IP address

factory-reset    Resets and shuts down the Linux installation to a state that
                 can be shipped to a customer

show-log         EN: Logdatei anzeigen.

unassign         EN: Hebt die Zuordnung des Satellites auf.

motd             Shows the message of the day.

grpc-logging     Enable or disable gRPC logging

monitoring       Start or stop satellite monitoring.

set-ntp          Configure NTP servers.

help             Display more information on a specific command.

version          Display version information.

Hint

Here you will learn how to configure a static IP address.

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!