Oktober 2010 3A EDITOR PMS 6.0
AED-SICAD Aktiengesellschaft Postfach 83 07 54 81707 München www.aed-sicad.de Ihre Anregungen Wir nehmen gerne Ihre Rückmeldungen und Anregungen zu diesem Handbuch entgegen. Ihre Hinweise helfen uns dabei, die Dokumentation auf die Anforderungen unserer Kunden hin zu optimieren. Ein entsprechendes Faxformular finden Sie im hinteren Teil dieser Dokumentation. Natürlich können Sie uns Ihre Anregungen auch gerne online über unsere Homepage www.aed-sicad.de übermitteln.
Wir bieten Ihnen Schulungen...zu dem in diesem Handbuch beschriebenen Produkt...und zu vielen weiteren AED-SICAD relevanten Themen Unser Training Center steht Ihnen bei Fragen gerne zur Verfügung. AED-SICAD Aktiengesellschaft Training Center Postfach 83 07 54 81707 München Aktuelle Informationen über verfügbare Kurse finden Sie auch auf unserer Homepage www.aed-sicad.de Alle verwendeten Hard- und Softwarenamen sind Handelszeichen und/oder Warenzeichen der jeweiligen Hersteller. Copyright by AED-SICAD Aktiengesellschaft, 2010. All rights, including rights of translation, reproduction by printing, copying or similar methods, even of parts, are reserved. Offenders will be liable for damages. All rights, including rights created by parent grant or registration of a utility model or design, are reserved. Delivery subject to availability; right of technical modifications reserved.
Inhalt 1 Installation des Projektmanagement-Service... 6 1.1 Installation des IIS... 6 1.1.1 Installation IIS 5 auf Windows XP... 6 1.1.2 Installation IIS 6 auf Windows 2003... 6 1.1.3 Installation IIS 7 auf Windows 2008... 6 1.2 Installation des Projektmanagement-Service... 7 2 Konfiguration des Projektmanagement-Service... 8 2.1 Konfiguration des IIS... 8 2.1.1 WebService konfigurieren auf Windows XP... 8 2.1.2 WebService konfigurieren auf Windows 2003... 12 2.1.3 WebService konfigurieren auf Windows 2008... 12 2.2 IIS neu starten:... 13 2.3 Lese- und Schreibzugriff... 14 2.4 Projektmanagement-Service im 3A Explorer verwenden... 14 AED-SICAD Aktiengesellschaft 5 / 18
1 Installation des Projektmanagement-Service Verwendung und Benutzung des Projektmanagement-Service sind optional. Das Programm ist ausschließlich auf der Maschine zu installieren, auf der die zentrale Projektsteuerungsdatenbank verwaltet werden soll. Achtung: Eine parallele Installation des Projektmanagement-Service und eines 3A Servers auf derselben Maschine ist nicht möglich. 1.1 Installation des IIS Voraussetzung für den Projektmanagement-Service ist die Installation der Internet- Informationsdienste (IIS) von Mircosoft. 1.1.1 Installation IIS 5 auf Windows XP Zum Beispiel durch Auswahl von Start [Einstellungen] Systemsteuerung Software Windows Komponenten hinzufügen/entfernen. Die Standardinstallation des Internet-Informationsdienste (IIS) ist in der Regel geeignet. Falls Unterkomponenten ausgewählt werden (über Details ), sollten Sie mindestens folgende Unterkomponenten installieren: Gemeinsame Dateien, Internet-Informationsdienste Manager bzw. Snap-In, WWW-Server (falls abhängig vom Betriebssystem hier Unterkomponenten für WWW-Server oder WWW-Dienst über Details angeboten werden: mindestens WWW-Dienst) 1.1.2 Installation IIS 6 auf Windows 2003 Zum Beispiel durch Auswahl von Start [Einstellungen] Systemsteuerung Software Windows Komponenten hinzufügen/entfernen. (je nach Betriebssystem evtl. unter Anwendungsserver unter Details ) Die Standardinstallation des Internet-Informationsdienste (IIS) ist in der Regel geeignet. Falls Unterkomponenten ausgewählt werden (über Details ), sollten Sie mindestens folgende Unterkomponenten installieren: Gemeinsame Dateien, Internet-Informationsdienste Manager bzw. Snap-In, WWW-Server (falls abhängig vom Betriebssystem hier Unterkomponenten für WWW-Server oder WWW-Dienst über Details angeboten werden: mindestens WWW-Dienst) 1.1.3 Installation IIS 7 auf Windows 2008 Zum Beispiel durch Auswahl von Start Verwaltung Server-Manager Über Rollen Rollen hinzufügen kann der Webservice (IIS) hinzugefügt werden. AED-SICAD Aktiengesellschaft 6 / 18
Neben den standardmäßig ausgewählten Rollendiensten sind noch explizit zu wählen: ASP.NET und die dadurch automatisch nachgezogenen Rollendienste (.NET-Erweiterbarkeit, ISAPI-Erweiterung,ISAP-Filter) IIS6-Metabasiskompatibilität 1.2 Installation des Projektmanagement-Service Zur Installation der Software wählen Sie die Funktion Neue Programme hinzufügen unter Systemsteuerung -> Software. Navigieren Sie zur Produkt-CD und wählen Sie das setup.exe aus und folgen Sie den Anweisungen. Die Installation legt einen neuen Ordner im Verzeichnis des IIS (standardmäßig unter C:\Inetpub\wwwroot ), mit dem bei der Installation vergebenen Namen ( Virtuelles Verzeichnis ), an. AED-SICAD Aktiengesellschaft 7 / 18
2 Konfiguration des Projektmanagement-Service 2.1 Konfiguration des IIS 2.1.1 WebService konfigurieren auf Windows XP Starten Sie den Internet Informationsdienste-Manager über: Start [Einstellungen] Systemsteuerung; wählen Sie Verwaltung und anschließend Internet- Informations-Dienste Navigieren Sie zu <Rechnername>(lokaler Computer) Websites -> Standardwebsite -> AaaProjektmanagementService Im Kontextmenü des Knotens klicken Sie auf Eigenschaften. ASP.NET-Version setzen Im Reiter ASP.NET können Sie die ASP.NET-Version einstellen. Wählen Sie hier den Eintrag 2.0.50727 aus. Authentifizierungsmethoden setzen Wählen Sie nun den Reiter Verzeichnissicherheit. Klicken Sie unter Steuerung des anonymen Zugriffs und der Authentifizierung auf Bearbeiten. AED-SICAD Aktiengesellschaft 8 / 18
Aktivieren Sie die Optionen Anonymer Zugriff und Integrierte Windows-Authentifizierung und bestätigen Sie mit Übernehmen bzw. OK. Registrieren des ASP.NET IIS Danach ist in einem Eingabeaufforderungsfenster folgende Kommando abzusetzen: %WINDIR%\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe i Wenn KEIN lokales Datenverzeichnis verwendet wird: Wird als Datenverzeichnis des 3A Editors ein zentrales Laufwerk verwendet, so müssen zusätzliche Einstellungen vorgenommen werden. Navigieren Sie zunächst erneut zu den Authentifizierungsmethoden des Projektmanagement-Service. Als Benutzername tragen Sie einen Benutzer mit einer Domain ein, der volle Schreib- und Leserechte für das Datenverzeichnis des installierten 3A-Editors besitzt. Geben Sie das zugehörige Kennwort an und deaktivieren Sie die Option Kennwortkontrolle durch IIS zulassen. Bestätigen Sie Ihre Änderungen mit OK bzw. Übernehmen. AED-SICAD Aktiengesellschaft 9 / 18
Danach setzen Sie in einem Eingabeaufforderungsfenster das folgende Kommando ab: %WINDIR%\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe ga domäne\benutzer ( domäne\benutzer wie zuvor angegeben, Ausgabe: Gewähren Sie domäne\benutzer Zugriff auf die IIS-Metabase und andere von ASP.NET verwendete Verzeichnisse. Das Gewähren des Zugriffs von domäne\benutzer auf die IIS-Metabase und andere von ASP.NET verwendete Verzeichnisse ist abgeschlossen.) In der Datei %WINDIR%\Microsoft.NET\Framework\v2.0.50727\CONFIG\machine.config muss der Eintrag <processmodel autoconfig="true"/> erweitert werden um den bei den Authentifizierungsmethoden angegebenen Benutzer: <processmodel autoconfig="true" username="domäne\benutzer" password="passwort"/> Sollen diese Anmeldeinformationen verschlüsselt werden, so gehen Sie wie folgt vor: - Sie benötigen das Programm Aspnet_setreg.exe, das von http://support.microsoft.com/kb/329290 heruntergeladen werden kann (detailliertere Beschreibung zur Verwendung auf derselben Seite) - Stellen Sie sicher, dass Sie über Administrator-Rechte verfügen und führen Sie den folgenden Befehl aus: c:\speicherortdesprogramms>aspnet_setreg.exe -k:software\aspnetprocess\processmodel -u:"domäne\benutzer" -p:"passwort" - Nachdem Sie den Befehl ausgeführt haben, erhalten Sie eine Ausgabe etwa folgenden Inhalts (sinngemäße Übersetzung): Die Konfiguration muss folgende Einträge enthalten. Nehmen Sie ggf. die entsprechenden Änderungen vor: username="registry:hklm\software\aspnetprocess\processmodel\aspnet_setreg, username" password="registry:hklm\software\aspnetprocess\processmodel\aspnet_setreg, password" Die DACL des Registrierungsschlüssels gewährt Vollzugriff für "System", "Administratoren" und "Ersteller-Besitzer". - Speichern Sie diese Information nun in der Datei machine.config, indem Sie <processmodel autoconfig="true"/> durch folgenden Eintrag ersetzen: < processmodel autoconfig="true" username="registry:hklm\software\aspnetprocess\processmodel\aspnet_setreg,username" password="registry:hklm\software\aspnetprocess\processmodel\aspnet_setreg,password" /> - Erteilen Sie dem Konto des Prozesses "Aspnet_wp.exe" Leseberechtigungen für die Registry- Schlüssel Ausnahme für Firewall einstellen Bei einer aktiven Firewall muss IIS als Ausnahme eingetragen werden um die Verbindung anderer Rechner mit dem Projektmanagement-Service zu ermöglichen. Dazu ermitteln Sie zunächst die Port- Nummer der Standardwebsite des IIS: Starten Sie den Internet Informationsdienste-Manager über: Start [Einstellungen] Systemsteuerung; wählen Sie Verwaltung und anschließend Internet- Informations-Dienste Navigieren Sie zu <Rechnername>(lokaler Computer) Websites -> Standardwebsite AED-SICAD Aktiengesellschaft 10 / 18
Im Kontextmenü wählen Sie Eigenschaften. Im nachfolgenden Dialog ist der TCP-Anschluss im Reiter Website angegeben: Tragen Sie diese Nummer nun als Ausnahme in Ihrer Firewall ein (Systemsteuerung -> Windows Firewall -> Ausnahmen -> Port. Der anzugebende Name kann beliebig gewählt werden. AED-SICAD Aktiengesellschaft 11 / 18
2.1.2 WebService konfigurieren auf Windows 2003 Nur auf 64 Plattformen: IIS für 32 bit enablen: Der 3A Server ist eine 32-bit Applikation und läuft als solche unter 64-bit (x64) Microsoft Windows. Der IIS ist für 32 bit Programme zuzulassen. Hierzu sind in einem Eingabeaufforderungsfenster folgende Kommandos abzusetzen: cscript C:\inetpub\adminscripts\adsutil.vbs SET w3svc/apppools/enable32bitapponwin64 1 %WINDIR%\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe -i Anschließend ist im IIS die Ausführung von ASP.Net (32 bit) zuzulassen. Dazu starten Sie den Internet Informationsdienste-Manager über: Start [Einstellungen] Systemsteuerung; wählen Sie Verwaltung und anschließend Internet[informations]dienste-Manager Navigieren Sie zu <Rechnername>(lokaler Computer) Webdiensterweiterungen Ändern Sie den Eintrag ASP.NET 2.0.50727 (32-bit) auf 'zugelassen'. Authentifizierungsmethoden setzen 2.1.3 WebService konfigurieren auf Windows 2008 Eigenschaften des Anwendungspools Starten Sie den Internetinformationsdienste-Manager über: Start Verwaltung und anschließend Internetinformationsdienste-Manager Navigieren Sie zu <Rechnername>(<Rechnername>\<Benutzerkennung>) Anwendungspools Klicken Sie mit der rechten Maustaste auf DefaultAppPool und wählen Sie Erweiterte Einstellungen. AED-SICAD Aktiengesellschaft 12 / 18
Der 3A Server ist eine 32-bit Applikation und läuft als solche unter 64-bit (x64) Microsoft Windows. Der IIS ist für 32 bit Programme zuzulassen. Dies kann alles in der jetzt angezeigten Maske eingestellt werden. Es ist zu ändern: 32-Bit-Anwendungen aktivieren: true Prozessmodell: Leerlauftimeout auf 0 Wiederverwendung: Regelmäßiges Zeitintervall(Minuten) auf 0 2.2 IIS neu starten: Nach den durchgeführten Änderungen müssen die Internet-Informationsdienste neu gestartet werden. Rufen Sie dazu die Funktion Ausführen im Startmenü auf, geben Sie dort iisreset ein und bestätigen Sie mit OK AED-SICAD Aktiengesellschaft 13 / 18
2.3 Lese- und Schreibzugriff Der Projektmanagement-Service sowie der bei der Konfiguration angegebene Benutzer benötigen vollen Lese- und Schreibzugriff auf das Datenverzeichnis der zentralen 3A Editor-Installation sowie insbesondere auf die Projektsteuerung. Gegebenenfalls ist dieser Zugriff einzustellen. 2.4 Projektmanagement-Service im 3A Explorer verwenden URM-Benutzer eintragen (nur bei Verwendung des URM) Im Installationsverzeichnis des Projektmanagement-Service befindet sich die Datei Web.config. Öffnen Sie diese mit einem Texteditor und passen Sie die Zeilen entsprechend Ihrer Umgebung an. <appsettings> <add key="applicationname" value="3a-editor"/> <add key="instancename" value="-"/> <add key="user" value=""/> <add key="password" value=""/> </appsettings> User und Password müssen mit einem in der Projektsteuerung bekannten Benutzer belegt werden. Die benötigten Informationen können der Tabelle SD81010 der Projektsteuerung entnommen werden. User entspricht dem Feld BKN, Password dem Feld PWD. Da Passwörter in der Projektsteuerung generell verschlüsselt abgespeichert werden, ist das Schlüsselwort #Enc: vor das Passwort zu setzen (z.b.: Passwort in der Datenbank: password -> <add key="password" value=" #Enc:pAssWorD "/>). Der eingetragene Benutzer muss vollen Lese- und Schreibzugriff auf das Datenverzeichnis des 3A- Editors haben. Gegebenenfalls sind diese Rechte zu gewährleisten. Konfigurationseinstellung Um den Projektmanagement-Service im 3A Explorer einsetzen zu können, muss der Preference- Parameter <setting> AED-SICAD Aktiengesellschaft 14 / 18
<name>aaaexplorer.aaaprojectmanagementservice</name> <value>http://localhost/aaaprojektmanagementservice/projectservice.asmx</value> </setting> eingestellt werden. Wird der Web Service auf einer anderen Maschine ausgeführt, so ist localhost durch die entsprechende IP-Adresse zu ersetzen. Wurde bei der Installation ein anderes Virtuelles Verzeichnis als AaaProjektmanagementService gewählt, so muss die URL entsprechend angepasst werden. Der Projektmanagement-Service kann nun über die Funktion Übernehmen/Übergeben von Projekten im Menü Extras des 3A Explorers verwendet werden. AED-SICAD Aktiengesellschaft 15 / 18
AED-SICAD Aktiengesellschaft Postfach 83 07 54 81707 München Ihre Anregungen www.aed-sicad.de Absender: Produkt: Kommentare:
Herausgegeben von / Published by AED-SICAD Aktiengesellschaft Postfach 83 07 54 81707 München Printed in Germany