Jump to: navigation, search

Difference between revisions of "View Cache Launcher"


({{UBIK}} View Cache Launcher (VCL))
 
(6 intermediate revisions by 2 users not shown)
Line 11: Line 11:
 
! Attribute!!Purpose!!Optional
 
! Attribute!!Purpose!!Optional
 
|-
 
|-
| '''Index'''|| ? ||  
+
| '''Protocol'''|| choose your wanted transport-protocol (https, http) ||  
 
|-
 
|-
| '''Protocol'''|| choose your wanted transport-protocol (typically: https) ||
+
| '''Url'''|| URL of the webserver ||
|-
+
| '''Url'''|| IP-adress of your webserver ||
+
 
|-
 
|-
 
| '''Port'''|| port which is assigned to the webserver ||
 
| '''Port'''|| port which is assigned to the webserver ||
Line 21: Line 19:
 
| '''Path'''|| specify the path where the CONTENT webservice is placed ||
 
| '''Path'''|| specify the path where the CONTENT webservice is placed ||
 
|-
 
|-
| '''App'''|| app name of your database ||
+
| '''App'''|| application name of your use-case||
 
|-
 
|-
| '''Context'''|| context name of your database ||
+
| '''Context'''|| context name of your use-case||
 
|-
 
|-
| '''TriggerInterval'''|| specify an interval in milliseconds ||
+
| '''TriggerInterval'''|| specify the interval in seconds how often a viewcache rebuild is triggered  ||
 
|-
 
|-
| '''OfflineCheckInterval'''|| specify an interval in milliseconds which checks if the viewcache is offline |||
+
| '''OfflineCheckInterval'''|| specify the interval in seconds how often the server-status is checked |||
 +
|-
 +
| '''Inactive'''|| possibility to configure a timespan in which no rebuild is triggered (from;to) in (hh:mm;hh:mm) || X
 
|-
 
|-
 
| '''LogPath'''|| specify the path where your logs should be placed ||  
 
| '''LogPath'''|| specify the path where your logs should be placed ||  
 
|-
 
|-
| '''USAMUrl'''||  ? ||
+
| '''USAMUrl'''||  Webserver URL of the USAM || X
 
|-
 
|-
| '''USAMPort'''|| ? ||
+
| '''USAMPort'''|| port which is assigned to the USAM webserver || X
 
|-
 
|-
| '''USAMProtocol'''|| ? ||
+
| '''USAMProtocol'''|| choose your wanted transport-protocol (https, http) || X
 
|-
 
|-
 
| '''USAMPath'''|| specify the path where the USAM webservice is placed ||
 
| '''USAMPath'''|| specify the path where the USAM webservice is placed ||
 
|-
 
|-
| '''USAMLogin'''|| state the user name that allows to login ||
+
| '''USAMLogin'''|| specify the login name which is used for triggering the viewcache build ||  
 
|-
 
|-
| '''USAMPwd'''||  state the belonging password from your given user name ||
+
| '''USAMPwd'''||  specify the password which is used for triggering the viewcache build||
 
|-
 
|-
| '''USAMDeviceName'''|| state a device name ||
+
| '''USAMDeviceName'''|| specify the device name which is used for triggering the viewcache build ||
 
|-|-
 
|-|-
 +
| '''PushUrl'''||  Webserver URL of the USAM || X
 +
|-
 +
| '''PushPort'''|| port which is assigned to the USAM webserver || X
 +
|-
 +
| '''PushProtocol'''|| choose your wanted transport-protocol (https, http) || X
 +
|-
 +
| '''PushPath'''|| specify the path where the USAM webservice is placed || X
 +
|-
 
|}
 
|}
  
Line 56: Line 64:
 
     </startup>
 
     </startup>
 
     <appSettings>
 
     <appSettings>
       <add key="Index" value="?"/>
+
       <add key="Protocol" value="yourWantedTransportProtocol"/>
       <add key="Protocol" value="https"/>
+
       <add key="Url" value="yourServerName"/>
       <add key="Url" value="10.0.0.100"/>
+
       <add key="Port" value="yourServerPort"/>
       <add key="Port" value="888"/>
+
       <add key="Path" value="yourServerPath"/>
       <add key="Path" value="CLIENT/UBIK/CONTENT"/>
+
       <add key="App" value="yourApplicationName"/>
       <add key="App" value="APP_001"/>
+
       <add key="Context" value="yourContextName"/>
       <add key="Context" value="CXT_001"/>
+
       <add key="TriggerInterval" value="yourTriggerInterval" />
       <add key="TriggerInterval" value="1800" />
+
       <add key="OfflineCheckInterval" value="yourCheckingInterval" />
       <add key="OfflineCheckInterval" value="60" />
+
       <add key ="Inactive" value = "01:45;05:15"/>
       <add key="LogPath" value="D:\UBIK\LOG\VCL\log.txt"/>     
+
       <add key="LogPath" value="yourLogPath"/>     
       <add key="USAMUrl" value="?"/>
+
       <add key="USAMUrl" value="yourUSAMServerName"/>
       <add key="USAMPort" value="?"/>
+
       <add key="USAMPort" value="yourUSAMServerPort"/>
       <add key="USAMProtocol" value="?"/>
+
       <add key="USAMProtocol" value="yourWantedTransportProtocol"/>
       <add key="USAMPath" value="CLIENT/UBIK/USAM"/>
+
       <add key="USAMPath" value="yourUSAMServerPath"/>
       <add key="USAMLogin" value="ubik"/>
+
       <add key="USAMLogin" value="yourLoginName"/>
       <add key="USAMPwd" value="ubikpwd"/>
+
       <add key="USAMPwd" value="yourLoginPassword"/>
       <add key="USAMDeviceName" value="satellite"/>
+
       <add key="USAMDeviceName" value="yourDeviceName"/>
 
     </appSettings>
 
     </appSettings>
 
</configuration>
 
</configuration>

Latest revision as of 14:28, 22 January 2021

UBIK® View Cache Launcher (VCL)

The VCL is an installable windows system service which can be used to automaically trigger one or more UBIK contexts(s) provided by an UBIK IIS service to build up its view cache.

After unpacking the VCL binaries and config-files, move the files to a directory where the local system account (or the specified one configured to run the VCL service) is allowed to execute the "install.bat". This file installs the UBIK.VCL.Service.exe as a service.

The VCL is configured in “UBIK.VCL.Service.exe.config":

Attribute Purpose Optional
Protocol choose your wanted transport-protocol (https, http)
Url URL of the webserver
Port port which is assigned to the webserver
Path specify the path where the CONTENT webservice is placed
App application name of your use-case
Context context name of your use-case
TriggerInterval specify the interval in seconds how often a viewcache rebuild is triggered
OfflineCheckInterval specify the interval in seconds how often the server-status is checked
Inactive possibility to configure a timespan in which no rebuild is triggered (from;to) in (hh:mm;hh:mm) X
LogPath specify the path where your logs should be placed
USAMUrl Webserver URL of the USAM X
USAMPort port which is assigned to the USAM webserver X
USAMProtocol choose your wanted transport-protocol (https, http) X
USAMPath specify the path where the USAM webservice is placed
USAMLogin specify the login name which is used for triggering the viewcache build
USAMPwd specify the password which is used for triggering the viewcache build
USAMDeviceName specify the device name which is used for triggering the viewcache build
PushUrl Webserver URL of the USAM X
PushPort port which is assigned to the USAM webserver X
PushProtocol choose your wanted transport-protocol (https, http) X
PushPath specify the path where the USAM webservice is placed X

Example

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <startup>
        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5.1" />
    </startup>
    <appSettings>
      <add key="Protocol" value="yourWantedTransportProtocol"/>
      <add key="Url" value="yourServerName"/>
      <add key="Port" value="yourServerPort"/>
      <add key="Path" value="yourServerPath"/>
      <add key="App" value="yourApplicationName"/>
      <add key="Context" value="yourContextName"/>
      <add key="TriggerInterval" value="yourTriggerInterval" />
      <add key="OfflineCheckInterval" value="yourCheckingInterval" />
      <add key ="Inactive" value = "01:45;05:15"/>
      <add key="LogPath" value="yourLogPath"/>    
      <add key="USAMUrl" value="yourUSAMServerName"/>
      <add key="USAMPort" value="yourUSAMServerPort"/>
      <add key="USAMProtocol" value="yourWantedTransportProtocol"/>
      <add key="USAMPath" value="yourUSAMServerPath"/>
      <add key="USAMLogin" value="yourLoginName"/>
      <add key="USAMPwd" value="yourLoginPassword"/>
      <add key="USAMDeviceName" value="yourDeviceName"/>
    </appSettings>
</configuration>

Configure more than one service and/or context to be updated

Please duplicate the entries used and add a number suffix. Here is an example:

<add key="Protocol" value="https" />
<add key="Protocol01" value="https" />

Remark: The number should be continously incremented by one, if there is a number missing in-between (-> e.g. Protocol, Protocol01, Protocol03,..), the last executed will be Protocol01.