Wählen Sie die Eigenschaften und Werte aus, die Sie für einen bestehenden konfigurierbaren FtpServer-Service ändern bzw. bei der Erstellung eines neuen Service verwenden möchten.
Zur Änderung dieser Eigenschaften müssen Sie den Brokernamen und -c
FtpServer angeben.
Außerdem müssen Sie ObjectName auf den
Namen des konfigurierbaren Service setzen, den Sie zuvor erstellt haben.
Im Abschnitt
mqsichangeproperties-Befehl finden Sie entsprechende Verwendungsbeispiele.
Wenn Sie einen konfigurierbaren FtpServer-Service über den Befehl
mqsicreateconfigurableservice definieren, können
Sie den Namen dieses konfigurierbaren Service in der Eigenschaft
Ferner Server und
Port
auf der Registerkarte FTP der
FileInput- und
FileOutput-Knoten angeben.
Die Befehlssyntax zur
Erstellung eines konfigurierbaren FtpServer-Service lautet wie folgt:
Dabei
steht
Objektname für den Namen des konfigurierbaren Service und
Eigenschaftsname für eine oder mehrere der in diesem Abschnitt beschriebenen
Eigenschaften.
Wenn Sie einen konfigurierbaren FtpServer-Service definieren,
müssen
Sie einen Wert für die Eigenschaft 'serverName' angeben. Alle anderen Eigenschaften sind optional.
- serverName
- Die IP-Adresse und optional die Portnummer für den fernen FTP-oder SFTP-Server. Die Syntax für die Eigenschaft ist mit der gültigen Syntax für die
Eigenschaft Ferner Server und Port
der FileInput- und
FileOutput-Knoten identisch (ausgenommen davon ist der
Name eines konfigurierbaren FTP-Server-Service).
- accountInfo
- Für einige FTP-Server ist ein Accountname während des FTP-Anmeldeverfahrens erforderlich. Wenn
eine Angabe für diese Eigenschaft erfolgt, entspricht der Wert dem Accountnamen, der bei der
FTP-Anmeldung angegeben wird. Wenn diese Eigenschaft nicht angegeben wird und der Server einen
Accountnamen anfordert, schlägt die FTP-Übertragung fehl.
- cipher
- Der zur Verschlüsselung verwendete Verschlüsselungscode. Diese Eigenschaft hat die Form einer
Liste mit einem oder mehreren Werten, die durch Pluszeichen (+) getrennt sind:
- blowfish-cbc
- 3des-cbc
- aes128-cbc
Der zur Verschlüsselung verwendete Verschlüsselungscode ist von der
SSH-Implementierung abhängig.
Listen Sie die Werte in der gewünschten Rangfolge auf. Diese Eigenschaft ist nur gültig, wenn SFTP als Protokoll angegeben ist. Wenn FTP angegeben
ist, wird diese Eigenschaft ignoriert.
Wenn kein Wert angegeben ist, gilt der folgende Standardwert:
blowfish-cbc+3des-cbc+aes128-cbc
- compression
- Gibt die Stufe der zu verwendenden Komprimierung an. Gültige Werte sind ganze Zahlen von 0 bis 9, wobei 0 keine Komprimierung bedeutet und 9 für eine maximale Komprimierung steht.
Diese Eigenschaft ist nur gültig, wenn SFTP als Protokoll angegeben ist. Wenn FTP angegeben
ist, wird diese Eigenschaft ignoriert.
Wenn kein Wert angegeben ist, wird der Standardwert 0 verwendet.
- connectionType
- Die Socketverbindung für FTP-Daten. Der Wert lautet entweder ACTIVE oder
PASSIVE.
Diese Eigenschaft ist nur gültig, wenn FTP
als Protokoll angegeben ist. Wenn SFTP angegeben ist, wird diese Eigenschaft ignoriert.
- knownHostsFile
- Die Position der Datei für bekannte Hosts. Der Wert muss der vollständig qualifizierte Pfad zu
einer gültigen Datei für bekannte Hosts sein.
Die Hostinformation wird in einer Datei mit dem
Namen known_hosts im standardmäßigen OpenSSH-Format gespeichert.
Diese Eigenschaft ist nur obligatorisch, wenn die Eigenschaft
strictHostKeyChecking auf 'Yes' gesetzt ist. Ist die Eigenschaft
strictHostKeyChecking auf 'No' gesetzt, wird diese Eigenschaft ignoriert.
Diese Eigenschaft ist nur gültig, wenn SFTP als Protokoll angegeben ist. Wenn FTP angegeben
ist, wird diese Eigenschaft ignoriert.
- mac
- Nachrichtenauthentifizierungscode (Message Authentication Code). Diese Eigenschaft hat die Form
einer Liste mit einem oder mehreren Werten, die durch Pluszeichen (+) getrennt sind:
Der verwendete Nachrichtenauthentifizierungscode ist von der
SSH-Implementierung abhängig. Listen Sie die Werte in der gewünschten Rangfolge auf.
Diese Eigenschaft ist nur gültig, wenn SFTP als Protokoll angegeben ist. Wenn FTP angegeben
ist, wird diese Eigenschaft ignoriert.
Wenn kein Wert angegeben ist, gilt der folgende Standardwert:
hmac-md5+hmac-sha1
- preserveRemoteFileDate
- Diese Eigenschaft gibt an, ob Dateien, die der
FileInput-Knoten von einem fernen Server abruft, das
Datum der letzten Änderung auf dem Server beibehalten.
Der Standardwert ist 'Nein'. Wenn Sie 'Ja'
auswählen, führt der FileInput-Knoten eine entsprechende
Analyse durch, um das Datum der fernen Datei während der Verarbeitung zu ermitteln. Dazu wird der
Befehl MDTM verwendet, sofern er von dem fernen Server unterstützt wird. Wo dies nicht der Fall
ist, wird der Listentext verwendet.
Bei der Analyse von Listentext ist die Genauigkeit auf
die Informationen begrenzt, die in dem Listenformat, das der ferne Server verwendet, verfügbar
sind. Wenn das Listenformat mehrdeutig ist, führt der
FileInput-Knoten die Analyse auf Basis der lokalen
Einstellungen des Brokers durch. Falls das Datum nicht verlässlich vom Server ermittelt werden
kann, wird eine Ausnahme ausgegeben und die Nachricht nicht verarbeitet.
- protocol
- Das zu verwendende Protokoll für die Fernübertragung. Gültige Werte sind FTP und SFTP.
Wenn im
konfigurierbaren Service kein Protokoll angegeben ist, wird der im Knoten angegebene Wert verwendet.
- remoteDirectory
- Der relative oder absolute Verzeichnisname auf dem fernen FTP-Server.
Ist diese Eigenschaft gesetzt, wird damit die Eigenschaft
Serververzeichnis auf der Registerkarte
FTP des FileInput-Knotens bzw.
FileOutput-Knotens überschrieben, der diesen Service
verwendet.
- scanDelay
- Hier kann angegeben werden, wie viele Sekunden gewartet werden soll, wenn bei einem Suchlauf
für das Verzeichnis keine Dateien für die Verarbeitung identifiziert werden konnten. Der Standardwert beträgt 60 Sekunden. Ist diese Eigenschaft gesetzt, wird damit die Option
Scan-Verzögerung auf der Registerkarte
FTP des FileInput-Knotens
überschrieben, der diesen Service verwendet.
- securityIdentity
- Der Name der über den Befehl
mqsisetdbparms
definierten Sicherheitsidentität.
Ist diese Eigenschaft festgelegt, wird damit die Option
Sicherheitsidentität auf der Registerkarte
FTP des FileInput-Knotens bzw.
FileOutput-Knotens überschrieben, der diesen Service
verwendet. Wenn diese Eigenschaft den Wert 'secId' hat, definieren Sie die Sicherheitsidentität mit
folgendem Befehl:
- Bei Verwendung von FTP:
mqsisetdbparms WBRK7_DEFAULT_BROKER -n ftp::secId -u Benutzername -p Kennwort
- Bei Verwendung von SFTP:
mqsisetdbparms WBRK7_DEFAULT_BROKER -n sftp::secId -u Benutzername -p Kennwort
oder mqsisetdbparms WBRK7_DEFAULT_BROKER -n sftp::secId -u Benutzername -i SSHIdentityFile
-r Verschlüsselungstext
- strictHostKeyChecking
- Gibt an, wie Hostschlüssel in der Verbindungsaufbau- und Authentifizierungsphase geprüft
werden. Gültige Werte sind:
- No
- Gibt an, dass folgende Aktion ausgeführt wird:
- Beim Aufbau einer Verbindung zu einem neuen Host die Verbindung herstellen und den Schlüssel
des Hosts akzeptieren und speichern
- Beim Aufbau einer Verbindung zu einem Host, zu dem bereits früher eine Verbindung hergestellt
und dessen Hostschlüssel nicht geändert wurde, eine Ausnahmebedingung ausgeben
(FileOutput-Knoten).
Bei Auswahl von 'No' wird
eine Standarddatei für bekannte Hosts (die vom Broker verwaltet wird) verwendet.
- Yes
- Verbindung zu bekannten Hosts mit gültigen Schlüsseln herstellen, andernfalls eine Ausnahmebedingung ausgeben.
Bei Auswahl von 'Ja' müssen Sie unter Angabe der Eigenschaft knownHostsFile die Datei mit den bekannten Hosts angeben.
Der Standardwert ist 'No'. Die Hostinformation wird in einer Datei mit
dem Namen known_hosts im standardmäßigen OpenSSH-Format gespeichert.
Diese Eigenschaft ist nur gültig, wenn SFTP als Protokoll angegeben ist. Wenn FTP angegeben
ist, wird diese Eigenschaft ignoriert.
- timeoutSec
- Der Zeitlimitwert (in Sekunden) zum Herstellen einer Verbindung mit dem fernen
FTP- oder SFTP-Server. Sie können eine beliebige gültige ganze Zahl als Wert für die Eigenschaft timeoutSec festlegen. Der Zeitlimitwert 0 wird als unbegrenztes Zeitlimit interpretiert. Wenn Sie FTP verwenden, ist der Standardwert 5 Sekunden. Wenn Sie SFTP verwenden, ist der Standardwert 20 Sekunden.
- transferMode
- Der Übertragungsmodus der FTP-Verbindung. Der Wert lautet entweder BINARY oder
ASCII.
Die Standardeinstellung ist BINARY. Ist diese Eigenschaft
gesetzt, wird damit die Option Transfermodus auf der
Registerkarte FTP des
FileInput-Knotens bzw.
FileOutput-Knotens überschrieben, der diesen Service
verwendet.
Diese Eigenschaft ist nur gültig, wenn FTP
als Protokoll angegeben ist. Wenn SFTP angegeben ist, wird diese Eigenschaft ignoriert.
Standardmäßig ist keine dieser
Eigenschaften in der konfigurierbaren Servicedefinition für den FTP-Server gesetzt. Bei der
Definition eines konfigurierbaren FtpServer-Service muss als einzige Eigenschaft unbedingt der
Servername angegeben werden.
Es folgt ein Beispiel für den Befehl
mqsicreateconfigurableservice, mit dem ein
konfigurierbarer FtpServer-Service erstellt wird:
mqsicreateconfigurableservice WBRK7_DEFAULT_BROKER -c FtpServer -o Server01
-n serverName,scanDelay,transferMode,connectionType,securityIdentity
-v one.hursley.abc.com:123,20,BINARY,ACTIVE,secId
Mit Ausnahme der Eigenschaften
'accountInfo' und 'connectionType', die nur in der Definition des konfigurierbaren
FtpServer-Service festgelegt werden können, können Sie diese Eigenschaften in der Definition des
konfigurierbaren FtpServer-Service oder auf der Registerkarte FTP der
FileInput- und
FileOutput-Knoten festlegen. Werte, die in den Eigenschaften in der Definition des konfigurierbaren FtpServer-Service gesetzt
wurden, setzen die Werte außer Kraft, die in den entsprechenden Eigenschaften der
FileInput- und
FileOutput-Knoten definiert wurden.
Wenn die
Eigenschaft 'accountInfo' definiert wird, werden die Angaben während des Anmeldeprotokolls beim
Erstellen einer Verbindung zum konfigurierbaren FtpServer-Service nach Angabe von Benutzer-ID und
Kennwort verwendet. Diese Informationen werden manchmal von FTP-Servern benötigt und im Rahmen des
Anmeldeprotokolls angefordert. Mit dieser Einstellung können
FileInput- und
FileOutput-Knoten bei der Anmeldung ordnungsgemäß
antworten.
Wenn Sie die Eigenschaft 'connectionType' festlegen, wird dadurch der Typ des für
den Austausch von Dateien mit dem FTP-Server verwendeten Datensockets geändert. Wenn diese
Eigenschaft auf ACTIVE gesetzt wird, bezieht sich dies auf einen vom fernen Server
zum Client hergestellten Socket (Broker-Nachrichtenfluss). Wird diese Eigenschaft auf
PASSIVE gesetzt, bezieht sich dies auf einen vom Client zum fernen Server
hergestellten Socket (z. B. Anmelde- oder Steuersocket). Der Standardwert lautet
PASSIVE. Bei dieser Einstellung ist die Wahrscheinlichkeit größer, dass sie von
den meisten Firewall-Schutzeinrichtungen toleriert wird, sodass sich der Client anmelden kann. Sie
können diese Eigenschaft auf ACTIVE setzen, wenn der FTP-Server keine passiven
Verbindungen (PASSIVE) unterstützt oder wenn Sie in Ihrer Konfiguration bestimmte
Vereinbarungen berücksichtigen müssen.