# Manual do &kbackup;

## Introdução

&kbackup; é um programa que permite fazer backup de qualquer pasta ou arquivo, utilizando uma árvore de diretórios fácil de usar para selecionar o que deseja fazer backup. Ele permite salvar suas configurações em arquivos de perfil, onde um perfil é um arquivo de texto simples contendo definições para pastas e arquivos a serem incluídos ou excluídos do processo de backup. Além disso, permite definir onde o backup será salvo. O destino pode ser uma pasta local (⪚ um dispositivo montado localmente como um drive ZIP, pen drive, &etc;), mas também pode ser qualquer &URL; remota (⪚ smb://remoto/algo_caminho) para fazer backup de seus dados para um servidor central, &etc;

O programa também pode executar um backup automatizado sem o uso de interface gráfica. Pode-se simplesmente criar um perfil e usar suas configurações para informar ao &kbackup; o que fazer quando executar em modo não-interativo, ⪚ inicializando a partir de uma tarefa do cron.

O programa foi desenvolvido para ser muito simples em seu uso, para que possa ser usado por usuários que não são especialistas em computação.

O formato de armazenamento é o conhecido formato TAR, pelo qual os dados ainda podem ser armazenado em formato compactado (xz, bzip2 ou gzip).

A implementação atual apresenta apenas a etapa de backup. Para restaurar os dados de volta ao seu sistema, atualmente você precisa usar, ⪚, &dolphin; para abrir os arquivos de backup TAR e arrastar/soltar os arquivos de volta ao seu sistema de arquivos. Isso também é uma vantagem do uso do formato de arquivo TAR bem conhecido e bem suportado.

Se os arquivos estiverem compactados, você poderá descompactar todos os arquivos da atual pasta recursivamente com o seguinte comando:

    find . -name \*bz2 -print0 | xargs -0 bunzip2

Alternativamente, você pode usar &ark; para extrair um backup completo ou apenas alguns arquivos de um backup.

## Usando o &kbackup;

Basta selecionar as pastas nas quais deseja armazenar os dados. Isso é feito selecionando todas as pastas na árvore de pastas à esquerda da janela principal.

Se você selecionar uma pasta, o &kbackup; armazenará automaticamente todos os arquivos e subpastas dentro dela. Se você quiser excluir partes de uma pasta selecionada, basta desmarcar os arquivos/pastas dentro da pasta ainda selecionada.

Em geral, isso significa: uma pasta selecionada armazenará tudo o que estiver dentro dela e abaixo dela, exceto as partes desmarcadas. Isso também significa que, sempre que você reutilizar um perfil (veja abaixo) posteriormente e novos arquivos forem adicionados a uma pasta já selecionada para backup, todos os novos arquivos também serão armazenados.

Aqui está uma captura de tela do &kbackup; Captura de tela da janela principal

### Usando perfis

Para guardar uma seleção para uso posterior, basta salvá-la em um arquivo de perfil de backup. Use o menu Arquivo e selecione Salvar perfil.

Para recarregar uma seleção no &kbackup;, use o item de menu Arquivo Carregar perfil....

O &kbackup; salva em um perfil as seleções para todas as pastas/arquivos incluídos, pastas/arquivos excluídos, a pasta/&URL; de destino, o prefixo de arquivo definido, o tamanho máximo de arquivo de fatia definido, &etc;

Se você quiser facilitar o uso do backup diário do mesmo conjunto de arquivos, basta armazenar suas configurações em um perfil do &kbackup; (um arquivo `.kbp`) e passar esse arquivo na linha de comando.

⪚:

    kbackup meusDados.kbp

Dica: você também pode criar um atalho na sua área de trabalho para um arquivo `.kbp`, pois o tipo de arquivo está registrado para iniciar o &kbackup; com um clique duplo.

### Fatias do arquivamento

Como um meio de armazenamento normalmente tem capacidade limitada (por exemplo, um disco ZIP de 100 MB), o &kbackup; criará várias fatias do arquivo.

Cada fragmento do arquivo receberá seu próprio nome, que terá a seguinte aparência:

backup_2006.08.26-13.04.44_1.tar

O nome contém a data e hora de criação (que serão as mesmas para todas as fatias de um backup) e um número de sequência da fatia no final (_1 neste exemplo).

No menu Arquivo Configurações do perfil..., você pode definir um prefixo de arquivo diferente do padrão backup.

Na janela Configurações do perfil, você também pode definir um tamanho máximo de fatia de arquivo, que limita o tamanho da fatia mesmo que haja mais espaço disponível no dispositivo de destino. Isso ajuda a criar fatias de arquivo que podem ser gravadas posteriormente em um &CD;/&DVD;, &etc; Se você limitar explicitamente o tamanho de uma fatia de arquivo, o tamanho disponível será marcado com (*) na janela principal.

Mas mesmo que você defina uma fatia como tendo tamanho ilimitado, existem outras restrições que limitam o tamanho de uma fatia:

- limitado pela pasta de destino (quando armazenado diretamente em uma pasta local)

- limitado pela pasta `/tmp` quando criamos um arquivo temporário para posterior upload para um &URL; remoto

Nas Configurações do perfil, você também pode definir um número máximo de backups completos que serão mantidos na pasta de destino e, portanto, excluir automaticamente todos os backups mais antigos. Por exemplo, se você definir para 3, o &kbackup; manterá os 3 últimos backups e excluirá todos os mais antigos.

### Backup incremental

Com um backup incremental, nem todos os arquivos serão salvos a cada execução do backup, mas apenas os arquivos que foram alterados desde o último backup. Isso tem a grande vantagem de que o backup incremental geralmente inclui muito menos arquivos do que um backup completo e, portanto, será concluído em muito menos tempo.

O funcionamento é o seguinte: No perfil, você define um intervalo (em dias) para o backup completo. Por exemplo, ao definir 5 dias, o &kbackup; fará um backup completo de todos os arquivos a cada 5 dias. Sempre que você iniciar o &kbackup; antes do intervalo expirar com este perfil - independentemente da frequência com que você executa um backup - somente os arquivos que foram alterados desde o último backup serão salvos. O &kbackup; armazena o registro de data e hora do último backup no perfil e, portanto, sabe o que fazer na próxima execução.

Os arquivos de fatiamento de arquivo criados durante um backup incremental conterão o texto _inc, ⪚:

backup_2010.06.14-18.50.26_1_inc.tar

Os arquivos de backup completos não incluirão _inc no nome, ⪚:

backup_2010.06.13-20.58.14_1.tar

Quando se deseja restaurar arquivos a partir de um backup incremental, é importante procurar a versão mais recente do arquivo a ser restaurado em todos os arquivos _inc e, finalmente, também o último arquivo de backup completo. Essa é exatamente a desvantagem do backup incremental (mas não há vantagem sem desvantagem ;-) )

Se você deseja realizar um backup completo antes do tempo do ciclo incremental definido em um perfil, pode fazê-lo marcando a opção Forçar backup completo na interface do usuário. Quando o &kbackup; é iniciado pela linha de comando, isso pode ser feito usando a opção `--forceFull`

Um backup completo forçado reiniciará o ciclo de backup, &ie; o &kbackup; conta os dias até o próximo backup completo a partir do momento do último backup completo.

### Compressão do arquivo

O &kbackup; compactará os arquivos armazenados se você ativar essa opção nas configurações do perfil. Dependendo da disponibilidade no seu sistema, ele escolherá a compactação `xz`, `bzip2` ou `gzip`. O &kbackup; compactará todos os arquivos e armazenará todos os arquivos com uma extensão adicional (`.xz`, `.bzip2` ou `.gz`) no arquivo `.tar`, que então não estará compactado.

Quando você seleciona criar o backup em algum sistema de arquivos local (⪚ seu disco extra, unidade ZIP, &etc;) - o que significa que você não inseriu uma &URL; de destino remota - o &kbackup; pode dividir todo o backup em várias fatias compactadas devido a limitações de capacidade da mídia.

⪚:

backup_2006.08.26-13.04.44_1.tar

backup_2006.08.26-13.04.44_2.tar

### Automatizando o backup

Se você deseja automatizar o processo de backup, o &kbackup; oferece diferentes opções de linha de comando para ajudar com isso:

- `--auto`

  Ao executar o &kbackup; com esta opção e um perfil `.kbp` específico, ele será iniciado, carregará o perfil especificado, executará o backup e será encerrado ao término. Tudo isso é feito com uma interface de usuário &kbackup; visível.

- `--autobg`

  Ao executar o &kbackup; com esta opção e um perfil `.kbp` específico, ele executará o mesmo processo que com `--auto` mas sem exibir qualquer interface gráfica do usuário. Portanto, o sufixo bg significa background - tudo é feito em segundo plano. Assim, esta é a opção correta a ser usada quando você faz seus backups, ⪚ iniciados por uma tarefa do cron.

  Ao usar a opção `--autobg`, a saída do &kbackup; - que mostra o progresso do backup - é escrita no stderr. Por padrão, a saída inclui apenas algumas mensagens importantes e um resumo no final. Se você passar a opção `--verbose`, verá também o nome de cada arquivo que está sendo copiado.

## Referência de comandos

### A janela principal do &kbackup;

#### Menu Arquivo

Arquivo Abrir recente

- Exibe um submenu com os perfis usados ​​recentemente para facilitar a seleção.

Arquivo Novo perfil

- Limpa a seleção e o campo de entrada de destino, para poder definir um novo perfil.

Arquivo Carregar perfil...

- Carrega um perfil.

Arquivo Salvar perfil

- Salva todas as configurações no perfil atualmente carregado.

Arquivo Salvar perfil como...

- Salva todas as configurações em um perfil com um novo nome.

Arquivo Configurações do perfil...

- Nas configurações, você pode definir se os arquivos de fatias começam com o nome padrão backup ou com um nome alternativo. Você também pode limitar o tamanho da fatia de arquivo. Consulte o capítulo Fatias de arquivo. Essas configurações também são armazenadas no perfil.

&Ctrl;Q Arquivo Sair

- Sai do &kbackup;.

#### Menu Configurações

Configurações Ícone na área de notificação

- Quando esta opção está ativada, um ícone é exibido na bandeja do sistema, que reflete o status atual de uma operação de backup. Uma animação é exibida quando um backup está em andamento; caso contrário, você verá um ícone estático. Se esta opção estiver selecionada, o fechamento da janela principal não encerrará o &kbackup;. O aplicativo deve ser encerrado explicitamente selecionando a ação Sair. Através do menu de contexto do ícone do &kbackup; na bandeja do sistema, você pode iniciar e cancelar uma operação de backup - da mesma forma que na janela principal. A dica de ferramenta neste ícone também fornece informações de progresso (número de arquivos salvos, tamanho do backup e o último arquivo salvo).

Configurações Ativar todas as mensagens

- A ativação desta entrada limpa todos os sinalizadores Não perguntar novamente armazenados internamente para as janelas exibidas no &kbackup;.

Configurações Mostrar arquivos ocultos

- Ativa ou desativa a exibição de arquivos ocultos (precedidos por um ponto) na visualização em árvore. Use esta opção se quiser excluir alguns arquivos ocultos do backup. Se quiser excluir todos os arquivos ocultos, use um filtro de nome de arquivo nas configurações do perfil.

#### Menu Ajuda

O &kbackup; possui o item de menu comum do &kde; Ajuda, para mais informações, leia a seção sobre o Menu de Ajuda dos Fundamentos do &kde;.

## Guia do desenvolvedor do &kbackup;

O &kbackup; pode ser estendido usando um script shell (ou qualquer outro executável) que será iniciado em três pontos diferentes durante o processo de backup. A ideia por trás disso é permitir montar, desmontar e ejetar mídias de uma maneira específica do sistema, ou fazer outras coisas com os arquivos compactados gerados.

O script a ser executado deve ser fornecido com a opção de linha de comando `--script`.

Aqui está um exemplo de script:

### sliceScript.sh

    #!/bin/sh

    mode=$1
    archive=$2
    target=$3
    mountPoint=$4

    case "$mode" in
     "slice_init" )
        if [ "$mountPoint" != "" ]
        then
          mount /media/zip
          rm -f /media/zip/backup_2*.tar*
        fi
     ;;

     "slice_closed" )
     ;;

     "slice_finished" )
        if [ "$mountPoint" != "" ]
        then
          umount /media/zip
          eject /media/zip
        fi
     ;;
    esac

O script é sempre invocado com quatro argumentos de linha de comando:

- modo de invocação

- nome do arquivo (fatia) de arquivamento

- pasta de destino/&URL;

- ponto de montagem da pasta de destino, se for uma pasta local; caso contrário, uma string vazia

Existem três modos de invocação possíveis:

- slice_init

  chamada antes da criação de uma nova fatia de arquivo no disco

- slice_closed

  chamado após a criação de uma fatia do arquivo, mas antes de ela ser colocada na pasta de destino

  Isso pode ser usado se você quiser copiar a parte do arquivo para algum local adicional, ⪚ o arquivo é enviado para o servidor principal (via &URL; de destino), mas você também deseja manter o último backup no disco local.

- slice_finished

  chamado após uma fatia do arquivo ter sido transferida com sucesso para a pasta de destino

## Créditos e licença

&kbackup;

Direitos autorais do programa © 2006 - 2009 Martin Koller martin@kollix.at

Direitos autorais da documentação © 2006 - 2009 Martin Koller

Tradução de Marcus Gama marcus.gama@gmail.com

&underFDL; &underGPL;
&documentation.index;