Technik:CoPlanner Installation: Quick Guide

Hier wird die Installation eines CoPlanners in Kurzform beschrieben.

Erstinstallation

Voraussetzungen

In dieser Beschreibung wird vorausgesetzt

• Es gibt einen Server/VM auf die zugegriffen werden kann
• Auf diesem System ist ein SQL Server installiert
• CoPlanner Software und CoPlanner Modell wurde von CoPlanner zur Verfügung gestellt

Benutzer

Es empfiehlt sich für den laufenden CoPlanner Betrieb zumindest zwei Domänenbenutzer anzulegen. Die Namen sind frei wählbar, exemplarisch werden in diesem Dokument folgende Benutzer verwendet:

DOMAIN\COPSERVICE: Das ist der Benutzer unter dem der CoPlanner Dienst am Applikationsserver läuft.

DOMAIN\COPUSER: Dieser Benutzer wird für Fernwartungszugriffe auf den Applikationsserver verwendet. Sollten personengebunden Benutzer angelegt werden, so sind für alle dieselben Berechtigungen zu setzen

CoPlanner Software

Die CoPlanner Software befindet sich in einer gezippten Datei. Der Name setzt sich hier immer aus der Version und dem Hotfix zusammen. z.B. CoP10 HF1.1.zip

• Das noch gezippte Archiv mit Rechtsklick/Eigenschaften -> Unblock entblocken
• Das Verzeichnis entpacken

Es gibt nun eine Verzeichnisstruktur, die folgende Ordner enthält:

• benoetigteKomponenten
• Clients
• Reporting
• ReportServer
• Server
• Tools

In den Ordner Tools gehen und "Rename_Configs.bat" ausführen.

CoPlanner Modell

Ab CoPlanner 11 werden die Modelldaten alle in der Datenbank abgelegt. Damit sind die Ordner, die es in CoP 10 gab nicht mehr relevant, sobald diese über das CoP-Version in die Datenbank übernommen wurden:

• Analyze Objects (Definitionen der CoPlanner Würfel)
• Design (Formatvorlagen)
• DimensionSettings (Einstellungen zu den Dimensionen)
• Jobs (Abos des Abomanagers)
• Transfer (Definitionen der Importe)
• Upload (Dateien welche über Importe importiert werden)

Das Modell wurde ebenfalls über ein .zip File zur Verfügung gestellt. Bitte extrahieren Sie dieses in einem getrennten Ordner.

Datenbank einspielen

Am SQL Server muss die im CoPlanner Modell vorhandene Datenbank eingespielt werden.

Dazu einfach im SQL Server das Backup wiederherstellen (weitere Infos zur Wiederherstellung finden Sie hier).

Auf der Datenbank müssen Rechte für die Benutzer vergeben werden. Nähere Informationen dazu finden Sie hier.

Ordner einspielen

Die oben genannten Ordner müssen in den Ordner Server der Software kopiert werden.

Lizenz

In den Ordner Tools\LicenceKeyGenerator wechseln und die "CopLicenceKeyGenerator91.exe" ausführen.

Dadurch wird im Ordner folgende Datei erstellt: CoPlannerLicKey91.key.

Diese Datei muss der Firma CoPlanner zur Verfügung gestellt werden, damit das Lizenzfile erstellt werden kann.

Die Firma CoPlanner erstellt daraufhin das Licencefile („xxx.lic“). Diese muss im Ordner Server abgelegt werden und die LicenceID (Nummer der Lizenz) in die Datei Technik:CoPlanner-Server#SvrConfig.xml eingetragen werden.

Eine ausführlichere Beschreibung finden Sie hier.

Konfiguration

Server

Wechseln Sie in das Serververzeichnis und öffnen das Konfigurationsprogramm SvrConfig.exe.

Hier werden nur die notwendigsten Konfigurationen erwähnt. Weitere Konfigurationsmöglichkeiten finden Sie hier.

CopSettings

Eintrag	Beschreibung	Beispiel
ConnectionString	Server Name des Servers, auf dem sich die Datenbank befindet Initial Catalog Name der Datenbank User id Name des Benutzers, mit dem sich der CoPlanner-Server am SQL-Server anmeldet (standardmäßig sollte bereits die ID „sa“ existieren). Alternativ kann bzw. muss ein User mit entsprechenden Rechten am SQL-Server angelegt werden. Password Passwort des Benutzers Pooling Damit Restore Database (fix integriert im Entwicklermenü) funktioniert, muss im Connectionstring Pooling = false vorhanden sein!	Server=meinsqlserver;Initial Catalog=COP_meinFirmenname;Integrated Security=SSPI;pooling=false
ServiceName	Name des CopService	copService
TelnetDebugPort	Es ist möglich, mittels Telnet ein Sichtfenster zum CoPlanner-Service aufzubauen. Dieser Eintrag legt die Portnummer für die Telnetverbindung fest. Die Verbindung erfolgt durch die DOS-Eingabeaufforderung (Start Ausführen cmd). Zum Aufruf der Verbindung geben Sie: telnet rechnername portnummer (Bsp: telnet hostname 6900) ein und drücken auf Return.	6900
LicenceID	Wird zwingend für den Start des CoPlanner Servers benötigt. Siehe Abschnitt Lizenz.	1234

WebConfig

Folgende Punkte müssen im Bereich WebConfig definiert werden:

Eintrag	Beschreibung	Beispiel
WebAppUrl	Zwingend erforderlich ab CoP 10 HF 1.2: Definiert die Basis-URL unter welcher der interne Webserver verfügbar ist, über welchen die komplette Kommunikation erfolgt. Achtung!  Für die Verwendung von https muss ein Zertifikat zur Verfügung stehen.	https://+:4443/coplanner
ReportServerUrl	URL über die mit dem Repotserver kommuniziert werden kann. Nur notwendig, wenn das Webreporting im Einsatz ist. Die URL muss der reportServerUrl im Programm ReportSvrConfig.exe (s.u.) entsprechen. Achtung!  Das + in der URL muss hier durch den Servernamen oder die IP-Adresse ersetzt werden. Im Fall der Verwendung von https mit dem alternativen Antragstellernamen aus dem Zertifikat. Achtung!  Für die Verwendung von https muss ein Zertifikat zur Verfügung stehen.	https://myserver.com:4444/coplanner/reporting

ReportServer

Wechseln Sie in das ReportServer-Verzeichnis und öffnen das Konfigurationsprogramm ReportSvrConfig.exe.

HTTPsREST

Eintrag	Beschreibung	Beispiel
reportServerUrl	URL über welche der Reportserver kommuniziert Achtung!  Für die Verwendung von https muss ein Zertifikat zur Verfügung stehen.	https://+:4444/coplanner/reporting
CopServerServiceName	Name, unter welchem das CoPlanner Service läuft (siehe Eintrag ServiceName in der svrconfig im Server). Dient nur dazu, um bei der Service-Installation dann eine Abhängigkeit auf das CoPlanner Service zu setzen. Soll es keine Abhängigkeit geben, kann der Eintrag einfach leer gelassen werden.	CopService
ReportServerServiceName	Name, unter welchem das ReportServer Service angelegt werden soll.	CopReportingService
EventsUrl	Hier muss die ReportServerUrl, wobei das + mit dem entsprechenden Namen oder IP-Adresse ersetzt sein muss, erweitert mit api/v1.0/events stehen
CopServerUrl	URL über die mit dem CoPlanner Server/Service kommuniziert werden kann.
MaxRows	Dies ist die Anzahl der Datensätze, die maximal vom CoPlanner Server empfangen werden kann. Diese sollte in Relation zur Leistung des Client-Rechners stehen. Wird beim Laden von Datensätzen in einer Matrixmaske die hier festgelegte maximale Datensatzanzahl überschritten, wird der Ladevorgang unterbrochen und eine Meldung ausgegeben, die auffordert, die Datenmenge mittels Filtern entsprechend einzuschränken.
MaxCells	Gibt an, wie viele Zellen (Produkt der Achsendimensionselemente) maximal vom CoPlanner Server geladen werden. Ist dieser Tag nicht vorhanden, oder wird 0 eingetragen, erfolgt keine Einschränkung.

Clients

Windows

Gehen Sie in das Verzeichnis Clients\Windows. Öffnen Sie dort die ClientConfig.xml in einem Texteditor.

ClientConfig

Eintrag	Beschreibung	Beispiel
Serverurl	URL unter der der CoPlanner Server erreichbar ist	https://meinzugriffsname:4443/coplanner

Weitere Konfigurationsmöglichkeiten finden Sie hier.

Installieren der Services

CoPlanner Service

• Aufruf der SvrConfig.exe im Serverordner
• Button 'Install Service' links unten klicken
• Eingeben des Benutzers, unter dem das Service laufen soll (z.B. DOMAIN\COPSERVICE)

Das Service wurde damit erstellt.

CoPlanner Reporting Service

• Aufruf der ReportSvrConfig.exe im ReportServer-Ordner
• Button 'Install Service' links unten klicken
• Eingeben des Benutzers, unter dem das Service laufen soll (z.B. DOMAIN\COPSERVICE)

Das Service wurde damit erstellt.

Überprüfung der Installation

• Starten Sie das CoPlanner Service über die Dienste und starten Sie das Telnet mit dem TelnetDebugPort, den Sie in der SvrConfig angegeben haben.
• Warten Sie bis der Server hochgefahren ist. Das erkennen Sie an den Ausgaben 'Server started successfully!' und 'Http Server listening on https://+:4443/coplanner'

Erhalten Sie diese Meldungen nicht, stimmt etwas an der Serverkonfiguration nicht und Sie sollten dann entsprechende Fehlermeldungen erhalten

• Wechseln Sie in das Client\Windows-Verzeichnis und starten Sie die coplanner.exe

Sie sollten hier ein Anmeldefenster bekommen. Erhalten Sie kein Anmeldefenster prüfen Sie bitte die ClientConfig.xml in diesem Verzeichnis, ob die Portnummer und der Servername stimmen.

• Starten Sie das CoPlannerReportServer-Service über die Dienste

Prüfen Sie im Logfile, ob Sie die Meldung 'Verbindung zum CoPlanner Server hergestellt' erhalten. Sofern Sie diese Meldung nicht erhalten, gibt es ein Problem mit der Konfiguration und Sie sollten eine entsprechende Meldung sehen.