Installationsanleitung

Transkript

1 Installationsanleitung Copyright 2010 cobra computer s brainware GmbH cobra CRM PLUS und cobra Web CRM sind eingetragene Warenzeichen der cobra computer s brainware GmbH. Andere Begriffe können Warenzeichen oder anderweitig geschützt sein und werden hier ohne jegliche Gewährleistung der freien Verwendbarkeit benutzt. Alle Rechte vorbehalten. Nachdruck, auch auszugsweise, verboten. Kein Teil dieses Werkes darf ohne schriftliche Einwilligung der cobra GmbH in irgendeiner Form (Fotokopie, Mikrofilm, Scan oder ein anderes Verfahren) auch nicht für Zwecke der Unterrichtsgestaltung reproduziert oder unter Verwendung elektronischer Systeme verarbeitet, vervielfältigt oder verbreitet werden. Änderungen, Irrtümer und Druckfehler vorbehalten. und

2 Inhalt Voraussetzungen... 3 Das Web CRM Paket... 3 Datenbanken... 3 Installation... 5 Anwendungsverzeichnis... 5 Berechtigungen... 5 Weitere Verzeichnisse... 6 Verbindung zur Datenbank versand... 7 Website im IIS anlegen und einrichten... 9 Windows Server Start... 9 Anwendungspool anlegen... 9 Identität des Anwendungspools Eine Website anlegen Alternative das Web CRM als Unterweb anlegen Einstellungen der Website oder des virtuellen Verzeichnisses Windows Server Start Anwendungspool anlegen Anwendungspool einstellen Eine Website anlegen Alternative das Web CRM als Unterweb anlegen Einstellungen der Website oder des virtuellen Verzeichnisses Demo einrichten und starten Demo-Datenbanken auf dem SQL Server einbinden Web CRM-Programmdateien kopieren Website anlegen Datei Web.Config anpassen Dokumentenverwaltung einrichten Zugriffsrechte vergeben Jetzt können Sie starten Zugangsdaten der Demo

3 Voraussetzungen Folgendes muss auf Ihrem System bereits vorhanden sein, bevor Sie Web CRM installieren. Windows Server 2003 oder eine höhere Windows Server-Version IIS (Internet-Informationsdienste).NET Framework 3.5 oder höher SQL Server 2000 oder höher Optional: Wenn der versand per Exchange Server gewünscht ist, muss ein Exchange Server mit Outlook Web Access installiert sein. Das Web CRM Paket Entpacken Sie die Datei WebCRM.zip in ein beliebiges Verzeichnis. Dieses Paket enthält das eigentliche Web CRM (Ordner»Web CRM«) und die Demodatenbanken (Ordner»DBs«). Datenbanken Wenn Sie keine bestehende CRM Plus-Datenbank haben, spielen Sie die mitgelieferten Demo-Datenbanken in Ihren SQL Server ein. Richten Sie für den Zugriff auf die Datenbank einen Benutzer im SQL Server ein. Wir empfehlen, für die Verbindung zum SQL Server die»sql Server Authentifizierung«zu benutzen und dem neu erstellten Benutzer nur jene Berechtigungen zu erteilen, die für die vom Web CRM benötigten Datenbanken notwendig sind. Der 3

4 Datenbankbenutzer benötigt für die Datenbanken mindestens die Rechte des db_owner. 4

5 Installation Anwendungsverzeichnis Kopieren Sie das Anwendungsverzeichnis an einen beliebigen Ort auf Ihrem Webserver. Entfernen Sie einen eventuellen Schreibschutz für das gesamte Anwendungsverzeichnis. Berechtigungen Da der Internet Information Server standardmäßig den Benutzer»Netzwerkdienst«einsetzt, um Webanwendungen auszuführen, müssen im Anwendungsverzeichnis folgende Berechtigungen gesetzt werden. Geben sie dem Benutzer»Netzwerkdienst«Leseberechtigung auf das gesamte Anwendungsverzeichnis. Geben Sie dem Benutzer»Netzwerkdienst«Schreib- und Änderungsberechtigung auf die Verzeichnisse»App_Data«und»Layouts«innerhalb des Anwendungsverzeichnisses. Geben Sie dem Benutzer»Netzwerkdienst«Schreib- und Änderungsberechtigung auf die Dateien /web.config und /Widgets/widget_list.ascx. Erstellen Sie einen Ordner für temporäre Dateien mit Lese-, Schreib- und Änderungsberechtigung für den»netzwerkdienst«. Erstellen Sie einen Ordner für die Logdatei mit Lese-, Schreib- und Änderungsberechtigung für den»netzwerkdienst«. Erstellen Sie einen Ordner für die Dokumentenverwaltung mit Lese-, Schreibund Änderungsberechtigung für den»netzwerkdienst«, oder erteilen Sie die Lese-, Schreib- und Änderungsberechtigung für ein vorhandenes Dokumentenverzeichnis. 5

6 Weitere Verzeichnisse Tragen Sie die Pfade zu den erstellten Ordnern für die temporären Dateien und die Dokumentenverwaltung in die web.config ein: Suchen Sie dafür in der web.config nach dem Tag <appsettings>. Passen Sie unterhalb der gefunden Stelle die folgenden beiden Zeilen entsprechend an: <add key="documentsroot" value="c:\webcrmdocs\"/> <add key="tempdocumentsroot" value="c:\webcrmdocs\tempdocs\"/> Verbindung zur Datenbank Für die erste Verbindung zur Datenbank müssen in der Datei /web.config die Verbindungen zur Datenbank eingestellt werden. Öffnen Sie dazu die Datei /web.config mit den Windows Text Editor (»Start: Ausführen: Notepad«) oder einem beliebigen anderen Text- bzw. XML-Editor. Suchen Sie in der Datei nach dem Tag: <connectionstrings>. Darunter befinden sich Zeilen, die wie folgt aufgebaut sind: <add name="personalization" connectionstring="[...]" /> <add name="users" connectionstring="[...]" /> <add name="system" connectionstring="[...]" /> <add name="appointment" connectionstring="[...]" /> <add name="documents" connectionstring="[...]" /> <add name="data" connectionstring="[...]" /> Im Attribut connectionstring wird die Verbindungszeichenfolge zu der entsprechenden Datenbank eingetragen. Personalization enthält die Verbindungs-Zeichenfolge zur ASP.NET Personalisierungs-Datenbank. Users enthält die Verbindungs-Zeichenfolge zur Benutzer-Datenbank. System enthält die Verbindungs-Zeichenfolge zur System-Datenbank. Appointment enthält die Verbindungs-Zeichenfolge zur Termin-Datenbank. Documents enthält die Verbindungs-Zeichenfolge zur Dokumenten-Datenbank. Data enthält die Verbindungs-Zeichenfolge zur eigentlichen CRM Plus-Datenbank. (Alle anderen Einträge können ignoriert werden.) 6

7 Die Verbindungszeichenfolgen sind immer wie folgt aufgebaut: data source=<sql Servername\Instanzname>;Initial Catalog=<Datenbankname>; User Id=<Benutzername>;Password=<Passwort>; data source enthält den Namen und ggf. die Instanz des SQL Servers. Initial Catalog enthält den Namen der entsprechenden Datenbank. User Id enthält den Namen des SQL Server-Benutzers, der auf die Datenbank zugreifen darf. Password enthält das Passwort des oben angegebenen SQL Server-Benutzers. Wir empfehlen, für die Verbindung zum SQL Server die»sql Server Authentifizierung«zu benutzen und dem neu erstellten Benutzer nur jene Berechtigungen zu erteilen, die für die vom Web CRM benötigten Datenbanken notwendig sind. Der Datenbankbenutzer benötigt für die Datenbanken mindestens die Rechte des db_owner. versand Der versand an Adressen aus dem Web CRM heraus, kann sowohl über einen lokalen client erfolgen, als auch über einen vorhandenen Exchange Server. Wird der Versand per Exchange Server gewählt muss sichergestellt sein, dass auf dem Exchange Server das Outlook Web Access installiert ist. Der Versand per Exchange Server benötigt zwingend das Outlook Web Access auf dem Exchange Server! Wenn der versand des Web CRM über einen vorhandenen Exchange Server laufen soll, müssen noch folgende Einstellungen in der web.config gemacht werden. Suchen Sie dafür in der web.config nach dem Tag <appsettings>. <add key="domain" value="ihredomaene" /> Tragen Sie hier die Active Directory Domain ein die vom Exchange Server verwendet wird. <add key=" sendmethod" value="exchange" /> Tragen Sie hier Exchange ein um der Versand per Exchange Server zu aktivieren. Mit dem Standardwert Default wird - wie gehabt - der lokale client für den versand verwendet. <add key="exchangebasepath" value=" IhreDomaene.de/exchange/"/> Tragen Sie hier die vollständige Adresse zum Outlook Web Access ein. 7

8 8

9 Website im IIS anlegen und einrichten Windows Server 2003 Hier lesen Sie, wie Sie Web CRM auf einem Windows 2003-Server mit IIS 6.0 aufsetzen. Auf dem IIS 6.0 kann für das Web CRM eine eigene Website angelegt werden. Sie können den Web CRM aber auch auf dem IIS 6.0 als Unterweb einer anderen Website betreiben. Im Folgenden wird daher auch beschrieben, wie sie auf dem IIS 6.0 eine eigene Website für das Web CRM anlegen. Start Wechseln Sie in die Systemsteuerung von Windows. Klicken Sie dort»verwaltung«doppelt an. Öffnen Sie den Internet-Informationsdienste Manager (IIS) durch Doppelklick. Sie können den IIS auch öffnen, in dem Sie im Start-Menü»Serververwaltung«aufrufen und»diesen Anwendungsserver verwalten«anklicken. Oder wählen Sie unter»systemsteuerung: Verwaltung«den Internet-Informationsdienste Manager aus. Anwendungspool anlegen Der Anwendungspool isoliert die Ausführung einer oder mehrerer Anwendungen. Öffnen Sie den Internet-Informationsdienste Manager. 9

10 Legen Sie wie im Bild gezeigt einen Anwendungspool für Web CRM an. Sie können einen beliebigen Namen eingeben. Sie tragen den Anwendungspool später bei den Eigenschaften der Website ein. Identität des Anwendungspools In den Eigenschaften des Anwendungspools stellen Sie ein, unter welchem Windows-Konto die Web-Anwendung läuft (Register»Identität«). Die Vorgabe ist»netzwerkdienste«. Sie können auch ein beliebiges anderes Konto auswählen. Wir empfehlen, nur das voreingestellte Konto»Netzwerkdienste«zu verwenden! Das eingestellte Konto wird verwendet: beim Zugriff auf den SQL Server (allerdings nur, wenn per Windows Authentifizierung auf die Datenbanken zugegriffen wird) und beim Zugriff auf das Dateisystem (z. B.: temporäre Dokumente anlegen, Dokumentenverwaltung, Log-Datei und für diverse Einstellungen im Adminbereich). 10

11 Eine Website anlegen Legen Sie eine neue Website an. Dazu klicken Sie den Ordner»Websites«mit der rechten Maustaste an und erteilen den abgebildeten Befehl. Tragen Sie den Namen der neuen Website ein. 11

12 Auf der folgenden Seite können Sie den Hostheader für diese Website eingeben. Geben Sie an, in welchem Verzeichnis die Dateien für die Website liegen: Wenn Sie den anonymen Zugriff erlauben, kann jeder versuchen, sich am Web CRM anzumelden. Wenn Sie den anonymen Zugriff deaktivieren, können nur solche Benutzer auf das Web CRM zugreifen, die sich im Browser mit einem Windows-Konto anmelden. Diese Anmeldung erfolgt vor der eigentlichen Anmeldung am Web CRM. In diesem Fall sind allerdings insgesamt zwei Anmeldungen erforderlich. Wir empfehlen, den anonymen Zugriff in einer Internetumgebung zuzulassen. In einer Intranet-Umgebung kann der anonyme Zugriff verweigert werden. 12

13 Es müssen nur»lesen«und»skripts ausführen«angeklickt werden. Im Anschluss sollten Sie die Einstellungen der Website prüfen und ergänzen. Der Eigenschaften-Dialog der Website enthält mehr Seiten als der Dialog Unterwebs. Die wesentlichen Einstellungen für das Web CRM sind aber bei beiden gleich und werden weiter unten gemeinsam beschrieben. Alternative das Web CRM als Unterweb anlegen Zum Anlegen eines Unterweb klicken Sie die gewünschte Website, zu der Sie das Unterweb anlegen möchten, mit der rechten Maustaste an und erteilen den abgebildeten Befehl. Ein Assistent öffnet sich, in dem Sie ein virtuelles Verzeichnis anlegen. Dieses Verzeichnis verweist auf den Ordner, in dem die Daten des Web CRM liegen. 13

14 Tragen Sie ein, unter welchem Namen das virtuelle Verzeichnis geführt werden soll. Geben Sie an, in welchem Verzeichnis die Dateien für die Website liegen. Legen Sie die Rechte fest, die Benutzer in diesem Verzeichnis haben sollen. Es müssen nur»lesen«und»skripts ausführen«angeklickt werden. Das virtuelle Verzeichnis muss im IIS als Anwendung eingetragen sein. Das Verzeichnis bekommt im IIS das Zahnrad-Symbol. Im Eigenschaften-Dialog steht auf der Registerkarte»Virtuelles Verzeichnis«als Anwendungsname der Name, den Sie im Assistenten als Alias angegeben haben. 14

15 Einstellungen der Website oder des virtuellen Verzeichnisses Klicken Sie die neu entstandene Website oder das virtuelle Verzeichnis mit der rechten Maustaste an. Erteilen Sie aus dem Kontextmenü den Befehl»Eigenschaften«. Kontrollieren und ergänzen Sie hier die Einstellungen für Ihr Web bzw. das virtuelle Verzeichnis. Am besten wird für die Website ein eigener Anwendungspool angelegt und in der Registerkarte unter»anwendungspool«eingetragen. Die Datei Default.aspx muss auf dem Reiter»Dokumente«als Standarddokument eingetragen sein: 15

16 In der Registerkarte»ASP.NET«muss die ASP.NET Version ausgewählt sein (das ist Standard). Nach der Einrichtung ist es unbedingt notwendig, das ASP.NET in den Webdiensterweiterungen zuzulassen! Windows Server 2008 So setzen Sie Web CRM auf einem Windows Server 2008 mit IIS 7.0 auf. Achten Sie beim Installieren des IIS darauf, die Anwendungsentwicklungsfeatures für ASP.NET mitzuinstallieren. 16

17 Start Wechseln Sie in die Systemsteuerung von Windows. Klicken Sie dort»verwaltung«doppelt an. Öffnen Sie den Internet-Informationsdienste Manager (IIS) durch Doppelklick. Anwendungspool anlegen Im IIS klicken Sie»Anwendungspools«an und öffnen das Kontextmenü der Liste durch Klick mit der rechten Maustaste. Im Kontextmenü wählen Sie den Eintrag»Anwendungspool hinzufügen «. 17

18 Sie können einen beliebigen Namen eingeben. Sie tragen den Anwendungspool später unter den Eigenschaften der Website ein. Anwendungspool einstellen In den»erweiterten Einstellungen«des Anwendungspools stellen Sie ein, unter welchem Windows-Konto die Web-Anwendung läuft. Die Vorgabe ist»netzwerkdienste«. Sie können auch ein beliebiges anderes Konto auswählen. Wir empfehlen, nur das voreingestellte»netzwerkdienste«als Konto zu verwenden! 18

19 Das eingestellte Konto wird verwendet: beim Zugriff auf den SQL Server (allerdings nur, wenn per Windows Authentifizierung auf die Datenbanken zugegriffen wird) und beim Zugriff auf das Dateisystem (z. B.: temporäre Dokumente anlegen, Dokumentenverwaltung, Log- Datei und für diverse Einstellungen im Adminbereich). Wenn das Betriebssystem Ihres Webservers ein 64-Bit-System ist, müssen Sie den Anwendungspool auf 32-Bit umstellen. Stellen Sie hierfür die Eigenschaft»32-Bit-Anwendungen aktivieren«auf»true«19

20 Eine Website anlegen Legen Sie eine neue Website an. Dazu klicken Sie den Ordner»Websites«an und wählen unter»aktionen«oder über das Kontextmenü den Befehl»Website hinzufügen «aus. Tragen Sie den Namen der neuen Website ein und wählen Sie den Anwendungspool aus. 20

21 Geben Sie an, in welchem Verzeichnis die Dateien für die Website liegen und tragen Sie, wenn gewünscht, den Hostheader ein: Diese Einstellungen können Sie später unter»grundeinstellungen«oder»bindungen«ändern. Die weiteren Einstellungen einer Website entsprechen denen eines virtuellen Verzeichnisses und werden weiter unten erläutert. 21

22 Alternative das Web CRM als Unterweb anlegen Zum Anlegen eines Unterweb klicken Sie die gewünschte Website, zu der Sie das Unterweb anlegen möchten, mit der rechten Maustaste an und erteilen den abgebildeten Befehl. Ein Dialog öffnet sich, in dem Sie das virtuelles Verzeichnis anlegen. Tragen Sie ein, unter welchem Namen das virtuelle Verzeichnis geführt werden soll und geben Sie an, in welchem Verzeichnis die Dateien für die Website liegen. 22

23 Das virtuelle Verzeichnis muss anschließend im IIS als Anwendung eingetragen sein. Öffnen Sie dazu das Kontextmenü für das virtuelle Verzeichnis und wählen Sie den Befehl»In Anwendung konvertieren«. In dem Dialog, der sich jetzt öffnet, geben Sie der Anwendung einen Namen und wählen den Anwendungspool aus. Das Verzeichnis bekommt im IIS das Weltkugel- Symbol. Sie sehen unter»aktionen«die Rubrik»Anwendung bearbeiten«mit den Befehlen»Grundeinstellungen «und»erweiterte Einstellungen «. 23

24 Einstellungen der Website oder des virtuellen Verzeichnisses Sie können die Einstellungen für Features einer Website oder eines virtuellen Verzeichnisses bearbeiten, in dem Sie die Website oder das virtuelle Verzeichnis in der Baum-Darstellung anklicken und in der Mitte die Ansicht»Features«wählen. Die Einstellungen zu den Features, die unter der Rubrik»ASP.NET«zusammengefasst sind, werden aus der Web.Config des Web CRM ausgelesen. Die Einstellungen der Web.Config können mit dem IIS konfiguriert werden. Einige Einstellungen werden auch über den Administrationsbereich des Web CRM verwaltet. Die Einstellungen zu den Features unter der Rubrik»IIS«entsprechen den Einstellungen der IIS-Website-Eigenschaften-Dialogs. Unter»Standarddokument«muss auch die Datei»Default.aspx«eingetragen sein. Unter»Authentifizierung«können Sie den anonymen Zugriff ein- oder ausschalten. Unter»SSL-Einstellungen«können Sie den Zugriff per HTTPS einstellen. 24

25 Demo einrichten und starten Das Web CRM auf der CD ist für die beigelegten Demo-Datenbanken eingerichtet. So können Sie den cobra Web CRM schnell und einfach ausprobieren. Demo-Datenbanken auf dem SQL Server einbinden Binden Sie die beiliegenden mdf-dateien aus dem»demodbs«-verzeichnis von der CD in den SQL Server ein. Dazu Kopieren Sie die Dateien in das Data-Verzeichnis Ihres SQL Servers, öffnen Sie das SQL Server Management Studio oder den SQL Server Enterprisemanager, öffnen das Kontextmenü auf»databases«und wählen den Punkt»Attach«bzw.»Datenbank anhängen«aus. Wählen sie nun die DemoWebCRM.mdf aus. Analog verfahren Sie für DemoWebCRM_Pers.mdf und DemoWebCRM_Sys.mdf. DemoWebCRM.mdf Demo-Datenbank für das Web CRM. DemoWebCRM_Pers.mdf In der DemoWebCRM_Pers.mdf sind die Tabellen für die Personalisierung der Website enthalten. 25

26 DemoWebCRM_Sys.mdf In der DemoWebCRM_Sys.mdf sind die Tabellen der System.db, Benutzer.db, DocMan.db und Termine.mdb enthalten. Web CRM-Programmdateien kopieren Erstellen Sie auf dem Web-Server ein Verzeichnis für das Web CRM (z. B.: C:\Inetpub\WebCRMTest). Kopieren Sie den Inhalt des»web CRM«-Verzeichnisses von der CD in das Verzeichnis hinein. Website anlegen Siehe dazu Seite 11. Datei Web.Config anpassen Passen sie die SQL-Connection-Strings in der Datei Web.Config an Ihren SQL Server an. Dokumentenverwaltung einrichten Kopieren Sie das beiliegende Verzeichnis»DemoDocs«auf Ihren Server. Das Verzeichnis enthält bereits hinterlegte Dokumente passend zu den Demo- Datenbanken. Das ASPNET-Benutzerkonto (bzw. das Benutzerkonto des verwendeten Anwendungspools) braucht Schreib- und Leserechte an dem Verzeichnis, den Unterverzeichnissen und Dateien. Tragen Sie in der Web.Config den Pfad zum Dokumentenverzeichnis und das temporäre Verzeichnis (DemoDocs\TempDocs) ein. Zugriffsrechte vergeben Wie beschrieben. 26

27 Jetzt können Sie starten Öffnen Sie den Browser und geben Sie die Adresse Ihres Web CRM ein, z. B.: (das»webcrm«nach»localhost/«ist der Alias, den Sie beim Anlegen des Webs eingegeben haben). Zugangsdaten der Demo Benutzername: Erwin Schmidt (oder sein Zeichen»es«) Benutzerkennwort: webcrm Systemverwalterkennwort: webcrmadmin Melden Sie sich als Erwin Schmidt an. 27