Zum Inhalt springen

Jitterbit-Konfigurationsdatei für private Agenten jitterbit.conf

Einführung

Diese Seite beschreibt die Hauptkonfigurationsdatei für private Agenten, jitterbit.conf. Sie befindet sich im Installationsverzeichnis (JITTERBIT_HOME), standardmäßig C:\Program Files\Jitterbit Agent\ unter Microsoft Windows, /opt/jitterbit/ unter Linux und Docker.

Die Datei verwendet das [INI-Dateiformat], in dem Abschnittsnamen in eckigen Klammern stehen und jeder Abschnitt eine Liste von Schlüssel-Wert-Paaren ist. Abschnitte können in beliebiger Reihenfolge in der Datei angeordnet werden. (Diese Seite ordnet Abschnitte alphabetisch, aber in der Standarddatei ist dies nicht der Fall.) Falls Abschnitte oder Schlüssel in der Datei nicht vorhanden sind, müssen diese hinzugefügt werden; einige werden in der Standarddatei nicht bereitgestellt. Für Schlüssel, die nicht vorhanden oder auskommentiert sind (mit einem führenden #), gilt der Standardwert. Boolesche Werte können als 0/1 oder false/true angegeben werden. Pfade verwenden Schrägstriche, auch bei der Angabe von Windows-Speicherorten.

Wichtig

Änderungen an der Datei werden erst angewendet, nachdem der Agent neu gestartet wurde, und werden beim Upgrade nicht überschrieben.

[AgentCapability]

Diese Einstellungen gelten für native und Drittanbieter-Funktionen zur Observability privater Agenten.

Speichernutzungsmetriken werden nur auf Windows-Agenten erfasst. Auf Linux-Agenten wird die Speichernutzung nicht bei der Berechnung der Funktionsfähigkeit verwendet, und die Speichereinstellungen in diesem Abschnitt haben keine Auswirkung.

Apache verarbeitet nur API-Anfragen, daher sind die Apache-Thread-Einstellungen in diesem Abschnitt nur auf einem Agent relevant, der APIs verarbeitet.

Wenn CPU- oder Speichernutzungsmetriken aktiviert sind, überschreiben diese die anderen Eingaben zur Funktionsfähigkeit: Wenn einer von beiden seinen Schwellenwert überschreitet, meldet der Agent sich als nicht funktionsfähig, unabhängig von der Verfügbarkeit von Apache-Threads oder Prozessmotor-Worker-Threads.

Wichtig

Keine Werte in diesem Abschnitt ändern, es sei denn, der Jitterbit-Support weist dies an.

Schlüssel Standard Beschreibung
ApacheThreadBuffer 10 Apache-Thread-Limit-Puffer.
ApacheThreadCapabilityDebugOutput false Wenn true, zusätzliche Apache-Fehlerbehebungsprotokolle ausgeben.
ApacheThreadCapabilityEnabled false Wenn true, Apache-Thread-Nutzungsmetrik aktivieren, um den Funktionsfähigkeitsstatus des Agenten zu bestimmen.
ApacheThreadCapabilityReportInterval 2 Häufigkeit der Überprüfung der Apache-Thread-Nutzung (Sekunden).
CapabilityDebugOutput false Wenn true, zusätzliche Fehlerbehebungsprotokolle zur Funktionsfähigkeit ausgeben.
CapabilityRefreshCooldown 1 Nach dem Übergang eines Agenten in den Status „nicht funktionsfähig" die Abkühlungszeit (Sekunden) vor der Aktualisierung des Funktionsfähigkeitsstatus. Standardwert in Agent-Version 12.7 von 2 auf 1 geändert.
CpuConsecutiveFailureThreshold 3 Anzahl der aufeinanderfolgenden CPU-Schwellenwertüberschreitungen, die erforderlich sind, damit der Agent von funktionsfähig zu nicht funktionsfähig wechselt. Gilt nur, wenn CpuUsageCapabilityEnabled auf true gesetzt ist. Standardwert in Agent-Version 12.7 von 1 auf 3 geändert.
CpuUsageCapabilityDebugOutput false Wenn true, CPU-Funktionsfähigkeits-Debug-Protokolle in der Prozessmotor-Protokolldatei aktivieren. Wenn false, nur Änderungen des CPU-Funktionsfähigkeitsstatus protokollieren.
CpuUsageCapabilityEnabled false Wenn true, IncapableCpuUsage-Metrik aktivieren, um den Funktionsfähigkeitsstatus des Agenten zu bestimmen.
CpuUsageCapabilityReportInterval 1 Häufigkeit der Überprüfung des CPU-Prozentsatzes (Sekunden).
EnhancedCapabilityMetricsEnabled false Wenn true, Logik für Agent-Funktionsfähigkeitsmetriken aktivieren.
EnhancedCapabilityMetricsJMXEnabled true Wenn true, JMX-Metrik für Funktionsfähigkeit aktivieren.
EnhancedCapabilityMetricsSubmissionEnabled false Wenn true, EnhancedCapabilityMetricsEnabled auf true setzen und Funktionsfähigkeitsmetriken an Harmony senden.
IncapableCpuUsage 95 CPU-Prozentsatz, bei dem der Agent nicht funktionsfähig wird. Wird ignoriert, wenn CpuUsageCapabilityEnabled nicht auf true gesetzt ist.
IncapableMemoryUsage 95 Speicherprozentsatz, bei dem der Agent nicht funktionsfähig wird. Wird ignoriert, wenn MemoryUsageCapabilityEnabled nicht auf true gesetzt ist.
MemoryUsageCapabilityDebugOutput false Wenn true, zusätzliche Speicher-Fehlerbehebungsprotokolle ausgeben.
MemoryUsageCapabilityEnabled false Wenn true, IncapableMemoryUsage-Metrik aktivieren, um den Funktionsfähigkeitsstatus des Agenten zu bestimmen.
MemoryUsageCapabilityReportInterval 1 Häufigkeit der Überprüfung des Speicherprozentsatzes (Sekunden).

[AgentMetrics]

Diese Einstellungen gelten nur für die Funktion native Observability.

Key Standard Beschreibung
Enabled false Bei true wird die Verwendung anderer Keys in diesem Abschnitt ermöglicht. Bei false werden die Werte anderer Keys in diesem Abschnitt ignoriert.
JitterbitMetricsServiceEnabled false Bei true wird der Metriken-Erfassungsdienst gestartet.
UserIntentFileWatcherEnabled true Bei true und wenn sowohl Enabled als auch JitterbitMetricsServiceEnabled auf true gesetzt sind, wird ein Datei-Watcher-Dienst gestartet, der die neueste Benutzeraktion erfasst.
OperationStatusLogToFileEnabled false Bei true werden Operationsstatus in eine Datei protokolliert. (Verschoben und umbenannt von EnableAgentMetricLogging in [MetricLogging].)
OperationStatusLogToFileAsyncEnabled true Bei true und wenn OperationStatusLogToFileEnabled auf true gesetzt ist, wird asynchron mit separaten Threads protokolliert. (Verschoben und umbenannt von EnableAgentMetricLogging in [MetricLogging]) Nicht ändern, es sei denn, der Jitterbit-Support weist dies an.
AgentEnvSyncProgressToFileEnabled false Bei true wird der Agent-Synchronisierungsprozess in eine Datei protokolliert. (Verschoben und umbenannt von EnableAgentSyncMetricLogging in [MetricLogging].)
SchedulerMetricThreads 100 Größe des Metriken-Scheduler-Thread-Pools.
ProcessEngineMetricThreads Wert von MaxNumberOfWorkerThreads in [ProcessEngine] Größe des Metriken-Prozessmodul-Thread-Pools.
OperationEngineMetricThreads (Keine) Wenn RunOperationsInSeparateProcess=true, wird diese Anzahl von Threads aus dem Thread-Pool verwendet.

[APIInfo]

Diese Einstellung gilt für Operationen, die von einem API Manager OData API ausgelöst werden.

Key Standard Beschreibung
DebugJDML false Bei true wird zusätzliche Protokollierung von OData API-Aufrufen im API Manager ermöglicht, einschließlich SQL, das an die Datenbank gesendet wird.

[APIOperation]

Diese Einstellungen gelten für Operationen, die durch einen benutzerdefinierten API oder OData-API des API Manager ausgelöst werden.

Schlüssel Standard Beschreibung
EnableErrorLogging true Protokolliert nur API-Operationsfehler in Operationsprotokollen. Wird ignoriert, wenn EnableLogging auf true gesetzt ist.
EnableLogging false Protokolliert alle durch API ausgelösten Operationen (erfolgreich und erfolglos) in Operationsprotokollen. Dies bietet eine Kontrolle auf Agent-Ebene, ähnlich wie das Aktivieren von Operationsdebug-Protokollierung für einzelne Operationen. Falls true, hat dies Vorrang vor EnableErrorLogging. Weitere Details zur API-Operationsprotokollierung finden Sie unter API-Anfrage- und Antwortdaten.
EnableOperationIdLogging false Protokolliert die ID einer Operation, die einen Absturz verursacht.
APIOperationLogging false Protokolliert den Start und die verstrichene Zeit eines API-Aufrufs.

Caution

Turning on this setting generates at least four additional lines for each API operation, which can result in very large log files.

[AutoScaling]

Schlüssel Standard Beschreibung
DeregisterAgentOnDrainstop false Deregistriert den Agent beim Stoppen. Entspricht deregisterAgentOnDrainstop in register.json.
DeregisterAgentOnJVMShutdown true Deaktiviert die Deregistrierung beim JVM-Herunterfahren, wenn die Deregistrierung über automatische Registrierung oder DeregisterAgentOnDrainstop aktiviert ist.

[ConnectorsInfo]

Schlüssel Standard Beschreibung
MSAXUrl http://127.0.0.1:8002/AX/ Wird vom Microsoft Dynamics AX Connector verwendet. Nicht ändern, es sei denn, der Jitterbit-Support weist dies an.
MSCrmUrl http://127.0.0.1:8000/CRM/ Wird vom Microsoft Dynamics CRM Connector verwendet. Nicht ändern, es sei denn, der Jitterbit-Support weist dies an.
jitterbit.connectorcall.timeout 300 Timeout für Connector-Aufrufe (Sekunden) für bestimmte Connectoren. Nicht ändern, es sei denn, der Jitterbit-Support weist dies an.
jitterbit.connector.disable.file.watcher false Falls true, deaktiviert den Connector-Datei-Watcher. Nicht ändern, es sei denn, der Jitterbit-Support weist dies an.
jitterbit.connector.max.recent.connector.lookup 15 Maximale Anzahl der zu speichernden MD5-Connector-Checksummen. (Falls die Checksumme für einen neuen Connector einer vorhandenen entspricht, wird der Download übersprungen.)
jitterbit.connector.max.temp.file.write.attempts 30 Maximale Anzahl der Versuche, eine temporäre Connector-Datei zu verschieben.

[DbDrivers]

Dieser Abschnitt gibt die Standard-Sonderzeichen an, die zum Begrenzen von Namen in einigen Treibern verwendet werden, die vom Database-Connector unterstützt werden. Unterstützte Trennzeichen sind: / . \* = ? | ( ) [ ] { }.

Schlüssel und Werte werden in einfache Anführungszeichen gesetzt, und Sonderzeichen werden mit \ escaped.

Schlüssel Standard
DataDirect 32-BIT SequeLink 5.4 Quote Begin \"
DataDirect 32-BIT SequeLink 5.4 Quote End \"
Excel Quote Begin [
Excel Quote End ]
IBM DB2 (AS400) Quote Begin \"
IBM DB2 (AS400) Quote End \"
Microsoft Access Driver (*.mdb) Quote End ]
Microsoft Excel Driver (*.xls) Quote Begin [
Microsoft Excel Driver (*.xls) Quote End ]
Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb) Quote Begin [
Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb) Quote End ]
Microsoft ODBC for Oracle Quote Begin \"
Microsoft ODBC for Oracle Quote End \"
Microsoft Quote Begin [
MySQL ODBC 3.51 Driver Quote Begin `
MySQL ODBC 3.51 Driver Quote End `
MySQL ODBC 5.1 Driver Quote Begin `
MySQL ODBC 5.1 Driver Quote End `
MySQL Quote Begin `
MySQL Quote End `
Oracle ODBC Driver Quote Begin \"
Oracle ODBC Driver Quote End \"
Oracle Quote Begin \"
Oracle Quote End \"
Oracle in OraClient10g_home2 Quote Begin \"
Oracle in OraClient10g_home2 Quote End \"
Oracle in XE Quote Begin \"
Oracle in XE Quote End \"
PostgreSQL ANSI Quote Begin \"
PostgreSQL ANSI Quote End \"
PostgreSQL Quote Begin \"
PostgreSQL Quote End \"
PostgreSQL Unicode Quote Begin \"
PostgreSQL Unicode Quote End \"
PostgreSQL-psql Quote Begin \"
PostgreSQL-psql Quote End \"
SQL Server Quote Begin [
SQL Server Quote End ]

[DbInfo]

Key Default Description
User jitterbit Benutzername für lokale PostgreSQL-Datenbank.
DisableOdataCount false Deaktiviert die Einstellungen $count und $inlinecount in eingehenden OData-Abfragen. Auf true setzen, wenn die Datenbankzählfunktion Leistungsprobleme verursacht.
Password None Passwort für lokale PostgreSQL-Datenbank. Bei jeder Installation wird ein neues Passwort generiert, auch auf demselben Host. Das Passwort im Docker-Hub-Image ändert sich zwischen Versionen und ist für alle Container basierend auf einem Image gleich.
Driver 'PostgreSQL Unicode(x64)' Windows-Standard.
'PostgreSQL-jitterbit' Linux-Standard.
SystemDbName 'postgres' Name der PostgreSQL-Systemdatenbank.
Server 127.0.0.1 Hostname oder IP-Adresse des PostgreSQL-Servers.
Port 6432 Standard-PostgreSQL-Server-Port. (6543 auf Private-Agent-Version 10.60 oder älter.)
UseInternalPooling true Bei true wird internes Datenbankverbindungs-Pooling aktiviert, um die Agent-Leistung zu optimieren.
  • Windows, Neuinstallation (Agent 12.5 und später): Das Installationsprogramm schreibt diesen Schlüssel mit dem Wert true.
  • Windows, Upgrade (auf Agent 12.5 und später): Wenn der Schlüssel nicht bereits in der Datei definiert ist, fragt das Installationsprogramm, ob er aktiviert werden soll.
  • Linux (Agent 12.9 und später): Wenn der Schlüssel in der Datei fehlt, wird standardmäßig true verwendet.
  • Alle anderen Fälle: Wenn der Schlüssel fehlt, gilt false.

[Debug]

Key Default Description
WebServiceDebugFile '' Absoluter Pfad zur Debug-Datei der Backend-Webservices. Bei einer leeren Zeichenkette ist die Protokollierung deaktiviert. Der Pfad muss Schrägstriche verwenden, auch unter Windows. Das Verzeichnis muss vorhanden sein und Lese-/Schreibberechtigungen für den Agent haben.

[ErrorHandling]

Dieser Abschnitt konfiguriert die Behandlung möglicher Fehlersituationen im Backend. Mögliche Werte sind:

  • Ok: Die Situation ist normal; fortfahren wie gewohnt.
  • Warning: Eine Warnung protokollieren und fortfahren.
  • Error: Die Situation ist kritisch.
Schlüssel Standard Beschreibung
NoRowsAffectedOnDbUpdates Ok Eine Update-Anweisung in einem Datenbankziel, die keine Zeilen betrifft, ist Ok gemäß der obigen Definition.
NoTargetDataGenerated Ok Keine generierten Zieldaten ist Ok gemäß der obigen Definition.
NoWebServiceRequestData Warning Keine verfügbaren Daten zum Generieren einer gültigen Webservice-Anfrage generiert eine Warning gemäß der obigen Definition.
EmptyDatabaseSource Warning Eine flache Datenbankquelle ist leer generiert eine Warning gemäß der obigen Definition.

[FileCleanup]

Schlüssel Standard Beschreibung
AutoStart true Startet die Datenbereinigungs-Routinen.
SleepTimeInSeconds 5 Wartezeit für Datenbereiniging (Sekunden).
FrequencyInHours 24.0 Datenbereinigungsintervall (Stunden).

[HttpConnectionPool]

Dieser Abschnitt wird mit Proxy-Einstellungen zum Aufrufen externer Ressourcen verwendet.

Schlüssel Standard Beschreibung
MaxConnections 50 Maximale Anzahl der Gesamtverbindungen im Pool. Bei 0 oder weniger wird der Standardwert der Apache HttpClient-Bibliothek verwendet.
MaxConnectionsPerRoute 5 Maximale Anzahl der Verbindungen pro Route. Bei 0 oder weniger wird der Standardwert der Apache HttpClient-Bibliothek verwendet.
TimeoutInSeconds 60 Pool-Verbindungs-Timeout (Sekunden). Bei 0 oder weniger wird der Standardwert der Apache HttpClient-Bibliothek verwendet.
HttpSocketTimeoutInSeconds 180 Client-Socket-Timeout (Sekunden), die Zeit, die der Client-Socket nach dem Herstellen der Verbindung und dem Senden einer Anfrage auf eine Antwort wartet. Bei 0 oder weniger wird der Standardwert der Apache HttpClient-Bibliothek verwendet.
HttpConnectionTimeoutInSeconds 180 Timeout (Sekunden) zum Warten auf die Verbindung mit dem Remote-Host.

[HttpConnectionPoolLocal]

Dieser Abschnitt wird mit lokalen Ressourcen (SOAP-Services, API) verwendet.

Schlüssel Standard Beschreibung
MaxConnections 50 Maximale Anzahl der Gesamtverbindungen im Pool. Bei 0 oder weniger wird der Standardwert der Apache HttpClient-Bibliothek verwendet.
MaxConnectionsPerRoute 50 Maximale Anzahl der Verbindungen pro Route. Bei 0 oder weniger wird der Standardwert der Apache HttpClient-Bibliothek verwendet.
TimeoutInSeconds 60 Pool-Verbindungs-Timeout (Sekunden). Bei 0 oder weniger wird der Standardwert der Apache HttpClient-Bibliothek verwendet.
HttpSocketTimeoutInSeconds 180 Client-Socket-Timeout (Sekunden) (Zeit, die der Client-Socket nach dem Herstellen der Verbindung und dem Senden einer Anfrage auf eine Antwort wartet). Bei 0 oder weniger wird der Standardwert der Apache HttpClient-Bibliothek verwendet.
HttpConnectionTimeoutInSeconds 180 Timeout (Sekunden) zum Warten auf die Verbindung mit dem Remote-Host.

Tipp

Wenn Sie MaxConnections und MaxConnectionsPerRoute auf 100 setzen, nehmen Sie diese zusätzlichen Änderungen vor:

  1. Bearbeiten Sie die Datei jitterbit-agent-config.properties und setzen Sie:

    max.concurrent.requests=100

  2. Bearbeiten Sie die Datei httpd.conf und setzen Sie:

    ThreadsPerChild 101

[HttpEndPoints]

Schlüssel Standard Beschreibung
EnableErrorLogging true Fehler bei gehosteten HTTP-Endpunkten im Operationsprotokoll protokollieren. Wird ignoriert, wenn EnableLogging auf true gesetzt ist.
EnableLogging true Alle HTTP-Endpunktaufrufe im Aktivitätsprotokoll protokollieren.

[JavaBackend]

Schlüssel Standard Beschreibung
DebugLogLevel (Keine) Tomcat-Debug-Protokollebene (SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, OFF, ALL). Tomcat-Serverprotokolle werden in JITTERBIT_HOME/tomcat/logs geschrieben. Siehe CleanupRules.xml für Löschzeiträume von Protokolldateien.

[JavaUiBackend]

Schlüssel Standard Beschreibung
LogLevel OFF Java (Tomcat) UI-Protokollebene (SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, OFF, ALL). Tomcat-Serverprotokolle werden in JITTERBIT_HOME/tomcat/logs geschrieben. Siehe CleanupRules.xml für Löschzeiträume von Protokolldateien.

[JDBCEngine]

Schlüssel Standard Beschreibung
SessionTimeout 60 Timeout für offene JDBC-Sitzungen (Minuten).
ClientSessionTimeout 180 Maximale JDBC-Operationsdauer (Minuten).
LogLevel INFO JDBC-Engine-Protokollebene (SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, OFF, ALL). Tomcat-Serverprotokolle werden in JITTERBIT_HOME/tomcat/logs geschrieben. Siehe CleanupRules.xml für Löschzeiträume von Protokolldateien.

[JdbcSecurity]

Dieser Abschnitt wurde in Agent-Version 12.10 hinzugefügt. Er schränkt JDBC-Verbindungszeichenfolgen und Verbindungen für den Datenbankkonnektor aus Sicherheitsgründen ein.

Schlüssel Standard Beschreibung
block.localhost.connections true Blockiert eine Datenbankverbindung zu localhost oder 127.0.0.1, wenn auf true gesetzt. Setzen Sie auf false, um eine Datenbankverbindung zu einer Datenbank zuzulassen, die auf demselben Host wie der Agent ausgeführt wird.
mysql.blocked.params Siehe unten MySQL-JDBC-Verbindungszeichenfolgen-Parameter, die immer abgelehnt werden.
mysql.forced.false.params Siehe unten MySQL-JDBC-Verbindungszeichenfolgen-Parameter, die abgelehnt werden, wenn sie in der Verbindungszeichenfolge auf true gesetzt sind.
postgresql.blocked.params Siehe unten PostgreSQL-JDBC-Verbindungszeichenfolgen-Parameter, die immer abgelehnt werden.
oracle.blocked.params Siehe unten Oracle-JDBC-Verbindungszeichenfolgen-Parameter, die immer abgelehnt werden.
sqlserver.blocked.params Siehe unten SQL Server-JDBC-Verbindungszeichenfolgen-Parameter, die immer abgelehnt werden.

Im Folgenden wird der vollständige Abschnitt mit seinen Standardwerten angezeigt. Um eine bestimmte Verbindung oder einen bestimmten Parameter zuzulassen und den Rest eingeschränkt zu halten, kopieren Sie ihn und entfernen Sie diesen Parameter aus dem Wert des relevanten Schlüssels:

[JdbcSecurity]
block.localhost.connections=true
mysql.blocked.params=queryinterceptors,statementinterceptors,propertiestransform,socketfactory,socksproxyhost
mysql.forced.false.params=allowLoadLocalInfile,allowLocalInfile,allowUrlInLocalInfile,autoDeserialize,allowMultiQueries
postgresql.blocked.params=socketfactory,socketfactoryarg,sslfactory,sslfactoryarg,sslhostnameverifier,sslpasswordcallback,authenticationpluginclassname,loggerfile,loggerlevel
oracle.blocked.params=oracle.net.tns_admin,oracle.net.wallet_location
sqlserver.blocked.params=socketfactoryclass

Um jeden Parameter für einen Schlüssel zuzulassen, setzen Sie ihn auf einen leeren Wert (z. B. mysql.blocked.params=).

Warnung

Das Auskommentieren eines der fünf *.blocked.params- oder *.forced.false.params-Schlüssel (mit einem führenden #) stellt die Standardeinschränkung nicht wieder her. Es hat die gleiche Wirkung wie das Setzen des Schlüssels auf einen leeren Wert: Jeder Parameter für diesen Schlüssel wird zugelassen. Um die Standardeinschränkung nach dem Hinzufügen dieses Abschnitts wiederherzustellen, löschen Sie die Zeile des Schlüssels vollständig, oder kommentieren Sie die [JdbcSecurity]-Zeile selbst aus, wodurch jeder Schlüssel im Abschnitt auf seinen Standard zurückgesetzt wird.

[JsonParser]

Dieser Abschnitt wurde in Agent-Version 12.5 hinzugefügt.

Schlüssel Standard Beschreibung
MaxStringLength 20000000 Maximale Anzahl von Zeichen, die in einem einzelnen JSON-Zeichenfolgenwert zulässig sind. Operationen, die JSON-Zeichenfolgen verarbeiten, die diesen Grenzwert überschreiten, schlagen mit einem StreamConstraintsException-Fehler fehl. Erhöhen Sie diesen Wert, wenn Sie größere JSON-Payloads verarbeiten müssen (z. B. auf 50000000 für ein 50-MB-Limit setzen).

[LDAP]

Verwenden Sie diesen Abschnitt, um UTF-8-Unterstützung für Microsoft Windows und Active Directory mit Windows-Private-Agents hinzuzufügen.

Schlüssel Standard Beschreibung
CharacterEncoding ISO-8859-1 LDAP-Zeichenkodierung.

Tipp

Wenn Sie die LDAPReplace()-Funktion verwenden, um einen Wert in einem Active Directory wie unten gezeigt zu ersetzen, kann es vorkommen, dass der Text in ein anderes Ergebnis als der Eintrag konvertiert wird, z. B. dass François durch FrançOis ersetzt wird:

LdapReplace("givenName", "François");

Fügen Sie in solchen Fällen diesen Abschnitt hinzu und starten Sie den Agent neu.

Weitere Informationen finden Sie unter Studio LDAP-Funktionen oder Design Studio LDAP-Funktionen.

[Masking]

Dieser Abschnitt wurde in Agent-Version 11.59 / 12.3 hinzugefügt. Diese Einstellungen können verwendet werden, um benutzerdefinierte Request-Header in Studio HTTP-Aktivitäten und Design Studio HTTP-Quellen und Zielen zu maskieren. Wenn ein Request-Header maskiert wird, werden maskierte Werte in Runtime-Protokollen als ***REDACTED*** angezeigt.

Schlüssel Standard Beschreibung
HttpRequestHeaders true Wenn false, werden Request-Header, die in RequestHeaders bereitgestellt werden, nicht maskiert.
RequestHeaders Kommagetrennte Liste benutzerdefinierter Request-Header, die maskiert werden sollen (z. B. security_key,test_header,test_header2).

Beachten Sie, dass die folgenden Request-Header bereits standardmäßig in Runtime-Protokollen maskiert sind und diese Einstellungen nicht erfordern:

Kategorie Header-Name
Authentifizierung und Token authorization
proxy-authorization
x-api-key
x-auth-token
x-access-token
x-refresh-token
x-session-token
x-id-token
x-client-secret
Cookies und CSRF cookie
x-csrf-token
x-xsrf-token
PII (GDPR / CCPA) x-user-id
x-user-email
x-user-name
x-user-phone
x-user-address
x-customer-id
x-employee-id
x-national-id
x-date-of-birth
x-ip-address
x-forwarded-for
x-real-ip
x-originating-ip
Zahlungen (PCI-DSS) x-card-number
x-card-cvv
x-card-expiry
x-bank-account
x-payment-token
Gesundheit (HIPAA) x-patient-id
x-medical-record
x-health-plan-id
x-diagnosis-code
Interne Weiterleitung und Trace x-internal-ip
x-backend-server
x-cluster-node
x-request-id
x-correlation-id

[MetricLogging]

Wichtig

Dieser Abschnitt ist seit Private Agent Version 11.41 veraltet und wird in einer späteren Version entfernt. Die Schlüssel wurden in den Abschnitt [AgentMetrics] verschoben, wobei einige Schlüssel umbenannt wurden. Weitere Informationen finden Sie in diesem Abschnitt.

Schlüssel Standard Beschreibung
EnableAgentMetricLogging false Wenn true, ist die Agent-Metrik-Protokollierung aktiviert.
EnableAgentMetricAsyncLogging true Wenn true, wird die Protokollierung asynchron durchgeführt. Nicht ändern, es sei denn, der Jitterbit-Support weist dies an.
EnableAgentSyncMetricLogging Wenn true, wird die Synchronisierungsmetrik-Protokollierung aktiviert.
SchedulerMetricThreads 100 Größe des Thread-Pools des Metrik-Schedulers.
ProcessEngineMetricThreads Wert von MaxNumberOfWorkerThreads in [ProcessEngine] Größe des Thread-Pools der Metrik-Verarbeitungs-Engine.
OperationEngineMetricThreads (Keine) Wenn RunOperationsInSeparateProcess=true, diese Anzahl von Threads aus dem Thread-Pool verwenden.

[OperationEngine]

Schlüssel Standard Beschreibung
Debug false Debug-Modus aktivieren. Sowohl der Wert Debug als auch WriteLog müssen auf 1 gesetzt sein, damit Protokolle generiert werden.
AlwaysRunSuccessOperation false Vorgänge immer erfolgreich ausführen, auch wenn keine Daten vorhanden sind.
TemporaryStorageRootDirectory (Keine) Absoluter Pfad zum Stammverzeichnis des temporären Speichers. Wenn nicht angegeben, wird TemporaryStorage an den Wert für TempDir angehängt (C:\Windows\Temp\jitterbit\TemporaryStorage für Windows, /tmp/jitterbit/TemporaryStorage für Linux). Der Pfad muss Schrägstriche verwenden, auch unter Windows. Das Verzeichnis muss vorhanden sein und Lese-/Schreibberechtigungen für den Agent haben.
MaxNumberOfOperationThreads (Keine) Maximale Anzahl von Vorgangs-Threads. Wenn nicht angegeben, ist die Anzahl der Vorgangs-Threads unbegrenzt.
MaxOperationStackDepth 50 Maximale Anzahl verschachtelter synchroner Vorgangsaufrufe. Wenn 0 oder eine negative Zahl, ist das Maximum unbegrenzt.
MaxAsyncOperationChainLength 50 Maximale Anzahl asynchroner Vorgänge, die in einer einzelnen Kette zulässig sind (um unendliche Vorgangsschleifen zu vermeiden). Wenn 0 oder eine negative Zahl, ist das Maximum unbegrenzt.
MaxAsyncOperationChainLengthOverrideAllowed true Überschreiben Sie die maximale Länge der asynchronen Vorgangskette, indem Sie die jitterbit.operation.max_async_chain_length Jitterbit-Variable festlegen.
AlwaysDeleteTempDir false Temporäre Dateien löschen, auch bei Fehler.

Vorsicht

Wenn die Debug-Protokollierung für Vorgänge aktiviert ist, führt das Setzen dieses Werts auf true dazu, dass Komponenteneingabe- und -ausgabedaten nicht generiert werden, da temporäre Vorgangsdateien gelöscht werden, bevor der Verbose Log Shipper-Dienst diese erfassen kann.
WriteLog 0 Zusätzliche Prozessmeldungen für API- und geplante Vorgänge in die Protokolldatei schreiben aktivieren (1) oder deaktivieren (0).

[PredefinedGlobalVariables]

Jede Jitterbit-Variable kann in diesem Abschnitt festgelegt werden, um standardmäßig auf die gesamte Agent-Gruppe angewendet zu werden. Um eine Jitterbit-Variable auf Operationsebene festzulegen, siehe Jitterbit-Variablen in Skripten oder Transformationen festlegen.

Die folgende Tabelle zeigt Beispiele für Jitterbit-Variablen, die in diesem Abschnitt festgelegt werden können. Diese Liste ist nicht vollständig. Weitere Informationen finden Sie in der Jitterbit-Variablendokumentation für jede einzelne Variable.

Schlüssel Standard Beschreibung
jitterbit.http.enable_cookies false Aktiviert Cookies für HTTP-Verbindungen.
jitterbit.scripting.db.auto_commit true Führt automatisch einen Commit für Datenbankskripte durch. Bei false werden Datenbanktransaktionen verwendet.
jitterbit.scripting.db.max_rows 10000 Maximale Anzahl betroffener Datenbankzeilen. Gilt für DBExecute, DBLookup und DBLookupAll Studio-Datenbankfunktionen oder Design Studio-Datenbankfunktionen.
jitterbit.scripting.ldap.include_dn_in_results false Bei true wird der Distinguished Name (DN) in Active Directory einbezogen.
jitterbit.scripting.ldap.max_search_results 1 Maximale Anzahl zurückgegebener LDAP-Suchergebnisse.
jitterbit.scripting.ldap.return_null_if_no_results false Bei true geben LDAP-Abfragen ohne übereinstimmende Datensätze einen einzelnen NULL-Wert zurück.
jitterbit.scripting.ldap.scope 1 Aktiviert (1) oder deaktiviert (0) LDAP.
jitterbit.scripting.ldap.use_paged_search false Aktiviert die seitenweise LDAP-Suche in Skripten. Bei true ruft Jitterbit Daten seitenweise ab und vermeidet die Überschreitung von Active Directory-Limits.
jitterbit.scripting.nesting.max 10 Maximale Anzahl verschachtelter Skripte.
jitterbit.scripting.while.max_iterations 50000 Jitterbit-Skript-Iterationslimit.
jitterbit.source.db.preserve_char_whitespace false Behält die führenden und nachfolgenden Leerzeichen der Quelldatenbank bei.
jitterbit.source.ftp.transfer_timeout 3600 FTP-Quellen-Übertragungszeitüberschreitung (Sekunden).
jitterbit.source.text.csv_nullable false Ermöglicht Nullwerte in CSV-Textdateien.
jitterbit.target.db.include_null_in_sql_statement false Bezieht Nullwerte in die SQL-Anweisungen der Zieldatenbank ein.
jitterbit.target.ftp.transfer_timeout 3600 FTP-Ziel-Übertragungszeitüberschreitung (Sekunden).
jitterbit.target.http.remove_trailing_linebreaks true Entfernt nachfolgende Zeilenumbrüche vor dem Posten von Zieldaten.
jitterbit.target.xml.num_for_bool false Bei true werden boolesche XML-Werte als 0 und 1 dargestellt. Bei false wird false und true verwendet.

[PredefinedServerGlobalDataElement]

Key Standard Beschreibung
(Benutzerdefiniert) (Benutzerdefiniert) Benutzerdefinierte vordefinierte globale Variablen, die für jeden Vorgang initialisiert werden, der auf dem Agent startet.

[ProcessEngine]

Key Standard Beschreibung
MaxNumberOfWorkerThreads auto Anzahl der Worker-Threads (1 bis 200). Bei auto entspricht die Anzahl dem Doppelten der Prozessorkerne.
RunOperationsInSeparateProcess true Bei true ist die Laufzeit des Vorgangs unbegrenzt. Verwenden Sie MaxOperationRuntimeSeconds, um ein Laufzeitlimit festzulegen.
MaxOperationRuntimeSeconds (Keine) Maximale Laufzeit des Vorgangs (Sekunden). Wird ignoriert, wenn RunOperationsInSeparateProcess auf false gesetzt ist.
MaxOperationRuntimeMessage (Keine) Meldung, die angezeigt wird, wenn das Laufzeitlimit erreicht ist. Wird ignoriert, wenn RunOperationsInSeparateProcess auf false gesetzt ist.
EnableDebugDump false Falls nicht angegeben, wird DebugDumpDir standardmäßig auf die Einstellung TempDir unter [Settings] gesetzt.
DebugDumpDir (Keine) Absoluter Pfad zum Debug-Dump-Verzeichnis. Falls nicht gesetzt, wird der Wert für TempDir verwendet. Wird ignoriert, wenn EnableDebugDump nicht auf true gesetzt ist. Der Pfad muss Schrägstriche verwenden, auch unter Windows. Das Verzeichnis muss vorhanden sein und Lese-/Schreibberechtigungen für den Agent haben.

[ResultFiles]

Key Standard Beschreibung
DisableSuccess false Erfolgsdateien erstellen.
DisableFailure false Fehlerdateien erstellen.

[Scheduler]

Key Standard Beschreibung
AutoStart 1 Automatisches Starten des Schedulers aktivieren (1) oder deaktivieren (0).
SleepTimeInSeconds 5 Ruhezeit (Sekunden).
WriteLog 0 Scheduler-Debug-Protokollierung aktivieren (1) oder deaktivieren (0). Die Protokolldatei scheduler_debug.log befindet sich im Verzeichnis, das durch den Wert für TempDir angegeben ist.

[Settings]

Key Standard Beschreibung
TempDir (Keine) Absoluter Pfad zu einem temporären Verzeichnis. Falls leer, verwenden temporäre Dateien das Temp-Verzeichnis des Betriebssystems (%temp%\jitterbit unter Windows, /tmp/jitterbit unter Linux). Der Pfad muss Schrägstriche verwenden, auch unter Windows. Das Verzeichnis muss vorhanden sein und Lese-/Schreibberechtigungen für den Agent haben.
CurlDebugDir (Keine) Absoluter Pfad zur curl-Protokolldatei für FTP-, SFTP-, HTTP- und HTTPS-Anfragen. Eine Datei wird pro Anfrage erstellt. Protokolldateinamen sind GUID mit einer .txt-Erweiterung. Der Pfad muss Schrägstriche verwenden, auch unter Windows. Das Verzeichnis muss vorhanden sein und Lese-/Schreibberechtigungen für den Agent haben.
CurlDefaultSSLVersionMax true Bei true wird die Option --tls-max verwendet (gilt für curl 7.54.0 und höher).
EnableLocalFileLocation false Ermöglicht die Erstellung lokaler Dateien. Erforderlich für den Local Storage-Connector, Trigger-Dateien oder Erfolgs-/Fehlerordner, die auf anderen Connectoren konfiguriert sind.
JavaScriptMaxIterations 50000 Maximale Anzahl der pro Skript zulässigen Schleifeniterationen.
RecoverableStatusCode 500, 502, 503, 504 Wenn gesetzt und die Option Wiederholung in einer HTTP-Verbindung ausgewählt ist, wird die Aktivität von den aufgelisteten Fehlercodes wiederhergestellt und die Aktivität erneut versucht.
EnableAPITimeout false Bei true verwenden Vorgänge, die von API Manager-APIs ausgelöst werden, die Timeout-Einstellungen des Vorgangs.
TargetHttpRemoveTrailingLinebreaks false Bei true werden die CR/LF am Ende von Zeilen in HTTP-Connector-Post-Transformationen entfernt.
AllowUnsafeLegacyRenegotiation false Bei true wird unsichere Legacy-TLS-Renegotiation während des Verbindungs-Handshakes mit dem Server zugelassen. Erforderlich, um den Fehler error:0A000152:SSL routines::unsafe legacy renegotiation disabled. zu vermeiden. Unterstützt mit Agents Version 11.39 und später.

[Settings/XMLSchemas]

Diese Einstellungen definieren die Speicherorte der verfügbaren XML-Schemas.

Schlüssel Standard
Schema_2001 JITTERBIT_HOME/DataInterchange/xml_dtd/Schemas/XMLSchema_2001.xsd
Schema_1999 JITTERBIT_HOME/DataInterchange/xml_dtd/Schemas/XMLSchema_1999.xsd
SoapEncoding JITTERBIT_HOME/DataInterchange/xml_dtd/Schemas/SOAP_Encoding.xsd
WSDL JITTERBIT_HOME/DataInterchange/xml_dtd/Schemas/WSDL.xsd
SoapEncoding_v11 JITTERBIT_HOME/DataInterchange/xml_dtd/Schemas/SOAP_Encoding_v11.xsd
SoapEncoding_v12 JITTERBIT_HOME/DataInterchange/xml_dtd/Schemas/SOAP_Encoding_v12.xsd

[SMTPClient]

Schlüssel Standard Beschreibung
DefaultSMTPServers (Keine) Kommagetrennte Liste von SMTP-Servern, die verwendet werden, wenn eine E-Mail versendet werden soll und der Benutzer keine SMTP-Server angegeben hat.
DefaultFromEmail (Keine) E-Mail-Adresse für das Feld Von, wenn der Benutzer keine Adresse angegeben hat.
DefaultAccount (Keine) Anmeldename für SMTP-Server, die eine Authentifizierung erfordern.
DefaultAccountPassword (Keine) Passwort für SMTP-Server, die eine Authentifizierung erfordern.
UseSSL (Keine) Wenn true, erfordert der SMTP-Server SSL/TLS.

Hinweis

Endpunkte, die mit der Funktion SendSystemEmail und DefaultSMTPServers erstellt werden, sind in der Endpunkt-Nutzungsberichterstellung enthalten und werden auf die Lizenz angerechnet.

[SSH]

Schlüssel Standard Beschreibung
PublicKeyFile (Keine) Absoluter Pfad zum öffentlichen Schlüssel. Der Pfad muss Schrägstriche verwenden, auch unter Windows. Das Verzeichnis muss vorhanden sein und Lese-/Schreibberechtigungen für den Agent haben. Dateiberechtigungen auf Schreibschutz für den Jitterbit-Benutzer setzen.
PrivateKeyFile (Keine) Absoluter Pfad zum privaten Schlüssel. Der Pfad muss Schrägstriche verwenden, auch unter Windows. Das Verzeichnis muss vorhanden sein und Lese-/Schreibberechtigungen für den Agent haben. Dateiberechtigungen auf Schreibschutz für den Jitterbit-Benutzer setzen.
PrivateKeyPassphrase (Keine) Passphrase für den privaten Schlüssel. Dateiberechtigungen auf Schreibschutz für den Jitterbit-Benutzer setzen.
Zusätzliche Sätze (Keine) Benutzerkonfiguriert.

Zusätzliche Sätze

Für zusätzliche Sätze fügen Sie ein Suffix (z. B. XXX) zu diesen Schlüsseln hinzu (um PublicKeyFileXXX, PrivateKeyFileXXX, PrivateKeyPassphraseXXX zu erstellen), und referenzieren Sie diese dann in Jitterbit-Skriptvariablen mit $jitterbit.source.sftp.ssh_key_id="XXX" oder $jitterbit.target.sftp.ssh_key_id="XXX".

[SSL]

Schlüssel Standard Beschreibung
CertificateFile (Keine) Absoluter Pfad zur SSL-Clientzertifikatdatei. Der Pfad muss Schrägstriche verwenden, auch unter Windows. Das Verzeichnis muss vorhanden sein und Lese-/Schreibberechtigungen für den Agent haben. Es werden nur PEM-formatierte Zertifikate und Schlüssel unterstützt. Dateiberechtigungen auf Schreibschutz für den Jitterbit-Benutzer setzen.
PrivateKeyFile (Keine) Absoluter Pfad zum privaten Schlüssel. Der Pfad muss Schrägstriche verwenden, auch unter Windows. Das Verzeichnis muss vorhanden sein und Lese-/Schreibberechtigungen für den Agent haben. Es werden nur PEM-formatierte Zertifikate und Schlüssel unterstützt. Dateiberechtigungen auf Schreibschutz für den Jitterbit-Benutzer setzen.
PrivateKeyPassphrase (Keine) Passphrase für den privaten Schlüssel. Der Pfad muss Schrägstriche verwenden, auch unter Windows. Das Verzeichnis muss vorhanden sein und Lese-/Schreibberechtigungen für den Agent haben. Es werden nur PEM-formatierte Zertifikate und Schlüssel unterstützt. Dateiberechtigungen auf Schreibschutz für den Jitterbit-Benutzer setzen.
Zusätzliche Sätze (Keine) Benutzerkonfiguriert.

Zusätzliche Sätze

Für zusätzliche Sätze fügen Sie ein Suffix (z. B. YYY) zu diesen Schlüsseln hinzu (um CertificateFileYYY, PrivateKeyFileYYY, PrivateKeyPassphraseYYY zu erstellen), und referenzieren Sie diese dann in Jitterbit-Skriptvariablen mit $jitterbit.target.http.ssl_cert_id = "YYY";, $jitterbit.source.http.ssl_cert_id = "YYY"; oder $jitterbit.web_service_call.ssl_cert_id = "YYY";.

[TraceLogging]

Key Standard Beschreibung
tracelog.shipper.enabled false Wenn true, aktiviert die Trace-Protokollierung des Operationsmoduls auf dem Agent.

[TransformationEngine]

Key Standard Beschreibung
WriteLog false Detaillierte Transformations-Debug-Protokollierung. Wenn true, wird Debug in [OperationEngine] auf true gesetzt.
WriteLogDir (Keine) Absoluter Pfad zum Protokollverzeichnis. Falls nicht angegeben, werden Protokolle in JITTERBIT_HOME/DataInterchange/Temp/Debug geschrieben. Wird ignoriert, wenn WriteLog nicht 1 ist. Der Pfad muss Schrägstriche verwenden, auch unter Windows. Das Verzeichnis muss vorhanden sein und Lese-/Schreibberechtigungen für den Agent haben.
ValidateXML true XML-Validierung.
LdapEnableAutoUpdateMode false LDAP-Auto-Update-Modus aktivieren.
TimingOn false Datei-Profiling global aktivieren (1) oder deaktivieren (0). Dateien werden in JITTERBIT_HOME/DataInterchange/Temp/LOG geschrieben.
AutoStreaming true Transformations-Auto-Streaming.
UseOldRuleForLoopOneOfXmlNode false (Für Rückwärtskompatibilität verwenden.)
AutoXsiNil false Attribut xsi:nil="true" für Elemente setzen, die obligatorisch und nicht zugeordnet sind in Transformationen.
DefaultEntityResolution true Parsing von IDoc-Typen aktivieren.

[VerboseLogging]

Dieser Abschnitt wird für die Generierung von Komponenteneingabe- und -ausgabedaten verwendet, wenn Operationsdebug-Protokollierung für eine einzelne Studio-Operation aktiviert ist.

Komponenteneingabe- und -ausgabedaten werden in der Harmony-Cloud protokolliert, es sei denn, verbose.logging.enable ist auf false gesetzt. Die Einstellung für Cloud-Protokollierung hat keine Auswirkung auf diese Art der Protokollierung.

Dies setzt die Generierung von Komponenteneingabe- und -ausgabedaten außer Kraft, wenn Debug-Protokollierung aktivieren bis für eine einzelne Studio-Operation konfiguriert ist, verhindert aber nicht die Generierung von Operationsdebug-Protokolldateien.

Key Standard Beschreibung
verbose.logging.enable true Wenn Operationsdebug-Protokollierung für eine einzelne Studio-Operation aktiviert ist, Komponenteneingabe- und -ausgabedaten in das Studio-Operationsprotokoll schreiben.
verbose.logging.commpress.folder.path (Keine) Auskommentiert. Nicht ändern, es sei denn, der Jitterbit-Support weist dies an. commpress (zwei 'm') ist eine bekannte Falschschreibung dieser Eigenschaft.
verbose.logging.log.folder.path (Keine) Auskommentiert. Nicht ändern, es sei denn, der Jitterbit-Support weist dies an.
verbose.logging.log.file.extension .verbose Wird für Operationsdebug-Protokollierung verwendet. Nicht ändern, es sei denn, der Jitterbit-Support weist dies an.
verbose.logging.use.dynamic.host.for.collector.url true Wird für Operationsdebug-Protokollierung verwendet. Nicht ändern, es sei denn, der Jitterbit-Support weist dies an.
verbose.logging.collector.url (Keine) URL des Protokollsammler-Service.