Dokumentation
pascom Produkt Dokumentation und Release Notes
Desktop Client Installation
So installieren Sie den pascom Desktop Client auf den Plattformen Windows, macOS und Linux
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
Systemvoraussetzung Windows 10 oder 11 (64bit). Jeweils das neueste Patchlevel.
Bei Verwendung der Windows “N”-Editionen kann es notwendig sein, das jeweils passende “Media Feature Pack” nachzuinstallieren Windows 10/11 N: Media Feature Pack für Windows N - Microsoft-Support. Ansonsten kann es zu Abstürzen und/oder Fehlern bei der Audio/- Videowiedergabe kommen.
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 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
| Richtlinie 1 | Richtlinie 2 | Richtlinie 3 | |
|---|---|---|---|
| Richtlinienname | pascomSIP | pascomRTP | pascomXMPP |
| Anwendungsname | pascom Client.exe | pascom Client.exe | pascom Client.exe |
| Protokoll | TCP und UDP | UDP | TCP |
| Quellport | * | * | * |
| Zielport | 5060:5062 | 30000:35000 | 5222 |
| Quell-IP | * | * | * |
| Ziel-IP | * | * | * |
| DSCP-Wert | 24 | 46 | 24 |
| Drosselungsrate | -1 | -1 | -1 |
Terminalserver Installation
Systemvoraussetzung Windows Server 2016 64bit oder höher
(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.
Bevor Sie mit der Installation beginnen, deinstallieren Sie bitte, falls vorhanden, 32-bit Versionen des pascom Client die älter als Version 84.R2233 sind.
- 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
Die automatischen Updates des pascom Client werden nur deaktiviert wenn der pascom Client keine Schreibrechte hat. Dies ist das Standardverhalten wenn Sie den Beispielpfad verwenden. Andernfalls kann es passieren, dass Autoupdates aktiviert werden und man diese via Flags oder Umgebungsvariablen wieder deaktivieren muss.
RDP Split Modus am Terminalserver nutzen
Mithilfe des Kommandozeilenparamters --rdp oder durch Setzen der Umgebungsvariable PC_RDP auf 1 ist es nun 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
Systemvoraussetzung macOS 11 oder höher
- 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
Systemvoraussetzung Ubuntu 22.04 LTS. Andere Linux Distributionen können funktionieren, werden aber von pascom weder aktiv getestet noch offiziell unterstützt.
- 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 20.04 oder 22.04 verwenden, müssen Sie zusätzlich die folgenden Bibliotheken installieren:
sudo apt install libxcb-cursor-dev
Windows Installer Kommandozeilen Parameter
| Parameter | Bedeutung |
|---|---|
| /S | Ermöglicht eine Installation im Hintergrund, ohne dass Dialogfenster angezeigt werden. Nützlich bei automatischer Softwareverteilung |
| /D=PATH | Gibt einen Installationsordner an. Dieser Parameter muss immer der letzte in der Befehlszeile sein, darf keine Anführungzeichen enthalten und unterstützt nur absolute Dateipfade |
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.