Tech Notes

Installation

Der Bereich Installation kommt innerhalb von OpaccOneInstallation.xml nur ein Mal vor und enthält Informationen/Einstellungen welche die ganze OpaccERP-Installation betreffen.

Installation

Element Beschreibung Bemerkung
Name
Name der OpaccERP-Installation.
Description
Beschreibung der OpaccERP-Installation.
Comment
Kommentar zu den vorangehenden Attributen.
RootPath
RootPath auf das Insyde-Verzeichnis.
Tragen Sie hier den vollen UNC-Pfad ein.
Die Angabe des RootPath ist zwingend!
Beim Start des ServiceBus wird der RootPath geprüft. Erfolgt der Start nicht aus diesem Verzeichnis, weil beispielsweise die gesamte Installation kopiert wurde und nun ohne Anpassung gestartet werden soll, so wird der Start des ServiceBus bzw. des OpaccERP-Clients (Cloud oder Classic) abgebrochen.
AlternateRootPath
Alternativer RootPath auf das Insyde-Verzeichnis.
Optional können mehrere alternative RootPath-Einträge erfasst werden.
Version
Aktuelle Version von Opacc OXAS und Opacc ERP.
Wird durch den Update bzw. durch das Einlesen eines Builds gesetzt und darf nicht mutiert werden.
OxasAccess
Einträge für den Zugriff von Services und Agents auf den OXAS Frontend Service.
ServicesAndAgents
Pattern für Services und Agents, sowie URL zum OXAS Frontend Service.
NamePattern
NamePattern für den Servicenamen.
Das NamePattern muss mit dem Servicenamen "matchen".
Je weniger Wildcards '*' ein NamePattern enthält, desto passender ist es.
Je mehr Punkte '.' ein NamePattern enthält, desto besser/präziser ist es.
Beispiele:
Opacc.Search.*
Opacc.Search.Agent
OxasFrontendBaseUrl
URL des Opacc OXAS Frontend Service.
Die Angabe der OxasFrontendBaseUrl ist für das Nutzen unserer Service- und Agent-Komponenten notwendig. Diese greifen via WebSocket auf das Interface von OXAS zu, wofür sie die hier konfigurierte URL benötigen.
ServiceBusCohortId
CohortId für die Verteilung auf verschiedene ServiceBus-Instanzen.
Die Angabe einer CohortId ist optional.
Der Betrieb unserer Service- und Agent-Komponenten basiert auf einem eigenen Cluster, der zwingend den Namen IS (Internal Services) tragen muss und als Cluster für die OXAS Services dient.
MaintenanceWindow
Zentrales Wartungsfenster.
Während des MaintenanceWindow erfolgen durch unsere Agent- und Service-Dienste keine Zugriffe auf OpaccERP und es werden keine ServiceBus-Connections aufgebaut. Zudem erfolgen keine Aktualisierungen/Zugriffe auf die Monitor-Objekte.
Enabled
Ist das zentrale Wartungsfenster aktiv oder nicht.
Mögliche Werte: true/false
Start
Start des zentralen Wartungsfensters.
Stop
Ende des zentralen Wartungsfensters.
WeekdayRestriction
Wochentags-Restriktion des zentralen Wartungsfensters.
Wird hier ein Wochentag eingetragen, ist das zentrale Wartungsfenster nur an diesem Tag aktiv. Soll für mehrere Wochentage ein zentrales Wartungsfenster definiert werden, muss dies für jeden Wochentag separat gemacht werden.
Version
Aktuelle Version von OpaccERP.
Dieser Eintrag wird beim Update bzw. Einlesen eines Servicepacks automatisch aktualisiert.

Beispiel

<?xml version="1.0" encoding="utf-8"?>
<Configuration xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Installation>
    <Name>TEST1620</Name>
    <Description>Testinstallation SCH v16.20</Description>
    <Comment>Basis für Freigabetests. Anpassungen nur durch Testing-Team!</Comment>
    <RootPath>\\testserver\TEST1620\insyde</RootPath>
    <AlternateRootPath>D:\TEST1620\insyde</AlternateRootPath>
    <AlternateRootPath>\\testserver.intra.local\D$\TEST1620\insyde</AlternateRootPath>
    <Version>24.2.0.216</Version>
    <OxasAccess>
      <ServicesAndAgents>
        <NamePattern>Opacc.*</NamePattern>
        <OxasFrontendBaseUrl>https://opaccerp.mydomain.ch/</OxasFrontendBaseUrl>
        <ServiceBusCohortId></ServiceBusCohortId>
      </ServicesAndAgents>
    </OxasAccess>
    <MaintenanceWindow>
      <Enabled>true</Enabled>
      <Start>00:29:00</Start>
      <Stop>01:00:00</Stop>
      <WeekdayRestriction>Mon</WeekdayRestriction>
    </MaintenanceWindow>
    <Version>16.20.0.114</Version>
Beispiel für ein Wartungsfenster welches nur am Sonntag aktiv ist:
<MaintenanceWindow> 
  <Enabled>true</Enabled> 
  <Start>06:00:00</Start> 
  <Stop>08:00:00</Stop> 
  <WeekdayRestriction>Sun</WeekdayRestriction> 
</MaintenanceWindow>
Beispiel für zwei Wartungsfenster. Eines am Sonntag und eines am Mittwoch:
<MaintenanceWindow> 
  <Enabled>true</Enabled> 
  <Start>06:00:00</Start> 
  <Stop>08:00:00</Stop> 
  <WeekdayRestriction>Sun</WeekdayRestriction> 
</MaintenanceWindow> 
<MaintenanceWindow> 
  <Enabled>true</Enabled> 
  <Start>21:00:00</Start> 
  <Stop>23:00:00</Stop> 
  <WeekdayRestriction>Wed</WeekdayRestriction> 
</MaintenanceWindow>