Arquivo de opções do agente de armazenamento

O arquivo de opções do agente de armazenamento contém o nome do servidor com o qual o agente de armazenamento se comunica, além de outras opções. Normalmente, não altere o arquivo de opções, a menos que haja mudanças no servidor do IBM Storage Protect.

O arquivo de opções do agente de armazenamento se chama dsmsta.opt. O dsmsta.opt arquivo está localizado no diretório onde o programa do agente de armazenamento foi instalado. O arquivo de opções está armazenado no seguinte caminho padrão:

  • Sistemas Operacionais AIX/usr/tivoli/tsm/StorageAgent/bin
  • Sistemas Operacionais Linux/opt/tivoli/tsm/StorageAgent/bin
  • Sistemas Operacionais Windowsc:\program files\tivoli\tsm\StorageAgent

Opções Obrigatórias

DEVCONFig nome_do_arquivo
O nome do arquivo de configuração do dispositivo para o agente de armazenamento. Um nome típico para o arquivo é devconfig.
SERVERName nome_do_servidor
O nome do servidor do IBM Storage Protect com o qual o agente de armazenamento se comunica. O DSMSTA SETSTORAGESERVER comando insere essa opção.
Número da porta TCP

Especifica o número da porta na qual o driver de comunicação TCP/IP do servidor deve aguardar solicitações de sessões do cliente.

Use números de porta diferentes para as opções TCPPORT e TCPADMINPORT para criar um conjunto de regras de firewall para sessões de cliente e outro conjunto para outros tipos de sessão (sessões administrativas, sessões servidor-a-servidor, sessões de subagentes do SNMP, sessões de agentes de armazenamento, sessões de clientes de biblioteca, sessões de servidores gerenciados e sessões de servidores de eventos). Se os dois números de porta forem diferentes, encadeamentos separados serão usados para atender às sessões do cliente e aos outros tipos de sessão. Se você permitir que as duas opções usem o mesmo número da porta (por padrão ou explicitamente configurando-as para o mesmo número da porta), um único encadeamento do servidor será usado para atender a todas as solicitações de sessão.

Opções adicionais

AdminOnClientPort

Especifica se o recurso TCPPORT pode ser utilizado por sessões administrativas. É possível especificar um dos valores a seguir:

Sim (padrão)
Se a opção estiver definida como SIM, ou se e TCPADMINPORTTCPPORT tiverem o mesmo valor (padrão), as sessões administrativas poderão usar o TCPPORT.
NO
Se a opção estiver definida como NÃO e se o TCPADMINPORT valor for diferente do TCPPORT valor, as sessões administrativas não poderão usar TCPPORT.
CHECKTAPEPOS

Especifica se o servidor do IBM Storage Protect valida a posição dos blocos de dados na fita. Essa CHECKTAPEPOS opção se aplica apenas a operações realizadas com unidades de fita. Ela não se aplica a classes de dispositivo de acesso sequencial sem fita, como FILE. Se as informações do servidor sobre a posição não corresponderem à posição detectada pela unidade, será exibida uma mensagem de erro, a transação será revertida e os dados não serão gravados no banco de dados.

O padrão é YES.

As seguintes opções estão disponíveis:

True
Especifica que o servidor do IBM Storage Protect valida a posição dos dados na fita. Para unidades que suportam o modo somente de adição, este parâmetro especifica que a proteção “ IBM Storage ” permite que a unidade também valide a posição dos dados durante cada operação de gravação, a fim de evitar a sobrescrita de dados.
Não
Especifica que a validação de posição de todos os dados está desligada.
TSMOnly
Especifica que o servidor do IBM Storage Protect valida a posição dos dados na fita. O servidor não usa o modo somente anexo mesmo que a unidade suporte o recurso.
DriveOnly
Especifica que o servidor do IBM Storage Protect habilita o modo somente de adição para unidades que suportam esse recurso. O servidor não valida a posição dos dados na fita.
COMMTimeout seconds
Especifica o número máximo de segundos que o servidor aguarda uma mensagem esperada do cliente durante uma operação que provoca uma atualização no banco de dados. O valor padrão é 60. O valor mínimo é 1. Se o tempo decorrido exceder o tempo limite, o servidor encerra a sessão com o cliente. Talvez seja recomendável aumentar o valor do tempo limite para evitar que os clientes fiquem sem conexão. Os clientes podem sofrer um tempo limite de espera se houver uma carga pesada na rede do seu ambiente ou quando estiverem fazendo backup de arquivos grandes.
IDLETimeout minutes
Especifica o número máximo de minutos que uma sessão de cliente pode permanecer inativa antes que o servidor cancele a sessão. O valor padrão é 15 minutos. O valor mínimo é 1 minuto. Talvez seja recomendável aumentar o valor do tempo limite para evitar que os clientes sejam desconectados por expiração do tempo de espera, caso haja uma carga pesada na rede em seu ambiente. Observe, no entanto, que muitas sessões inativas podem impedir que outros usuários se conectem ao servidor.
MAXSessions number_of_sessions
Especifica o número máximo de sessões simultâneas de clientes que podem se conectar ao servidor. O valor padrão é 25 sessões do cliente. O valor mínimo é 2 sessões do cliente. O valor máximo é limitado apenas pelo tamanho da memória virtual disponível ou pelos recursos de comunicação.
MsgStackTrace on|off
Especifica que uma lista de funções será exibida no console do servidor e também será registrada no log de atividades após a emissão de mensagens específicas. Essas informações ajudam a equipe do serviço de proteção da IBM Storage a diagnosticar problemas específicos com mais rapidez. Recomenda-se que essa opção esteja ativada.
RESOURCETimeout minutes

Especifica o número máximo de minutos que um agente de armazenamento aguarda por um recurso no servidor. O valor padrão é 60 minutos. O valor mínimo é 1 minuto.

Para recursos de banco de dados e sessões no agente de armazenamento, o monitor de recursos “ IBM Storage Protect” seleciona o menor valor de tempo limite para iniciar um processo de recuperação.

Em contrapartida, no caso do compartilhamento de bibliotecas, o monitor de recursos seleciona o tempo mais longo para a recuperação tanto do gerenciador de bibliotecas quanto do cliente da biblioteca. Para uma gestão mais eficiente dos recursos da biblioteca compartilhada, considere definir o tempo limite dos recursos no mesmo valor para todos os participantes de uma configuração compartilhada. Em qualquer caso de recuperação de erros, o IBM Storage Protect sempre adota o limite de tempo de espera mais longo.

Você também deve definir essa opção no arquivo de opções do servidor. O servidor utiliza essa opção para monitorar algumas sessões e recursos do agente de armazenamento e cancelar as sessões com base no valor especificado.

Importante: Se essa opção for definida no arquivo de opções do servidor, esse valor substituirá o valor definido no arquivo de opções do agente de armazenamento.
SANDISCOVERY

Especifica se a função de descoberta de SAN do IBM Storage Protect está ativada. Quando definido como ON, o agente de armazenamento utiliza a detecção de SAN nos seguintes casos:

  • Durante a inicialização do agente de armazenamento
  • Quando o caminho do dispositivo é alterado e ocorre um conflito entre o número de série do dispositivo e o caminho do dispositivo fornecido pelo servidor

SANDISCOVERY OFF é o valor padrão para AIX, Linux, HP-UX, Oracle Solaris e Microsoft Windows (versão de 64 bits).

As seguintes opções estão disponíveis:

ON
Especifica que o servidor utiliza a detecção SAN quando o caminho do dispositivo é alterado ou quando o QUERY SAN comando é executado.
DESLIGADO
Desativa a função de descoberta da SAN, mas não coloca o caminho do dispositivo offline. Defina a SANDISCOVERY opção como DESLIGADO se o HBA utilizado pelo agente de armazenamento não for compatível com o mapeamento de dispositivos SAN.
UNSCANNEDPATHOFF
Desativa a função de descoberta da SAN e coloca o caminho do dispositivo offline caso o servidor não consiga abri-lo.

Ao utilizar a detecção SAN, o agente de armazenamento pode corrigir automaticamente o nome de arquivo específico do dispositivo caso ele seja alterado. Se o HBA utilizado pelo agente de armazenamento não for compatível com o mapeamento de dispositivos SAN, defina a SANDISCOVERY opção como OFF.

Para obter informações sobre o mapeamento de dispositivos SAN em HBA compatíveis com o IBM Storage Protect, consulte o site de suporte do IBM Storage Protect para redes de área de armazenamento.

O agente de armazenamento não requer uma ligação persistente quando a função de descoberta da SAN está ativada.

Sistemas Operacionais LinuxSistemas Operacionais AIXPara auxiliar na identificação de problemas, você pode usar o dsmsanlist módulo para obter informações sobre os dispositivos em uma rede de área de armazenamento (SAN). O dsmsanlist módulo é instalado por padrão quando o agente de armazenamento do Tivoli Storage Manager é instalado.

Sistemas Operacionais AIXAs funções de SAN-discovery no AIX exigem privilégios de usuário root. dsmqsanPara permitir que usuários com e sem privilégios de root utilizem a descoberta de SAN, um módulo utilitário especial é iniciado quando uma função de descoberta de SAN é acionada. O módulo utiliza a função de detecção de SAN como root. Os usuários sem privilégios de root que iniciam uma função de detecção de SAN obtêm privilégios de root especificamente para essa detecção. Enquanto a detecção da SAN está em andamento, dsmqsan o processo é executado como root.

Sistemas Operacionais AIXO dsmqsan módulo é instalado por padrão durante a instalação do servidor do IBM Storage Protect. Ele está instalado com o proprietário root, o grupo system e o modo 4755. O bit SETUID está ativado. Se, por motivos de segurança, você não quiser que usuários sem privilégios de root executem funções de detecção de SAN, desative essa opção. Se usuários sem privilégios de root tiverem problemas com as funções de detecção de SAN, verifique as seguintes configurações e permissões de acesso:

Sistemas Operacionais AIX
  • O bit SETUID. Deve estar ativado.
  • Permissões especiais de arquivos e propriedade do dispositivo. Os usuários sem privilégios de root precisam de acesso de leitura/gravação a arquivos especiais de dispositivos, por exemplo, a dispositivos de fita e bibliotecas.
  • A SANDISCOVERY opção no arquivo de opções do servidor. Esta opção deve estar ativada

Sistemas Operacionais AIXO dsmqsan O módulo funciona apenas para funções de descoberta de SAN e não fornece privilégios de root para outras funções IBM Storage Protect.

SSLTCPADMINPORT

Especifica o endereço da porta na qual o driver de comunicação do servidor TCP/IP aguarda solicitações de sessões habilitadas pelo Secure Sockets Layer ( SSL ). As sessões são destinadas ao cliente administrativo da linha de comandos.

Quando você usa a SSLTCPADMINPORT opção ou SSLTCPPORT e inicia o servidor, é criado um arquivo cert.kdb de banco de dados de chaves. O arquivo do banco de dados de chave é criado no diretório da instância do servidor e é inicializado com um certificado autoassinado.

Os seguintes tipos de sessões não usam o SSL:

  • NDMP (Network Data Management Protocol)
  • ACSLS (Automated Cartridge System Library Software)
  • Subagente SNMP (Protocolo Simples de Gerenciamento de Rede)

Se a opção ADMINONCLIENTPORT for configurada como NO, as sessões ativadas por SSL para o cliente administrativo exigirão SSLTCPADMINPORT com um número de porta diferente daquele especificado pela opção SSLTCPPORT. A opção SSLTCPADMINPORT não afeta as opções TCPPORT ou TCPADMINPORT e suas interações com a opção ADMINONCLIENTPORT.

O driver de comunicação do TCP/IP deve ser ativado com COMMMETHOD TCPIP ou COMMMETHOD V6TCPIP.

SSLTCPPORT

Especifica o número da porta do Secure Sockets Layer ( SSL ). O driver de comunicação de TCP/IP do servidor aguarda os pedidos nesta porta para as sessões ativadas por SSL do cliente.

Os seguintes tipos de sessões não usam o SSL:

  • NDMP (Network Data Management Protocol)
  • ACSLS (Automated Cartridge System Library Software)
  • Subagente SNMP (Protocolo Simples de Gerenciamento de Rede)
  • Operações de restauração do banco de dados

Se a ADMINONCLIENTPORT opção estiver definida como NO, as sessões habilitadas para o protocolo SSL (HTTPS) no cliente administrativo exigem que SSLTCPADMINPORT a opção seja configurada com um número de porta diferente daquele especificado pela SSLTCPPORT opção. A opção SSLTCPPORT não afeta as opções TCPPORT ou TCPADMINPORT e sua interação com a opção ADMINONCLIENTPORT.

O driver de comunicação do ` TCP/IP ` deve ser ativado no arquivo de opções do cliente apropriado com COMMMETHOD TCPIP a opção ou COMMMETHOD V6TCPIP a opção. O cliente de backup e arquivamento suporta a COMMMETHOD TCPIP opção ou a COMMMETHOD V6TCPIP opção, mas não ambas ao mesmo tempo.

STAKEYDBPW
Especifica a senha usada para verificar e controlar o acesso ao banco de dados de chaves do SSL. O usuário não pode editar o valor de STAKEYDBPW.
STAMaxSessõesAgrupadas number
Especifica o número de sessões individuais que podem ser iniciadas e encerradas entre o agente de armazenamento e o servidor do IBM Storage Protect. O intervalo de valores é de 0 a 150, com o valor padrão sendo 25. Cada sessão é controlada pela opção IDLETIMEOUT e é interrompida quando o tempo limite é excedido. Se o agente de armazenamento precisar de mais sessões do que o especificado, sessões adicionais serão permitidas. Embora o valor padrão seja normalmente suficiente, definir essa opção com um número baixo pode prejudicar o desempenho. Se o agente de armazenamento tiver várias sessões de cliente, aumentar o valor desta opção ajuda a dar suporte a essas sessões.
TCPADMINPORT number

Especifica o número da porta na qual o driver de comunicação TCP/IP do servidor deve aguardar solicitações de sessões diferentes das sessões do cliente. As sessões que não são de cliente incluem sessões administrativas, sessões servidor a servidor, sessões de subagentes d SNMP, sessões de agentes de armazenamento, sessões de clientes de biblioteca, sessões de servidores gerenciados e sessões de servidores de eventos. O padrão é o valor TCPPORT.

Use números de porta diferentes para as opções TCPPORT e TCPADMINPORT a fim de criar um conjunto de regras de firewall para sessões de cliente e outro conjunto para os demais tipos de sessão que não sejam de cliente. Ao usar o SESSIONINITIATION parâmetro de REGISTER NODE e UPDATE NODE, é possível fechar a porta especificada por TCPPORT no firewall e indicar os nós cujas sessões agendadas são iniciadas a partir do servidor. Se os dois números de porta forem diferentes, encadeamentos separados serão usados para atender às sessões do cliente e aos tipos de sessão. Se você permitir que as duas opções usem o mesmo número da porta (por padrão ou explicitamente configurando-as para o mesmo número da porta), um único encadeamento do servidor será usado para atender a todas as solicitações de sessão.

As sessões do cliente que tentarem usar a porta especificada por TCPADMINPORT serão encerradas (se TCPPORT e TCPADMINPORT especificarem portas diferentes). As sessões administrativas são permitidas em qualquer uma das portas (a menos que a ADMINONCLIENTPORT opção esteja definida como NO), mas, por padrão, utiliza a porta especificada por TCPADMINPORT.

THROUGHPUTDatathreshold kilobytes_per_second
Especifica a taxa de transferência que as sessões de cliente devem atingir para evitar o cancelamento após THROUGHPUTTIMETHRESHOL o minutes decorrer do prazo. O valor padrão 0 impede que as sessões dos clientes sejam verificadas quanto a uma taxa de transferência insuficiente. A taxa de transferência é calculada somando-se o número de bytes enviados e recebidos e dividindo-se pelo tempo de duração da sessão. A duração não inclui o tempo gasto na espera pela montagem dos dispositivos de armazenamento e começa no momento em que o cliente envia dados ao servidor para armazenamento. O valor mínimo é 0; o máximo é 99999999.
THROUGHPUTTimethreshold minutes
Especifica o limite para analisar as sessões dos clientes e cancelá-las caso o limite de taxa de transferência de dados não seja atingido (consulte THROUGHPUTDATATHRESHOLD). Esse limite não inclui o tempo gasto aguardando a montagem de mídias. O prazo começa a contar quando um cliente inicia o envio de dados ao servidor para armazenamento (em contraste com dados de configuração ou de manutenção da sessão). O valor padrão de 200 impede a análise das sessões dos clientes em busca de baixa taxa de transferência. O valor mínimo é 0; o máximo é 99999999.
UseLargeBuffers yes|no
Especifica que são utilizados buffers grandes para as comunicações cliente/servidor. O valor padrão YES indica que são utilizados buffers grandes; NO indica que eles não são utilizados.