Parâmetros para o comando db2mtool

O comando db2mtool possui muitos parâmetros.

Os seguintes parâmetros são requeridos para a maioria das acções de db2mtool:
  • setupSrcAddress: endereço de IP ou nome do sistema central para o nó de origem de configuração
  • setupSrcUser: o nome do perfil de utilizador
  • setupSrcPassword: a palavra-passe
  • setupSrcSysName: o nome do sistema do nó de origem de configuração
  • setupCpySysName: o nome do sistema do nó de cópia de configuração

A especificação dos parâmetros opcionais setupSrcUUID e setupCpyUUID é vivamente recomendada, mas não é requerida. Caso os nomes do sistema dos nós de origem de configuração e de cópia de configuração não sejam exclusivos na rede, então especifique os UUIDs para identificar exclusivamente cada nó.

As ferramentas de configuração têm de ler os ficheiros de configuração JSON a partir do nó de origem de configuração, como tal deverá facultar sempre os parâmetros da lista acima para todos os comandos de acção de clonagem. Estes parâmetros não são necessários quando utilizar comandos de acção de configuração: help, new, update, save, restore, reversecloneinfo, retrieveuuid e cluster.

O parâmetro config é requerido para algumas operações como, por exemplo, poweron e poweroff quando não é possível obter o ficheiro JSON a partir do nó de origem de configuração. Utilize o parâmetro config para transmitir o caminho e o nome do ficheiro de configuração JSON. As ferramentas de configuração irão ler o JSON a partir deste ficheiro em vez de obter o mesmo a partir da tabela de bases de dados no nó de origem de configuração.

Tabela 1. Parâmetros de db2mtool
Parâmetro Descrição
action Acção Tipo de acção
action=checksysbas acção de clonagem
action=cleanup acção de clonagem
action=cluster acção de conjuntos de unidades
action=flashcopy acção de clonagem
help ajuda para comandos
action=iaspcopy acção de clonagem
action=installCertificate acção de clonagem
action=listCertificate acção de clonagem
action=new acção de ficheiros de configuração
action=postiaspcopy acção de clonagem
action=poweroff acção de clonagem
action=poweron acção de clonagem
action=precheck acção de clonagem
action=preiaspcopy acção de clonagem
action=remotecopy acção de clonagem
action=restore acção de ficheiros de configuração
action=retrieveuuid acção de ficheiros de configuração
action=reversecloneinfo acção de ficheiros de configuração
action=save acção de ficheiros de configuração
action=start acção de clonagem
action=startiaspwarmclone acção de clonagem
action=startwarmclone acção de clonagem
action=update acção de ficheiros de configuração
config Especifica o caminho e nome de ficheiro do ficheiro de configuração JSON no nó actual. Este ficheiro será utilizado em vez de utilizar as informações de configuração de JSON armazenadas no ficheiro QMRDBJSON em QUSRSYS no nó de origem de configuração. Será ignorado caso sejam especificados os parâmetros setupSrcSysName e setupCpySysName.
dbIaspAutoVaryOff

Opcional. Indica se os IASPs de base de dados deverão ser desactivados automaticamente no início do processo de clonagem.

Este parâmetro é ignorado para a clonagem a quente.
dbIaspAutoVaryOn Opcional. Indica se os IASPs de base de dados deverão ser activados automaticamente no final do processo de clonagem.
dbiaspname

Opcional. Especifica os nomes dos IASPs de base de dados principais a clonar. É possível listar múltiplos IASPs separados por uma vírgula sem espaços.

Caso este parâmetro seja omitido, então todos os IASPs de base de dados definidos no ficheiro JSON serão clonados.

Os IASPs especificados e todos os respectivos IASPs secundários têm de ser adicionados primeiro ao ficheiro de configuração JSON.
dscli Opcional, válido apenas para armazenamento DS8000. Utilizado para especificar a localização da CLI do DS. A predefinição é /ibm/dscli/dscli.
ibmikspass Opcional. A palavra-passe para o arquivo de certificados *SYSTEM do nó no qual se encontra um supervisor de conjuntos de unidades em execução. É requerido para o supervisor de conjuntos de unidades quando instalar certificados.
jsonDB As informações da base de dados onde o ficheiro de configuração JSON está armazenado.
jsonFile O caminho do ficheiro de configuração JSON
jsonType Especifique o tipo de ficheiro JSON. Os valores válidos são: clone_info.json e meta_data.json
ksPass Opcional. Utilizado apenas para as acções installCertificate e listCertificate. Indica a palavra-passe do ficheiro de Arquivo de Chaves Java™. É necessário especificar a palavra-passe correcta no comando.
lclPowerHmcPass Parâmetro opcional para transmitir a palavra-passe do perfil de utilizador da HMC local. Utilize lclPowerHMCUser e lclPowerHMCPass em conjunto.
lclPowerHMCUser Parâmetro opcional para transmitir o nome do perfil de utilizador da HMC local. Utilize lclPowerHMCUser e lclPowerHMCPass em conjunto.
lclStgFile
lclStgPass
lclStgUser
Parâmetros opcionais, que são o ficheiro de utilizadores/palavras-passe/palavra-passe do Armazenamento (DS8000), ficheiro de utilizadores/chaves do Armazenamento (IBM Spectrum Virtualize) e utilizadores/palavras-passe da HMC de POWER. Os valores locais e remotos poderão ser os mesmos caso apenas possua um sistema de armazenamento ou uma HMC de POWER. Caso sejam especificados, os valores irão substituir os valores em clone_info.json.
logFile

Opcional. Especifica o caminho e nome de ficheiro a utilizar para o ficheiro de registo. O caminho predefinido será utilizado caso este parâmetro não seja especificado.

O caminho predefinido é: /qibm/userdata/qdb2mir/mrdb/tools/toolkit.setup.log
lpar Opcional. Utilizado apenas para as acções poweroff e poweron. Indica que sistema pretende ligar ou desligar. Os valores válidos são: source, copy, both, uuid.
operation Utilizado apenas para as acções poweroff e poweron. A operação do parâmetro é opcional; indica o tipo de encerramento executado para o nó de origem de configuração. Os valores válidos são:
osshutdown_immed
encerramento imediato do IBM® i
osshutdown_cntrld
encerramento controlado do IBM i
shutdown
encerramento da HMC
partitionName As informações da HMC utilizadas para obter o UUID da partição. Introduza o nome da partição.
powerHMCHost As informações da HMC utilizadas para obter o UUID da partição. Introduza o nome do sistema central ou endereço de IP da HMC.
powerHMCPass As informações da HMC utilizadas para obter o UUID da partição. Introduza a palavra-passe da HMC.
powerHMCUser As informações da HMC utilizadas para obter o UUID da partição. Introduza o nome de utilizador da HMC.
poweroffCopy Opcional. Indica se o processo de clonagem ou de limpeza encerra o nó de cópia de configuração caso este esteja activo. Os valores válidos são yes e no. O valor predefinido é yes.
pwEncrypted Parâmetro opcional para indicar se as palavras-passes armazenadas no ficheiro JSON são encriptadas ou não. Apenas deverá ser utilizado caso o ficheiro JSON tenha sido editado directamente para não guardar especificamente palavras-passe encriptadas. Os valores válidos são yes e no. O valor predefinido é yes.
rmtPowerHMCPass Parâmetro opcional para transmitir a palavra-passe do perfil de utilizador da HMC remota. Utilize rmtPowerHMCUser e rmtPowerHMCPass em conjunto
rmtPowerHMCUser Parâmetro opcional para transmitir o nome do perfil de utilizador da HMC remota. Utilize rmtPowerHMCUser e rmtPowerHMCPass em conjunto.
rmtStgFile
rmtStgPass
rmtStgUser
Parâmetros opcionais, que são o ficheiro de utilizadores/palavras-passe/palavra-passe do Armazenamento (DS8000), ficheiro de utilizadores/chaves do Armazenamento (IBM Spectrum Virtualize) e utilizadores/palavras-passe da HMC de POWER. Os valores locais e remotos poderão ser os mesmos caso apenas possua um sistema de armazenamento ou uma HMC de POWER. Caso sejam especificados, os valores irão substituir os valores em clone_info.json.
section

Parâmetro opcional para indicar a secção do ficheiro de configuração JSON a ser actualizada. Caso não seja especificado, a predefinição é actualizar todas as secções.

Caso jsonType=clone_info, os valores válidos são: ibmi, storage, csm, hmc e iasp.

Caso jsonType=meta_data, os valores válidos são: systemname, hostname, network, nrgdb2, nrgifs, nrgres, nrgorm e nrgmgr.
setupCpySysName Nome do sistema do nó de cópia de configuração. Caso este parâmetro e setupSrcSysName sejam ambos especificados, o parâmetro config será ignorado.
setupCpyUUID UUID da partição do nó de cópia de configuração
setupSrcAddress O nome do sistema central ou endereço de IP do nó de origem de configuração
setupSrcPassword Palavra-passe para o perfil de utilizador do nó de origem de configuração
setupSrcSysName Nome do sistema do nó de origem de configuração. Caso este parâmetro e setupCpySysName sejam ambos especificados, o parâmetro config será ignorado
setupSrcUser Perfil de utilizador no nó de origem de configuração
setupSrcUUID UUID da partição do nó de origem de configuração
svcCleanRate Opcional, apenas válido para sistemas de armazenamento IBM Spectrum Virtualize, indica a taxa de limpeza de FlashCopy.
svcCopyRate Opcional, apenas válido para sistemas de armazenamento IBM Spectrum Virtualize, indica a velocidade de cópia de FlashCopy.
systemName As informações da HMC utilizadas para obter o UUID da partição. Introduza o nome do sistema POWER.
timeout Opcional. O valor predefinido é 10800. Intervalo de tempo de espera de activação e desactivação de Power em segundos