Selecione as propriedades e valores que você deseja alterar para um serviço configurável FtpServer existente ou para criar um novo serviço.
Para alterar estas propriedades, você deve especificar o nome do broker e -c FtpServer. Você também deve configurar o ObjectName para o nome do serviço configurável que você criou anteriormente.
Consulte Comando mqsichangeproperties para obter exemplos de sua utilização.
Para serviços configuráveis FtpServer, você deve parar e iniciar o grupo de execução para que uma mudança de valor de propriedade entre em vigor.
Serviços configuráveis fornecidos que são criados para cada broker | Propriedades para cada serviço configurável definido | Descrição de propriedades |
---|---|---|
Nenhuma | accountInfo |
Alguns servidores FTP requerem um nome de conta durante o procedimento de logon do FTP. Se esta propriedade for especificada, seu valor será o nome da conta fornecido quando solicitado durante o logon no FTP. Se esta propriedade não for especificada, e o servidor solicitar um nome de conta, a transferência por FTP falhará. |
cipher |
A cifra usada para criptografia. Esta propriedade
utiliza o formato de um ou mais dos seguintes valores, separados por
sinais de mais (+):
Esta propriedade é válida somente quando SFTP é especificado como o protocolo. Se FTP for usado, esta propriedade será ignorada. Se nenhum valor for especificado, o padrão a seguir será utilizado: blowfish-cbc+3des-cbc+aes128-cbc |
|
compression |
O nível de compactação a ser usado. Os valores válidos são números inteiros no intervalo de 0 a 9, em que 0 especifica nenhuma compactação e 9 especifica compactação máxima. Esta propriedade é válida somente quando SFTP é especificado como o protocolo. Se FTP for usado, esta propriedade será ignorada. Se nenhum valor for especificado, o valor-padrão de 0 será usado. |
|
connectionType |
A conexão do soquete de dados do FTP. Os valores válidos são ACTIVE ou PASSIVE. Esta propriedade é válida somente quando FTP é especificado como o protocolo. Se SFTP for especificado, esta propriedade será ignorada. |
|
knownHostsFile |
O local do arquivo de hosts conhecidos. O valor deve ser o caminho completo para um arquivo de hosts conhecidos válido. As informações do host são armazenadas em um arquivo known_hosts no formato OpenSSH padrão. Esta propriedade é obrigatória se a propriedade strictHostKeyChecking estiver configurada como Sim. Se a propriedade strictHostKeyChecking estiver configurada como Não, esta propriedade será ignorada. Esta propriedade é válida somente quando SFTP é especificado como o protocolo. Se FTP for usado, esta propriedade será ignorada. |
|
mac |
O Código de Autenticação de Mensagem. Esta propriedade
utiliza o formato de um ou mais dos seguintes valores, separados por
sinais de mais (+):
Esta propriedade é válida somente quando SFTP é especificado como o protocolo. Se FTP for usado, esta propriedade será ignorada. Se nenhum valor for especificado, o padrão a seguir será utilizado: hmac-md5+ hmac-sha1 |
|
preserveRemoteFileDate |
Essa propriedade especifica se os arquivos recuperados de um servidor remoto pelo nó FileInput reterão a data de última modificação no servidor. O valor padrão é Não. Se você selecionar Sim, o nó FileInput concluirá a análise apropriada para determinar a data do arquivo remoto durante o processamento. O comando MDTM é usado onde for suportado pelo servidor remoto. Onde não for suportado, o texto de listagem será usado. Ao analisar a partir do texto de listagem, a precisão está limitada às informações disponíveis no formato de listagem específico usado pelo servidor remoto. Se o formato de listagem for ambíguo, o nó FileInput baseará a análise nas configurações do código do idioma do broker. Se não for possível determinar a data de modo confiável no servidor remoto, uma exceção será emitida e a mensagem não será processada. |
|
protocol |
O protocolo de transferência remoto a usar. Os valores válidos são FTP ou SFTP. Se nenhum protocolo for especificado no serviço configurável, o valor especificado no nó será usado. |
|
remoteDirectory |
O nome de diretório relativo ou absoluto no servidor FTP remoto. Se configurada, esta propriedade substituirá a propriedade Diretório do Servidor na guia FTP do nó FileInput ou FileOutput que utiliza este serviço. |
|
scanDelay |
O tempo, em segundos, a aguardar após uma varredura do diretório resultar em nenhum arquivo sendo identificado para processamento. O valor-padrão é 60 segundos. Se configurada, esta propriedade substituirá a propriedade Atraso de Varredura na guia FTP do nó FileInput que utiliza este serviço. |
|
securityIdentity |
O nome de uma identidade de segurança defino usando o comando mqsisetdbparms.
Se configurada, esta propriedade substituirá a propriedade Identidade
de Segurança na guia FTP do nó FileInput ou FileOutput
que utiliza este serviço. Se o valor desta propriedade for secId, use o comando
a seguir para definir a identidade de segurança:
|
|
serverName |
O endereço IP e, opcionalmente, o número da porta para o servidor FTP remoto. A sintaxe para a propriedade é idêntica à sintaxe que é permitida para a propriedade Servidor e Porta FTP dos nós FileInput e FileOutput (exceto que ela não pode ter o nome de um serviço configurável FtpServer). |
|
strictHostKeyChecking |
Esta propriedade especifica como as chaves do host são
verificadas durante a fase de conexão e autenticação. Os valores válidos são:
As informações do host são armazenadas em um arquivo known_hosts no formato OpenSSH padrão. Esta propriedade é válida somente quando SFTP é especificado como o protocolo. Se FTP for usado, esta propriedade será ignorada. |
|
timeoutSec |
O valor de tempo limite, em segundos, para estabelecer uma conexão com o servidor FTP ou SFTP remoto. Você pode configurar qualquer número inteiro válido como valor da propriedade timeoutSec. Um tempo limite igual a 0 é interpretado como infinito. Se você estiver usando FTP, o valor padrão será 5 segundos. Se você estiver usando SFTP, o valor padrão será 20 segundos. |
|
transferMode |
O modo de transferência da conexão de FTP. Os valores válidos são BINARY (o padrão) ou ASCII. Se configurada, esta propriedade substituirá a propriedade Modo de Transferência na guia FTP do nó FileInput ou FileOutput que utiliza este serviço. Esta propriedade é válida somente quando FTP é especificado como o protocolo. Se SFTP for especificado, esta propriedade será ignorada. |
Se você definir um serviço configurável FtpServer usando o comando mqsicreateconfigurableservice, será possível então especificar o nome deste serviço configurável na propriedade Servidor e Porta Remotos na guia FTP dos nós FileInput e FileOutput.
onde Objectname é o nome do serviço configurável e PropertyName é uma ou mais das propriedades descritas neste tópico.>>-mqsicreateconfigurableservice--BrokerName-- -c FtpServer----> >-- -o--ObjectName--+---------------------------+---------------> | .-,----------------. | | V | | '- -n----+--------------+-+-' '-PropertyName-' >--+----------------------------+------------------------------>< | .-,-----------------. | | V | | '- -v----+---------------+-+-' '-PropertyValue-'
Esta propriedade é válida somente quando SFTP é especificado como o protocolo. Se FTP for usado, esta propriedade será ignorada.
Se nenhum valor for especificado, o seguinte padrão será usado: blowfish-cbc+3des-cbc+aes128-cbc
Esta propriedade é válida somente quando SFTP é especificado como o protocolo. Se FTP for usado, esta propriedade será ignorada.
Se nenhum valor for especificado, o valor-padrão de 0 será usado.
Esta propriedade é válida somente quando FTP é especificado como o protocolo. Se SFTP for especificado, esta propriedade será ignorada.
As informações do host são armazenadas em um arquivo known_hosts no formato OpenSSH padrão.
Esta propriedade é obrigatória se a propriedade strictHostKeyChecking estiver configurada como Sim. Se a propriedade strictHostKeyChecking estiver configurada como Não, esta propriedade será ignorada.
Esta propriedade é válida somente quando SFTP é especificado como o protocolo. Se FTP for usado, esta propriedade será ignorada.
Esta propriedade é válida somente quando SFTP é especificado como o protocolo. Se FTP for usado, esta propriedade será ignorada.
Se nenhum valor for especificado, o seguinte padrão será usado: hmac-md5+ hmac-sha1
O valor padrão é Não. Se você selecionar Sim, o nó FileInput concluirá a análise apropriada para determinar a data do arquivo remoto durante o processamento. O comando MDTM é usado onde for suportado pelo servidor remoto. Onde não for suportado, o texto de listagem será usado.
Ao analisar a partir do texto de listagem, a precisão está limitada às informações disponíveis no formato de listagem específico usado pelo servidor remoto. Se o formato de listagem for ambíguo, o nó FileInput baseará a análise nas configurações do código do idioma do broker. Se não for possível determinar a data de modo confiável no servidor remoto, uma exceção será emitida e a mensagem não será processada.
mqsisetdbparms MB8BROKER -n ftp::secId -u userName -p password
mqsisetdbparms MB8BROKER -n sftp::secId -u userName -p password
ou mqsisetdbparms MB8BROKER -n sftp::secId -u userName -i SSHIdentityFile
-r Passphrase
Se você selecionar Sim, deverá especificar seu próprio arquivo de hosts conhecidos usando a propriedade knownHostsFile.
As informações do host são armazenadas em um arquivo known_hosts no formato OpenSSH padrão.
Esta propriedade é válida somente quando SFTP é especificado como o protocolo. Se FTP for usado, esta propriedade será ignorada.
Esta propriedade é válida somente quando FTP é especificado como o protocolo. Se SFTP for especificado, esta propriedade será ignorada.
mqsicreateconfigurableservice MB8BROKERR -c FtpServer -o Server01
-n serverName,scanDelay,transferMode,connectionType,securityIdentity
-v one.hursley.abc.com:123,20,BINARY,ACTIVE,secId
Os valores configurados nas propriedades da definição do serviço FtpServer configurável substituem o conjunto de valores das propriedades correspondentes nos nós FileInput e FileOutput.
Se você definir a propriedade accountInfo, ela será utilizada durante o protocolo de login na conexão com o serviço FtpServer configurável depois do fornecimento do identificador do usuário e da senha. Essas informações são, às vezes, exigidas pelos servidores FTP e solicitadas como parte do protocolo de login. Essa configuração permite que os nós FileInput e FileOutput respondam apropriadamente durante o logon.
Se você definir a propriedade connectionType, ela irá alterar o tipo de soquete de dados utilizado para transferir arquivos para e do servidor de FTP. Se você configurar esta propriedade como ACTIVE, isto irá se referir a um soquete que foi estabelecido pelo servidor remoto para o cliente (o fluxo de mensagens do broker). Se você configurar esta propriedade como PASSIVE, ela irá se referir a um soquete que foi estabelecido pelo cliente para o servidor remoto (no estado em que se encontra o soquete de login ou de controle). O padrão é PASSIVE, que é mais provável de ser tolerado pela maioria dos tipos de proteção de firewall que permitem que o cliente efetue login. É possível configurar esta propriedade como ACTIVE se o servidor FTP não suportar conexões PASSIVE ou se houver ajustes especiais que sua configuração deve atender.