Technik:CoPlanner-Reportserver

Reportserver ab 9.5 HF 2.8

ReportSvrConfig.xml

Die ReportSvrConfig.xml enthält die folgenden Einträge, welche definiert werden müssen:

Eintrag	Beschreibung
reportServerUrl	URL über welche der Reportserver kommuniziert
serviceName	Name, unter welchem das ReportServer Service angelegt werden soll über das Tool ReportServerServiceInstall.exe.
serviceNameCopServer	Servicename des installierten CoPlanner Services, damit bei der Installation des ReportServer Services, die entsprechende Abhängigkeit definiert werden kann. Sollte es kein Service geben, oder dieses auf einem anderen Server installiert sein, diesen Eintrag einfach leer lassen.

Einrichten der Verbindung

Für die Verbindung zum CoPlanner-Server muss die ClientConfig.xml entsprechend konfiguriert werden.

ClientConfig.xml

<?xml version="1.0" encoding="utf-16" standalone="yes"?>
<ClientConfig>
   <IpSettings>
      <Version>1</Version>
      <Server>localhost</Server>
      <Port>8963</Port>
      <MaxRows>100000</MaxRows>
      <MaxCells>0</MaxCells>
      <TcpFormatter>Native</TcpFormatter>
      <SSLCommonName></SSLCommonName>
   </IpSettings>
   <Languages>
      <Available>Deutsch|English</Available>
   </Languages>
</ClientConfig>

Für die Anmeldung des ReportServers am CoPlanner Server muss die SessionSettings.xml konfiguriert werden. Dieser User muss im CoPlanner nur die Rechte haben für den Plan und das Unternehmen, welches hier definiert wurde. Die Anwender können unabhängig davon, auf alle Pläne und Unternehmen zugreifen, auf welche Sie berechtigt sind.

SessionSettings.xml

<?xml version="1.0" encoding="utf-16" standalone="yes"?>
<SessionSetting>
   <Version>1</Version>
   <User>Administrator</User>
   <Password>pwd</Password>
   <Entity>Bike GmbH</Entity>
   <Plan>Plan Bike GmbH</Plan>
</SessionSetting>

Für die SSPI Anmeldung ist im SessionSettings.xml als Username nichts und als Kennwort "SSPI" zu hinterlegen. Um SSPI zu verwenden muss der User in der Domäne und im CoPlanner angelegt werden und im CoPlanner die Rechte auf die angegebene Kombination von Plan und Unternehmen haben.

ReportSvrConfig.exe

Ist das zentrale Tool, über welches Sie alle Konfigurationseinstellungen von oben treffen können. Über dieses Tool lässt sich auch das Reportserver-Service installieren bzw. Deinstallieren.

Zusätzliche Voraussetzungen

Damit der Benutzer, unter dem der CoPlanner Reportserver als Konsole oder das Service läuft, nicht Administrator sein muss, muss für den Benutzer und die definierte reportServerUrl folgender Befehl in der Konsole als Administrator ausgeführt werden. In der ReportSvrConfig.exe wird dieser Schritt beim Installieren bzw. Deinstallieren des Services mitausgeführt. Die Bindung des SSL Zertifikats muss jedoch manuell über den unten beschriebenen Befehl ausgeführt werden.

netsh http add urlacl url=<reportServerUrl> user=<DOMAIN\user>

Parameter	Beschreibung
url	reportServerUrl, welche in der Cop.Server.Report.Service.exe.config bzw. CopReportServer.exe.config vergeben wurde
user	Benutzer unter dem der CoPlanner Reportserver/das Service laufen soll

Beispiel: netsh http add urlacl url=https://+:4445/coplanner/reporting user=Cop\Serviceuser

Entfernen kann man diesen Eintrag mit netsh http delete urlacl url=<ReportServerUrl>

Beispiel: netsh http delete urlacl url=https://+:4445/coplanner/reporting

Bindung des SSL Zertifikats

Für die Bindung des SSL Zertifikats muss folgender Befehl als Administrator in der Konsole ausgeführt werden

netsh http add sslcert ipport=0.0.0.0:<Portnummer> certhash=<fingerprint> appid=<GUID>

Parameter	Beschreibung
Portnummer	Portnummer, welche in der reportServerUrl verwendet wird. z.B. bei reportServerUrl https://+:4445/coplanner/reporting wäre das 4445
certhash	Fingerabdruck des Zertifikats. Dieser ist in den Details des Zertifikats zu finden und muss hier ohne den Leerzeichen angegeben werden.
GUID	Die GUID unterscheidet sich, ob der Reportserver als Konsole oder als Service verwendet wird Service: {d36681ea-e3d6-4909-94c3-93834beddb9d} Konsole: {489b672b-5171-4aae-9e79-320427ab6c62}

Beispiel: netsh http add sslcert ipport=0.0.0.0:4445 certhash=2170950415ef045f6cb314c92e124411dd0590bf appid={6ef7e594-5b5e-4626-904a-47b513e81e30}

Entfernen kann man diese Bindung mit netsh http delete sslcert ipport=0.0.0.0:<Portnummer>

Beispiel: netsh http delete sslcert ipport=0.0.0.0:4445

Konfiguration in der SvrConfig.xml

In der SvrConfig.xml muss der Eintrag ReportServerUrl auf die definierte ReportServerUrl gesetzt werden. Achtung: hier muss ein möglicherweise verwendetes + in der URL mit dem Servernamen/IP Adresse ersetzt werden.

Reportserver vor 9.5 HF 2.8

ReportServer als Service

Cop.Server.Report.Service.exe.config

Diese Datei definiert die Eigenschaften des Reportserver Services.

 <appSettings>
   ...
   <add key="reportServerUrl" value="https://+:4445/coplanner/reporting" />
   <add key="serviceName" value="CopReportingService" />
   <add key="serviceNameCopServer" value="CopService" />
 </appSettings>

Vor dem 9.5 HF 1.9 musste auch noch folgender Parameter mit angegeben werden: <add key="copServerRestUrl" value="https://servername:4443/coplanner" />

Eintrag	Beschreibung
reportServerUrl	URL über welche der Reportserver kommuniziert
serviceName	Name, unter welchem das ReportServer Service angelegt werden soll über das Tool ReportServerServiceInstall.exe.
serviceNameCopServer	Servicename des installierten CoPlanner Services, damit bei der Installation des ReportServer Services, die entsprechende Abhängigkeit definiert werden kann. Sollte es kein Service geben, oder dieses auf einem anderen Server installiert sein, diesen Eintrag einfach leer lassen.
copServerRestUrl	Ab 9.5 HF 1.9 hinfällig. WebAppUrl des CoPlanner Servers. Hier ist zu beachten, dass ein ggf. vorhandenes + in dieser URL mit dem Servernamen/IP Adresse ersetzt werden muss.

Einrichten der Verbindung

Für die Verbindung zum CoPlanner-Server muss die ClientConfig.xml entsprechend konfiguriert werden.

ClientConfig.xml

<?xml version="1.0" encoding="utf-16" standalone="yes"?>
<ClientConfig>
   <IpSettings>
      <Version>1</Version>
      <Server>localhost</Server>
      <Port>8963</Port>
      <MaxRows>100000</MaxRows>
      <MaxCells>0</MaxCells>
      <TcpFormatter>Native</TcpFormatter>
      <SSLCommonName></SSLCommonName>
   </IpSettings>
   <Languages>
      <Available>Deutsch|English</Available>
   </Languages>
</ClientConfig>

Für die Anmeldung des ReportServers am CoPlanner Server muss die SessionSettings.xml konfiguriert werden. Dieser User muss im CoPlanner nur die Rechte haben für den Plan und das Unternehmen, welches hier definiert wurde. Die Anwender können unabhängig davon, auf alle Pläne und Unternehmen zugreifen, auf welche Sie berechtigt sind.

SessionSettings.xml

<?xml version="1.0" encoding="utf-16" standalone="yes"?>
<SessionSetting>
   <Version>1</Version>
   <User>Administrator</User>
   <Password>pwd</Password>
   <Entity>Bike GmbH</Entity>
   <Plan>Plan Bike GmbH</Plan>
</SessionSetting>

Für die SSPI Anmeldung ist im SessionSettings.xml als Username nichts und als Kennwort "SSPI" zu hinterlegen. Um SSPI zu verwenden muss der User in der Domäne und im CoPlanner angelegt werden und im CoPlanner die Rechte auf die angegebene Kombination von Plan und Unternehmen haben.

ReportServerServiceInstall.exe

Dieses Tool bietet eine Hilfestellung für das Installieren des Reportserver Services, auf Basis der Daten aus der Cop.Server.Report.Service.exe.config.

ReportServer als Konsole

CopReportServer.exe.config

Diese Datei definiert die Eigenschaften des Reportservers als Konsole.

 <appSettings>
   ...
   <add key="reportServerUrl" value="https://+:4445/coplanner/reporting" />
 </appSettings>

Eintrag	Beschreibung
reportServerUrl	URL über welche der Reportserver kommuniziert

Einrichten der Verbindung

Für die Verbindung zum CoPlanner-Server muss die ClientConfig.xml entsprechend konfiguriert werden.

ClientConfig.xml

<?xml version="1.0" encoding="utf-16" standalone="yes"?>
<ClientConfig>
   <IpSettings>
      <Version>1</Version>
      <Server>localhost</Server>
      <Port>8963</Port>
      <MaxRows>100000</MaxRows>
      <MaxCells>0</MaxCells>
      <TcpFormatter>Native</TcpFormatter>
      <SSLCommonName></SSLCommonName>
   </IpSettings>
   <Languages>
      <Available>Deutsch|English</Available>
   </Languages>
</ClientConfig>

Für die Anmeldung des ReportServers am CoPlanner Server muss die SessionSettings.xml konfiguriert werden. Dieser User muss im CoPlanner nur die Rechte haben für den Plan und das Unternehmen, welches hier definiert wurde. Die Anwender können unabhängig davon, auf alle Pläne und Unternehmen zugreifen, auf welche Sie berechtigt sind.

SessionSettings.xml

<?xml version="1.0" encoding="utf-16" standalone="yes"?>
<SessionSetting>
   <Version>1</Version>
   <User>Administrator</User>
   <Password>pwd</Password>
   <Entity>Bike GmbH</Entity>
   <Plan>Plan Bike GmbH</Plan>
</SessionSetting>

Für die SSPI Anmeldung ist im SessionSettings.xml als Username nichts und als Kennwort "SSPI" zu hinterlegen. Um SSPI zu verwenden muss der User in der Domäne und im CoPlanner angelegt werden und im CoPlanner die Rechte auf die angegebene Kombination von Plan und Unternehmen haben.

Zusätzliche Voraussetzungen

Damit der Benutzer, unter dem der CoPlanner Reportserver als Konsole oder das Service läuft, nicht Administrator sein muss, muss für den Benutzer und die definierte reportServerUrl folgender Befehl in der Konsole als Administrator ausgeführt werden. In der ReportServerServiceInstall.exe kann dieser Schritt unter Punkt 6 ausgeführt werden, die Bindung des SSL Zertifikats muss jedoch manuell über den unten beschriebenen Befehl ausgeführt werden.

netsh http add urlacl url=<reportServerUrl> user=<DOMAIN\user>

Parameter	Beschreibung
url	reportServerUrl, welche in der Cop.Server.Report.Service.exe.config bzw. CopReportServer.exe.config vergeben wurde
user	Benutzer unter dem der CoPlanner Reportserver/das Service laufen soll

Beispiel: netsh http add urlacl url=https://+:4445/coplanner/reporting user=Cop\Serviceuser

Entfernen kann man diesen Eintrag mit netsh http delete urlacl url=<ReportServerUrl>

Beispiel: netsh http delete urlacl url=https://+:4445/coplanner/reporting

Bindung des SSL Zertifikats

Für die Bindung des SSL Zertifikats muss folgender Befehl als Administrator in der Konsole ausgeführt werden

netsh http add sslcert ipport=0.0.0.0:<Portnummer> certhash=<fingerprint> appid=<GUID>

Parameter	Beschreibung
Portnummer	Portnummer, welche in der reportServerUrl verwendet wird. z.B. bei reportServerUrl https://+:4445/coplanner/reporting wäre das 4445
certhash	Fingerabdruck des Zertifikats. Dieser ist in den Details des Zertifikats zu finden und muss hier ohne den Leerzeichen angegeben werden.
GUID	Die GUID unterscheidet sich, ob der Reportserver als Konsole oder als Service verwendet wird Service: {d36681ea-e3d6-4909-94c3-93834beddb9d} Konsole: {489b672b-5171-4aae-9e79-320427ab6c62}

Beispiel: netsh http add sslcert ipport=0.0.0.0:4445 certhash=2170950415ef045f6cb314c92e124411dd0590bf appid={6ef7e594-5b5e-4626-904a-47b513e81e30}

Entfernen kann man diese Bindung mit netsh http delete sslcert ipport=0.0.0.0:<Portnummer>

Beispiel: netsh http delete sslcert ipport=0.0.0.0:4445

Konfiguration in der SvrConfig.xml

In der SvrConfig.xml muss der Eintrag ReportServerUrl auf die definierte ReportServerUrl gesetzt werden. Achtung: hier muss ein möglicherweise verwendetes + in der URL mit dem Servernamen/IP Adresse ersetzt werden.