Technik:CoPlanner-Server

Der Ordner CoPlanner-Server muss auf jenem Rechner vorhanden sein, welcher als Server fungieren soll. Dieser enthält einige Konfigurationsdateien, welche Variablen, die Verbindung zu Clients, uvm. definieren. Diese müssen sorgfältig konfiguriert werden.

SysCommands.xml

Diese Datei ist im Serververzeichnis zu finden. Sie beinhaltet Informationen für CoPlanner Systemeinstellungen. Zu beachten ist hierbei nur, in welcher Sprache der SQL-Server instal-liert ist. Handelt es sich um ein deutsches Setup, so müssen Sie als Anwender nicht ein-greifen. Handelt es sich um ein englisches Setup, muss die Datei SysCommands.xml ge-löscht oder umbenannt und danach die Datei SysCommands_EnSql.xml, welche ebenfalls im Serververzeichnis liegt, in SysCommands.xml umbenannt werden.

SvrConfig.xml

Diese Datei definiert Eigenschafen des CoPlanner-Servers. Sie befindet sich im Serverver-zeichnis.

Datei:T Codesnip.jpg

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!!!

DATABASENAME

• Name der SQL-Datenbank

PORTNUMBER

• Freigegebene und nicht verwendete Portnummer für die Kommunikation des CoPlanner-Servers mit den CoPlanner-Clients.

OLAPSERVER

• Name des Servers, auf dem sich die OLAP-Datenbank befindet

OLAPDB

• Name der OLAP-Datenbank

OLAPAUTOPROCESS

• Soll die OLAP-Datenbank automatisch vom CoPlanner-Server aus aufbereitet werden, wenn sich die SQL-Datenbank verändert hat.

Zulässige Einträge:

JA

NEIN

OLAPCONNECTIONSTRING

• Provider

Datenquellentreiber, der verwendet werden soll (Standardeintrag: SQLOLEDB.1)

• User ID

User ID für Login der Datenquelle (siehe oben)

• Initial Catalog

Datenbankname der Datenquelle

• Data Source

Server, auf dem sich die Datenquelle befindet

WJ_VERSETZUNG

• Legt die Versetzung des Wirtschaftsjahres des Unternehmens zum Kalenderjahr fest. Dabei wird ausgehend vom Monat Jänner gerechnet.

0 bedeutet: keine Wirtschaftsjahrversetzung -1 bedeutet: Anfang des Wirtschaftsjahres im Dezember des Vorjahres 1 bedeutet: Anfang des Wirtschaftsjahres im Februar desselben Jahres

TcpFormatter

• Legt den Übertragungsmodus zwischen Client und Server fest. Möglich ist die Aus-wahl zwischen „Bin“ für binäre Übertragung und „Text“ für Textübertragung. Der ge-wählte Modus muss sowohl am Server als auch am Client (ClientConfig.xml) einge-stellt werden und übereinstimmen.

Backuppath

• Legt den temporären Speicherplatz für ein Datenbankbackup, welches durch einen Client veranlasst werden kann, fest. Der SQL-Server muss Schreibrechte auf das an-gegebene Verzeichnis haben. Es darf kein Netzlaufwerk sein, sondern auf ein lokales Volume des SQL-Servers verweisen.

BackuppathFromCopServer

• Für den Fall, dass der SQL-Server und Cop-Server auf unterschiedlichen Maschinen laufen, muss hier ein Pfad angegeben werden, durch welchen (mit Schreibrechten!) der Cop-Server auf das in Backuppath definierte Laufwerk des SQL-Servers Zugriff hat. Wird dieser Parameter nicht definiert, so wird wie bisher Backuppath verwendet.

Beispiel: Backuppath lautet „c:\copSqlBkups“. BackuppathFromCopServer lautet für den Fall, dass der SQl-Server auf einem Rechner namens „TSCOP001“ läuft „\\tscop001\c$\copSqlBkups“ wobei der Benutzer, unter welchem der COP-Server lauft, Schreibrechte auf c$ des Servers TSCOP001 haben muss.

CoPlanner-Server als Dienst

Es ist möglich, den CoPlanner-Server als Dienst zu installieren. Wichtig hierbei ist, dass der CoPlanner Server als Dienst NICHT mit dem „lokalen Systemkonto“ betrieben wird. Als Account muss ein NT-User verwendet werden, um eine korrekte Abarbeitung bei OLAP-Ab-fragen gewährleisten zu können. Dabei sind folgende Punkte zu beachten:

CopService.exe.config

Datei:T Codesnip1.jpg

Diese Datei enthält Informationen, die beim Starten des Dienstes vom CoPlanner-Server eingelesen werden. Sie befindet sich im Serververzeichnis. Zwei Einträge, die standardmä¬ßig in der Datei enthalten sind, sind:

TCP_DEBUG_PORT Es ist möglich, mittels Telnet ein Sichtfenster zum CoPlanner-Server 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.

EXPATH Dieser Eintrag gibt an, welches Verzeichnis das Basisverzeichnis des Servers ist. In obigem Beispiel ist dieses Verzeichnis C:\temp. In diesem MÜSSEN folgende Dateien bzw. Ordner enthalten sein:

• Ordner Berichte (mit Inhalt)
• Ordner Report (mit Inhalt)
• Ordner Transfer (mit Inhalt)
• Ordner ReportTemplates (mit Inhalt)
• Datei SvrConfig.xml
• Datei SysCommands.xml

Diese Dateien finden Sie im CoPlanner-Server-Ausführungsverzeichnis. Um gleich das CoPlanner-Ausführungsverzeichnis zu verwenden (empfohlen), lassen Sie den Eintrag wie in unten angeführtem Beispiel leer: <add key=“EXPATH“ value=““ />

Weitere Variablen: Variablen können zum Beispiel bei Importen benutzt werden. Importobjekte benötigen einen Connectionstring, um zB. eine Verbindung zu einer Vorsystemdatenbank auf-bauen zu können. Um nun mit einem Eintrag mehrere Objekte gleichzeitig ändern zu können wird empfohlen, solche Connectionstrings als Variablen zu definieren, um Änderungen schneller vollziehen zu können. Eine Variable MUSS mit DbCon_ beginnen damit der CoPlanner sie als solche er-kennt. <add key=“DbCon_Variablenname“ value=“Wert bzw. Eintrag, den die Variable haben soll“ />

ENTITY_SECURITY Durch diesen Eintrag kann man die Unternehmenssecurity deaktivieren. Ist dieser gar nicht vorhanden oder in folgender Form: <add key="ENTITY_SECURITY" value="TRUE"></add>, ist die Unternehmenssecurity aktiv. Deaktiviert wird diese wie folgt: <add key="ENTITY_SECURITY" value="FALSE"></add>

OlapSecurity Ist dieser Eintrag auf true, ist die OlapSecurity aktiviert, ist der Eintrag auf false, ist diese inaktiv. Ist der Eintrag nicht im Config File vorhanden, ist die Security per default aktiv.

OlapLoadMeasureFormatAndType Ist dieser Eintrag auf true, werden Measureformat und Typ vom Olap Server pro Measure geladen. Bei false werden Measures immer als Text geladen und die Formatted Value verwendet (Achtung bei Culturevermischungen) (ab SSAS 2005).

OlapUseMultipleHierarchies Ist dieser Eintrag auf true, werden Alternativhierarchien von Olap Dimensionen geladen und können verwendet werden (ab SSAS 2005).

OlapReplaceNullValues Ist dieser Eintrag auf true, werden Null Values vom Connector mit 0 ersetzt.

OlapMultiSelectFilterActive Ist dieser Eintrag auf true, werden Dimensionen die als Filter verwendet werden mit Mehrfachauswahl (Multiselect) unterstützt.

OlapXmlaLoadActive Ist dieser Eintrag auf true, werden Strukturdaten mittels XMLA geladen enormer Performancegewinn!!!

OlapClientBasedLoad Ist dies auf true, werden die Daten vom Client selbst geladen. Dies ermöglicht eine parallele Abarbeitung von Anfragen Performancegewinn bei Mehrfachzugriff

Hinweis  Die benötigten Komponenten des Servers (ADOMD, XmlParser), müssen am CLIENT installiert werden!!! Des Weiteren darf als OlapServer im SvrConfig.xml nicht „localhost“ eingetragen werden, sondern der Name oder die IP des entsprechenden Servers!!!

LoadConnectorsOnStartUp Durch diese Option kann angegeben werden, ob die Connectoren (c3, combined, …) gleich beim Serverstart geladen werden sollen. Dies ist bei keiner Olap Verwendung empfehlenswert, da der erste Benutzer nicht die Ladezeit abwarten muss. Ist LoadConnectorsOnStartUp auf true und OlapSec auf false, würden die Olap-Stammdaten nie neu geladen werden. Hierfür wurde ein Serverbefehl implementiert: OBJ_OBV_RELOAD_CONNECTORS Dieser erzwingt einen Neuaufbau aller Connectoren. Verfügbar ist der Aufruf über Makro => NavAction => ServerCommand => OBJ_OBV_RELOAD_CONNECTORS.

EventLogEntryLevel Steuert, welche Einträge ins Ereignisprotokoll geschrieben werden, unterschieden kann nach Schweregrad des Fehlers <add key="EventLogEntryLevel" value="Warning"></add> --> Warnings und Fehler (Rote und Gelbe Cop-Würfel) <add key="EventLogEntryLevel" value="Error"></add> --> Nur Fehler (Rote Würfel) <add key="EventLogEntryLevel" value="None"></add> --> Gar keine Einträge

DefaultLanguage Die Defaultsprach des Servers ist damit einstellbar (ML Routine CoPlanner). Per Default ist germand Standard, wird bspw. english verwendet, werden in den eigentli-chen Tabellen jene Einträge gespeichert, die mittels „Englischem Client Logon“ er¬fasst werden. Einträge bspw. in deutsch werden in den ML Systemtabellen gespei¬chert. Alle verfügbaren Sprachen sind in der Dokumentation zur ML Routine ersich¬tlich. Beispiel: <add key="DefaultLanguage" value="german"></add>

ClientConnectionTimeOut Nach Ablauf wird die Client-Session am Server gelöscht. Angabe in Minuten. Default-Wert 1.440 Minuten.

RSMode Mit dieser Option wird der parallele Zugriff von Clients aktiviert. Matrix Builder/Excel Client Anfragen, Stammdaten (Dimensionen), AggMasken Refresh/Laden der Defini-tion und sämtliche Commands für Login werden parallel zu anderen am Server ab-gearbeitet. <add key="RSMode" value=""></add>

GCCollectAfterClientDataCommand Nach jedem ClientDataCommand wird der GarbageCollector angewiesen, nicht ver-wendeten Speicher freizugeben. Beispiel: <add key="GCCOLLECTAFTERCLIENTCOMMAND" value="true"></add>

CopServiceInstall.bat

Um den CoPlanner als Dienst zu installieren, müssen Sie nur diese Datei starten. Sie befin¬det sich im Serververzeichnis des CoPlanner. Ein Konsolenfenster erscheint und informiert über den Status der Installation. Ist bereits ein CoPlanner-Server Dienst installiert, müssen Sie vor der Neuinstallation erst den alten Dienst beenden und deinstallieren. Das Deinstallieren erfolgt durch Starten der Datei CopServiceUnInstall.bat welche sich ebenfalls im Serververzeichnis des CoPlanner befindet. Sollte bei der Installation des Services eine Security Exception auftreten so muss eine Console (cmd.exe) als Administrator (Ausführen als) gestartet werden. Anschließend kann in das Serververzeichnis gewechselt werden und die Datei CopServiceInstall.bat aufgerufen werden.

Mehrere CoPlanner Dienste auf einem Rechner installieren

Auf einem Rechner können auch mehrere CoPlanner Services installiert werden. Dazu sind einige Einstellungen in der Datei „CopService.exe.config“ notwendig. Des Weiteren werden zwei CoPlanner Server Ordner benötigt. Zwei CoPlanner Services dürfen nicht auf densel¬ben Server Ordner verweisen.

Einstellungen in „CopService.exe.config“

In der Datei „CopService.exe.config“ muss für jeden Service ein eigener Name vergeben werden. Dazu kann innerhalb des Tags „<appSettings>“ folgende Zeile hinzugefügt werden: <add key="SERVICE_NAME" value="copService_bike2"></add> Das Item „value“ bezeichnet den Namen des zu erstellenden CopService. Um über Telnet die Debug Meldungen des Servers lesen zu können muss auch der "TCP_DEBUG_PORT" angepasst werden: <add key="TCP_DEBUG_PORT" value="6901"></add> Zusätzlich muss in der Datei „SvrConfig.xml“ für jeden Server eine eigene Potnummer ver-geben werden. Um die Services zu installieren muss anschließend für jeden Service die Datei „CopServiceInstall.bat“ ausgeführt werden.

Beispiel einer Konfiguration:

Die Datei „CopService.exe.config“ befindet sich bspw. im Ordner „C:\Programme\coplanner\server1“

Datei:T Codesnip2.jpg

Die Datei „CopService.exe.config“ für den zweiten CopService befindet sich bspw. im Ord-ner „C:\Programme\coplanner\server2“

Datei:T Codesnip3.jpg

Nach dem Anpassen der Portnummern können die jeweiligen Services mittels der Batch Datei “CopServiceInstall.bat” installiert werden. Unter den Windows Diensten sind nun 2 voneinander unabhängige Dienste vorhanden.

Die Debug Meldungen des Servers können nun über den Konsolenbefehl:

telnet localhost 6900

bzw.

telnet localhost 6901

ausgegeben werden.

CoPlanner-Server als Applikation

Es ist möglich, den CoPlanner-Server als Applikation zu installieren. Dabei sind folgende Punkte zu beachten:

CopServer.exe.config

Datei:T Codesnip5.jpg

Durch die Datei CopServer.exe.config können Einstellungen getroffen werden, welche beim Starten der Applikation eingelesen und entsprechend verarbeitet werden. Für die Verfügba¬ren Optionen siehe CopService.exe.config.

Starten des Servers als Applikation

Durch das Kopieren des Serververzeichnisses auf den Rechner ist die Installation eigentlich beendet. Sie müssen nur noch die Datei CopServer.exe starten. Ein Konsolenfenster er-scheint. Hier können Sie mit verfolgen, welche Operationen der CoPlanner-Server gerade ausführt. Im Zusammenhang mit 64 Bit wird nur der SQL Server bzw. Analysis Server 2005 unterstützt.

CoPlanner Server und 64 Bit Systeme

Es besteht die Möglichkeit, den CoPlanner auf 64 Bit Systemen zu betreiben. Der Vorteil hier sind schnellere Prozessablaufzeiten und vor allem die Möglichkeit, mehr Speicher zu nutzen. Unter 32 Bit stehen einem .Net Prozess bekanntlich nur 1,3 GB zur Verfügung.

Voraussetzungen

Um nun den CoPlanner Server auf einem 64 Bit System betreiben zu können, werden fol-gende Komponenten vorausgesetzt bzw. empfohlen:

• Windows Server 2003 x64 (am Rechner des CoPlanner Servers)
• Net Framework 2.0 x64 (am Rechner des CoPlanner Servers) mit SP1
• XML Parser 4 mit SP2 (Package wie unter 32 Bit) (am Rechner des CoPlanner Servers)
• XML Parser 6 x64 (am Rechner des CoPlanner Servers)
• AdoMD.Net (selbes Package wie unter 32 Bit) (am Rechner des CoPlanner Servers)
• SQL Server 2005 (empfohlen x64) mit SP2
• Analysis Server 2005 (empfohlen x64) mit SP2

Umstellung bestehender Systeme

Soll ein Upgrade von SQL Server 2000 auf 2005 durchgeführt werden, kann die SQL Server Datenbank problemlos auf dem SQL Server 2005 wiederhergestellt werden. Leider ist dies bei DTS Packages (Data Transformation Services) und Analysis Server 2000 Datenbanken (Olap) nicht der Fall. DTS Packages müssen in der neuen Umgebung SQL Server Integration Services (SSIS) neu erstellt werden, da keine Abwärtskompatibilität seitens MS gegeben ist. Analysis Services Datenbanken können portiert werden, jedoch können dabei Fehler auftre-ten bzw. können bei portierten Datenbanken die neuen Features eingeschränkt bis gar nicht verwendet werden. Hier empfehlen wir einen Neuaufbau der Datenbank.