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 installiert ist. Handelt es sich um ein deutsches Setup, so müssen Sie als Anwender nicht eingreifen. Handelt es sich um ein englisches Setup, muss die Datei „SysCommands.xml“ gelö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 Serververzeichnis.

<?xml version= "1.0" standalone="yes"?>
<SvrConfig.xml>
   <SvrSettings>
      <VERSION>4</VERSION>
      <DATAPROVIDER>SQL</DATAPROVIDER>
      <CONNECTIONSTRING>Server=localhost;Initial Catalog=COP_BIKE;Integrated Security=SSPI;pooling=false</CONNECTIONSTRING>
      <DATABASENAME>COP_BIKE</DATABASENAME>
      <LANGUAGE>DEFAULT</LANGUAGE>
      <PORTNUMBER>8963</PORTNUMBER>
      <OLAPSERVER>localhost</OLAPSERVER>
      <OLAPDB>COP_OLAP</OLAPDB>
      <OLAPCONNECTIONSTRING>Provider=SQLOLEDB.1;Persist Security Info=False;user id=sa;password=;Initial Catalog=COP_BIKE;Data Source=localhost</OLAPCONNECTIONSTRING>
      <OLAPAUTOPROCESS>NEIN</OLAPAUTOPROCESS>
      <WJ_VERSETZUNG>0</WJ_VERSETZUNG>
      <TcpFormatter>Bin</TcpFormatter>
      <Backuppath>C:\</Backuppath>
   </SvrSettings>
</SvrConfig.xml>

Folgende Punkte müssen definiert werden:

Eintrag	Beschreibung
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. Wird ClientBasedOlap verwendet (siehe Copservice.exe.config bzw. Copserver.exe.config) muss der Name des Server bzw. die IP Adresse angegeben werden. Folgende Namen sind nicht zulässig: localhost, ., 127.0.0.1 und local.
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 Auswahl zwischen „Bin“ für binäre Übertragung und „Text“ für Textübertragung. Der gewählte Modus muss sowohl am Server als auch am Client („ClientConfig.xml“) eingestellt 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 angegebene 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

<?xml version= "1.0?>
<configuration>
   <startup>
   </startup>
   <appSettings>
      <add key="TCP_DEBUG_PORT" value="6900"></add>
      <add key="EXPATH" value="C:\temp"></add>
      <add key="DbCon_Stage" value="Server=copserver;Initial Catalog=COP_STAGE;Integrated Security=SSPI"></add>
      <add key="DbCon_Vorsystem" value="Server=erpserver;Initial Catalog=ERP;user id=sa;password=;"></add>
   </appSettings>
</configuration>

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:

Eintrag	Beschreibung
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=""></add>

Weitere Variablen:
Variablen können zum Beispiel bei Importen benutzt werden. Importobjekte benötigen einen Connectionstring, um zB. eine Verbindung zu einer Vorsystemdatenbank aufbauen 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 erkennt.

<add key="DbCon_Variablenname" value="Wert bzw. Eintrag, den die Variable haben soll"></add>

Eintrag	Beschreibung
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 eigentlichen Tabellen jene Einträge gespeichert, die mittels „Englischem Client Logon“ erfasst werden. Einträge bspw. in deutsch werden in den ML Systemtabellen gespeichert. Alle verfügbaren Sprachen sind in der Dokumentation zur ML Routine ersichtlich. 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.
MultiThreadCommand	Mit dieser Option wird der parallele Zugriff von Clients aktiviert. Matrix Builder/Excel Client Anfragen, Stammdaten (Dimensionen), AggMasken Refresh/Laden der Definition und sämtliche Commands für Login werden parallel zu anderen am Server abgearbeitet. Beispiel: <add key="MultiThreadCommand" value="true"></add>
GCCollectAfterClientDataCommand	Nach jedem ClientDataCommand wird der GarbageCollector angewiesen, nicht verwendeten Speicher freizugeben. Diese Option sollte nur bei x86 Systemen aktiviert werden, bei x64 Umgebungen kann die Performance verschlechtert werden. Beispiel: <add key="GCCollectAfterClientDataCommand" value="true"></add>
ProActiveCaching	Bei CoPlanner Würfeln wird ein Tupel Caching aktiviert. Dies hat zur Folge, das mehrmals verwendete Zwischenergebnisse zwischengespeichert werden und somit eine Performanceverbesserung erreicht wird. Beispiel: <add key="ProActiveCaching" value="true"></add>
EmptyCellsClientGenerated	Leerzellen werden nicht vom Server, sonder vom Client generiert. Dies hat bessere Serverantwortzeiten zur Folge bei dünn besiedelten Matrizen. Beispiel: <add key="EmptyCellsClientGenerated" value="true"></add>
SSPIServicePrincipalName	Service Principal Name: Kann per default leer bleiben. Wird nur bei SSPI in Verbindung mit Double Hop benötigt Bspw.: "cop/mycomputer.mydomain.com" Beispiel: <add key="SSPIServicePrincipalName" value="cop/mycomputer.mydomain.com"></add>
IsAliveClientTypes	Client Typen die hier eingetragen werden senden periodisch AliveCommands an den Server um diesen mitzuteilen, dass die Session noch aktiv ist. Wird über einen längeren Zeitraum kein AliveCommand vom Client an den Server gesendet, wird die Session deaktiviert. Folgende Client Typen sind zulässig: Excel, Windows, CubeWare, Web. Beispiel: <add key="IsAliveClientTypes" value="Excel|Windows"></add>
OptimizeForCPUCount	Durch diese Eigenschaft kann gesteuert werden, wie viele gleichzeitige Client Anfragen der CoPlanner Server parallel abarbeiten soll. Per Default werden alle CPUs des Rechners ausgelastet. Beispiel: <add key="OptimizeForCPUCount" value="4"></add>
NTLogonTypes	Die bei dieser Eigenschaft aufgelisteten NT Logon Typen werden bei der NT Authentifizierung durch einen Client verwendet. Ist die Eigenschaft nicht in der Configdatei vorhanden, werden alle drei verwendet. Folgende Typen stehen zur Verfügung: INTERACTIVE, NETWORK, BATCH Beispiel: <add key="NTLogonTypes" value="INTERACTIVE|NETWORK"></add>
ServerLogPath	Verfügbar ab CoPlanner Server 9.1, Hotfix 2.1 Ist der Eintrag nicht vorhanden bzw. die Value leer, wird das Serververzeichnis für die Ablage der Datei "Serverlog.txt" verwendet. Ist ein gültiges Verzeichnis eingetragen, wird in dem definierten Verzeichnis die Datei "Serverlog.txt" abgelegt. Ist der Pfad ungültig, wird dies am Server beim Start ausgegeben, das Schreiben in die Log Datei wird deaktiviert. Lautet der Wert der Value "NoLog", wird das Schreiben bzw. Erstellen der Log-Datei ebenfalls deaktiviert. Beispiel: <add key="ServerLogPath" value=""></add> Möglich Einträge: Kein Eintrag <add key="ServerLogPath" value=""></add> Gültiges Verzeichnis <add key="ServerLogPath" value="C:\temp\logs"></add> Es wird keine Log-Datei ausgegeben <add key="ServerLogPath" value="NoLog"></add>

CopServiceInstall.bat

Um den CoPlanner als Dienst zu installieren, müssen Sie nur diese Datei starten. Sie befindet 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 denselben 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 vergeben 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“

<?xml version= "1.0?>
<configuration>
   <startup>
   </startup>
   <appSettings>
      <add key="TCP_DEBUG_PORT" value="6900"></add>
      <add key="EXPATH" value="C:\Programme\coplanner\server1"></add>
      <add key="SERVICE_NAME" value="copService_bike1"></add>
      <add key="DbCon_Stage" value="Server=copserver;Initial Catalog=COP_STAGE;Integrated Security=SSPI"></add>
      <add key="DbCon_Vorsystem" value="Server=erpserver;Initial Catalog=ERP;user id=sa;password=;"></add>
   </appSettings>
</configuration>

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

<?xml version= "1.0?>
<configuration>
   <startup>
   </startup>
   <appSettings>
      <add key="TCP_DEBUG_PORT" value="6901"></add>
      <add key="EXPATH" value="C:\Programme\coplanner\server2"></add>
      <add key="SERVICE_NAME" value="copService_bike2"></add>
      <add key="DbCon_Stage" value="Server=copserver;Initial Catalog=COP_STAGE;Integrated Security=SSPI"></add>
      <add key="DbCon_Vorsystem" value="Server=erpserver;Initial Catalog=ERP;user id=sa;password=;"></add>
   </appSettings>
</configuration>

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

<?xml version= "1.0?>
<configuration>
   <startup>
   </startup>
   <appSettings>
      <add key="TCP_DEBUG_PORT" value="6900"></add>
      <add key="EXPATH" value="C:\temp"></add>
      <add key="DbCon_Stage" value="Server=copserver;Initial Catalog=COP_STAGE;Integrated Security=SSPI"></add>
      <add key="DbCon_Vorsystem" value="Server=erpserver;Initial Catalog=ERP;user id=sa;password=;"></add>
   </appSettings>
</configuration>

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ügbaren 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 erscheint. 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 folgende 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 auftreten bzw. können bei portierten Datenbanken die neuen Features eingeschränkt bis gar nicht verwendet werden. Hier empfehlen wir einen Neuaufbau der Datenbank.