Desktop Client Installation

Ihre Firewall anpassen

Viele Unternehmen haben keinen eingeschränkten Internetzugriff und können den pascom Desktop UC Client daher sofort, ohne jede Anpassung an der Firewall nutzen.

Wenn Sie jedoch genau festlegen auf welche Internetdienste Ihr Unternehmensnetzwerk zugreifen darf, schalten Sie bitte folgende Ports für den pascom Desktop Client frei, um einen reibungslosen Betrieb der pascom Telefonanlage zu ermöglichen:

Firewall konfigurieren / Portübersicht

Eigenen Proxy Server im pascom Client konfigurieren

Sollten Sie einen eigenen Proxy Server im Unternehmen betreiben, welcher den Datenverkehr ins Internet steuert, muss der pascom Client entsprechend kofiguriert werden.

Wie Sie Ihre Proxy Server Daten im pascom Client einrichten, erfahren Sie in dieser Anleitung.

Windows Installation

Die Windows Installation benötigt keine Administratorrechte und erfolgt automatisch in das Home-Directory des aktuell angemeldeten Benutzers:

• Windows Desktop Client herunterladen
• pascom-client-setup.exe ausführen
• Installationanweisungen folgen

Windows Silent Installation

Eine Silent Installation ist eine Installationsmethode für Software, bei der keine Benutzerinteraktion erforderlich ist und keine grafische Benutzeroberfläche angezeigt wird. Bei einer Silent Installation werden alle notwendigen Installationsparameter im Voraus festgelegt und die Installation läuft im Hintergrund ab, ohne dass der Benutzer etwas bestätigen oder auswählen muss. Sie können dazu das Ziel des Installationpakets über die Eigenschaften anpassen oder das Installationspaket über die Commandozeile starten.

pascom-installer.exe /S

Es wird auch gleich automatisch ein Shortcut der pascom App auf dem Desktop angelegt.

Autostartverhalten einstellen

Um gleichzeitig das Autostartverhalten der pascom App bei der Installation anzupassen, können sie folgenden Commandozeilenparameter benutzen.

AUTOSTART="yes"

Silent Uninstallation

Gehen Sie hier genauso vor, wie bei der Installation. Den Uninstaller finden Sie im App-Verzeichnis der pascom App.

uninst.exe /S

Windows QoS Einstellungen (Optional)

Um die maximale Sprachqualität zu erreichen markiert der pascom Client alle Sprachdaten entsprechend mit QoS-Flags.

Dies passiert, mit Ausnahme von Windows, auf allen weiteren Plattformen automatisch.

Unter Windows sind folgende Gruppenrichtlinien “Richtlinienbasierter QoS” notwendig um die Pakete entsprechend zu markieren.

Die Gruppenrichtlinien werden unter folgendem Pfad erstellt:

Lokaler Computer > Computerkonfiguration 
> Windows-Einstellungen > Richtlinienbasierter QoS

Terminalserver Installation

(Optional) Am Microsoft Terminal Server können Sie den pascom Desktop Client optional statt in das jeweilige Home-Directory der Benutzer direkt in das Programm Verzeichnis installieren.

Der Nachteil dieser Installationsart ist, dass Sie sich selbst um das Update des Desktop Clients kümmern müssen da dieses Administrator Rechte bendötigt und der pascom Client keine Schreibrechte bekommt. Als Vorteil sparen Sie ca. 100 MB Plattenplatz pro Benutzer.

• Windows Desktop Client herunterladen
• Öffnen Sie die Eingabeaufforderung als Administrator
• Starten Sie das Setup und geben Sie das Zielverzeichnis an

Beispiel:

pascomClient-setup.exe /D=C:\Program Files\pascom Client

RDP Split Modus am Terminalserver nutzen

Der RDP Modus ist standartmäßig aktiviert, wenn die pascom APP eine Terminalsitzung erkennt. Daher muss auf einer Serverumgebung keine umständliche Konfiguration vorgenommen werden. Kann aber mit Umgebungsvariablen deaktiviert werden.

Kurz erklärt

Mithilfe des Kommandozeilenparamters --rdp oder durch Setzen der Umgebungsvariable PC_RDP ist es möglich, für den Client am Terminalserver, die Verwendung von Softphone und Video-Support zu deaktivieren. Dies erlaubt dem Client am Terminalserver, das Softphone einer weiteren Client-Instanz zur Telefonie zu verwenden.

Damit ist es z.B. möglich, eine Client Instanz innerhalb einer RDP Sitzung und eine weitere auf dem Host-Rechner zu starten. Die innerhalb der RDP-Sitzung laufende Instanz hat das --rdp Flag gesetzt, die äußere nicht. Somit kann ein an den PC angestecktes Headset zur Telefonie verwendet werden.

Was bewirkt das?

• Bessere Audioqualität, da das Audio nicht in die RDP-Sitzung übertragen werden muss.
• Headsetsteuerung (z. B. Annehmen über Taste am Headset) funktioniert dadurch.
• Integrationen in Software die auf einem Terminal-Server läuft (z. B. Outlook, DATEV) funktioniert weiterhin.
• Weniger CPU-Last auf Terminal-Servern, da Audio und Video über den Client auf dem jeweilgen Endgerät enkodiert und dekodiert werden.
• Anrufsteuerung ist über jeden der Clients vollständig möglich.

Das Feature funktioniert plattformübergreifend (Windows, macOS, Linux) und ist nicht auf RDP-Sitzungen beschränkt.

macOS Installation

• macOS Desktop Client herunterladen
• pascom Client.dmg ausführen
• Schieben Sie das pascom Icon auf den Application Ordner
• Sobald der Kopiervorgang abgeschlossen ist, können Sie den Client starten

Installation auf MAC mit Apple M1 Silicon CPU

Sobald Sie den pascom Client auf einem MAC mit Apple M1 Silicon Chipsatz installieren möchten, fordert Sie der Installer auf, das Programm Rosetta 2 zu installieren. Dieses Programm sorgt dafür, dass Sie Anwendungen nutzen können, welche für einen Mac mit Intel-Prozessor entwickelt wurden.

Linux Installation

• Linux Desktop Client herunterladen
• pascom_Client.tar.bz2 im Home-Directory entpacken
• Ubuntu Application Icon mit create-starter.sh erstellen
• Client über Application Icon starten

Beispiel

tar jxvf ./Downloads/pascom_Client-7.17.10.R.tar.bz2
./pascom_Client/create-starter.sh 

Wenn Sie eine X-Window-Sitzung unter Ubuntu 22.04 verwenden, müssen Sie zusätzlich die folgenden Bibliotheken installieren:

sudo apt install libxcb-cursor-dev

Ubuntu 24.04 Audio

Wenn Sie Ubuntu 24.04 LTS verwenden, müssen Sie die folgenden zusätzlichen Bibliotheken installieren, damit Audio funktioniert:

apt install libasound2-plugin

Ubuntu 22.04 Audio

Wenn Sie Ubuntu 22.04 LTS verwenden und Audioprobleme haben, sollten Sie Pipewire anstelle von Pulseaudio verwenden. Hier finden Sie eine detailierte Anleitung.

Jabra Headset oder Kuando Busylight auf Linux verwenden

Wenn sie ein Jabra Headset mit Tastensteuerung oder ein Kuando Busylight verwenden möchten, ist es notwendig die richtigen UDEV regeln manuell anzulegen. Im Client Installationsverzeichnis gibt es hierzu die Skripte pascom-configure-jabraheadset.sh bzw. pascom-configure-kuando-busylight.sh. Diese müssen mit root rechten ausgeführt werden.

Windows Installer Kommandozeilen Parameter

Desktop Client Umgebungsvariablen und Kommandozeilen Parameter

Der pascom Desktop Client unterstützt auf allen Betriebsystemen zahlreiche Kommandozeilen Parameter und reagiert außerdem auf etliche Umgebungsvariablen.

Welche Parameter und Umgebungsvariablen von Ihrer Version unterstützt werden können Sie durch den Parameter --help abfragen.

Beispiel

Options:
  --userDir <userDir>                    Set user directory. Via Environment:
                                         Set PC_USERDIR to desired value
  -h, --help                             Displays help on commandline options.
  --help-all                             Displays help including Qt specific
                                         options.
  --exec                                 Execute a command instead of starting
                                         a client instance. Example: --exec
                                         dial,*104 (Calls your own Voicemailbox)
  --noUpdate                             Disable automatic update. Via
                                         Environment: Set PC_NO_UPDATE to any
                                         value.
  --forceTouchMode                       Show UI like touchscreen is enabled
  --debugMode                            Debug Mode. Via Environment: Set
                                         PC_DEBUGMODE to any value.
  --pcRendererMode <pcRendererMode>      Change the used rendering backend.
                                         Possible values are: auto, opengl,
                                         openglSoftware, software. On Windows
                                         there are additional modes: D3D11,
                                         D3D11Software. On Windows and Ubuntu
                                         there are additional modes: vulkan,
                                         vulkanSoftware. On MacOS there are
                                         additional modes: metal. Via
                                         Environment: Set PC_RENDERER_MODE to
                                         desired value.
  --rdp                                  Disable all video and/or audio
                                         functionality on this client instance.
                                         Via Environment: Set PC_RDP to any
                                         value
  --proxyServer <proxyServer>            Use the given server as proxy. Via
                                         Environment: Set PC_PROXYSERVER
  --proxyPort <proxyPort>                Use the given port for connecting to
                                         the proxy. Via Environment: Set
                                         PC_PROXYPORT, default: 3128
  --proxyUser <proxyUser>                Use the given user to authenticate
                                         against the proxy. Via Environment: Set
                                         PC_PROXYUSER
  --proxyPassword <proxyPassword>        Use the given password to authenticate
                                         against the proxy. Via Environment: Set
                                         PC_PROXYPASSWORD
  --user <user>                          Override login username for first
                                         login. Via Environment: Set PC_USER to
                                         desired value. This value will be
                                         ignored after the first successful
                                         login.
  --password <password>                  Override login password. Insecure,
                                         please use PC_PASS environment variable
                                         instead
  --server <server>                      Override login server for first login.
                                         Via Environment: Set PC_SERVER to
                                         desired value. This value will be
                                         ignored after the first successful
                                         login.
  --disableHeadsetSupport                Set to true to disable automatic
                                         headset detection and controls. Via
                                         Environment: Set
                                         PC_HEADSET_SUPPORT_DISABLED to any
                                         value.
  --logSennheiserMessages                Log all communication from and to
                                         Sennheiser HeadSetupApplication. Via
                                         Environment: Set
                                         PC_LOG_SENNHEISER_MESSAGES to any
                                         value.
  --logPolyMessages                      Log all communication from and to Poly
                                         / Plantronics Hub Application. Via
                                         Environment: Set PC_LOG_POLY_MESSAGES
                                         to any value.
  --iceServers                           STUN/TURN Servers to use, comma
                                         separated. Via Environment: Set
                                         PC_ICE_SERVERS to desired value.
  --disableVideo                         Completely disable video support. Via
                                         Environment: Set PC_DISABLE_VIDEO to
                                         any value
  --enableWinks                          Enable usage of legacy winks API.
                                         Required for some webcams but may lead
                                         to crashes. Via Environment: Set
                                         PC_ENABLE_WINKS to any value
  --disableQueueState                    Disable queue state UI on this client.
                                         Via Environment: Set
                                         PC_DISABLE_QUEUE_STATE to any value
  --minimized                            Do not open the main window on
                                         startup. Via Environment: Set
                                         PC_MINIMIZED to any value
  --useCustomNotificationsAsDefault      Do not use native notifications by
                                         default. Via Environment: Set
                                         PC_USE_CUSTOM_NOTIFICATIONS_AS_DEFAULT
                                         to any value.
  --limitJournalDays <limitJournalDays>  Limit the amount of locally
                                         synchronized journal entries to the
                                         specified number of days. Via
                                         Environment: Set PC_LIMIT_JOURNAL_DAYS
                                         to the desired value.