Technik:CoPlanner-Reportserver

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

Wie bei allen Clients des CoPlanner existiert hierfür eine Konfigurationsdatei mit dem Namen ClientConfig.xml.

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>
   </IpSettings>
   <Languages>
      <Available>Deutsch|English</Available>
   </Languages>
</ClientConfig>

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>

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

Wie bei allen Clients des CoPlanner existiert hierfür eine Konfigurationsdatei mit dem Namen ClientConfig.xml.

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>
   </IpSettings>
   <Languages>
      <Available>Deutsch|English</Available>
   </Languages>
</ClientConfig>

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>

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 WebAppUrl 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=<WebAppUrl> user=<DOMAIN\user>

Parameter	Beschreibung
url	WebAppUrl, welche in der svrconfig vergeben wurde
user	Benutzer unter dem der CoPlanner Server/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 WebAppUrl verwendet wird. z.B. bei WebAppUrl https://+:4443/coplanner wäre das 4443
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.