Produktdokumentation. ProCall Enterprise. UCServer Web Services

Transkript

1 Prduktdkumentatin PrCall Enterprise UCServer Web Services

2 PrCall Enterprise Inhaltsverzeichnis 1 UCServer Web Services Installatin Verwaltung Fehlerursachen 8

3 UCServer Web Services 1 UCServer Web Services Beim UCServer Web Services handelt es sich um einen PrCall Enterprise Dienst zur Anbindung vn PrCall für Mac OS X PrCall Mbile UCServer Web Services wird innerhalb des Micrsft Internet Infrmatin Services (IIS) eines Micrsft Server Betriebssystems installiert und stellt Anwendungen eine sichere Schnittstelle über ffene Standardprtklle zur Kmmunikatin mit dem UCServer zur Verfügung. Nach der Installatin ist der Micrsft Internet Infrmatin Services (IIS) s eingerichtet, dass der UCServer Web Services nur Anwendungen aus dem Unternehmensnetzwerk zur Verfügung steht. Die Knfiguratin des Micrsft Internet Infrmatin Services (IIS) kann s geändert werden, dass die Dienste PrCall für Mac OS X PrCall Mbile auch vn unterwegs aus nutzbar sind. Vrausgesetzte Kenntnisse Für die Installatin und den Betrieb des UCServer Web Services benötigen Sie Kenntnisse in Knfiguratin einer Firewall Installatin und Knfiguratin des Micrsft Internet Infrmatin Services (IIS) Erstellung und Einrichtung vn SSL-Zertifikaten zur Verschlüsselung der Kmmunikatin 1.1 Installatin Für die Installatin vn UCServer Web Services laden Sie bitte die PrCall Enterprise ZIP-Datei herunter. Vraussetzungen Für die Installatin vn UCServer Web Services empfehlen wir Hardware bis 250 aktive Anwender PC mit mindestens 2 GHz Taktfrequenz 3

4 PrCall Enterprise 1 GB Arbeitsspeicher 20 MB freier Festplattenspeicher, zzgl. Plattenplatz für Lgfiles Betriebssystem Windws 2008 Server 32/64bit (ab Service Pack 2) Windws 2008 R2 Server Windws Small Business Server 2011 Standard Windws Server 2012 Infrastruktur Es wird nur IPv4 und kein IPv6 Unterstützt. Die Installatin auf einem nicht-server Betriebssystem z. B. Windws Vista, Windws 7 der Windws 8 wird nicht unterstützt. Wird UCServer Web Services auf einem nicht-server Betriebssystem installiert, kmmt es ab einer geringen Anzahl gleichzeitiger Nutzer zu Verbindungsabbrüchen zum Micrsft Internet Infrmatin Services (IIS). Es handelt sich dabei um eine technische Einschränkung des Micrsft Internet Infrmatin Services (IIS) auf nichtserver Betriebssystemen. Installatin Bitte überprüfen Sie die nachflgenden Punkte: 1. UCServer ist installiert und gestartet. 2. Zwischen UCServer Web Services und UCServer (Standard Prt 7222) kann eine TCP Verbindung hergestellt werden. Das ist z. B. der Fall, wenn UCServer und UCServer Web Services gemeinsam auf dem selben Betriebssystem installiert sind. 3. Während der Installatin des UCServer Web Services wird der Micrsft Internet Infrmatin Services (IIS) auf Ihrem Betriebssystem aktiviert und vrknfiguriert. 4. Möchten Sie PrCall Mbile der PrCall für Mac OS X vn Unterwegs aus nutzen, s müssen Sie sicherstellen, dass der Micrsft Internet Infrmatin Services (IIS) aus dem Internet erreichbar ist. Lesen Sie hierzu das Kapitel Erreichbarkeit aus dem Internet (DMZ). 5. Für eine verschlüsselte Datenkmmunikatin zwischen UCServer Web Services und PrCall Mbile der PrCall für Mac OS X wird ein gültiges Server-Zertifikat benötigt. Welche Anfrderungen an ein slches Zertifikat bestehen, entnehmen Sie bitte dem Kapitel ServerZertifikate für verschlüsselte Datenkmmunikatin. Während der Installatin vn UCServer Web Services wird eine Internetverbindung benötigt, falls das Micrsft.NET Framewrk 4 (Full) nicht installiert ist. Sie können auch das vllständige Paket bei Micrsft herunterladen ( details.aspx?id=17718) und vr UCServer Web Services manuell installieren. Im Addns-Ordner der PrCall Enterprise ZIP-Datei finden Sie das UCServer Web Services Installatinsprgramm. Benötigte Micrsft Internet Infrmatin Services (IIS) Features Der UCServer Web Services benötigt eine Reihe vn Features des Micrsft Internet Infrmatin Service (IIS) die nachflgend aufgelistet werden: Alle Windws-Server-Betriebssysteme: IIS-WebServerRle IIS-WebServer IIS-StaticCntent IIS-DefaultDcument 4

5 UCServer Web Services IIS-HttpErrrs IIS-HttpRedirect IIS-HealthAndDiagnstics IIS-HttpLgging IIS-HttpCmpressinStatic IIS-HttpCmpressinDynamic IIS-WebServerManagementTls IIS-ManagementCnsle IIS-RequestFiltering Zusätzliche nur bei Windws Small Business Server 2008/2011: IIS-CmmnHttpFeatures IIS-DirectryBrwsing IIS-ApplicatinDevelpment IIS-ASP IIS-CGI IIS-ServerSideIncludes IIS-RequestMnitr IIS-HttpTracing IIS-CustmLgging IIS-ODBCLgging IIS-Security IIS-BasicAuthenticatin IIS-IPSecurity IIS-Perfrmance IIS-ManagementScriptingTls IIS-ManagementService IIS-IIS6ManagementCmpatibility IIS-Metabase IIS-WMICmpatibility IIS-LegacyScripts IIS-LegacySnapIn WAS-WindwsActivatinService WAS-PrcessMdel WAS-NetFxEnvirnment WAS-CnfiguratinAPI Zusätzliche nur bei Windws Server 2012: NetFx4Extended-ASPNET45 IIS-NetFxExtensibility45 IIS-ISAPIExtensins IIS-ISAPIFilter IIS-ASPNET45 NetFx3ServerFeatures 5

6 PrCall Enterprise Erreichbarkeit aus dem Internet (DMZ) Für die Nutzung vn PrCall Mbile der PrCall für Mac OS X vn unterwegs über das Internet hne ein Virtual Private Netwrk (VPN) sind weitere Knfiguratinsschritte in Ihrer IT-Infrastruktur ntwendig. In der Verwaltung können diese Knfiguratinsschritte nicht vrgenmmen werden. Hier kann es z. B. ntwendig sein, die Firewall Knfiguratin Ihres Ruters dahingehend zu ändern, dass Verbindungen aus dem Internet zum UCServer Web Services weitergeleitet werden (prt frwarding). Um Ihre sensitiven Daten vr dem Zugriff durch Dritte zu schützen, empfehlen wir UCServer Web Services auf einem separaten Rechner innerhalb einer DMZ mit einem zweistufigen Firewall-Knzept zu installieren. Nähere Infrmatinen zur DMZ finden Sie unter Demilitarized_Zne. Als zusätzliche Sicherheitsmaßnahme empfehlen wir ferner in der Firewall zum internen Netzwerk hin nur die IP-Adresse des Rechners zuzulassen, auf dem UCServer Web Services läuft. 6

7 UCServer Web Services Firewall In Ihrer Firewall müssen weitere Einstellungen vrgenmmen werden, um UCServer Web Services z. B. aus dem Internet zu erreichen der den Zugriff auf UCServer der MetaDirectry zu gewähren: Ursprung Ziel Prt Prtkll Richtung Ihre statische IPAdresse im Internet (WAN) IP-Adresse des Rechners w UCServer Web Services installiert ist 443 HTTPS inbund IP-Adresse des IP-Adresse des Rechners w Rechners w UCServer Web UCServer Web Services installiert Services installiert ist ist 7222 ASN.1 inbund 714 LDAPS inbund IP-Adresse des Rechners w UCServer Web Services installiert ist IP-Adresse des Rechners w MetaDirectry installiert ist Server-Zertifikate für verschlüsselte Datenkmmunikatin Server-Zertifikate werden für eine verschlüsselte Datenkmmunikatin zwischen UCServer Web Services und PrCall Mbile der PrCall für Mac OS X benötigt. Ein Server-Zertifikat dient zur eindeutigen Identifizierung eines Rechners. Das Zertifikat muss auf den FQDN (fully qualified dmain name) des Rechners durch eine vertrauenswürdige Instanz ausgestellt sein. Sll UCServer Web Services unter der URL erreichbar sein, s muss das Zertifikat auf ws.ucsftware.de ausgestellt werden. Ihre statische Internet IP-Adresse ist auch auf ws.ucsftware.de eingestellt. Ein Server-Zertifikat einer vertrauenswürdigen Stelle erhalten Sie beispielsweise bei Verisign ( und Thawte ( Bevr Sie ein Zertifikat bestellen, empfehlen wir Ihnen, dies vrher zu testen. Viele Hersteller bieten Testzertifikate mit einem limitierten Testzeitraum an. Zertifikate werden im Zertifikat-SnapIn der Micrsft Management Cnsle (MMC) installiert. 1.2 Verwaltung Nach der Installatin können Sie die PrCall UCServer Web Services Verwaltung über das WindwsStartmenü aufrufen um Änderungen an der Knfiguratin vrzunehmen. Die einzelnen Reiter bieten Ihnen dabei die flgenden Möglichkeiten: Übersicht: 7

8 PrCall Enterprise Zeigt einen schnellen Überblick zur Erreichbarkeit der UCServer Web Services swie der angebundenen UCServer. Web Services: Knfiguratin der externen Verbindungsdaten für UCServer Web Services, verwendeter Prt und SSL-Übertragung. Knfiguratin: Knfiguratin der internen Verbindungsdaten zwischen UCServer Web Services und angebundenen UCServer Diagnse: Zur Analyse vn Fehlermeldungen der unerwarteten Verhalten kann die Prtkllierung der UCServer Web Services angepasst werden. Falls Prbleme mit UCServer Web Services auftreten sllten, können Sie hier auch eine ZIP-Archiv mit allen Infrmatinen zur weiteren Analyse des Sachverhalts erstellen. Zudem haben Sie die Möglichkeit, die Prtklldateien manuell zu löschen bzw. eine Supprt-Datei auf dem Desktp abzulegen. Bitte aktivieren Sie die zusätzliche Prtkllierungsstufe "Netzwerk" nur auf Anfrderung. Angemeldete Benutzer: Übersicht der aktiven Anwender am UCServer Web Services. Diese Infrmatin können Sie nutzen um z. B. den passenden Zeitpunkt für Ihre Wartungsarbeiten zu auszuwählen. Inf über: Versinsinfrmatinen zum installierten Prdukt. 2 Fehlerursachen In diesem Abschnitt finden Sie eine Anleitung zur Ursachenanalyse bei häufigen Fehlerursachen. Feedback senden am UCServer Web Services Im Reiter Diagnse haben Sie in der PrCall UCServer Web Services Verwaltung die Möglichkeit für eine vllständige Fehlermeldung die benötigten Daten zu erfassen. Nutzen Sie anschließend unsere Online-Supprt Anfrage unter um Ihren Prblemfall zu melden. UCServer Web Services Fehlermeldung im Brwser bei der Erreichbarkeitsprüfung: "Die Website kann nicht angezeigt werden" 8

9 Fehlerursachen Prblembeschreibung Nach der Installatin und Knfiguratin vn UCServer Web Services möchten Sie in der Verwaltung die interne bzw. externe Erreichbarkeit überprüfen. Dazu klicken Sie auf den angezeigten Link, wrauf sich ein Brwserfenster öffnet mit der Bitte um Benutzername/Passwrt. Nach erflgter Authentifizierung wird die Meldung "Die Website kann nicht angezeigt werden" ausgeliefert. UCServer Web Services Webseite knnte nach der Installatin nicht gestartet werden, da der angegebene Prt z. B. durch eine andere Anwendung verwendet wird. Dies ist häufig der Fall, wenn Sie den Webserver des MetaDirectry nutzen, der standardmäßig den Prt 80 belegt. Die Flge ist, dass die Website, unter der Mbile Service installiert ist, nicht gestartet werden knnte. Für einen bereits im Vrfeld installierten Micrsft Internet Infrmatin Service (IIS) wurde die annyme Authentifizierung nicht aktiviert. Dies führt dazu, dass der IIS selbst versucht, mit den angegeben Benutzerinfrmatinen eine Autrisierung vrzunehmen, was fehlschlagen muss. Überprüfen Sie zunächst in der Micrsft Internet Infrmatin Service (IIS)-Verwaltung, b die annyme Authentifizierung für die Website und Applikatin aktiviert ist. Falls das Prblem immer nch auftritt, ändern Sie zunächst den Prt des Mbile Service durch erneutes Installieren und Ausführen des Knfiguratinsassistenten bzw. durch manuelles Knfigurieren im Micrsft Internet Infrmatin Service (IIS) (Änderung der Prts). Anschließend sllten Sie in der Lage sein, die entsprechende Website zu starten und die Erreichbarkeitsprüfung zu wiederhlen. Fehlermeldung im Brwser bei der Erreichbarkeitsprüfung: "502 Bad Gateway" Prblembeschreibung Nach der Installatin und Knfiguratin des UCServer Web Services möchten Sie in der Verwaltung die interne bzw. externe Erreichbarkeit überprüfen. Dazu klicken Sie auf den angezeigten Link, wrauf sich ein Brwserfenster öffnet mit der Bitte um Benutzername/Passwrt. Nach erflgter Authentifizierung wird die Meldung "502 Bad Gateway" angezeigt. Die ausgelieferte Fehlermeldung deutet darauf hin, dass der UCServer vm UCServer Web Services nicht erreicht werden kann. Bitte prüfen Sie zunächst, b Sie den entsprechenden UCServer vn dem Rechner aus erreichen können, auf dem der UCServer Web Services installiert ist. Dies können Sie beispielsweise durch Installatin eines UCClient verifizieren. Alternativ besteht die Möglichkeit, eine Prüfung mit telnet auf dem knfigurierten Prt durchzuführen. Wenn Sie nicht vm 9

10 PrCall Enterprise Standard abgewichen sind, lautet das Kmmand beispielsweise: telnet uc-server-name 7222 Alternativ können Sie auch mit der IP-Adresse des UCServer arbeiten, um ein Prblem bei der DNS-Auflösung auszuschließen. Bitte geben Sie die IP-Adresse des UCServer in der UCServer Web Services Verwaltung ein. Fehlende Kntakte bzw. werden keine MetaDirectry Datensätze angezeigt Prblembeschreibung Die Suche auf dem mbilen Endgerät liefert weniger Treffer als die gleiche Suchanfrage auf meinem Desktp-Client. Suchergebnisse aus dem MetaDirectry werden nicht angezeigt. Für die Anbindung des MetaDirectry an den UCServer Web Services benötigen Sie mindestens MetaDirectry 3.5 der neuer. Bitte prüfen Sie die Versinsnummer Ihres MetaDirectry und laden sich gegebenenfalls die aktuellste Versin auf unserer Website herunter. Eine Kntaktsuche die z.b. Umlaute wie ä ö ü enthält, führt zu einem Verbindungsfehler 500 Prblembeschreibung Sie verwenden als Firewall ein Micrsft Threat Management Gateway (TMG). Eine Kntaktsuche aus der mbilen Applikatin, die u.a. Umlaute enthält, führt zu flgender Fehlermeldung: "Verbindungsfehler! Bitte prüfen Sie Ihre Internetverbindung und versuchen Sie es erneut!" Der Suchbegriff wird bei einer Suchanfrage über die URL übergeben. Alle Snderzeichen, insbesndere auch deutsche Umlaute, werden drt "URL-encded". Wird als Firewall ein Micrsft Threat Management Gateway (TMG; eingesetzt, kann dies zur ben genannten Fehlermeldung führen, wenn die Knfiguratinseinstellung der Firewall "HighByte-Zeichen" innerhalb der URL verbietet. Durch diese Einstellung wird jegliche Weiterverarbeitung mit einem HTTP Fehler 500 abgelehnt. Deaktivieren Sie innerhalb des Micrsft Threat Management Gateway die Optin "Blck high-bit characters". PrCall für Mac OS X / PrCall Mbile Geplante Anrufe werden nicht angezeigt Prblembeschreibung 10 Obwhl in Ihrem UCClient geplante Anrufe hinterlegt sind, werden diese in der App nicht angezeigt.

11 Fehlerursachen Wird für die Planung vn Anrufen nicht der ESTOS UCServer genutzt sndern Micrsft Outlk (Anwendereinstellung im UCClient), s können geplante Anrufe nicht in der App eingesehen werden. Stellen Sie die geplanten Anrufe in Ihrem UCClient auf "UCServer" um. Präsenz eines Mac OS X Anwenders wird nie inaktiv Prblembeschreibung Die Präsenz eines Mac Anwenders wechselt niemals auf inaktiv. Der Anwender wird immer verfügbar. Die Erkennung für Inaktivität funktiniert nicht bei Nutzung einer Bildschirmfreigabe (z. B. über VNC) über das Netzwerk. Es handelt sich hierbei um eine technische Einschränkung der Bildschirmfreigabe für die es keine Lösung gibt. Der Mac OS X Anwender wird nie als inaktiv angezeigt werden können. Tltips erscheinen zu spät/langsam Prblembeschreibung Tltips zu einzelnen Elementen erscheinen gefühlt eine Sekunde zu spät. Es handelt sich hierbei um eine systemweite Mac OS X Einstellung die für alle Anwendungen gilt. Im Terminal kann mit dem Aufruf defaults write -g NSInitialTlTipDelay -integer 1 die Verzögerung auf eine Sekunde geändert werden. 11

12 ESTOS GmbH Petersbrunner Str. 3a D Starnberg Telefn: Fax: +49 (8151) (8151) Sweit nicht anders angegeben, sind alle genannten Markenzeichen gesetzlich geschützte Markten der ESTOS GmbH. Dies gilt insbesnder für Prduktnamen und Lgs. Micrsft, Windws und das Windws Lg sind Marken der Micrsft Crprtain. Alle anderen Prdukt- und Firmennahmen sind Marken der jeweiligen Inhaber. Alle Änderungen vrbehalten. Stand 4.1.dc-8