Wichtige Befehle

Notfunk-Telefonanlage

Zurück
Technik
- Übersicht
- Modulare Koffer
- Warnmeldungen
- Telefonanlage (NFPBX)

Wichtige Befehle

Auf dieser Seite möchten wir euch die wichtigsten Befehle im Umgang mit der Telefonanlage darstellen. Diese Liste ist nicht vollständig, kann aber beim Kennenlernen der Anlage behilflich sein.

Prüfen, ob die Telefonanlage läuft

Für den reibungslosen Betrieb der PBX ist es notwendig, dass mehrere Container laufen und erreichbar sind. Der Status der Container kann mit den folgenden Befehlen geprüft werden.

    $ cd /opt/docker/nfpbx
    $ docker compose ps

Beispiel:

pbxtest:~$ cd /opt/docker/nfpbx
pbxtest:/opt/docker/nfpbx$ docker compose ps
NAME                IMAGE                                     COMMAND                  SERVICE             CREATED             STATUS                  PORTS
db                  registry.emcom.io:81/mariadb:10.9         "docker-entrypoint.s…"   db                  25 hours ago        Up 21 hours
pbx                 registry.emcom.io:81/pbx:stable           "/usr/sbin/asterisk …"   pbx                 25 hours ago        Up 21 hours
pbxfrontend         registry.emcom.io:81/pbxfrontend:stable   "/NotfunkSIPManager"     pbxfrontend         25 hours ago        Up 21 hours
phonemgmtd          registry.emcom.io:81/phonemgmtd:stable    "/phonemgmtd"            phonemgmtd          25 hours ago        Up 21 hours
timeserver          registry.emcom.io:81/ntp:9f6b1d2433       "/bin/sh /opt/startu…"   timeserver          25 hours ago        Up 21 hours (healthy)

Es ist zu sehen, dass die folgende Container im Status 'Up' sind:

db
pbx
pbxfrontend
phonemgmtd
timeserver

Sollten die Container auch einige Zeit nach dem Starten nicht im Status 'Up' sein, kann man mittels des Befehls 'docker compose logs' die Ausgaben der Container auf Fehler hin untersuchen.

Telefonanlage neu starten

    $ cd /opt/docker/nfpbx
    $ docker compose restart

Dieser Befehl startet die Telefonanlage und alle zugehörigen Container neu.

Beispiel:

root@pbxtest:~# cd /opt/docker/nfpbx/
root@pbxtest:/opt/docker/nfpbx# docker compose restart
[+] Running 5/5
 ⠿ Container timeserver   Started                                                                                                                                                                      0.7s
 ⠿ Container db           Started                                                                                                                                                                      1.0s
 ⠿ Container pbx          Started                                                                                                                                                                      0.9s
 ⠿ Container pbxfrontend  Started                                                                                                                                                                    0.9s
 ⠿ Container phonemgmtd   Started                                                                                                                                                                 0.9s

Prüfen, ob sich die Telefonanlage am Core-Backbone angemeldet hat

    $ docker exec -ti pbx asterisk -rx 'pjsip show registrations'

Mit diesem Befehl werden die Verbindungen der Telefonanlage angezeigt. Wichtig ist hier, dass eine Verbindung mit dem Core im Status "Registered" vorhanden ist.

Beispiel:

pbxtest:/opt/docker/nfpbx$ docker exec -ti pbx asterisk -rx 'pjsip show registrations'

 <Registration/ServerURI..............................>  <Auth....................>  <Status.......>
==========================================================================================

 reg_core/sip:emcom.io                                   auth_reg_core               Registered        (exp. 38s)

Objects found: 1

Asterisk ending (0).

Welche Endgeräte sind an der Telefonanlage angemeldet?

    $ docker exec -ti pbx asterisk -rx 'pjsip show endpoints'

Dieser Befehl zeigt alle an der Telefonanlage registrierten Nebenstellen.

Beispiel:

pbxtest:~# docker exec -ti pbx asterisk -rx 'pjsip show endpoints'

 Endpoint:  
    I/OAuth:  
        Aor:  
      Contact:  
  Transport:  
   Identify:  
        Match:  
    Channel:  
        Exten:   CLCID: 
==========================================================================================

 Endpoint:  27/27                                                Not in use    0 of inf
     InAuth:  27/27
        Aor:  27                                                 5
      Contact:  27/sip:27@10.55.4.54:43660;transport=Tcp;l 02413471c2 Avail         5.559
  Transport:  local-tcp                 tcp      0      0  0.0.0.0:5060

 Endpoint:  28/28                                                Unavailable   0 of inf
     InAuth:  28/28
        Aor:  28                                                 5
  Transport:  local-tcp                 tcp      0      0  0.0.0.0:5060

 Endpoint:  core                                                 Not in use    0 of inf
    OutAuth:  core_auth/123
        Aor:  core_aor                                           0
      Contact:  core_aor/sip:123@emcom.io                  c8f2685412 Avail        43.493
  Transport:  public-tcp                tcp      0      0  0.0.0.0:5080


Objects found: 3

Asterisk ending (0).

Hier sieht man den Status aller bekannten SIP-Endpoints, in diesem Beispiel sind das 3.

die Nebenstelle 27 ist erreichbar (Avail) mit einer Roundtriptime von ca. 5.5ms und telefoniert aktuell nicht (Not in use). Die IP-Adresse des Telefons lautet 10.55.4.54
die Nebenstelle 28 ist nicht erreichbar (Unavailable) und hat daher auch keine weiteren Informationen
der Core bzw. die "Vermittlung" ist ebenfalls erreichbar (Avail) mit einer Roundtriptime von ca. 43.5ms und wird aktuell nicht aktiv genutzt (Not in use)