Installationsanleitung. Diese Anleitung beschreibt die Schritte zur Installation von BlueBridge List2PDF for Microsoft SharePoint.

Transkript

1 Diese Anleitung beschreibt die Schritte zur Installation von BlueBridge List2PDF for Microsoft SharePoint.

2 TABLE OF CONTENTS Installation Vorbereitung der Installation Installationsassistent Lizenzdatei Installation mit STSADM Upgrade Deinstallation mit dem Assistenten mittels Central Administration Aktivierung Hilfe und Support Date: 01/19/ :12:56 Page 2

3 1. BlueBridge List2PDF for Microsoft SharePoint BlueBridge Technologies AG Stockgasse Buttenheim Germany Dieses Dokument beschreibt die Schritte zur Installation von BlueBridge List2PDF for Microsoft SharePoint. Der erste Schritt: Vorbereitung der Installation. Laden Sie diese Anleitung als PDF Dokument herunter: Date: 01/19/ :12:56 Page 3

4 2. Installation Installation BlueBridge List2PDF wird in Form einer SharePoint Solution deployed. In den meisten Fällen empfehlen wir die Benutzung des Installations-Assistents. Sofern sie die Solution manuell installieren möchten, können Sie dies auch per STSADM machen. Date: 01/19/ :12:56 Page 4

5 2.1 Vorbereitung der Installation Vorbereitung der Installation Die Installation erfolgt direkt auf dem Server, auf dem SharePoint betrieben wird. Die Erweiterung ist sowohl auf WSS 2007 als auch auf MOSS 2007 lauffähig. Bitte beachten Sie: BlueBridge List2PDF for Microsoft SharePoint benötigt eine gültige Lizenzdatei, auch wenn sie die Software nur testen. Eine 30 tägige Testlizenz wird bei der Installation automatisch hinzugefügt. Als Erstes sollen Sie eine Kopie der aktuellen Version von unserer Webseite herunterladen. Entpacken sie das Installationspaket (ZIP-File) im Filesystem des SharePoint Servers in einem gesonderten Verzeichnis. Date: 01/19/ :12:56 Page 5

6 Der nächste Schritt: Installationsassistent Date: 01/19/ :12:56 Page 6

7 2.2 Installationsassistent Installationsassistent Vor der Installation: Entpacken Sie das Installationspaket (Zip-Archiv) im Filesystem des SharePoint Servers. Hinweis: Führen Sie die Installation nicht von einem Netzwerklaufwerk (Fileshare) aus. Installation starten Starten Sie die Installation mit setup.exe Bestätigen Sie mit Next: Date: 01/19/ :12:56 Page 7

8 Bestätigen Sie mit Next, wenn alle Prüfpunkte positiv (grün) getestet wurden. Wählen Sie die zu installierenden Solutions aus Date: 01/19/ :12:56 Page 8

9 Erforderliche Komponenten Die Komponenten "BlueBridge.Core" und "BlueBridge.Spex.ListPDF" müssen auf allen Fällen installiert werden. Wenn Sie zum ersten Mal installieren, sollten Sie die Komponente "BlueBridge.Spex.ListPDF.Trial" ebenfalls installieren, die eine 30 tägige Testlizenz zur Installation hinzugefügt. Sollten Sie bereits eine Lizenz erworben haben, können Sie diese weiterhin verwenden und müssen das Trial-Modul nicht installieren. Lizenzvereinbarung Date: 01/19/ :12:56 Page 9

10 Setzen Sie den Haken bei "I accept the terms..." und bestätigen Sie mit Next. Wo die Software installiert werden soll Der Installations-Wizard prüft nun alle verfügbaren Web-Applikationen auf Ihrem Server. Wählen Sie diejenigen aus, für die Sie die Erweiterung installieren möchten. Hinweis: In der Regel haben Sie auf einem SharePoint Server zumindest zwei Web Applikationen (Central Administration und Content). Für die Central Administration ist die Installation von List2PDF generell nicht erforderlich, da diese Site für Administrationsaufgaben zuständig ist. Sollten Sie dennoch auf der Central Administration installieren wollen, muss diese Web Applikation zusätzlich lizenziert werden. Date: 01/19/ :12:56 Page 10

11 Abschluss der Installation Nachdem Sie die relevanten Web Applikationen ausgewählt haben, installiert der Assistent List2PDF auf Ihrem Server. Date: 01/19/ :12:56 Page 11

12 Klicken Sie auf Next. Date: 01/19/ :12:56 Page 12

13 Wenn Sie dieses Dialog sehen, dann ist List2PDF erfolgreich installiert worden. Sie können den Wizard nun schließen. Date: 01/19/ :12:56 Page 13

14 2.3 Lizenzdatei Lizenzdatei Wenn Sie das Modul BlueBridge.Spex.ListPDF.Trial beim Installationsassistent installiert haben, wurde automatisch eine Testlizenz generiert und Sie können sofort mit dem Testen anfangen. In Fällen, wo Sie eine separate Lizenzdatei von uns bekommen haben (zum Beispiel um Ihre Testzeit zu verlängern oder um die Extensions nach dem Kauf freizuschalten), dann sollten Sie diese hierhin kopieren: Program Files\Common Files\Microsoft Shared\web server extensions\12\licenses. Date: 01/19/ :12:56 Page 14

15 2.4 Installation mit STSADM Installation mit STSADM Diese Schritte beschreiben den Prozess, List2PDF über das STSADM Tool zu installieren. In den meisten Fällen ist eine Installation über den Installationsassistenten ausreichend sein und Sie sollten die Installation über STSADM nur versuchen, wenn Sie Erfahrung mit diesem Tool haben. Schritt 1: Installationspaket Im ersten Schritt laden Sie das Installationspaket herunter und entpacken Sie die Dateien in ein leicht zu findendes Verzeichnis auf dem Server wie zum Beispiel c:\install. Dieses Verzeichnis können Sie danach natürlich löschen. Schritt 2: Bereiten Sie sich für STSADM Operationen vor Öffnen Sie die Kommandozeile (CMD) und navigieren Sie zum C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\bin Schritt 3: Solutions hinzufügen Zuerst müssen die Solutions hochgeladen werden. Sie werden noch nicht aktiviert: Date: 01/19/ :12:56 Page 15

16 Führen Sie folgenden Befehl aus: stsadm -o addsolution -filename c:\install\bluebridge.spex.listpdf.wsp Diesen Befehl können Sie jetzt für alle WSP Dateien im Installationspaket wiederholen. Schritt 4: BlueBridge.Core deployen Da dieses Modul zueerst aktiviert werden muss, muss es separat und als Erstes deployed werden. Tippen Sie folgenden Befehl ein: stsadm -o deploysolution -name bluebridge.core.wsp -immediate -allowgacdeployment Schritt 5: Deployment von BlueBridge.Core ausführen Wie oben beschrieben ist dieses Modul erforderlich für die Aktivierung der anderen Module und muss daher zuerst abgeschlossen werden. Geben Sie diesen Befehl ein: stsadm -o execadmsvcjobs Schritt 6: Andere Module deployen Jetzt können Sie die anderen Module deployen. Date: 01/19/ :12:56 Page 16

17 Geben Sie diesen Befehl ein: stsadm -o deploysolution -name bluebridge.spex.listpdf.wsp -immediate -allowgacdeployment -allcontenturls Dies können Sie für die anderen WSPs wiederholen. Schritt 7: Jobs ausführen Alle in Schritt 6 für das Deployment in die Queue gestellten Jobs können Sie jetzt mit dem Befehl stsadm -o execadmsvcjobs ausführen. Schritt 8: Deployment überprüfen Öffnen Sie die SharePoint Zentraladministration und navigieren Sie zum Operations -> Solutions Management. Wenn alle Solutions als globally deployed oder auf einem bestimmten Server deployed gelistet sind, dann ist List2PDF richtig installiert worden. Date: 01/19/ :12:56 Page 17

18 Schritt 9: IISreset In manchen Konfiguration ist danach ein IISreset nötig, um die Installation abzuschließen. Date: 01/19/ :12:56 Page 18

19 3. Upgrade Upgrade Sollten Sie eine ältere Version bereits installiert haben, gibt Ihnen der Installationsassistent einige Optionen. Je nach Konfiguration werden diese Möglichkeiten angezeigt: Install: Die Solution wird installiert (weil sie noch nicht vorhanden ist) Upgrade: Die Solution wird aktualisiert ohne Neuinstallation. Bitte beachten Sie, dass ein IISreset danach erforderlich ist. Repair: Die Solution wird vom Solution Store enfernt (deinstalliert) und dann neu installiert Date: 01/19/ :12:56 Page 19

20 Skip: Die Solution wird bei der Installation übersprungen. Date: 01/19/ :12:56 Page 20

21 4. Deinstallation Deinstallation Während des Installationsvorgangs wurde eine SharePoint Solution installiert. Um diese zu deinstallieren, können sie die Standard-Oberfläche von SharePoint verwenden, oder Sie können die Solutions direkt in der Central Administration entfernen. Bitte beachten Sie, dass BlueBridge.Core auch für andere Lösungen der BlueBridge Technologies AG benötigt wird. Das Entfernen dieses Moduls kann also dazu führen, dass andere Komponente von BlueBridge nicht mehr funktionieren. Sollten Sie alle Module entfernen wollen, sollten Sie diese in folgende Reihenfolge deinstallieren: Zuerst die optionalen Module (den Trial), dann List2PDF selbst und zuletzt BlueBridge.Core. Date: 01/19/ :12:56 Page 21

22 4.1 mit dem Assistenten Deinstallation mit dem Assistenten Um das BlueBridge List2PDF mit dem Assistenten zu entfernen, starten Sie zunächst noch mal "setup.exe". Wählen Sie Uninstall, um die Solutions zu entfernen. Hinweis: Date: 01/19/ :12:56 Page 22

23 Seien Sie vorsichtig, wenn Sie "BlueBridge.Core" deinstallieren, denn dieses Modul wird auch von anderen Solutions der BlueBridge Technologies AG benötigt (nicht nur für List2PDF). Sollten Sie andere Software von BlueBridge im Einsatz haben, z.b. die BlueBridge Wiki Extensions for Microsoft SharePoint, sollten Sie BlueBridge.Core überspringen (Befehl: "Skip"), wenn Sie die anderen Module deinstallieren. Date: 01/19/ :12:56 Page 23

24 4.2 mittels Central Administration Deinstallation per Central Administration Wenn Sie List2PDF mittels Central Administration entfernen möchten, gehen Sie wie folgt vor: Öffnen Sie die SharePoint Central Administration und navigieren Sie auf Solution Management unter dem Bereich Operations. Hier finden Sie alle installierte Solutions. Klicken Sie auf bluebridge.spex.listpdf.wsp. Date: 01/19/ :12:56 Page 24

25 Klicken Sie auf Retract Solution... und dann auf Remove Solution. Date: 01/19/ :12:56 Page 25

26 Bitte beachten Sie, dass BlueBridge.Core auch für andere Solutions der BlueBridge Technologies AG benötigt wird. Das Entfernen dieses Moduls kann also dazu führen, dass andere Programme bzw. Solutions nicht mehr funktionieren. Bitte beachten Sie, dass BlueBridge.Core auch für andere Lösungen der BlueBridge Technologies AG benötigt wird. Das Entfernen dieses Moduls kann also dazu führen, dass andere Komponente von BlueBridge nicht mehr funktionieren. Sollten Sie alle Module entfernen wollen, sollten Sie diese in folgende Reihenfolge deinstallieren: Zuerst die optionalen Module (den Trial), dann das List2PDF selbst und zuletzt BlueBridge.Core. Date: 01/19/ :12:56 Page 26

27 5. Aktivierung Aktivierung von BlueBridge List2PDF Um List2PDF benutzen zu können, müssen Sie dies zuerst auf den relevanten SharePoint Sites aktivieren. Klicken Sie auf Websiteaktionen und dann Websiteeinstellungen. Wählen Sie zunächst Websitefeatures aus. Nun können Sie das Feature BlueBridge List2PDF aktivieren. Date: 01/19/ :12:56 Page 27

28 Date: 01/19/ :12:56 Page 28

29 6. Hilfe und Support Hilfe und Support Sie haben BlueBridge List2PDF for Microsoft SharePoint nun erfolgreich installiert. Für mehr Informationen darüber, wie Sie diese Software in Ihrer Organisation benutzt werden können, lesen Sie bitte unser Benutzerhandbuch. Für Fragen und Anregungen steht Ihnen unser Team jederzeit gerne zur Verfügung: Besuchen Sie auch unser Homepage: Date: 01/19/ :12:56 Page 29