Zum Inhalt springen

Wiki-Quellcode von HD AppControl (RangeeOS)

Version 27.9 von DanielBoker am 2023/07/05 09:45
Verstecke letzte Bearbeiter
Tobias Wintrich 4.1 1 {{info title="Zuletzt getestet mit diesen Versionsständen:"}}
2 **RangeeOS Firmware/Software:**
Tobias Wintrich 2.2 3
Tobias Wintrich 4.1 4 * firmware x64 - 11.00 Build 312
DanielBoker 27.6 5 * HybridDesktop.AppControl_1.5.13.0.msi
Tobias Wintrich 4.1 6
7 **Zur Nutzung des ICA Channels (Optional):**
8
9 * ICA 23.02 11.00 b002
10 * Hybrid Desktop Channel_1.0-x64 Build 003
11 * [[Richtlinie für Positivliste der virtuellen Kanäle unter Citrix>>doc:HowTos.Citrix - Positivliste für virtuelle Kanäle anlegen.WebHome]]
12
13 **Lizenz:**
14
DanielBoker 27.6 15 * //HybridDesktop AppControl //(nicht in "All" enthalten)
Tobias Wintrich 4.1 16
17 **Auf Serverseite:**
18
DanielBoker 27.6 19 * HybridDesktop.AppControl_1.5.13.0.msi
Tobias Wintrich 4.1 20 * HybridDesktop Channel Agent 1.0.2.1
21 * HybridDesktop Channel for ICA 1.0.0.0
22 {{/info}}
23
DanielBoker 27.6 24 Die HybridDesktop AppControl ermöglicht es, lokale Applikationen (Softwaremodule) aus dem Remotedesktop heraus zu starten und zu steuern. Hierdurch wird bei Wiedergabe von Medien oder auch bei der Nutzung von Konferenz- und Videotelefonielösungen eine deutlich bessere Performance erreicht, als es über eine RDP/ICA/PCOIP-Verbindung oder sonstige Remoteprotokolle möglich ist. Für den Nutzer entsteht nahezu kein Unterschied, er bedient weiterhin alles wie gewohnt.
Tobias Wintrich 4.1 25
26 {{toc outline="true"/}}
27
28 = Client =
29
30 == Installation ==
31
32 Installieren Sie auf der Thin Client Seite
33
DanielBoker 27.6 34 Firmware 11.00 Build 312 oder höher
Tobias Wintrich 4.1 35
36 Zur Verwendung des Citrix ICA-Channels wird zusätzlich das Paket "hybrid-desktop-channel_1.0-x64" benötigt.
37
38 Außerdem benötigen sie einen passenden ICA Client (Versionen siehe oben).
39
Tobias Wintrich 6.2 40 [[image:01_HD-BrowserRedirection_RangeeOS.png||alt="Ausgewählte Softwaremodule RangeeOS" data-xwiki-image-style-border="true" height="501" width="800"]]
Tobias Wintrich 4.1 41
42 Eine Anleitung zur Installation von Software- und Firmwareupdates finden Sie in der [[Rangee Knowledge Base>>https://kb.rangee.com/HowTos/RangeeOS - Firmware- und Softwareupdate/]].
43
44 == Konfiguration ==
45
46 {{id name="Thin Client - Konfiguration"/}}
47
DanielBoker 27.7 48 Navigieren Sie nach der Installation zu {{status title="Remote-Administration"/}} → {{status title="Toolbox API / Rangee Hybrid Tools"/}}(% id="cke_bm_4675S" style="display:none" %) (%%)→ {{status title="Konfigurieren"/}}
Tobias Wintrich 4.1 49
DanielBoker 27.9 50 {{info title="
51 Lizenzfehler"}}
Tobias Wintrich 4.1 52 Wird Ihnen auf dieser Seite anstelle der Optionen ein Lizenzfehler angezeigt, so ist auf dem Gerät aktuell keine gültige Lizenz für die Rangee Browser Redirection vorhanden.
53
Tobias Wintrich 6.2 54 [[image:03_HD-BrowserRedirection_RangeeOS.png||alt="RangeeOS Lizenzwarnung" height="117" width="800"]]
Tobias Wintrich 4.1 55
Tobias Wintrich 6.2 56 Sollten Sie bereits eine Lizenz für das Modul besitzen, können Sie diese Lizenz wie in der [[Rangee Knowledge Base>>https://kb.rangee.com/HowTos/Allgemein%20-%20Rangee%20Lizenzierung/Allgemein%20-%20Client%20Lizenzen%20abrufen%20bzw.%20installieren/]] beschrieben hinterlegen.
Tobias Wintrich 4.1 57
Tobias Wintrich 10.2 58 Wenn noch keine Lizenz für das Modul besitzen, können Sie über unseren [[Vertrieb >>mailto:vertrieb@hybriddesktop.com||shape="rect"]]oder unser [[Kontaktformular >>https://hybriddesktop.com/kontakt/||shape="rect"]] eine Lizenz erwerben oder eine [[30 tägige Demo Lizenz>>https://hybriddesktop.com/kostenfrei-testen/]] anfragen.
Tobias Wintrich 4.1 59 {{/info}}
60
61 === Optionen ===
62
63 {{info}}
64 Eine Erklärung aller weiteren verfügbaren Optionen, wird mit einem Klick auf das blaue Fragenzeichensymbol (oben rechts) eingeblendet.
65 {{/info}}
66
67 Hier eine Übersicht über die Wichtigsten Optionen:
68
69 (% style="list-style-type:square" %)
70 * **Aktivieren:** Mit dieser Option wird der Remote Browser Dienst aktiviert
Tobias Wintrich 27.1 71 Sobald der Dienst aktiviert ist, erscheint ein entsprechendes Icon im Tray des Thin Clients:
72 [[image:09_HD-BrowserRedirection_RangeeOS.png]]
Tobias Wintrich 4.1 73 * **Zulässige Webseiten:** An dieser Stelle kann eine beliebige Anzahl von Webseiten (ein Eintrag je Zeile) zur Weiterleitung definiert werden. Der Eintrag muss inkl. HTTP oder HTTPS erfolgen. "*" kann beliebig oft als Wildcard eingesetzt werden.
74 * **Erlaube Weiterleitung vom Benutzer definierter Webseiten:** Mit dieser Option erlauben Sie Benutzern beliebige Webseiten weiterzuleiten. Über das zugehörige Browser Plugin kann der Nutzer, wenn diese Option aktiviert ist, eine eigene Liste weiterzuleitender Webseiten anlegen oder die aktuelle Webseite per Knopfdruck weiterleiten.
75 * **Verbindungsmodus:** Mit dieser Option wird festgelegt wie die Kommunikation zwischen Server und Client stattfinden soll. Wählen Sie hier "Websocket" für die generische TCP basierte VErbindung oder "Channel" für die Nutzung des Citrix ICA-Channels aus.
76
77 (% id="HTaskbarEinstellungen28Optional-empfohlen29" class="auto-cursor-target" %)
78 == Server ==
79
80 == Installation des "HybridDesktop Redirection Connectors" ==
81
82 {{id name="Configuration Utility"/}}
83
84 Über den "HybridDesktop Redirection Connector" kann das Browser Plugin im Hintergrund die aktuelle IP des Thin Clients automatisch abfragen oder es kann der komplette Verkehr über ein entsprechendes Channel Plugin getunnelt werden.
85
Tobias Wintrich 10.2 86 Hierduch kann, komfortabel, mit wechselnden Client IP Adressen gearbeitet werden. Zudem ist die Funktion der "Nahtlos-Integration" nur mit installiertem Connector verfügbar.
Tobias Wintrich 4.1 87
Tobias Wintrich 10.2 88 [[image:04_HD-BrowserRedirection_RangeeOS.png||alt="Installation HD BrowserRedirection Connector auf Serverseite"]]
Tobias Wintrich 4.1 89
90 == Installation der Chrome "HD BrowserRedirection Extension" ==
91
92 === Option 1 - Manuell je User ===
93
94 {{info}}
95 Bei verwendung des Microsoft Edge Browser muss zunächst der Installation von Erweiterungen aus anderen Stores zugestimmt werden. Siehe hierzu[[ Hinzufügen, Deaktivieren oder Entfernen von Erweiterungen in Microsoft Edge>>url:https://support.microsoft.com/de-de/microsoft-edge/hinzuf%C3%BCgen-deaktivieren-oder-entfernen-von-erweiterungen-in-microsoft-edge-9c0ec68c-2fbc-2f2c-9ff0-bdc76f46b026]]
96 {{/info}}
97
98 Öffnen Sie [[https:~~/~~/chrome.google.com/webstore/detail/hd-browserredirection-ext/kgihjigonjmklfpbmagbdofjafegeoke?hl=de>>https://chrome.google.com/webstore/detail/hd-browserredirection-ext/kgihjigonjmklfpbmagbdofjafegeoke?hl=de||shape="rect"]] oder Suchen Sie im Chrome Store nach "HD BrowserRedirection Extension" und wählen Sie {{status title="HINZUFÜGEN"/}} (ganz unten).
99
Tobias Wintrich 10.2 100 [[image:05_HD-BrowserRedirection_RangeeOS.png||alt="HB BrowserRedirection Plugin für Chrome Browser" data-xwiki-image-style-border="true"]]
Tobias Wintrich 4.1 101
102 === Option 2 - Automatisch per GPO ===
103
104 Ein Anleitung zur Verteilung von Chrome Plugins per GPO finden Sie [[hier>>url:https://support.google.com/chrome/a/answer/7649924?hl=en&ref_topic=7649835||shape="rect"]].
105
106 Daten des Plugins:
107
108 **id:** kgihjigonjmklfpbmagbdofjafegeoke
109 **update_url:** [[https:~~/~~/clients2.google.com/service/update2/crx>>url:https://clients2.google.com/service/update2/crx||shape="rect"]]
110
111 {{info}}
112 Die Verteilung per Gruppenrichtlinie ist aktuell nur für den Google Chrome Browser möglich. Microsoft bietet hier keine Richlinie zur automatischen Installation von Plugins aus anderen Stores an.
113 {{/info}}
114
115 == Konfiguration der Chrome "HD BrowserRedirection Extension" ==
116
117 Öffnen Sie die Optionen des Chrome Plugins
118
Tobias Wintrich 10.2 119 [[image:06_HD-BrowserRedirection_RangeeOS.png||alt="HD Browser Redirection Extension Einstellungen öffnen"]]
Tobias Wintrich 4.1 120
121 Mit Standardeinstellungen versucht das Plugin über den "HybridDesktop Redirection Connector" den Thin Client und die benötigen Einstellungen zu ermitteln.
122
Tobias Wintrich 10.2 123 [[image:07_HD-BrowserRedirection_RangeeOS.png||alt="HD Browser Redirection Extension Settings" data-xwiki-image-style-border="true" height="446" width="400"]]
Tobias Wintrich 4.1 124
125 Wird Ihnen hier ein grünes Status Icon angezeigt, so ist die Konfiguration abgeschlossen. Falls nicht, müssen weitere Einstellungen händisch vorgenommen werden.
126
127 === Einstellungen ===
128
129 **Remote Browser Mode:** Hier gibt es die Wahl zwischen Auto (Channel/IP-Detection) und Manual. Im Auto Modus werden die notwendigen Daten durch den HybridDesktop Redirection Connector automatisch hinterlegt. Im Manuellen Modus hingegen müssen die Verbindungseinstellungen händisch konfiguriert werden.
130
131 **IP-Address:** Hier steht Entweder die IP des Clients (Modus -> Websocket auf Clientseite) oder "HybridDesktop Channel"
132
133 **Port:** Port für die Websocket Kommunikation oder leer wenn Modus Channel auf Clientseite
134
135 **Session Token:** Token für die Websocket Kommunikation oder leer wenn Modus Channel auf Clientseite
136
137 **Remoting URLs (server defined):** wird automatisch bei erfolgreicher Verbindung ausgefüllt, zeigt alle weiterzuleitenen Seiten an (auf Thin Client Seite konfiguriert)
138
139 **Remoting URLs (userdefined): **In dieser Liste kann der User selbstständig Seiten zur dauerhaften Weiterleitung konfigurieren (Option //"Erlaube Weiterleitung vom Benutzer definierter Webseiten"// muss auf Thin Client Seite gesetzt sein)
140
141 === Anzeige des Plugin Status Icons (Optional) ===
142
143 Zur Anzeige des aktuellen Plugin Status, muss das Plugin zunächst angepinnt werden
144
Tobias Wintrich 24.1 145 [[image:08_HD-BrowserRedirection_RangeeOS.png||height="205" width="300"]]
Tobias Wintrich 4.1 146
147 Das Plugin kann folgende Status anzeigen:
148
149 (% style="list-style-type:square" %)
Tobias Wintrich 18.1 150 * [[image:icon0.png||data-xwiki-image-style-border="true"]]Plugin aktiv und erfolgreich konfiguriert, aktueller Tab wird nicht weitergeleitet
151 * [[image:icon1.png||data-xwiki-image-style-border="true"]]Plugin aktiv und konfiguriert, aktueller Tab wird umgeleitet
152 * [[image:icon2.png||data-xwiki-image-style-border="true"]]Plugin nicht aktiv - Eventuell Fehler in Konfiguration oder Thin Client nicht erreichbar - Optionsseite für genauere Meldung überprüfen
Tobias Wintrich 4.1 153
154 === Aktuelle Webseite weiterleiten ===
155
156 Wenn die Option //"Erlaube Weiterleitung vom Benutzer definierter Webseiten"// auf Thin Client Seite aktiviert ist, kann jede beliebige aktuell angezeigte Webseite über einen Klick auf das Plugin Icon sofort weitergeleitet werden.