SiteAudit Knowledge Base. Einrichtung & Verwaltung der Reporting Web Site

Transkript

1 SiteAudit Knowledge Base Einrichtung & Verwaltung der Reporting Web Site Mai 2010 In diesem Beitrag: Funktionsübersicht Einrichtung RWS Verwaltung der Report-Ordner Zugriff auf SiteAudit Datenbanken SiteAudit 4.0 bietet viele neue Möglichkeiten. Eine davon ist die Möglichkeit aus jeder SiteAudit Ansicht einen Report zu erzeugen und diesen auf einer Website zu veröffentlichen, so dass Benutzer Reports mit einem Browser diese ansehen können. Dieser Beitrag beschreibt die Vorbereitung und Einrichtung einer solchen Website und bietet grundsätzliche Tipps zu IIS Einstellungen bezüglich der Reporting Website. Funktionsübersicht Die Reporting Website ist eine neue Funktion von SiteAudit 4.0, die es Benutzern ermöglicht SiteAudit Reports über Intranet oder Internet zu erhalten. Die Reporting Website ist eine ASPX Site, die unter Microsoft IIS 6 oder IIS 7 läuft. Authorisierte Benutzer können Reports direkt aus dem SiteAudit Viewer auf dieser Reporting Website veröffentlichen, und die Reports können über das Web mittels Internet Explorer 7 oder 8 abgerufen werden. Abbildung 1 zeigt ein Beispiel der Standard-Reporting Website, die mit SiteAudit 4.0 eingerichtet wurde. Reports können Daten aus verschiedenen Datenbanken beinhalten, je nachdem welche Datenbank-Anmeldedaten hinterlegt sind. Netaphor SiteAudit Software v1.0

2 Abbildung 1 Netaphor SiteAudit Reporting Website 2010 Netaphor Confidential CHANNEL PARTNER ONLY 2 4/19/2010

3 Einrichtung der Reporting Website Die Reporting Website wird mit dem Installationsprogramm von SiteAudit eingerichtet. Dieses bietet nun zusätzliche Funktionen. Die folgenden Informationen beschreiben die Installation der Reporting Website Komponente. IIS 6 oder IIS 7 muss installiert sein um die Reporting Website zu einzurichten. Ansonsten wird die Komponente bei der Installation deaktiviert. Die Reporting Website benötigt ein Lizenzupgrade, welche für Kunden mit einem gültigen Support- Vertrag kostenlos ist. Bitte kontaktieren Sie den Netaphor Support um eine neue Lizenz für die Reporting Website zu erhalten. Die SiteAudit Einrichtung beginnt mit einem Welcome-Screen, der angezeigt wird sobald das Installationsprogramm gestartet wurde. Das SiteAudit Schema und die Version werden im unteren Bereich angezeigt. Klicken Sie auf Weiter um fortzufahren Netaphor Confidential CHANNEL PARTNER ONLY 3 4/19/2010

4 Benutzer müssen dem Nutzungsvertrag zustimmen um SiteAudit Komponenten zu installieren. Klicken Sie auf die Checkbox und dann auf die Weiter Schaltfläche um fortzufahren. Um die Reporting Website einzurichten wählen Sie Reports via Browser Möglichkeit. Die Option Nur Ansichten und Reporterstellung wird automatisch angewählt, da der SiteAudit Viewer für die Einrichtung der Reporting Website benötigt wird. Klicken Sie auf die Schaltfläche Weiter um fortzufahren Netaphor Confidential CHANNEL PARTNER ONLY 4 4/19/2010

5 Wählen Sie, für wen die Software installiert werden soll und klicken Sie auf die Schaltfläche Weiter. Klicken Sie auf Weiter um den SiteAudit Installationspfad zu akzeptieren, oder ändern Sie diesen durch einen Klick auf die Schaltfläche Ändern, wählen Sie dort den Zielordner aus und klicken Sie auf Weiter um fortzufahren Netaphor Confidential CHANNEL PARTNER ONLY 5 4/19/2010

6 Klicken Sie auf Weiter um den Standard-Installationspfad für die Website zu akzeptieren oder klicken Sie auf Ändern um diesen anzupassen. Danach bitte auf Weiter klicken Netaphor Confidential CHANNEL PARTNER ONLY 6 4/19/2010

7 Tragen Sie den Namen des SQL Servers in dem Textfeld ein. Wenn ein SQL Server Instanzen beinhaltet, so muss der Name der Instanz angegeben werden. Zum Beispiel: DEVSQLSERVER\INSTANZ. Geben Sie die Anmeldedaten für den SQL Server an und klicken Sie auf Test um zu prüfen, ob die Anmeldedaten korrekt sind. Ein Erfolgreich Popup erscheint, wenn die Anmeldedaten gültig sind, falls nicht erscheint eine Fehlermeldung Netaphor Confidential CHANNEL PARTNER ONLY 7 4/19/2010

8 Wählen Sie die Datenbank aus, welche von der Reporting Website genutzt werden soll. Bitte seien Sie sich bewusst, dass Reports, welche durch die Reporting Website gestartet werden Daten aus der genutzten Datenbank enthalten. Die Website Datenbank-Konfiguration, siehe unten, kann auch im SiteAudit Viewer gemacht werden. Dies ermöglicht es Benutzern, unterschiedliche SQL Server und unterschiedliche Datenbanken zu verwenden. Wurde die Datenbank einmal ausgewählt, klicken Sie auf die Schaltfläche OK um fortzufahren Netaphor Confidential CHANNEL PARTNER ONLY 8 4/19/2010

9 Klicken Sie auf die Schaltfläche Installieren um die Einrichtung zu beginnen. Wurde die Installation gestartet, so kann es sein, dass der Benutzer Administratorrechte benötigt. Sobald die Installation abgeschlossen wurde, lesen Sie bitte das Lizenzabkommen und klicken danach auf Weiter um fortzufahren Netaphor Confidential CHANNEL PARTNER ONLY 9 4/19/2010

10 Klicken Sie auf Beenden um die Installation abzuschließen Netaphor Confidential CHANNEL PARTNER ONLY 10 4/19/2010

11 Reporting Website installierte Dateien Bei der Installation der Reporting Website wird ein virtuelles Verzeichnis angelegt und IIS wird konfiguriert um diese Anwendung zu nutzen. Der nachfolgende Screenshot zeigt die installierten Dateien und Ordner der Reporting Website Netaphor Confidential CHANNEL PARTNER ONLY 11 4/19/2010

12 IIS Konfiguration Bei der Installation der Reporting Website wird ein virtuelles Verzeichnis angelegt und IIS wird konfiguriert um diese Anwendung zu nutzen. Der nachfolgende Screenshot zeigt die installierten Dateien und Ordner der Reporting Website. Der Ordner App_Data beinhaltet die Beispiel-Ansichten, die automatisch installiert werden und die auf der Reporting Website zur Verfügung stehen. Der Ordner App_Theme beinhaltet das Standard-Theme für die Website. Benutzer können ihre eigenen Themes erstellen und in diesem Ordner bereitstellen Netaphor Confidential CHANNEL PARTNER ONLY 12 4/19/2010

13 Ein Anwendungspool wird automatisch erzeugt um Konflikten mit anderen Webanwendungen zu vermeiden. Der nachfolgende Screenshot zeigt dass das Default Theme für die Website genutzt wird. Benutzern ist es erlaubt ihre eigenen Themes zu verwenden. Das von der Reporting Website genutzte Theme muss in der Datei web.config angegeben werden. Während der Installation muss der Benutzer den SQL Server und die Datenbank angeben, welche von der Reporting Website genutzt werden. Der SQL Verbindungsstring wird hier angezeigt. Dieser kann im SiteAudit Viewer über den Dialog der Website Datenbank- Konfiguration angepasst werden. Nachfolgender Screenshot zeigt die Authentisierungseinstellungen der Reporting Website Netaphor Confidential CHANNEL PARTNER ONLY 13 4/19/2010

14 Verwaltung der Report-Ordner Die Ordner-Struktur der Reporting Website, die im linken Teil des nachfolgenden Screenshots zu sehen ist, wird durch die Datei Web.sitemap definiert. Diese befindet sich im Root-Ordner des Reporting Website Installationsverzeichnisses. Diese Datei wird als Sitemap-Datei bezeichnet. Achtung: die Ordnernamen beinhalten Leerzeichen, aber die echten Verzeichnisse im virtuellen Verzeichnis beinhalten diese nicht. Die Ansicht der Anzeigenamen und URLs wird der Web.sitemap-Datei festgelegt. Mehr dazu im nächsten Abschnitt. Die eigentliche Ordnerstruktur der Website-Anwendung wird im rechten Teil der Abbildung gezeigt. Die Strukturen scheinen überein zu stimmen. Bei einem zweiten Blick werden Sie feststellen, dass im IIS keine Leerzeichen bei den Ordnernamen sind. Diese sind nicht zugelassen, aber die Anzeigenamen, die im Browser angezeigt werden, dürfen Leerzeichen beinhalten und können komplett anders lauten als der eigentliche Verzeichnisname Netaphor Confidential CHANNEL PARTNER ONLY 14 4/19/2010

15 Site Map Ordner-Spezifikation Die Sitemap definiert die Ordnerstruktur und die Ordnernamen, die auf der Reporting Website angezeigt werden. Die Datei Web.sitemap in dem Root-Verzeichnis der Reporting Website beinhaltet nachfolgende Daten. <?xml version="1.0" encoding="utf-8"?> <sitemap xmlns=" > <sitemapnode url="default.aspx" title="reporting Web site" description="the Reporting Web site root folder" > <sitemapnode url="myreports/default.aspx" title="my Reports" description="contains sample reports" > <sitemapnode url="myreports/assessmentdetails/default.aspx" title="assessment Details" description="sample Assessment Detail reports" /> <sitemapnode url="myreports/consumables/default.aspx" title="consumables" description="sample Consumables reports" /> <sitemapnode url="myreports/hostanalysis/default.aspx" title="host Analysis" description="sample Host Analysis reports" /> <sitemapnode url="myreports/incidenthistory/default.aspx" title="incident History" description="sample Incident History reports" /> <sitemapnode url="myreports/inventory/default.aspx" title="inventory" description="sample Inventory reports" /> <sitemapnode url="myreports/jobanalysis/default.aspx" title="job Analysis" description="sample Job Analysis reports" /> <sitemapnode url="myreports/lifetimecounters/default.aspx" title="lifetime Counters" description="sample Lifetime Counters reports" /> <sitemapnode url="myreports/problemanalysis/default.aspx" title="problem Analysis" description="sample Problem Analysis reports" /> <sitemapnode url="myreports/slaanalysis/default.aspx" title="sla Analysis" description="sample Service Level Agreement reports" /> <sitemapnode url="myreports/volumeanalysis/default.aspx" title="volume Analysis" description="sample Volume Analysis reports" /> </sitemapnode> </sitemapnode> </sitemap> Die installierte Sitemap beinhaltet mehrere Ordner und SiteAudit installiert mehrere Beispiel- Ansichten in jeden dieser Ordner. Die Ansichten können über die Reporting Website geöffnet werden. Benutzer können Ihre eigenen Ansichten auf der Reporting Website veröffentlichen, eventuell muss jedoch hierfür ein neuer Ordner erstellt werden. Neue Ordner können in der Sitemap definiert werden und der IIS Administrator muss den eigentlichen Ordner im virtuellen Verzeichnis der Reporting Website erstellen. Wurde ein Ordner erstellt, so können Benutzer beliebig viele Ansichten veröffentlichen. Um einen Order in der Sitemap zu erstellen, fügen Sie nur ein neues sitemapnode-element in dem gewünschten Verzeichnis hinzu. Drei Properties müssen für jeden Ordner definiert werden: url, title und description. Diese werden nachfolgend beschrieben Netaphor Confidential CHANNEL PARTNER ONLY 15 4/19/2010

16 URL Die Property url beinhaltet den Verzeichnisnamen und den Pfad, falls das Verzeichnis ein Unterverzeichnis ist. Alle url Properties müssen mit der Default.aspx Site enden. Zum Beispiel bei einem Ordner in root, der TEST heißt. Der url Wert wäre: TEST/Default.aspx. Wenn Sie den TEST Ordner als Unterordner von Sample wollten, wäre der url Wert: Sample/TEST/Default.aspx. Es ist wichtig zu wissen, dass Leerzeichen in der url Property nicht zugelassen sind. Wenn eine Ansicht auf der Reporting Website veröffentlicht wird, muss sie in den hier definierter Ordner veröffentlicht werden. In diesem Beispiel sollten die Benutzer nezue Ansichten nach Sample/TEST veröffentlichen. Title Die title Property beinhaltet als Wert den Anzeigenamen, der im Browser dargestellt wird. Hierfür sind Leerzeichen erlaubt. Benutzer können jeglichen Text als Anzeigenamen verwenden, sinnvoll ist jedoch möglichst den gleichen Namen wie für den URL-Ordner zu verwenden. Description Die description Property erlaubt es dem Site-Administrator eine Beschreibung für den Ordner einzutragen. Die Beschreibung wird als Tooltip auf der Reporting Website angezeigt wenn man mit der Maus über den Verzeichnisnamen kommt. Benutzer konfigurieren Alle Benutzer, die die Reporting Website aufrufen, müssen Mitglied der IIS_USR Gruppe sein. Es ist möglich, dass Benutzer außerhalb der Gruppe auch die Website aufrufen können, allerdings nicht alle Funktionen der Website nutzen können. Daher ist es empfohlen die Benutzer in die Gruppe IIS_USR Gruppe aufzunehmen Netaphor Confidential CHANNEL PARTNER ONLY 16 4/19/2010

17 Zugriff auf alternative SiteAudit Datenbanken Während der Installation der Reporting Website konnten der SQL Server und Datenbank- Informationen hinterlegt werden. Diese Informationen werden auch Datenbank-Verbindungs- String genannt. Der Datenbank-Verbindungs-String erlaubt der Reporting Website Zugriff auf die SiteAudit Datenbank um Reports zu erzeugen. Unter Umständen muss nachträglich der SQL Server oder die Datenbank geändert werden. Unabhängig von dem ausgewählten SQL Server und der Datenbank verändert sich die Ordnerstruktur der Reporting Website nicht. Nur der Inhalt der einzelnen Reports ändert sich, durch die Auswahl einer anderen Datenbank. Um auf eine andere Datenbank zuzugreifen erzeugen Sie einen neuen Verbindungs-String mit dem Website Datenbank-Konfigurations-Dialog. Diesen starten Sie im SiteAudit Viewer über das Einstellungen-Menü. Dieser Dialog gleicht dem, der bei der SiteAudit-Installation angezeigt wird. Ändern Sie den SQL Server, die Datenbank oder die Anmeldedaten wie gewünscht Netaphor Confidential CHANNEL PARTNER ONLY 17 4/19/2010

18 Troubleshooting Der nachfolgende Abschnitt zeigt ein paar Probleme, denen sich Administratoren bei der Einrichtung der Reporting Website gegenüber sehen können. Zugriffsberechtigungen der Benutzer einrichten Alle Benutzer, die auf die Reporting Website zugreifen können müssen Mitglied der Gruppe IIS_USR sein. Es ist möglich, dass Benutzer auch ohne Mitglied zu sein die Website aufrufen können, aber die Website nur eingeschränkt nutzen können. Daher wird empfohlen die Benutzer immer in die IIS_USR Gruppe aufzunehmen. Zugriff auf Pfad verweigert Wenn der Fehler Zugriff auf Pfad verweigert bei Ansicht eines Reports auftritt, aktivieren Sie bitte die Intranet-Einstellungen im Internet Explorer. Dies kann behoben werden durch Deaktivierung der Einstellung Geschützter Modus. Verwendung alternativer Anmeldedaten Der Internet Explorer beinhaltet eine erweiterte Funktion, die immer nach Anmeldedaten fragt, selbst wenn der Benutzer sich an der Maschine mit seinem Domänen-Benutzer angemeldet hat. Um die Frage an Domänen-Benutzer zu unterdrücken, deaktivieren Sie die Frage bei den erweiterten Einstellungen. Domänen-Benutzer müssen sich nicht nochmals extra anmelden um auf die Reporting Website zuzugreifen. Es kann vorkommen, dass ein anderer Benutzer (nicht Domänen-Benutzer) sich auf der Reporting Website einloggen muss. Hierfür müssen Sie die Immer fragen Einstellung aktivieren, damit auch die korrekten Anmeldedaten eingegeben werden können Netaphor Confidential CHANNEL PARTNER ONLY 18 4/19/2010