Technics:CoPlanner-Server: Difference between revisions

From CoPlanner 11
Jump to navigationJump to search
← Older editNewer edit →
VisualWikitext
No edit summary
No edit summary
Line 168: Line 168:
|-
|-
|style="color:#3a3aff;"|OptimizeForCPUCount
|style="color:#3a3aff;"|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.
|this option defines the number of simultaneous client requests. On default all CUPs will be used.
|-
|-
|style="color:#3a3aff;"|ProActiveCaching
|style="color:#3a3aff;"|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.
|with this option the "Tupel Caching" of CoPlanner cubes can be activated. This means, that interim results will be chashed.
|-
|-
|style="color:#3a3aff;"|SkipImportHistory
|style="color:#3a3aff;"|SkipImportHistory
|Ist dieser Eintrag auf true, Fehlermeldungen beim Datenimport werden nicht in die History-Tabelle geschrieben.
|is this inscription on true, error messages will not be written to the histroy table.
|-
|-
|style="color:#3a3aff;"|NTLogonTypes
|style="color:#3a3aff;"|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
|All listed NT logon types will be used in case of NT authentication. On default all tree types will be used. Following types are available: INTERACTIVE, NETWORK, BATCH
|-
|-
|style="color:#3a3aff;"|CopSysIDStartOffset
|style="color:#3a3aff;"|CopSysIDStartOffset
|Die erste vom System vergebene CopSysID wird um diesen Offset erhöht. Werden mehrere Modell mit unterschiedlichen CopServices verwendet, werden so doppelte CopSysIDs vermieden.
|this offset will be added to the first created CopSysID. If there are several models in use, you avoid double CopSysIDs.
|-
|-
|style="color:#3a3aff;"|DynamicMode
|style="color:#3a3aff;"|DynamicMode
|Dynamisches Nachladen für das Modell aktivieren.
|activate dynamic reload.
|-
|-
|style="color:#3a3aff;"|MaxRows
|style="color:#3a3aff;"|MaxRows
|Dies ist die Anzahl der Datensätze, die maximal vom CoPlanner Server an den Client gesendet werden.
|maximum number of datasets send to the client.
|-
|-
|style="color:#3a3aff;"|MaxSvrLogFileSize
|style="color:#3a3aff;"|MaxSvrLogFileSize
|Die maximiale Größe welche die Server.txt erreichen kann. Wird diese Größe überschritten, wird diese Datei komprimiert und in ein Archiv-Verzeichnis verschoben. Null bedeutet keine Komprimierung.
|maximum size of server.txt. If the file will be greater it will be compressed and moved to a defined folder (archiv). Zero means no compression.
|}
|}




'''Folgende Punkte müssen im Bereich SSASSettings definiert werden:'''
'''The following points have to be defined in the area SSASSettings:'''


{| class="wikitable" width={{{breite|100%}}}
{| class="wikitable" width={{{breite|100%}}}

Revision as of 12:46, 17 December 2012

The folder CoPlanner Server has to exist on that computer, which should act as Server. It contains some configuration files, which define variables, connection to clients etc. These have to be configured accurately

SysCommands.xml

You find this file in the Server-Directory. It contains information for system settings of CoPlanner. Please note in which language the SQL-Server is installed. If Setup is in German, the user does not have to intervene. If Setup, however, is in English, file „SysCommands.xml“ has to be deleted or it has to be renamed and after that file „SysCommands_EnSql.xml“ has to be renamed, which is in the Server-Directory as well.

SvrConfig.xml

This file defines features of CoPlanner Server. It is located in the Server-Directory. 

<?xml version= "1.0" standalone="yes"?>
<SvrConfig.xml>
   <CopSettings>
      <Version>4</Version>
      <ConnectionString>Server=localhost;Initial Catalog=COP_BIKE;Integrated Security=SSPI;pooling=false</ConnectionString>
      <DataBaseName>COP_BIKE</DataBaseName>
      <PortNumber>8963</PortNumber>
      <FiscalYear>0</FiscalYear>
      <TcpFormatter>Bin</TcpFormatter>
      <ServiceName>copService</ServiceName>
      <TelnetDebugPort>6900</TelnetDebugPort>
      <DefaultLanguage>german</DefaultLanguage>
      <BackupPath>C:\temp\</BackupPath>
      <BackupRestoreLimitinMB>DE50FAULT</BackupRestoreLimitinMB>
      <WebAuthenticateUrl>http://copsupport.coplanner.com/licence/get_cop_lic_v3.php</WebAuthenticateUrl>
      <LicenceID></LicenceID>
      <SSPIPort>11000</SSPIPort>
      <ClientConnectionTimeOut>1440</ClientConnectionTimeOut>
      <EntitySecurity>true</EntitySecurity>
      <AllowNonPowerUserDeleteDimElementsWithData>false</AllowNonPowerUserDeleteDimElementsWithData>
      <SSPIServicePrincipalName></SSPIServicePrincipalName>
      <EventLogEntryLevel>ERROR</EventLogEntryLevel>
      <ServerLogPath></ServerLogPath>
      <IsAliveClientTypes></IsAliveClientTypes>
      <MultiThreadCommand>true</MultiThreadCommand>
      <OptimizeForCPUCount>4</OptimizeForCPUCount>
      <ProActiveCaching>true</ProActiveCaching>
      <SkipImportHistory>true</SkipImportHistory>
      <NTLogonTypes>INTERACTIVE|NETWORK|BATCH</NTLogonTypes>
      <CopSysIDStartOffset>0</CopSysIDStartOffset>
      <DynamicMode>false</DynamicMode>
      <MaxRows>300000</MaxRows>
      <MaxSvrLogFileSize>0</MaxSvrLogFileSize>
   </CopSettings>
   <SSASSettings>
      <Server>127.0.0.1</Server>
      <DataBaseName>cop_olap</DataBaseName>
      <Security>true</Security>
      <SplitCombinedObjects>true</SplitCombinedObjects>
      <ClientBasedLoad>false</ClientBasedLoad>
      <XmlaLoadActive>true</XmlaLoadActive>
      <UseRealElementIDs>true</UseRealElementIDs>
      <UseMultipleHierarchies>true</UseMultipleHierarchies>
      <MultiSelectFilterActive>false</MultiSelectFilterActive>
      <LoadMeasureFormatAndType>true</LoadMeasureFormatAndType>
      <ReplaceNullValues>false</ReplaceNullValues>
      <DimensionLoadMode>AsDimAndHierarchy</DimensionLoadMode>
      <LoadDimensionsByAlias>true</LoadDimensionsByAlias>
   </SSASSettings>
   <SSRSSettings>
      <ReportServerUrl>http://127.0.0.1/reportserver</ReportServerUrl>
      <ReportWebServiceUrl>http://127.0.0.1/reportserver/reportservice2005.asmx</ReportWebServiceUrl>
      <RootFolder>/CoPlanner/Reports</RootFolder>
      <UserFolder>/CoPlanner/User</UserFolder>
      <TempFolder>/CoPlanner/Temp</TempFolder>
      <SharedDataSourceReference>/CoPlanner/DataSources/CoPlanner</SharedDataSourceReference>
      <Parameters></Parameters>
   </SSRSSettings>
   <DBCon>
      <Stage>Server=localhost;Initial Catalog=COP_STAGE;Integrated Security=SSPI</Stage>
   </DBCon>
</SvrConfig.xml>


The following points have to be defined in the area CopSettings:

Inscription Description
ConnectionString
Server name of server, on which database is located
Initial Catalog name of database
User id name of the user, which is used to login on SQL-Server by CoPlanner Server (as standard, ID „sa“ should already exist). Alternatively, an user can or has to be set up with relevant rights on SQL-Server.
Password password of the user
Pooling to bring Restore Database (fix integrated in the development menue) into action, in Connectionstring Pooling has to be false there!
DataBaseName name of SQL-Database
PortNumber released and unused portnumber for the communication of CoPlanner Server with CoPlanner Clients
FiscalYear it determines posting of financial year of the company to calendar year.
It is calculated based on January.
0 means: none posting of financial year
-1 means: start of financial year in December of previous year
1 means: start of financial year in February of the same year
TcpFormatter it determines the mode of transmission between client and server. You can choose between „Bin“ for binary transmission and „Text“ for text transmission. The chosen mode has to be adjusted both on server and on client („ClientConfig.xml“) and both have to come to an agreement.
ServiceName name of CopService
TelnetDebugPort it is possible to establish a viewing window to CoPlanner Server with the aid of Telnet. This inscription determines portnumber for the connection of Telnet. The connection takes place by DOS-prompt (Start Run cmd). To start Setup please enter: telnet computer name portnummer (e.g. telnet hostname 6900) and click the button „Enter“.
DefaultLanguage The default language of the server is adjustable with this setting (ML routine CoPlanner). The default setting is German. If for example English is used, in the actual tables those entries are stored, which are seized by means of „English Client Logon“. Settings for example in German are stored in the ML system table. All available languages are available in the documentation of the ML routine.
BackupPath it determines temporary disk space for a database backup, which can be caused by a client. SQL-Server has to have rights of writing on the given directories. A network is not allowable, but it should refer to a local volume of the SQL-Server
BackupRestoreLimitinMB maximum Size of db backup in MB.
WebAuthenticateUrl link to evaluate CoPlanner Licence.
LicenceID needs to be set. CoPlanner Server can not be started without a Licence ID.
SSPIPort port for SSPI-Login communication.
ClientConnectionTimeOut after the expiration the client session on the server is deleted.
EntitySecurity With this inscription the company security can be deactivated. If there is no entry the default is set to true.
AllowNonPowerUserDeleteDimElementsWithData defines whether non PowerUser can delete elements with data.
SSPIServicePrincipalName Service Principal Name: Can be empty per default. Only in use in case of SSPI and double hop P.ex.: "cop/mycomputer.mydomain.com"
EventLogEntryLevel it steers, which inscriptions are written in event log, it can be distinguished after severity code of errors 
Warning --> Warnings and errors (red and yellow Cop-Cubes)
Error --> Only errors(red Cop-Cubes)
None --> No entries
ServerLogPath if this option isn't available or empty, the CoPlanner server folder will be used to store the file "Serverlog.txt". If a valid folder is entered, this folder will be used to write log file. If the folder isn't available, a message will be displayed and writing log file will be deactivated. The value "NoLog" deactivates writing log file too.
IsAliveClientTypes entered client types send periodically "AliveCommands" to CoPlanner server. If the client sends no "AliceCommands" to the CoPlanner server for an extended period of time, the session will be deactivated. Following client types are valid: Excel, Windows, CubeWare, Web.
MultiThreadCommand with this option the parallel access of Clients can be activated.
OptimizeForCPUCount this option defines the number of simultaneous client requests. On default all CUPs will be used.
ProActiveCaching with this option the "Tupel Caching" of CoPlanner cubes can be activated. This means, that interim results will be chashed.
SkipImportHistory is this inscription on true, error messages will not be written to the histroy table.
NTLogonTypes All listed NT logon types will be used in case of NT authentication. On default all tree types will be used. Following types are available: INTERACTIVE, NETWORK, BATCH
CopSysIDStartOffset this offset will be added to the first created CopSysID. If there are several models in use, you avoid double CopSysIDs.
DynamicMode activate dynamic reload.
MaxRows maximum number of datasets send to the client.
MaxSvrLogFileSize maximum size of server.txt. If the file will be greater it will be compressed and moved to a defined folder (archiv). Zero means no compression.


The following points have to be defined in the area SSASSettings:

Eintrag Beschreibung
Server 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.
DataBaseName Name der OLAP-Datenbank
Security Ist dieser Eintrag auf true, ist die Security aktiviert, ist der Eintrag auf false, ist diese inaktiv. Ist der Eintrag nicht im Config File vorhanden, ist die Security per default aktiv.
SplitCombinedObjects
ClientBasedLoad 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!
XmlaLoadActive Ist dieser Eintrag auf true, werden Strukturdaten mittels XMLA geladen enormer Performancegewinn!
UseRealElementIDs Die echten OLAP-Keys werden verwendet unter der Voraussetzung, dass diese numerisch sind.
UseMultipleHierarchies Ist dieser Eintrag auf true, werden Alternativhierarchien von Olap Dimensionen geladen und können verwendet werden (ab SSAS 2005).
MultiSelectFilterActive Ist dieser Eintrag auf true, werden Dimensionen, die als Filter verwendet werden, mit Mehrfachauswahl (Multiselect) unterstützt.
LoadMeasureFormatAndType 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).
ReplaceNullValues Ist dieser Eintrag auf true, werden Null Values vom Connector mit 0 ersetzt.
DimensionLoadMode Betrifft das Ladeverhalten von OLAP Dimensionen. Folgende Einträge sind zulässig: AsDimension (Defaultwert), AsDimHierarchy und AsDimAndHierarchy. Siehe: Exkurs SSAS Einstellungen
LoadDimensionsByAlias OLAP-Dimensionen werden mit ihrem Alias geladen. Siehe: Exkurs SSAS Einstellungen


Folgende Punkte müssen im Bereich SSRSSettings definiert werden:

Eintrag Beschreibung
ReportServerUrl Das virtuelle Verzeichnis für den Berichtsserver.
ReportWebServiceUrl Der SOAP-Endpunkt für die Berichtsverwaltung.
RootFolder Das Basisverzeichnis für die Berichte am Berichtsserver.
UserFolder Das Verzeichnis für Berichte, die im BI-Center mit dem Berichtsassistenten erstellt werden. Fehlt die Angabe, wird das Basisverzeichnis verwendet.
TempFolder Das Verzeichnis für Berichte, die im Analyzer mit dem Berichtsassistenten erstellt werden. Fehlt die Angabe, wird das Basisverzeichnis verwendet.
SharedDataSourceReference Pfad und Name zu einer bereits vorhandenen Datenquelle am Berichtsserver, die vom Berichtsassistenten beim Erstellen eines neuen Berichtes verwendet wird. Fehlt diese Angabe erzeugt der Berichtsassistent eine im Bericht eingebettete Datenquelle. Bei Berichten mit eingebetteten Datenquellen kann vom Reportbuilder keine Vorschau angezeigt werden.
Parameters

Folgende Punkte müssen im Bereich DBCon definiert werden:

Eintrag Beschreibung
Stage
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!

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. 

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

Exkurs SSAS Einstellungen

Der CoPlanner-Server bietet mehrere Möglichkeiten SSAS-Dimensionen zu laden. Im Folgenden werden die zulässigen Einstellungen aufgelistet.

DimensionLoadMode LoadDimensionByAlias Einstellung Ergebnis
AsDimension False
AsDimension True
AsDimHierarchy True
AsDimAndHierarchy True


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>
   <runtime>
      <legacyUnhandledExceptionPolicy enabled="true" >
   </runtime>
   <startup>
   </startup>
   <appSettings>
   </appSettings>
   <system.net>
      <mailSettings>
         <smtp deliveryMethod="Network" from="aboexecutor@coplanner.com">
            <network
               host="psad001.graz.coplanner.com"
               port="25"
               defaultCredentials="true"
               />
         </smtp>
      </mailSettings>
   </system.net>
</configuration>


Diese Datei enthält Informationen, die beim Starten des Dienstes vom CoPlanner-Server eingelesen werden. Sie befindet sich im Serververzeichnis. Siehe auch weitere Möglichkeiten der E-Mail Einstellungen.


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 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="SERVICE_NAME" value="copService_bike1"></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="SERVICE_NAME" value="copService_bike2"></add>
   </appSettings>
</configuration>


Nach dem Anpassen 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>
   </appSettings>
   <system.net>
      <mailSettings>
         <smtp deliveryMethod="Network" from="aboexecutor@coplanner.com">
            <network
               host="psad001.graz.coplanner.com"
               port="25"
               defaultCredentials="true"
               />
         </smtp>
      </mailSettings>
   </system.net>
</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 (selbe 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. 

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

|- |style="color:#0000ff;"|DefaultLanguage |The default language of the server is adjustable with this setting (ML routine CoPlanner). The default setting is German. If for example English is used, in the actual tables those entries are stored, which are seized by means of „English Client Logon“. Settings for example in German are stored in the ML system table. All available languages are available in the documentation of the ML routine. Example: 

<add key="DefaultLanguage" value="german"></add>

|- |style="color:#0000ff;"|ClientConnectionTimeOut |After the expiration the client session on the server is deleted. |- |style="color:#0000ff;"|MultiThreadCommand |With this option the parallel access of Clients can be activated. Example: 

<add key="MultiThreadCommand" value="true"></add>

|- |style="color:#0000ff;"|GCCollectAfterClientDataCommand |After every ClientDataCommand the GarbageCollector releases unused memory. Example: 

<add key="GCCOLLECTAFTERCLIENTCOMMAND" value="True"></add>

|- |style="color:#0000ff;"|ProActiveCaching |With this option the "Tupel Caching" of CoPlanner cubes can be activated. This means, that interim results will be chashed. Example: 

<add key="ProActiveCaching" value="true"></add>

|- |style="color:#0000ff;"|EmptyCellsClientGenerated |The CoPlanner client generates empty cells, not the CoPlanner server. This improves performance in case of thinly populated matrices. Example: 

<add key="EmptyCellsClientGenerated" value="true"></add>

|- |style="color:#0000ff;"|SSPIServicePrincipalName |Service Principal Name: Can be empty per default. Only in use in case of SSPI and double hop P.ex.: "cop/mycomputer.mydomain.com" Example: 

<add key="SSPIServicePrincipalName" value="cop/mycomputer.mydomain.com"></add>

|- |style="color:#0000ff;"|IsAliveClientTypes |Entered client types send periodically "AliveCommands" to CoPlanner server. If the client sends no "AliceCommands" to the CoPlanner server for an extended period of time, the session will be deactivated. Following client types are valid: Excel, Windows, CubeWare, Web. Example: 

<add key="IsAliveClientTypes" value="Excel|Windows"></add>

|- |style="color:#0000ff;"|OptimizeForCPUCount |This option defines the number of simultaneous client requests. On default all CUPs will be used. Example: 

<add key="OptimizeForCPUCount" value="4"></add>

|- |style="color:#0000ff;"|NTLogonTypes |All listed NT logon types will be used in case of NT authentication. On default all tree types will be used. Following types are available: INTERACTIVE, NETWORK, BATCH Example: 

<add key="NTLogonTypes" value="INTERACTIVE|NETWORK"></add>

|- |style="color:#0000ff;"|ServerLogPath |Available at CoPlanner Server 9.1, Hotfix 2.1 If this option isn't available or empty, the CoPlanner server folder will be used to store the file "Serverlog.txt". If a valid folder is entered, this folder will be used to write log file. If the folder isn't available, a message will be displayed and writing log file will be deactivated. The value "NoLog" deactivates writing log file too.
Example: 

<add key="ServerLogPath" value=""></add>

Valid values:

No value
<add key="ServerLogPath" value=""></add>
Valid folder
<add key="ServerLogPath" value="C:\temp\logs"></add>
No log file will be written
<add key="ServerLogPath" value="NoLog"></add>

|- |style="color:#0000ff;"|import.importSkipHistory |Is this inscription on true, error messages will not be written to the histroy table. Example: 

<add key="import.importSkipHistory" value="True"></add>

|}

CopServiceInstall.bat

To install CoPlanner as Service, only this file has to be started. It is located in the Server-Directory of CoPlanner. A console window appears and informs you about the status of installation.

Has a CoPlanner Server Service already been installed, you have to finish and to deinstall the old Service before you start the new installation. The deinstallation takes place by starting file CopServiceUnInstall.bat, which is located in the Server-Directory as well.


Install some CoPlanner Services on one computer

Some CoPlanner Services can be installed on one computer. Therefore in file „CopService.exe.config“ some features are necessary. Furthermore two CoPlanner Server folders will be required. Two CoPlanner Services are not allowed to refer to the same folder.

Settings in „CopService.exe.config“

For each Service a separate name has to be allocated in file „CopService.exe.config“. Therefore within the day „<appSettings>“ the following line can be added: 

      <add key="SERVICE_NAME" value="copService_bike2"></add>

The item „value“ identified the name of constructed CopService. "TCP_DEBUG_PORT" has to be adopted as well in order that Debug messages of the Server can be read on Telnet: 

      <add key="TCP_DEBUG_PORT" value="6901"></add>

In addition, for each Server a separate portnumber has to be allocated in file „SvrConfig.xml“.To install the Services, for each Service file „CopServiceInstall.bat“ has to be carried out subsequently.

Example of a configuration

File „CopService.exe.config“ is located e.g. in folder „C:\Program Files\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>

File „CopService.exe.config“ for the second CopService is located e.g. in folder „C:\Program Files\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>

After adopting portnumber the relative Services can be installed with the aid of batch file “CopServiceInstall.bat”. Under Windows Services there are two independent Services.

Debug messages of Server can be displayed about the command of console:

telnet localhost 6900

or

telnet localhost 6901


CoPlanner Server as a console

It is possible to install CoPlanner as a console. In process the following points have to be considered:

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>


This file contains information, which is read in at the start of Service by CoPlanner Server. They are located in the Server-Directory. For all available options CopService.exe.config.

Start of the Server as a console

The installation has finished by copying of Server-directory onto the computer. You only have to start file CopServer.exe. A console window appears. Here you can see which operations the CoPlanner Server is carrying out.

CoPlanner Server and 64 Bit Systems

The CoPlanner Server can be operated on 64 bit systems. The advantages are faster process cycle times and the possibility to use more than 1.3 Gb of memory

Requirements

The CoPlanner Server and Client needs the 64 bit components of the standard 32 bit components.

  • Windows Server 2003 x64
  • Net Framework 2.0 x64 with SP1
  • XML Parser 4 with SP2
  • XML Parser 6 x64
  • AdoMD.Net
  • SQL Server 2005 with SP2
  • Analysis Server 2005 with SP2

Conversion of existing systems

SQL Server 2000 Database can be imported on SQL Server 2005 or SQL Server 2008 Systems.

bei DTS Packages (Data Transformation Services) and Analysis Server 2000 Databases (Olap) cannot be imported. The packages need to be recreated with the SQL Server Integration Services (SSIS). No downward compatibility is given from Microsoft.

Analysis services data bases can be ported. But rrors can occur and/or ported data bases can be limited in function or not to be used at all. Here we recommend a reconstruction of the data base. -->

Retrieved from "https://copsupport.coplanner.com/help11_en/index.php?title=Technics:CoPlanner-Server&oldid=13851"