scruboplog

Exclui as entradas de oplog para uma réplica

Aplicabilidade

Produto Tipo de Comando
MultiSite Subcomando de multiutil
Plataforma
UNIX
Windows

Sinopse

scruboplog

{ [ –cl/an clan-name ] [ –site site-name ] | [ –dbset dbset-name ] }
–fam/ily family-name  –u/ser username  –p/assword password
–before { date-time | oplog-ID }

Descrição

As entradas do oplog (log de operações) devem ser mantidas na réplica durante um período de tempo significativo. Elas são utilizadas quando a réplica gera pacotes de atualização para enviar a todas as outras réplicas. As entradas do oplog também ser necessárias para ajudar outras réplicas a se recuperarem dos defeitos.

Entretanto, ocasionalmente, é provável que você queira excluir (limpar) as entradas do oplog para otimizar o espaço da unidade de disco rígido no qual a réplica reside. Também é possível utilizar o comando scruboplog para excluir o oplog de uma réplica que não será mais utilizado.

Embora as entradas do oplog registrem apenas as alterações que ocorreram em sua réplica, ao longo do tempo essas informações poderiam precisar de tanto espaço quanto os próprios dados.

Antes de limpar as entradas do oplog para uma réplica, você deve certificar-se de que elas não sejam mais necessárias e que as outras réplicas na família tenham as informações que você deseja excluir do oplog da réplica. Além disso, é necessário sincronizar as réplicas em uma família antes de limpar os oplogs.

Também é possível usar o comando scruboplog para limpar os bancos de dados que não estejam implementados em um ambiente ClearQuest MultiSite e usar o recurso da Web de procura de texto completo do ClearQuest.

Restrições

Você deve ter privilégios de Superusuário.

Opções e Argumentos

Especificando o Clã, o Site e a Família

Padrão
Clã: primeiro clã replicado nesse site. Se houver mais de uma conexão dbset registrada nesse host, –clan será obrigatório.

Site: site atual. Se houver mais de um site nesse host, –site será obrigatório.

Família: nenhum padrão; você deve especificar uma família.

–cl/an clan-name
Nome do clã da réplica.
–site site-name
Nome do site da réplica.
–fam/ily family-name
Família do banco de dados do usuário: nome fornecido ao banco de dados do usuário quando ele foi criado.

Família do repositório de esquemas: o nome da família é MASTR.

Especificando o dbset e a Família

É possível usar o comando scruboplog para limpar bancos de dados que não estejam implementados em um ambiente ClearQuest MultiSite e usar o recurso da Web de procura de texto completo do ClearQuest.

Padrão
Conjunto de bancos de dados: versão ClearQuest.
Família: nenhum padrão; você deve especificar uma família.
dbset dbset-name
Nome da conexão com o banco de dados.
fam/ily family-name
Família do banco de dados do usuário: nome do banco de dados dado ao banco de dados do usuário quando ele é criado.
Família do repositório de esquemas: o nome da família é MASTR.

Especificando um Nome de Usuário e uma Senha

Padrão
Você deve especificar um nome de usuário e uma senha.
–u/ser user
Nome de um usuário com privilégios de superusuário.
–p/assword password
Senha associada ao usuário especificado.

Especificando as Entradas para Exclusão

Padrão
Você deve especificar as entradas a serem excluídas.
–before { date-time | oplog-ID }
Exclui todas as entradas do oplog antes do date-time ou oplog-ID especificado. O argumento não é inclusivo: as entradas do oplog criadas na data especificada ou na hora especificada não são excluídas e a entrada do oplog com o ID especificado não é excluída.

O argumento oplog-ID deve ser um inteiro.

Para assegurar que os oplogs não sejam excluídos por engano, é necessário especificar um ano quando utilizar esse comando. Se você digitar uma data sem especificar o ano, esse comando assumirá o ano atual do calendário; por exemplo, se, em fevereiro de 2006, você tentar remover todos os oplogs criados antes de 19 de novembro de 2005 e utilizar uma entrada de 19 de novembro, o scruboplog excluirá todos os oplogs criados antes de 19 de novembro de 2006, que inclui todos os oplogs no ano atual (pois eles são todos anteriores a novembro de 2006).

Para exibir o log de operações de uma réplica, utilize dumpoplog. O argumento date-time pode ter um dos seguintes formatos:

date.time | date | time
em que:
date:
= day-of-week | long-date
time:
= h[h]:m[m][:s[s]] [UTC [ [ + | - ]h[h][:m[m] ] ] ]
day-of-week:
= today |yesterday |Sunday | ... |Saturday |Sun | ... |Sat
long-date:
= d[d]month[[yy]yy]
month:
= January |... |December |Jan |... |Dec

Especifique o horário no formato de 24 horas, em relação ao fuso horário local. Se você omitir o horário, o valor padrão será 00:00:00. Se omitir date, o valor padrão será today. Se você omitir o século, o ano ou uma data específica, será utilizado o mais recente. Especifique UTC se você desejar que o horário seja resolvido para o mesmo momento no tempo, independentemente do fuso horário. Utilize o operador mais (+) ou menos (-) para especificar um deslocamento positivo ou negativo para o horário UTC. Se você especificar UTC sem deslocamentos de hora ou minuto, a configuração padrão será GMT (Hora de Greenwich). (As datas anteriores a 1 de janeiro de 1970 (UTC - Universal Coordinated Time) são inválidas).

Exemplos
  • 22-November-2002
  • sunday
  • yesterday.16:00
  • 0
  • 8-jun
  • 13:00
  • today
  • 9-Aug.10:00UTC

Exemplos

Nestes exemplos, as linhas são quebradas por questões de legibilidade. Cada comando deve ser digitado em uma única linha física.

  • Exclua entradas do oplog antes de 21 de janeiro de 2002 para a família DEV da réplica boston_hub.

    multiutil scruboplog -clan telecomm -site boston_hub -family DEV
    -user susan -p passwd -before 21-January-2002

  • Exclua entradas de oplog de 1 a 300 para a família TEST da réplica tokyo.

    multiutil scruboplog -clan testing -site tokyo -family TEST
    -user masako -p passwd -before 301

  • Exclua entradas de oplog antes de 1 de janeiro de 2009 para o banco de dados do usuário PTEST do conjunto de banco de dados CLSIC configurado onde o banco de dados do usuário não estiver implementado em uma configuração do ClearQuest MultiSite:

    multiutil scruboplog -dbset CLSIC -family PTEST -user susan -p passwd -before 1-January-2009


Feedback