WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Serviço Configurável FtpServer

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 (+):
  • blowfish-cbc
  • 3des-cbc
  • aes128-cbc
O código que você usa para criptografia depende de sua implementação do SSH. Liste os valores na ordem de preferência.

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 (+):
  • hmac-md5
  • hmac-sha1
O MAC que você usa depende de sua implementação do SSH. Liste os valores na ordem de preferência.

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:
  • Se você estiver usando FTP:
    mqsisetdbparms BrokerName
    -n ftp::secId -u userName 
    -p password
  • Se você estiver usando SFTP:
    mqsisetdbparms BrokerName
    -n sftp::secId -u userName 
    -p password 
    ou
    mqsisetdbparms BrokerName
    -n sftp::secId -u userName 
    -i SSHIdentityFile 
    -r Passphrase

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:
Não
Especifica que a seguinte ação será executada:
  • Se a conexão for para um novo host, conecte e aceite a chave do host e armazene-a
  • Se a conexão for com um host que foi conectado anteriormente, e a chave de host tiver sido alterada, emita uma exceção (no nó FileOutput).
Se você selecionar Não, um arquivo de hosts conhecidos padrão (gerenciado pelo broker) será usado.
Sim
Conecta-se somente a hosts conhecidos com chaves válidas; caso contrário, emite uma exceção.

Se você selecionar Sim, deverá especificar seu próprio arquivo de hosts conhecidos usando a propriedade knownHostsFile.

O valor-padrão é Nã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.

Para criar um serviço FtpServer configurável, o comando tem a seguinte sintaxe:
Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsicreateconfigurableservice--BrokerName-- -c  FtpServer---->

>-- -o--ObjectName--+---------------------------+--------------->
                    |      .-,----------------. |   
                    |      V                  | |   
                    '- -n----+--------------+-+-'   
                             '-PropertyName-'       

>--+----------------------------+------------------------------><
   |      .-,-----------------. |   
   |      V                   | |   
   '- -v----+---------------+-+-'   
            '-PropertyValue-'       

onde Objectname é o nome do serviço configurável e PropertyName é uma ou mais das propriedades descritas neste tópico.
Se você definir um serviço FtpServer configurável, você deve especificar um valor para sua propriedade serverName. Todas as outras propriedades são opcionais.
serverName
O endereço IP e, opcionalmente, o número da porta para o servidor FTP ou SFTP remoto. A sintaxe para a propriedade é idêntica à sintaxe que é permitida para a propriedade Servidor remoto e porta dos nós FileInput e FileOutput (exceto que ela não pode ser o nome de um serviço configurável FtpServer).

accountInfo
Alguns servidores FTP requerem um nome de conta durante o procedimento de logon do FTP. Se essa propriedade for especificada, seu valor é 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 da conta, a transferência de FTP falhará.

cipher
O código usado para criptografia. Esta propriedade utiliza o formato de uma lista de um ou mais dos valores a seguir, separados por sinais de mais (+):
  • blowfish-cbc
  • 3des-cbc
  • aes128-cbc
O código que você usa para criptografia depende de sua implementação do SSH. Liste os valores na ordem de preferência.

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

compression
Especifica 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. Ela é 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
Código de Autenticação de Mensagem. Esta propriedade utiliza o formato de uma lista de um ou mais dos valores a seguir, separados por sinais de mais (+):
  • hmac-md5
  • hmac-sha1
O MAC que você usa depende de sua implementação do SSH. Liste os valores na ordem de preferência.

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

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 substitui o Diretório do Servidor na guia FTP do nó FileInput ou FileOutput que usa este serviço.

scanDelay
A duração de tempo, em segundos, para aguardar após uma varredura do diretório dar como resultado nenhum arquivo ter sido identificado para processamento. O padrão é 60 segundos. Se configurada, esta propriedade substitui o Atraso de Varredura na guia FTP do nó FileInput que usa este serviço.

securityIdentity
O nome de uma identidade de segurança definida usando o comando mqsisetdbparms. Se configurada, esta propriedade substitui a Identidade de Segurança na guia FTP do nó FileInput ou FileOutput que usa este serviço. Se o valor desta propriedade for secId, defina a identidade de segurança usando o comando a seguir:
  • Se você estiver usando FTP:
    mqsisetdbparms MB8BROKER -n ftp::secId -u userName -p password
  • Se você estiver usando SFTP:
    mqsisetdbparms MB8BROKER -n sftp::secId -u userName -p password
    ou
    mqsisetdbparms MB8BROKER -n sftp::secId -u userName -i SSHIdentityFile 
    -r Passphrase
strictHostKeyChecking
Especifica como as chaves do host são verificadas durante a fase de conexão e autenticação. Os valores válidos são:
Não
Especifica que a seguinte ação será executada:
  • Se a conexão for para um novo host, conecte e aceite a chave do host e armazene-a
  • Se a conexão for com um host que foi conectado anteriormente, e a chave do host foi alterada, emita uma exceção (nó FileOutput).
Se você selecionar Não, um arquivo de hosts conhecidos padrão (gerenciado pelo broker) será usado.
Sim
Conecta-se somente a hosts conhecidos com chaves válidas; caso contrário, emite uma exceção.

Se você selecionar Sim, deverá especificar seu próprio arquivo de hosts conhecidos usando a propriedade knownHostsFile.

O valor-padrão é Nã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. Este valor é BINARY ou ASCII. O padrão é BINARY. Se configurada, esta propriedade substitui o Modo de Transferência na guia FTP do nó FileInput ou FileOutput que usa este serviço.

Esta propriedade é válida somente quando FTP é especificado como o protocolo. Se SFTP for especificado, esta propriedade será ignorada.

Por padrão, nenhuma dessas propriedades na definição do serviço configurável FtpServer é definida. A única propriedade obrigatória quando você define um serviço configurável FtpServer é serverName.
O seguinte exemplo de um comando mqsicreateconfigurableservice mostra como criar um serviço configurável FtpServer:
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.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:28:31


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ac25670_