• Installation SIP Communicator
• Patch für Sipgate
• Konfiguration
• Test
• mehr...
• Bücher
• Links

Der SIP Commander ist ein einfacher SIP-Client in Java und sollte daher auf den meisten Plattformen laufen, allerdings braucht man das Java Media Framework, was nicht unbedingt überall verfügbar ist. Zum Download stehen zwei Pakete zur Verfügung, eines für Linux und eines für Windows. Die folgenden Angaben beziehen sich auf die Windows-Version (Linux habe ich nur als Server ohne Soundkarte).
Das Programm kann auch über Java Webstart gestartet werden, da es aber eine kleine Inkompatibilität mit sipgate gibt, muss man eine geänderte .jar Library einspielen, um mit sipgate telefonieren zu können. Das Patch wird weiter unten erklärt.

1. Download der Version von http://www.java.net/ in das Verzeichnis, von dem aus man das Programm starten möchte.
2. Entpacken der ZIP-Datei und damit eigentlich fertig. Zum Starten wird die Batch-Datei sip-communicator.bat verwendet. Führen Sie diese einmal aus Sie werden dann durch einen Konfigurationsdialog geführt - Sie können jetzt gerne etwas eintragen, aber wir werden später noch die richtigen Konfigurationswerte direkt in die entsprechende XML-Datei eintragen. Es geht hier nur um die Initialieirung des Java Media Frameworks und die Auswahl des richtigen Netzwerk-Adapters.
3. Patch downloaden und einspielen
4. Konfiguration in der XML-Datei eintragen

Ein Problem mit dem SIP Communicator ist eine Prüfung der eingehenden Anrufe. Dabei wird geprüft, ob der Nutzer der angerufen wird mit dem übereinstimmt, der lokal eingetragen ist. Allerdings gibt es hier eine Abweichung bei sipgate. Wird ein Anruf aus dem Festnetz übertragen, wird als Empfängeradresse nicht nur die Teilnehmernummer im sipgate Netz angegeben, sondern auch der Ländercode (49 für Deutschland) und die Stadtvorwahl mit sipgate Vorwahl (bei mir 211 für D-dorf und die 5), also insgesamt so etwas wie 492115#######. Verglichen wird aber mit ####### ohne die Vorwahl. Daher bricht der SIP Communicator die Verbindung ab.
Verantwortlich ist hierfür im Quelltext:
net.java.sip.communicator.sip.CallProcessing (Zeile:379):
if (!calleeUser.equals(localUser)) {
Ersetzt man das durch:
net.java.sip.communicator.sip.CallProcessing (Zeile:379):
if (!calleeUser.endWith(localUser)) {
hat man immer noch eine einfache Prüfung, die aber mit sipgate funktioniert.
Da nicht jeder selber den Quellcode laden möchte, habe ich die Änderung mal gemacht und die entsprechende jar Datei generiert (basierend auf der cvs Version vom 7.7.2004).
Diese bitte von hier laden und in das Verzeichnis vom SIP Communicator kopieren (ersetzt die vorhandene Version) - fertig.

Die Konfiguration erfolgt über die Datei sip-communicator.xml im Verzeichnis des SIP Communicator. Bitte öffnen Sie dieses mit einem Editor Ihrer Wahl. Hier finden Sie jetzt eine kommentierte Version, mit den Einträgen, die Sie ändern müssen (Einträge ohne Änderungen lasse ich weg und markiere die mit [...]):
<?xml version="1.0" encoding="UTF-8"?>
  <configuration>
   <log4j>
    [...]
   </log4j>
  <net>
   <java>
    <sip>
     <communicator>
      <FIRST_LAUNCH value="false"/>
      <ENABLE_SIMPLE value="false"/>
      <media>
       [...]
      </media>
      <sip>
       <PUBLIC_ADDRESS value="sip:#######@sipgate.net"/>

Ersetzen Sie hier die ####### durch Ihre sipgate Nummer und tragen Sie dann den Eintrag inkl. @sipgate.net ein.

       <TRANSPORT value=""/>
       <REGISTRAR_ADDRESS value="sipgate.de"/>

Hier bitte "sipgate.de" eintragen

       <USER_NAME value="#######"/>

Hier bitte ihre Login-Nummer bei sipgate eintragen

       <STACK_PATH value="gov.nist"/>
       <PREFERRED_LOCAL_PORT value=""/>
       <DISPLAY_NAME value="My Name"/>

Hier tragen Sie bitte ihren Namen ein, der beim Telefonieren übertragen werden soll.

       <REGISTRAR_TRANSPORT value="UDP"/>
       <REGISTRATIONS_EXPIRATION value="3600"/>
       <REGISTRAR_PORT value="5060"/>

Falls hier nicht 5060 stehen sollte, bitte eintragen.

       <DEFAULT_DOMAIN_NAME value="sipgate.de"/>

Hier bitte "sipgate.de" eintragen

       <DEFAULT_AUTHENTICATION_REALM value="sipgate.de"/>

Hier bitte "sipgate.de" eintragen

       <WAIT_UNREGISTGRATION_FOR value="1100"/>
       <SAME_USER_EVERYWHERE value="true"/>
       <simple>
        [...]
       </simple>
      </sip>
      <sipphone>
       <IS_RUNNING_SIPPHONE value="false"/>

Hier bitte "false" eintragen

       [...]
      </sipphone>
      <gui>
       [...]
      </gui>
      <common>
       [...]
      </common>
      <STUN_SERVER_ADDRESS value="stun.sipgate.net"/>

Hier bitte "stun.sipgate.net" eintragen.

      <STUN_SERVER_PORT value="10000"/>

Hier bitte "10000" eintragen.

      <VOICE_MAIL_ADDRESS value="17475551212"/>
     </communicator>
    </sip>
   </java>
  </net>
  <gov>
   [...]
  </gov>
  <javax>
   <sip>
    <IP_ADDRESS value="192.168.0.52"/>
    <STACK_NAME value="sip-communicator"/>
    <ROUTER_PATH value="net.java.sip.communicator.sip.SipCommRouter"/>
    <OUTBOUND_PROXY value="sipgate.de:5060/udp"/>

Hier bitte "sipgate.de:5060/udp" eintragen.

    <RETRANSMISSON_FILTER value=""/>
    <EXTENSION_METHODS value=""/>
    <RETRANSMISSION_FILTER value="true"/>
   </sip>
  </javax>
  <java>
   [...]
  </java>
</configuration>


Der einfachste Test ist: Rufen Sie sich selber über Festnetz an. Die Telefonnummer haben Sie ja von Sipgate mitgeteilt bekommen.

Der nächste Test ist ein Anruf bei der Testnummer von sipgate: 10000, einfach mal anrufen.

Zunächst einmal, ich habe wirklich keine Zeit persönlichen Support zu leisten. Also Emails mit diesem Hintergrund fliegen gleich raus. Aber ich bin gerne bereit inhaltliche Fehler zu beseitigen, oder zusätzliche Informationen einzupflegen, in dem Fall mail an sd@morgenlan.de.