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
CoPlanner Software
Die CoPlanner Software befindet sich in einer gezippten Datei. Der Name setzt sich hier immer aus der Version, dem Hotfix und dem Releasedatum zusammen. z.B. 9.5.1019.0 HF3.3 20190211.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
Das CoPlanner Modell setzt sich aus einer Datenbank und den folgenden Ordnern zusammen:
- Aggmasken (Definitionen des Typs Aggmasken)
- Analyze Objects (Definitionen der CoPlanner Würfel)
- Berichte (altes PDF-Reporting in der Objektverwaltung)
- 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.
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=meinsqlserver;Initial Catalog=COP_meinFirmenname;Integrated Security=SSPI;pooling=false | ||||||||||
| PortNumber | Freigegebene und nicht verwendete Portnummer für die Kommunikation des CoPlanner-Servers mit den CoPlanner-Clients. | 8963 | ||||||||||
| 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 | ||||||||||
| SSPIPort | Port bzw. Portrange für die SSPI-Login Kommunikation zwischen CoPlanner Client und CoPlanner Server. Darf von der Firewall nicht geblockt werden. | 11000-11100 | ||||||||||
| ServerLogPath | Pfad und Verzeichnis um Logfiles zu speichern. Ist der Eintrag nicht vorhanden bzw. die Value leer, wird das CoPlanner Serververzeichnis für die Ablage der Logfiles verwendet. Ist ein gültiges Verzeichnis eingetragen, erfolgt die Anlage der Dateien in dem definierten Verzeichnis. Ist der Pfad ungültig, wird dies am Server beim Start ausgegeben, das Schreiben in die Log Datei wird deaktiviert. Lautet der Eintrag "NoLog", wird das Schreiben bzw. Erstellen der Log-Datei ebenfalls deaktiviert. Der User unter dem der CoPlanner Dienst läuft muss entsprechende Schreiberechte besitzen. |
D:\meinCoPlannerVerzeichnis\Server\Logs | ||||||||||
| MaxSvrLogFileSize | Die maximiale Größe welche die Serverlog-Files erreichen können. Wird diese Größe überschritten, wird diese Datei komprimiert und in ein Archiv-Verzeichnis verschoben. Null bedeutet keine Komprimierung. Die Konfiguration erfolgt in KB. | 10000 |
WebConfig
Folgende Punkte müssen im Bereich WebConfig definiert werden:
| Eintrag | Beschreibung | Beispiel |
| WebAppUrl | Definiert die Basis-URL unter welcher der interne Webserver verfügbar ist, über den die REST-API und einige Features angesprochen werden. Wenn Sie die REST Funktionalitäten nicht nutzen wollen, kann der Eintrag einfach leer gelassen werden.
Bei Verwendung müssen die Schritte, welche unter Voraussetzungen für die Verwendung der REST-Funktionalitäten angeführt sind, ausgeführt werden. |
https://+:4443/coplanner |
| ReportServerUrl | URL über die mit dem Repotserver kommuniziert werden kann. Nur notwendig, wenn das Webreporting im Einsatz ist. | 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 | https://+:4444/coplanner/reporting |
| CopServerServiceName | Name, unter welchem das CoPlanner Service läuft (siehe Eintrag ServiceName in der svrconfig im Server) | CopService |
| ReportServerServiceName | Name, unter welchem das ReportServer Service angelegt werden soll. | CopReportingService |
| ReportServerLogPath | Ist kein Pfad angegeben, so wird das Logfile unter dem angegebenen Namen angelegt. Es kann hier auch vorne noch ein Pfad hinzugefügt werden. | CopReportServer.log |
ClientConfig
| Eintrag | Beschreibung | Beispiel |
| Server | Servername oder IP-Adresse des Systems, auf dem der CoPlanner Server bzw. Service läuft | myservername |
| Port | Port unter dem der CoPlanner Server bzw. Service läuft (siehe Eintrag PortNumber in der svrconfig im Server) | 8963 |
SessionSettings
| Eintrag | Beschreibung | Beispiel |
| User | Der hier angegebene User muss in der CoPlanner Benutzerverwaltung angelegt werden und Rechte auf dem bei Entity angegebenen Unternehmen haben und auf dem angegebenen Plan. | myReportserverUser |
| Password | Passwort zum verwendeten Benutzer. Ist der Benutzer, unter welchem der CoPlanner Reportserver ausgeführt wird in der Benutzerverwaltung vorhanden, so kann hier auch SSPI angegeben werden um sich mit SSPI zu identifizieren. | myPassword |
| Entity | Name des Unternehmens, über das eine Verbindung zum CoPlanner Server hergestellt wird. | Unternehmen |
| Plan | Name des Plans, über das eine Verbindung zum CoPlanner Server hergestellt wird. | Budget 2019 |
Clients
ClientConfig
| Eintrag | Beschreibung | Beispiel |
| Server | Servername oder IP-Adresse des Systems, auf dem der CoPlanner Server bzw. Service läuft | myservername |
| Port | Port unter dem der CoPlanner Server bzw. Service läuft (siehe Eintrag PortNumber in der svrconfig im Server) | 8963 |
