From 06702225a48b885b82d77e8304fb55c4ef66051d Mon Sep 17 00:00:00 2001 From: Andrea Mazzoleni Date: Sun, 14 Dec 2025 10:21:34 +0100 Subject: [PATCH] Auto update --- index.html | 1 - manual-pt.html | 2028 ++++++++++++++++++++++++++++++++++++++++++++ manual-ru.html | 1987 +++++++++++++++++++++++++++++++++++++++++++ manual-uk.html | 2214 ++++++++++++++++++++++++++++++++++++++++++++++++ manual.html | 2 +- 5 files changed, 6230 insertions(+), 2 deletions(-) create mode 100644 manual-pt.html create mode 100644 manual-ru.html create mode 100644 manual-uk.html diff --git a/index.html b/index.html index 8c087183..4001b2b8 100644 --- a/index.html +++ b/index.html @@ -135,4 +135,3 @@ Now go to Download. - diff --git a/manual-pt.html b/manual-pt.html new file mode 100644 index 00000000..5e3b462c --- /dev/null +++ b/manual-pt.html @@ -0,0 +1,2028 @@ + + + + + + + + + + + + + +SnapRAID + + + + + + + + + + + + +
+ + + +

+Portuguese manual for SnapRAID. +

+ +

1 +Sinopse +

+
+snapraid [-c, --conf CONFIG]
+    [-f, --filter PATTERN] [-d, --filter-disk NAME]
+    [-m, --filter-missing] [-e, --filter-error]
+    [-a, --audit-only] [-h, --pre-hash] [-i, --import DIR]
+    [-p, --plan PERC|bad|new|full]
+    [-o, --older-than DAYS] [-l, --log FILE]
+    [-s, --spin-down-on-error] [-w, --bw-limit RATE]
+    [-Z, --force-zero] [-E, --force-empty]
+    [-U, --force-uuid] [-D, --force-device]
+    [-N, --force-nocopy] [-F, --force-full]
+    [-R, --force-realloc]
+    [-S, --start BLKSTART] [-B, --count BLKCOUNT]
+    [-L, --error-limit NUMBER]
+    [-A, --stats]
+    [-v, --verbose] [-q, --quiet]
+    status|smart|probe|up|down|diff|sync|scrub|fix|check
+    |list|dup|pool|devices|touch|rehash
+
+

+

+snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT]
+
+

2 +Descrição +

+SnapRAID é um programa de backup projetado para arrays de disco, +armazenando informações de paridade para recuperação de dados no +caso de até seis falhas de disco. +

+Destinado principalmente a centros de mídia domésticos com arquivos +grandes e que mudam com pouca frequência, o SnapRAID oferece vários recursos: +

+

+Para mais informações, visite o site oficial do SnapRAID: +

+
+
+https://www.snapraid.it/
+
+
+

3 +Limitações +

+SnapRAID é um híbrido entre um programa RAID e um programa de backup, +visando combinar os melhores benefícios de ambos. No entanto, ele tem +algumas limitações que você deve considerar antes de usá-lo. +

+A principal limitação é que, se um disco falhar e você não tiver +sincronizado recentemente, talvez não consiga recuperar totalmente. +Mais especificamente, você pode não conseguir recuperar até o tamanho dos +arquivos alterados ou excluídos desde a última operação de sincronização. +Isso ocorre mesmo que os arquivos alterados ou excluídos não estejam no +disco com falha. É por isso que o SnapRAID é mais adequado para +dados que raramente mudam. +

+Por outro lado, arquivos recém-adicionados não impedem a recuperação de +arquivos já existentes. Você perderá apenas os arquivos adicionados +recentemente se estiverem no disco com falha. +

+Outras limitações do SnapRAID são: +

+

4 +Primeiros Passos +

+Para usar o SnapRAID, você precisa primeiro selecionar um disco em seu array +de discos para dedicar às informações de `parity` (paridade). Com um +disco para paridade, você poderá recuperar de uma única falha de disco, +semelhante ao RAID5. +

+Se você quiser recuperar de mais falhas de disco, semelhante ao RAID6, +você deve reservar discos adicionais para paridade. Cada disco de paridade +adicional permite a recuperação de mais uma falha de disco. +

+Como discos de paridade, você deve escolher os maiores discos do array, +pois a informação de paridade pode crescer até o tamanho do maior +disco de dados no array. +

+Esses discos serão dedicados a armazenar os arquivos de `parity`. +Você não deve armazenar seus dados neles. +

+Em seguida, você deve definir os discos de `data` (dados) que deseja proteger +com o SnapRAID. A proteção é mais eficaz se esses discos +contiverem dados que raramente mudam. Por esse motivo, é melhor +NÃO incluir o disco C:\ do Windows ou os diretórios /home, /var e /tmp +do Unix. +

+A lista de arquivos é salva nos arquivos de `content` (conteúdo), geralmente +armazenados nos discos de dados, paridade ou boot. +Este arquivo contém os detalhes do seu backup, incluindo todos os +checksums para verificar sua integridade. +O arquivo de `content` é armazenado em várias cópias, e cada cópia deve +estar em um disco diferente para garantir que, mesmo em caso de múltiplas +falhas de disco, pelo menos uma cópia esteja disponível. +

+Por exemplo, suponha que você esteja interessado em apenas um nível de +proteção de paridade, e seus discos estejam localizados em: +

+
+
+/mnt/diskp <- disco selecionado para paridade
+/mnt/disk1 <- primeiro disco a proteger
+/mnt/disk2 <- segundo disco a proteger
+/mnt/disk3 <- terceiro disco a proteger
+
+
+

+Você deve criar o arquivo de configuração /etc/snapraid.conf com +as seguintes opções: +

+
+
+parity /mnt/diskp/snapraid.parity
+content /var/snapraid/snapraid.content
+content /mnt/disk1/snapraid.content
+content /mnt/disk2/snapraid.content
+data d1 /mnt/disk1/
+data d2 /mnt/disk2/
+data d3 /mnt/disk3/
+
+
+

+Se você estiver no Windows, deve usar o formato de caminho do Windows, com +letras de unidade e barras invertidas em vez de barras. +

+
+
+parity E:\snapraid.parity
+content C:\snapraid\snapraid.content
+content F:\array\snapraid.content
+content G:\array\snapraid.content
+data d1 F:\array\
+data d2 G:\array\
+data d3 H:\array\
+
+
+

+Se você tiver muitos discos e ficar sem letras de unidade, pode montar +discos diretamente em subpastas. Consulte: +

+
+
+https://www.google.com/search?q=Windows+mount+point
+
+
+

+Neste ponto, você está pronto para executar o comando `sync` para construir +as informações de paridade. +

+
+
+snapraid sync
+
+
+

+Este processo pode levar várias horas na primeira vez, dependendo do +tamanho dos dados já presentes nos discos. Se os discos estiverem vazios, +o processo é imediato. +

+Você pode pará-lo a qualquer momento pressionando Ctrl+C e, na próxima +execução, ele será retomado de onde foi interrompido. +

+Quando este comando for concluído, seus dados estarão SEGUROS. +

+Agora você pode começar a usar seu array como quiser e periodicamente +atualizar as informações de paridade executando o comando `sync`. +

4.1 +Scrubbing +

+Para verificar periodicamente os dados e a paridade em busca de erros, +você pode executar o comando `scrub`. +

+
+
+snapraid scrub
+
+
+

+Este comando compara os dados em seu array com o hash calculado +durante o comando `sync` para verificar a integridade. +

+Cada execução do comando verifica aproximadamente 8% do array, excluindo +dados já examinados nos 10 dias anteriores. +Você pode usar a opção -p, --plan para especificar uma quantidade diferente +e a opção -o, --older-than para especificar uma idade diferente em dias. +Por exemplo, para verificar 5% do array em busca de blocos com mais de +20 dias, use: +

+
+
+snapraid -p 5 -o 20 scrub
+
+
+

+Se erros silenciosos ou de entrada/saída forem encontrados durante o processo, +os blocos correspondentes serão marcados como ruins no arquivo de `content` +e listados no comando `status`. +

+
+
+snapraid status
+
+
+

+Para corrigi-los, você pode usar o comando `fix`, filtrando por blocos +ruins com a opção -e, --filter-error: +

+
+
+snapraid -e fix
+
+
+

+Na próxima execução de `scrub`, os erros desaparecerão do relatório de `status` +se estiverem realmente corrigidos. Para torná-lo mais rápido, você pode usar +-p bad para examinar apenas blocos marcados como ruins. +

+
+
+snapraid -p bad scrub
+
+
+

+Executar `scrub` em um array não sincronizado pode relatar erros causados por +arquivos removidos ou modificados. Esses erros são relatados na saída de `scrub`, +mas os blocos relacionados não são marcados como ruins. +

4.2 +Pooling +

+Nota: O recurso de pooling descrito abaixo foi substituído pela ferramenta +mergefs, que agora é a opção recomendada para usuários Linux na comunidade +SnapRAID. Mergefs oferece uma maneira mais flexível e eficiente de agrupar +várias unidades em um único ponto de montagem unificado, permitindo acesso +perfeito a arquivos em todo o seu array sem depender de links simbólicos. +Ele se integra bem ao SnapRAID para proteção de paridade e é comumente usado +em configurações como OpenMediaVault (OMV) ou configurações NAS personalizadas. +

+Para ter todos os arquivos em seu array mostrados na mesma árvore de +diretórios, você pode habilitar o recurso de `pooling`. Ele cria uma +visualização virtual somente leitura de todos os arquivos em seu array +usando links simbólicos. +

+Você pode configurar o diretório de `pooling` no arquivo de configuração com: +

+
+
+pool /pool
+
+
+

+ou, se você estiver no Windows, com: +

+
+
+pool C:\pool
+
+
+

+e, em seguida, executar o comando `pool` para criar ou atualizar a +visualização virtual. +

+
+
+snapraid pool
+
+
+

+Se você estiver usando uma plataforma Unix e quiser compartilhar este +diretório pela rede com máquinas Windows ou Unix, você deve adicionar +as seguintes opções ao seu /etc/samba/smb.conf: +

+
+
+# Na seção global de smb.conf
+unix extensions = no
+
+
+

+
+
+# Na seção de compartilhamento de smb.conf
+[pool]
+comment = Pool
+path = /pool
+read only = yes
+guest ok = yes
+wide links = yes
+follow symlinks = yes
+
+
+

+No Windows, compartilhar links simbólicos por uma rede requer que os +clientes os resolvam remotamente. Para habilitar isso, além de +compartilhar o diretório do pool, você também deve compartilhar todos +os discos de forma independente, usando os nomes de disco definidos no +arquivo de configuração como pontos de compartilhamento. Você também +deve especificar na opção `share` do arquivo de configuração o caminho +UNC do Windows que os clientes remotos precisam usar para acessar +esses discos compartilhados. +

+Por exemplo, operando a partir de um servidor chamado `darkstar`, você +pode usar as opções: +

+
+
+data d1 F:\array\
+data d2 G:\array\
+data d3 H:\array\
+pool C:\pool
+share \\darkstar
+
+
+

+e compartilhar os seguintes diretórios pela rede: +

+
+
+\\darkstar\pool -> C:\pool
+\\darkstar\d1 -> F:\array
+\\darkstar\d2 -> G:\array
+\\darkstar\d3 -> H:\array
+
+
+

+para permitir que clientes remotos acessem todos os arquivos em \\darkstar\pool. +

+Você também pode precisar configurar clientes remotos para habilitar +o acesso a symlinks remotos com o comando: +

+
+
+fsutil behavior set SymlinkEvaluation L2L:1 R2R:1 L2R:1 R2L:1
+
+
+

4.3 +Desexcluir (Undeleting) +

+O SnapRAID funciona mais como um programa de backup do que como um sistema +RAID, e pode ser usado para restaurar ou desexcluir arquivos para seu +estado anterior usando a opção -f, --filter: +

+
+
+snapraid fix -f FILE
+
+
+

+ou para um diretório: +

+
+
+snapraid fix -f DIR/
+
+
+

+Você também pode usá-lo para recuperar apenas arquivos excluídos +acidentalmente dentro de um diretório usando a opção -m, --filter-missing, +que restaura apenas arquivos ausentes, deixando todos os outros intocados. +

+
+
+snapraid fix -m -f DIR/
+
+
+

+Ou para recuperar todos os arquivos excluídos em todas as unidades com: +

+
+
+snapraid fix -m
+
+
+

4.4 +Recuperando +

+O pior aconteceu e você perdeu um ou mais discos! +

+NÃO ENTRE EM PÂNICO! Você será capaz de recuperá-los! +

+A primeira coisa que você deve fazer é evitar mais alterações em seu array +de discos. Desabilite quaisquer conexões remotas a ele e quaisquer +processos agendados, incluindo qualquer sincronização noturna ou scrub +agendado do SnapRAID. +

+Em seguida, prossiga com as seguintes etapas. +

4.4.1 +PASSO 1 -> Reconfigurar +

+Você precisa de algum espaço para recuperar, idealmente em discos sobressalentes +adicionais, mas um disco USB externo ou um disco remoto será suficiente. +

+Modifique o arquivo de configuração do SnapRAID para fazer com que a opção +`data` ou `parity` do disco com falha aponte para um local com espaço +vazio suficiente para recuperar os arquivos. +

+Por exemplo, se o disco `d1` falhou, mude de: +

+
+
+data d1 /mnt/disk1/
+
+
+

+para: +

+
+
+data d1 /mnt/new_spare_disk/
+
+
+

+Se o disco a ser recuperado for um disco de paridade, atualize a opção +`parity` apropriada. +Se você tiver vários discos com falha, atualize todas as opções de +configuração deles. +

4.4.2 +PASSO 2 -> Corrigir +

+Execute o comando fix, armazenando o log em um arquivo externo com: +

+
+
+snapraid -d NAME -l fix.log fix
+
+
+

+Onde NAME é o nome do disco, como `d1` em nosso exemplo anterior. +Se o disco a ser recuperado for um disco de paridade, use os nomes +`parity`, `2-parity`, etc. +Se você tiver vários discos com falha, use várias opções -d para +especificar todos eles. +

+Este comando levará muito tempo. +

+Certifique-se de ter alguns gigabytes livres para armazenar o arquivo fix.log. +Execute-o a partir de um disco com espaço livre suficiente. +

+Agora você recuperou tudo o que é recuperável. Se alguns arquivos estiverem +parcialmente ou totalmente irrecuperáveis, eles serão renomeados +adicionando a extensão `.unrecoverable`. +

+Você pode encontrar uma lista detalhada de todos os blocos irrecuperáveis +no arquivo fix.log, verificando todas as linhas que começam com `unrecoverable:`. +

+Se você não estiver satisfeito com a recuperação, pode tentar novamente +quantas vezes quiser. +

+Por exemplo, se você removeu arquivos do array após a última +`sync`, isso pode resultar em alguns arquivos não sendo recuperados. +Neste caso, você pode tentar novamente o `fix` usando a opção -i, --import, +especificando onde esses arquivos estão agora para incluí-los novamente +no processo de recuperação. +

+Se você estiver satisfeito com a recuperação, pode prosseguir, +mas observe que, após a sincronização, você não pode mais tentar +o comando `fix` novamente! +

4.4.3 +PASSO 3 -> Checar +

+Como uma verificação cautelosa, você pode agora executar um comando +`check` para garantir que tudo esteja correto no disco recuperado. +

+
+
+snapraid -d NAME -a check
+
+
+

+Onde NAME é o nome do disco, como `d1` em nosso exemplo anterior. +

+As opções -d e -a dizem ao SnapRAID para verificar apenas o disco +especificado e ignorar todos os dados de paridade. +

+Este comando levará muito tempo, mas se você não for excessivamente +cauteloso, pode pulá-lo. +

4.4.4 +PASSO 4 -> Sincronizar +

+Execute o comando `sync` para ressincronizar o array com o novo disco. +

+
+
+snapraid sync
+
+
+

+Se tudo for recuperado, este comando é imediato. +

5 +Comandos +

+SnapRAID fornece alguns comandos simples que permitem a você: + +

+Os comandos devem ser escritos em letras minúsculas. +

5.1 +status +

+Imprime um resumo do estado do array de discos. +

+Inclui informações sobre a fragmentação da paridade, a idade +dos blocos sem verificação e todos os erros silenciosos registrados +encontrados durante o scrubbing. +

+As informações apresentadas referem-se à última vez que você +executou `sync`. Modificações posteriores não são levadas em conta. +

+Se blocos ruins foram detectados, seus números de bloco são listados. +Para corrigi-los, você pode usar o comando `fix -e`. +

+Também mostra um gráfico que representa a última vez que cada bloco +foi examinado (scrubbed) ou sincronizado (synced). Blocos examinados +são mostrados com '*', blocos sincronizados, mas ainda não examinados, +com 'o'. +

+Nada é modificado. +

5.2 +smart +

+Imprime um relatório SMART de todos os discos no sistema. +

+Inclui uma estimativa da probabilidade de falha no próximo +ano, permitindo que você planeje substituições de manutenção de +discos que mostrem atributos suspeitos. +

+Esta estimativa de probabilidade é obtida correlacionando os atributos +SMART dos discos com os dados do Backblaze disponíveis em: +

+
+
+https://www.backblaze.com/hard-drive-test-data.html
+
+
+

+Se o SMART relatar que um disco está falhando, `FAIL` ou `PREFAIL` é +impresso para esse disco, e o SnapRAID retorna com um erro. +Neste caso, a substituição imediata do disco é altamente recomendada. +

+Outras possíveis strings de status são: + + + + +
+logfail + +No passado, alguns atributos estavam abaixo do +limite. +
+logerr + +O log de erros do dispositivo contém erros. +
+selferr + +O log de autoteste do dispositivo contém erros. +
+

+Se a opção -v, --verbose for especificada, uma análise estatística +mais profunda é fornecida. Esta análise pode ajudá-lo a decidir +se você precisa de mais ou menos paridade. +

+Este comando usa a ferramenta `smartctl` e é equivalente a executar +`smartctl -a` em todos os dispositivos. +

+Se seus dispositivos não forem detectados automaticamente corretamente, +você pode especificar um comando personalizado usando a opção +`smartctl` no arquivo de configuração. +

+Nada é modificado. +

5.3 +probe +

+Imprime o estado de ENERGIA de todos os discos no sistema. +

+`Standby` significa que o disco não está girando. `Active` significa +que o disco está girando. +

+Este comando usa a ferramenta `smartctl` e é equivalente a executar +`smartctl -n standby -i` em todos os dispositivos. +

+Se seus dispositivos não forem detectados automaticamente corretamente, +você pode especificar um comando personalizado usando a opção +`smartctl` no arquivo de configuração. +

+Nada é modificado. +

5.4 +up +

+Liga (spins up) todos os discos do array. +

+Você pode ligar apenas discos específicos usando a opção -d, --filter-disk. +

+Ligar todos os discos ao mesmo tempo requer muita energia. +Certifique-se de que sua fonte de alimentação pode suportar isso. +

+Nada é modificado. +

5.5 +down +

+Desliga (spins down) todos os discos do array. +

+Este comando usa a ferramenta `smartctl` e é equivalente a executar +`smartctl -s standby,now` em todos os dispositivos. +

+Você pode desligar apenas discos específicos usando a opção -d, --filter-disk. +

+Para desligar automaticamente em caso de erro, você pode usar a opção +-s, --spin-down-on-error com qualquer outro comando, o que é +equivalente a executar `down` manualmente quando ocorre um erro. +

+Nada é modificado. +

5.6 +diff +

+Lista todos os arquivos modificados desde o último `sync` que precisam ter +seus dados de paridade recalculados. +

+Este comando não verifica os dados do arquivo, mas apenas o carimbo de +data/hora, tamanho e inode do arquivo. +

+Após listar todos os arquivos alterados, um resumo das alterações é +apresentado, agrupado por: + + + + + + + + +
+equal + +Arquivos inalterados de antes. +
+added + +Arquivos adicionados que não estavam presentes antes. +
+removed + +Arquivos removidos. +
+updated + +Arquivos com tamanho ou carimbo de data/hora diferente, +o que significa que foram modificados. +
+moved + +Arquivos movidos para um diretório diferente no mesmo disco. +Eles são identificados por terem o mesmo nome, tamanho, +carimbo de data/hora e inode, mas um diretório diferente. +
+copied + +Arquivos copiados no mesmo ou em um disco diferente. +Observe que se eles forem realmente movidos para um disco +diferente, eles também serão contados em `removed`. +Eles são identificados por terem o mesmo nome, tamanho e +carimbo de data/hora. Se o carimbo de data/hora sub-segundo +for zero, o caminho completo deve corresponder, não apenas +o nome. +
+restored + +Arquivos com um inode diferente, mas nome, tamanho e carimbo +de data/hora correspondentes. Estes são geralmente arquivos +restaurados após terem sido excluídos. +
+

+Se uma `sync` for necessária, o código de retorno do processo é 2, +em vez do padrão 0. O código de retorno 1 é usado para uma condição +de erro genérica. +

+Nada é modificado. +

5.7 +sync +

+Atualiza as informações de paridade. Todos os arquivos modificados +no array de discos são lidos, e os dados de paridade correspondentes +são atualizados. +

+Você pode parar este processo a qualquer momento pressionando Ctrl+C, +sem perder o trabalho já feito. +Na próxima execução, o processo `sync` será retomado de onde +foi interrompido. +

+Se erros silenciosos ou de entrada/saída forem encontrados durante o processo, +os blocos correspondentes são marcados como ruins. +

+Os arquivos são identificados por caminho e/ou inode e verificados por +tamanho e carimbo de data/hora. +Se o tamanho ou carimbo de data/hora do arquivo for diferente, a paridade +dos dados é recalculada para todo o arquivo. +Se o arquivo for movido ou renomeado no mesmo disco, mantendo o +mesmo inode, a paridade não é recalculada. +Se o arquivo for movido para outro disco, a paridade é recalculada, +mas as informações de hash calculadas anteriormente são mantidas. +

+Os arquivos `content` e `parity` são modificados se necessário. +Os arquivos no array NÃO são modificados. +

5.8 +scrub +

+Examina (scrubs) o array, verificando se há erros silenciosos ou de +entrada/saída nos discos de dados e paridade. +

+Cada invocação verifica aproximadamente 8% do array, excluindo +dados já examinados nos últimos 10 dias. +Isso significa que examinar (scrubbing) uma vez por semana garante +que cada bit de dados seja verificado pelo menos uma vez a cada +três meses. +

+Você pode definir um plano de scrub ou quantidade diferente usando a opção +-p, --plan, que aceita: +bad - Examina blocos marcados como ruins. +new - Examina blocos recém-sincronizados ainda não examinados. +full - Examina tudo. +0-100 - Examina a porcentagem especificada de blocos. +

+Se você especificar um valor percentual, também pode usar a opção +-o, --older-than para definir a idade mínima do bloco. +Os blocos mais antigos são examinados primeiro, garantindo uma +verificação ideal. +Se você quiser examinar apenas os blocos recém-sincronizados ainda +não examinados, use a opção `-p new`. +

+Para obter detalhes do status do scrub, use o comando `status`. +

+Para qualquer erro silencioso ou de entrada/saída encontrado, os blocos +correspondentes são marcados como ruins no arquivo de `content`. +Esses blocos ruins são listados em `status` e podem ser corrigidos com +`fix -e`. +Após a correção, no próximo scrub, eles serão verificados novamente e, +se considerados corrigidos, a marcação de ruim será removida. +Para examinar apenas os blocos ruins, você pode usar o comando +`scrub -p bad`. +

+É recomendado executar `scrub` apenas em um array sincronizado para +evitar erros relatados causados por dados não sincronizados. Esses erros +são reconhecidos como não sendo erros silenciosos, e os blocos não são +marcados como ruins, mas tais erros são relatados na saída do comando. +

+O arquivo `content` é modificado para atualizar o tempo da última verificação +para cada bloco e para marcar blocos ruins. +Os arquivos `parity` NÃO são modificados. +Os arquivos no array NÃO são modificados. +

5.9 +fix +

+Corrige todos os arquivos e os dados de paridade. +

+Todos os arquivos e dados de paridade são comparados com o estado de +snapshot salvo na última `sync`. +Se uma diferença for encontrada, ela é revertida para o snapshot armazenado. +

+ATENÇÃO! O comando `fix` não diferencia entre erros e modificações +intencionais. Ele reverte incondicionalmente o estado do arquivo +para a última `sync`. +

+Se nenhuma outra opção for especificada, todo o array é processado. +Use as opções de filtro para selecionar um subconjunto de arquivos ou +discos para operar. +

+Para corrigir apenas os blocos marcados como ruins durante `sync` e `scrub`, +use a opção -e, --filter-error. +Ao contrário de outras opções de filtro, esta aplica correções apenas a +arquivos que não foram alterados desde a última `sync`. +

+O SnapRAID renomeia todos os arquivos que não podem ser corrigidos adicionando +a extensão `.unrecoverable`. +

+Antes de corrigir, todo o array é escaneado para encontrar quaisquer +arquivos movidos desde a última operação `sync`. +Esses arquivos são identificados por seu carimbo de data/hora, ignorando +seu nome e diretório, e são usados no processo de recuperação, se +necessário. +Se você moveu alguns deles para fora do array, pode usar a opção +-i, --import para especificar diretórios adicionais para escanear. +

+Os arquivos são identificados apenas por caminho, não por inode. +

+O arquivo `content` NÃO é modificado. +Os arquivos `parity` são modificados se necessário. +Os arquivos no array são modificados se necessário. +

5.10 +check +

+Verifica todos os arquivos e os dados de paridade. +

+Funciona como `fix`, mas apenas simula uma recuperação e nenhuma alteração +é escrita no array. +

+Este comando é destinado principalmente a verificações manuais, +como após um processo de recuperação ou em outras condições especiais. +Para verificações periódicas e agendadas, use `scrub`. +

+Se você usar a opção -a, --audit-only, apenas os dados do arquivo +são verificados, e os dados de paridade são ignorados para uma +execução mais rápida. +

+Os arquivos são identificados apenas por caminho, não por inode. +

+Nada é modificado. +

5.11 +list +

+Lista todos os arquivos contidos no array no momento da +última `sync`. +

+Com -v ou --verbose, o tempo sub-segundo também é mostrado. +

+Nada é modificado. +

5.12 +dup +

+Lista todos os arquivos duplicados. Dois arquivos são considerados +iguais se seus hashes corresponderem. Os dados do arquivo não são lidos; +apenas os hashes pré-calculados são usados. +

+Nada é modificado. +

5.13 +pool +

+Cria ou atualiza uma visualização virtual de todos +os arquivos em seu array de discos no diretório `pooling`. +

+Os arquivos não são copiados, mas ligados usando +links simbólicos. +

+Ao atualizar, todos os links simbólicos existentes e subdiretórios +vazios são excluídos e substituídos pela nova +visualização do array. Quaisquer outros arquivos regulares são +deixados no lugar. +

+Nada é modificado fora do diretório do pool. +

5.14 +devices +

+Imprime os dispositivos de baixo nível usados pelo array. +

+Este comando exibe as associações de dispositivos no array +e destina-se principalmente como uma interface de script. +

+As duas primeiras colunas são o ID do dispositivo de baixo nível e o +caminho. As próximas duas colunas são o ID do dispositivo de alto nível +e o caminho. A última coluna é o nome do disco no array. +

+Na maioria dos casos, você tem um dispositivo de baixo nível para cada disco +no array, mas em algumas configurações mais complexas, você pode ter +vários dispositivos de baixo nível usados por um único disco no array. +

+Nada é modificado. +

5.15 +touch +

+Define um carimbo de data/hora sub-segundo arbitrário para todos os arquivos +que o têm definido como zero. +

+Isso melhora a capacidade do SnapRAID de reconhecer arquivos movidos +e copiados, pois torna o carimbo de data/hora quase único, +reduzindo possíveis duplicatas. +

+Mais especificamente, se o carimbo de data/hora sub-segundo não for zero, +um arquivo movido ou copiado é identificado como tal se corresponder +ao nome, tamanho e carimbo de data/hora. Se o carimbo de data/hora +sub-segundo for zero, ele é considerado uma cópia apenas se o caminho +completo, tamanho e carimbo de data/hora corresponderem. +

+O carimbo de data/hora de precisão de segundo não é modificado, +portanto, todas as datas e horas de seus arquivos serão preservadas. +

5.16 +rehash +

+Agenda um novo hash de todo o array. +

+Este comando altera o tipo de hash usado, tipicamente ao atualizar +de um sistema de 32 bits para um de 64 bits, para alternar do +MurmurHash3 para o mais rápido SpookyHash. +

+Se você já estiver usando o hash ideal, este comando +não faz nada e informa que nenhuma ação é necessária. +

+O novo hash não é executado imediatamente, mas ocorre +progressivamente durante `sync` e `scrub`. +

+Você pode verificar o estado do novo hash usando `status`. +

+Durante o novo hash, o SnapRAID mantém a funcionalidade total, +com a única exceção de que `dup` não pode detectar arquivos duplicados +usando um hash diferente. +

6 +Opções +

+SnapRAID fornece as seguintes opções: + + +
+-c, --conf CONFIG +
+Seleciona o arquivo de configuração a ser usado. Se não for especificado, +no Unix, ele usa o arquivo `/usr/local/etc/snapraid.conf` se existir, +caso contrário, `/etc/snapraid.conf`. +No Windows, ele usa o arquivo `snapraid.conf` no mesmo +diretório que `snapraid.exe`. +
+ + +
+-f, --filter PATTERN +
+Filtra os arquivos a serem processados em `check` e `fix`. +Apenas os arquivos que correspondem ao padrão especificado são processados. +Esta opção pode ser usada várias vezes. +Consulte a seção PATTERN para obter mais detalhes sobre +especificações de padrão. +No Unix, certifique-se de que os caracteres globbing sejam citados, se usados. +Esta opção pode ser usada apenas com `check` e `fix`. +Não pode ser usada com `sync` e `scrub`, pois eles sempre +processam o array inteiro. +
+ + +
+-d, --filter-disk NAME +
+Filtra os discos a serem processados em `check`, `fix`, `up` e `down`. +Você deve especificar um nome de disco conforme definido no +arquivo de configuração. +Você também pode especificar discos de paridade com os nomes: `parity`, +`2-parity`, `3-parity`, etc., para limitar as operações a um +disco de paridade específico. +Se você combinar múltiplas opções --filter, --filter-disk e --filter-missing, +apenas os arquivos que correspondem a todos os filtros são selecionados. +Esta opção pode ser usada várias vezes. +Esta opção pode ser usada apenas com `check`, `fix`, `up` e `down`. +Não pode ser usada com `sync` e `scrub`, pois eles sempre +processam o array inteiro. +
+ + +
+-m, --filter-missing +
+Filtra os arquivos a serem processados em `check` e `fix`. +Apenas os arquivos ausentes ou excluídos do array são processados. +Quando usado com `fix`, isso age como um comando `undelete` (desexcluir). +Se você combinar múltiplas opções --filter, --filter-disk e --filter-missing, +apenas os arquivos que correspondem a todos os filtros são selecionados. +Esta opção pode ser usada apenas com `check` e `fix`. +Não pode ser usada com `sync` e `scrub`, pois eles sempre +processam o array inteiro. +
+ + +
+-e, --filter-error +
+Processa os arquivos com erros em `check` e `fix`. +Processa apenas arquivos que têm blocos marcados com erros silenciosos +ou de entrada/saída durante `sync` e `scrub`, conforme listado em `status`. +Esta opção pode ser usada apenas com `check` e `fix`. +
+ + +
+-p, --plan PERC|bad|new|full +
+Seleciona o plano de scrub. Se PERC for um valor numérico de 0 a 100, +ele é interpretado como a porcentagem de blocos a serem examinados. +Em vez de uma porcentagem, você pode especificar um plano: +`bad` examina blocos ruins, `new` examina blocos ainda não examinados, +e `full` examina tudo. +Esta opção pode ser usada apenas com `scrub`. +
+ + +
+-o, --older-than DAYS +
+Seleciona a parte mais antiga do array a ser processada em `scrub`. +DAYS é a idade mínima em dias para um bloco ser examinado; +o padrão é 10. +Os blocos marcados como ruins são sempre examinados, +independentemente desta opção. +Esta opção pode ser usada apenas com `scrub`. +
+ + +
+-a, --audit-only +
+Em `check`, verifica o hash dos arquivos sem +verificar os dados de paridade. +Se você estiver interessado apenas em verificar os dados do arquivo, +esta opção pode acelerar significativamente o processo de verificação. +Esta opção pode ser usada apenas com `check`. +
+ + +
+-h, --pre-hash +
+Em `sync`, executa uma fase de hash preliminar de todos os novos dados +para verificação adicional antes do cálculo da paridade. +Normalmente, em `sync`, nenhum hash preliminar é feito, e os novos +dados são hashados logo antes do cálculo da paridade, quando são lidos +pela primeira vez. +Este processo ocorre quando o sistema está sob +carga pesada, com todos os discos girando e uma CPU ocupada. +Esta é uma condição extrema para a máquina, e se ela tiver um +problema de hardware latente, erros silenciosos podem passar +despercebidos porque os dados ainda não foram hashados. +Para evitar esse risco, você pode habilitar o modo `pre-hash` para +ter todos os dados lidos duas vezes para garantir sua integridade. +Esta opção também verifica arquivos movidos dentro do array +para garantir que a operação de movimentação foi bem-sucedida e, +se necessário, permite que você execute uma operação fix antes de prosseguir. +Esta opção pode ser usada apenas com `sync`. +
+ + +
+-i, --import DIR +
+Importa do diretório especificado quaisquer arquivos excluídos +do array após a última `sync`. +Se você ainda tiver esses arquivos, eles podem ser usados por `check` +e `fix` para melhorar o processo de recuperação. +Os arquivos são lidos, incluindo em subdiretórios, e são +identificados independentemente de seu nome. +Esta opção pode ser usada apenas com `check` e `fix`. +
+ + +
+-s, --spin-down-on-error +
+Em qualquer erro, desliga (spins down) todos os discos gerenciados +antes de sair com um código de status diferente de zero. Isso +impede que as unidades permaneçam ativas e girando após uma +operação abortada, ajudando a evitar acúmulo desnecessário de +calor e consumo de energia. Use esta opção para garantir que os +discos sejam interrompidos com segurança, mesmo quando um comando falhar. +
+ + +
+-w, --bw-limit RATE +
+Aplica um limite de largura de banda global para todos os discos. A +RATE é o número de bytes por segundo. Você pode especificar um +multiplicador como K, M ou G (por exemplo, --bw-limit 1G). +
+ + +
+-A, --stats +
+Habilita uma visualização de status estendida que mostra informações +adicionais. A tela exibe dois gráficos: +O primeiro gráfico mostra o número de stripes em buffer para cada +disco, juntamente com o caminho do arquivo que está sendo +acessado atualmente nesse disco. Tipicamente, o disco mais lento não +terá buffer disponível, o que determina a largura de banda máxima +alcançável. +O segundo gráfico mostra a porcentagem de tempo gasto esperando +nos últimos 100 segundos. Espera-se que o disco mais lento +cause a maior parte do tempo de espera, enquanto outros discos +devem ter pouco ou nenhum tempo de espera porque podem usar seus +stripes em buffer. +Este gráfico também mostra o tempo gasto esperando por cálculos +de hash e cálculos RAID. +Todos os cálculos são executados em paralelo com as operações de disco. +Portanto, enquanto houver tempo de espera mensurável para +pelo menos um disco, isso indica que a CPU é rápida o suficiente +para acompanhar a carga de trabalho. +
+ + +
+-Z, --force-zero +
+Força a operação insegura de sincronizar um arquivo com tamanho zero +que era anteriormente não zero. +Se o SnapRAID detectar tal condição, ele para de prosseguir +a menos que você especifique esta opção. +Isso permite que você detecte facilmente quando, após uma falha +do sistema, alguns arquivos acessados foram truncados. +Esta é uma condição possível no Linux com os sistemas de arquivos +ext3/ext4. +Esta opção pode ser usada apenas com `sync`. +
+ + +
+-E, --force-empty +
+Força a operação insegura de sincronizar um disco com todos +os arquivos originais ausentes. +Se o SnapRAID detectar que todos os arquivos originalmente presentes +no disco estão ausentes ou foram reescritos, ele para de prosseguir +a menos que você especifique esta opção. +Isso permite que você detecte facilmente quando um sistema de +arquivos de dados não está montado. +Esta opção pode ser usada apenas com `sync`. +
+ + +
+-U, --force-uuid +
+Força a operação insegura de sincronizar, verificar e corrigir +com discos que tiveram seus UUIDs alterados. +Se o SnapRAID detectar que alguns discos tiveram seus UUIDs alterados, +ele para de prosseguir a menos que você especifique esta opção. +Isso permite que você detecte quando seus discos estão montados +nos pontos de montagem errados. +No entanto, é permitido ter uma única mudança de UUID com +paridade única e mais com paridade múltipla, porque este é +o caso normal ao substituir discos após uma recuperação. +Esta opção pode ser usada apenas com `sync`, `check` ou +`fix`. +
+ + +
+-D, --force-device +
+Força a operação insegura de corrigir com discos inacessíveis +ou com discos no mesmo dispositivo físico. +Por exemplo, se você perdeu dois discos de dados e tem um disco +sobressalente para recuperar apenas o primeiro, você pode ignorar +o segundo disco inacessível. +Ou, se você quiser recuperar um disco no espaço livre restante +em um disco já usado, compartilhando o mesmo dispositivo físico. +Esta opção pode ser usada apenas com `fix`. +
+ + +
+-N, --force-nocopy +
+Em `sync`, `check` e `fix`, desabilita a heurística de detecção +de cópia. Sem esta opção, o SnapRAID assume que arquivos com os +mesmos atributos, como nome, tamanho e carimbo de data/hora, +são cópias com os mesmos dados. +Isso permite a identificação de arquivos copiados ou movidos de um +disco para outro e reutiliza as informações de hash já calculadas +para detectar erros silenciosos ou para recuperar arquivos ausentes. +Em alguns casos raros, esse comportamento pode resultar em falsos +positivos ou em um processo lento devido a muitas verificações de hash, +e esta opção permite que você resolva tais problemas. +Esta opção pode ser usada apenas com `sync`, `check` e `fix`. +
+ + +
+-F, --force-full +
+Em `sync`, força um recálculo completo da paridade. +Esta opção pode ser usada quando você adiciona um novo nível de +paridade ou se você reverteu para um arquivo de conteúdo antigo +usando dados de paridade mais recentes. +Em vez de recriar a paridade do zero, isso permite +que você reutilize os hashes presentes no arquivo de conteúdo para +validar dados e manter a proteção de dados durante o processo +`sync` usando os dados de paridade existentes. +Esta opção pode ser usada apenas com `sync`. +
+ + +
+-R, --force-realloc +
+Em `sync`, força uma realocação completa de arquivos e reconstrução +da paridade. +Esta opção pode ser usada para realocar completamente todos os +arquivos, removendo a fragmentação, enquanto reutiliza os hashes +presentes no arquivo de conteúdo para validar dados. +Esta opção pode ser usada apenas com `sync`. +ATENÇÃO! Esta opção é apenas para especialistas e é altamente +recomendado não usá-la. +Você NÃO tem proteção de dados durante a operação `sync`. +
+ + +
+-l, --log FILE +
+Escreve um log detalhado para o arquivo especificado. +Se esta opção não for especificada, erros inesperados são +impressos na tela, resultando potencialmente em saída excessiva +em caso de muitos erros. Quando -l, --log é especificado, apenas +erros fatais que fazem o SnapRAID parar são impressos +na tela. +Se o caminho começar com '>>', o arquivo é aberto +no modo de anexação. Ocorrências de '%D' e '%T' no nome são +substituídas pela data e hora no formato YYYYMMDD e +HHMMSS. Em arquivos em lote do Windows, você deve duplicar +o caractere '%', por exemplo, resultado-%%D.log. Para usar '>>', você deve +colocar o nome entre aspas, por exemplo, `">>resultado.log"`. +Para enviar o log para a saída padrão ou erro padrão, +você pode usar `">&1"` e `">&2"`, respectivamente. +Consulte o arquivo snapraid_log.txt ou a página man para descrições +de tags de log. +
+ + +
+-L, --error-limit NUMBER +
+Define um novo limite de erro antes de interromper a execução. +Por padrão, o SnapRAID para se encontrar mais de 100 +erros de entrada/saída, indicando que um disco provavelmente está +falhando. +Esta opção afeta `sync` e `scrub`, que têm permissão +para continuar após o primeiro conjunto de erros de disco para tentar +completar suas operações. +No entanto, `check` e `fix` sempre param no primeiro erro. +
+ + +
+-S, --start BLKSTART +
+Começa o processamento a partir do número de bloco +especificado. Isso pode ser útil para tentar verificar +ou corrigir blocos específicos em caso de um disco danificado. +Esta opção é principalmente para recuperação manual avançada. +
+ + +
+-B, --count BLKCOUNT +
+Processa apenas o número especificado de blocos. +Esta opção é principalmente para recuperação manual avançada. +
+ + +
+-C, --gen-conf CONTENT +
+Gera um arquivo de configuração dummy a partir de um arquivo +de conteúdo existente. +O arquivo de configuração é escrito na saída padrão +e não sobrescreve um existente. +Este arquivo de configuração também contém as informações +necessárias para reconstruir os pontos de montagem do disco, +caso você perca todo o sistema. +
+ + +
+-v, --verbose +
+Imprime mais informações na tela. +Se especificado uma vez, ele imprime arquivos excluídos +e estatísticas adicionais. +Esta opção não tem efeito nos arquivos de log. +
+ + +
+-q, --quiet +
+Imprime menos informações na tela. +Se especificado uma vez, remove a barra de progresso; duas vezes, +as operações em execução; três vezes, as mensagens de informação; +quatro vezes, as mensagens de status. +Erros fatais são sempre impressos na tela. +Esta opção não tem efeito nos arquivos de log. +
+ + +
+-H, --help +
+Imprime uma tela de ajuda curta. +
+ + +
+-V, --version +
+Imprime a versão do programa. +
+

7 +Configuração +

+SnapRAID requer um arquivo de configuração para saber onde seu array +de discos está localizado e onde armazenar as informações de paridade. +

+No Unix, ele usa o arquivo `/usr/local/etc/snapraid.conf` se existir, +caso contrário, `/etc/snapraid.conf`. +No Windows, ele usa o arquivo `snapraid.conf` no mesmo +diretório que `snapraid.exe`. +

+Deve conter as seguintes opções (sensível a maiúsculas/minúsculas): +

7.1 +parity FILE [,FILE] ... +

+Define os arquivos a serem usados para armazenar as informações de paridade. +A paridade permite proteção contra uma única falha de disco, +semelhante ao RAID5. +

+Você pode especificar vários arquivos, que devem estar em discos diferentes. +Quando um arquivo não pode mais crescer, o próximo é usado. +O espaço total disponível deve ser pelo menos tão grande quanto o maior +disco de dados no array. +

+Você pode adicionar arquivos de paridade adicionais mais tarde, mas você +não pode reordenar ou removê-los. +

+Manter os discos de paridade reservados para paridade garante que +eles não se fragmentem, melhorando o desempenho. +

+No Windows, 256 MB são deixados sem uso em cada disco para evitar o +aviso sobre discos cheios. +

+Esta opção é obrigatória e pode ser usada apenas uma vez. +

7.2 +(2,3,4,5,6)-parity FILE [,FILE] ... +

+Define os arquivos a serem usados para armazenar informações de paridade extra. +

+Para cada nível de paridade especificado, um nível adicional de proteção +é habilitado: +

+

+Cada nível de paridade requer a presença de todos os níveis de paridade +anteriores. +

+As mesmas considerações que para a opção 'parity' se aplicam. +

+Estas opções são opcionais e podem ser usadas apenas uma vez. +

7.3 +z-parity FILE [,FILE] ... +

+Define um arquivo e formato alternativo para armazenar paridade tripla. +

+Esta opção é uma alternativa a '3-parity', destinada principalmente a +CPUs de baixo custo como ARM ou AMD Phenom, Athlon e Opteron que não +suportam o conjunto de instruções SSSE3. Nesses casos, ela fornece +melhor desempenho. +

+Este formato é semelhante, mas mais rápido do que o usado pelo ZFS RAIDZ3. +Assim como o ZFS, ele não funciona além da paridade tripla. +

+Ao usar '3-parity', você será avisado se for recomendado usar +o formato 'z-parity' para melhoria de desempenho. +

+É possível converter de um formato para outro ajustando +o arquivo de configuração com o z-parity ou 3-parity desejado +e usando 'fix' para recriá-lo. +

7.4 +content FILE +

+Define o arquivo a ser usado para armazenar a lista e os checksums de todos +os arquivos presentes em seu array de discos. +

+Pode ser colocado em um disco usado para dados, paridade ou +qualquer outro disco disponível. +Se você usar um disco de dados, este arquivo é automaticamente excluído +do processo `sync`. +

+Esta opção é obrigatória e pode ser usada várias vezes para salvar +múltiplas cópias do mesmo arquivo. +

+Você deve armazenar pelo menos uma cópia para cada disco de paridade usado +mais um. Usar cópias adicionais não prejudica. +

7.5 +data NAME DIR +

+Define o nome e o ponto de montagem dos discos de dados no +array. NAME é usado para identificar o disco e deve +ser único. DIR é o ponto de montagem do disco no +sistema de arquivos. +

+Você pode alterar o ponto de montagem conforme necessário, desde que +mantenha o NAME fixo. +

+Você deve usar uma opção para cada disco de dados no array. +

+Você pode renomear um disco mais tarde alterando o NAME diretamente +no arquivo de configuração e, em seguida, executando um comando 'sync'. +No caso de renomeação, a associação é feita usando o UUID +armazenado dos discos. +

7.6 +nohidden +

+Exclui todos os arquivos e diretórios ocultos. +No Unix, arquivos ocultos são aqueles que começam com `.`. +No Windows, são aqueles com o atributo oculto. +

7.7 +exclude/include PATTERN +

+Define os padrões de arquivo ou diretório a serem excluídos ou incluídos +no processo de sincronização. +Todos os padrões são processados na ordem especificada. +

+Se o primeiro padrão que corresponde for um `exclude`, o arquivo +é excluído. Se for um `include`, o arquivo é incluído. +Se nenhum padrão corresponder, o arquivo é excluído se o último padrão +especificado for um `include`, ou incluído se o último padrão +especificado for um `exclude`. +

+Consulte a seção PATTERN para obter mais detalhes sobre +especificações de padrão. +

+Esta opção pode ser usada várias vezes. +

7.8 +blocksize SIZE_IN_KIBIBYTES +

+Define o tamanho básico do bloco em kibibytes para a paridade. +Um kibibyte é 1024 bytes. +

+O `blocksize` padrão é 256, o que deve funcionar para a maioria dos casos. +

+ATENÇÃO! Esta opção é apenas para especialistas e é altamente +recomendado não alterar este valor. Para alterar este valor no +futuro, você precisará recriar toda a paridade! +

+Uma razão para usar um `blocksize` diferente é se você tiver muitos arquivos +pequenos, na ordem de milhões. +

+Para cada arquivo, mesmo que apenas alguns bytes, um bloco inteiro de +paridade é alocado, e com muitos arquivos, isso pode resultar em +espaço de paridade não utilizado significativo. +Quando você preenche completamente o disco de paridade, você não está +autorizado a adicionar mais arquivos aos discos de dados. +No entanto, a paridade desperdiçada não se acumula em todos os discos de dados. +O espaço desperdiçado resultante de um grande número de arquivos em um disco +de dados limita apenas a quantidade de dados nesse disco de dados, +não em outros. +

+Como uma aproximação, você pode assumir que metade do tamanho do bloco é +desperdiçada para cada arquivo. Por exemplo, com 100.000 arquivos e um +tamanho de bloco de 256 KiB, você desperdiçará 12,8 GB de paridade, o +que pode resultar em 12,8 GB a menos de espaço disponível no disco de dados. +

+Você pode verificar a quantidade de espaço desperdiçado em cada disco usando `status`. +Esta é a quantidade de espaço que você deve deixar livre nos discos +de dados ou usar para arquivos não incluídos no array. +Se este valor for negativo, significa que você está perto de encher +a paridade e representa o espaço que você ainda pode desperdiçar. +

+Para evitar esse problema, você pode usar uma partição maior para paridade. +Por exemplo, se a partição de paridade for 12,8 GB maior que os discos de dados, +você tem espaço extra suficiente para lidar com até 100.000 +arquivos em cada disco de dados sem qualquer espaço desperdiçado. +

+Um truque para obter uma partição de paridade maior no Linux é formatá-la +com o comando: +

+
+
+mkfs.ext4 -m 0 -T largefile4 DEVICE
+
+
+

+Isso resulta em cerca de 1,5% de espaço extra, aproximadamente 60 GB para +um disco de 4 TB, o que permite cerca de 460.000 arquivos em cada disco +de dados sem qualquer espaço desperdiçado. +

7.9 +hashsize SIZE_IN_BYTES +

+Define o tamanho do hash em bytes para os blocos salvos. +

+O `hashsize` padrão é 16 bytes (128 bits), o que deve funcionar +para a maioria dos casos. +

+ATENÇÃO! Esta opção é apenas para especialistas e é altamente +recomendado não alterar este valor. Para alterar este valor no +futuro, você precisará recriar toda a paridade! +

+Uma razão para usar um `hashsize` diferente é se o seu sistema tiver +memória limitada. Como regra geral, o SnapRAID tipicamente requer +1 GiB de RAM para cada 16 TB de dados no array. +

+Especificamente, para armazenar os hashes dos dados, o SnapRAID requer +aproximadamente TS*(1+HS)/BS bytes de RAM, +onde TS é o tamanho total em bytes do seu array de discos, BS é o +tamanho do bloco em bytes, e HS é o tamanho do hash em bytes. +

+Por exemplo, com 8 discos de 4 TB, um tamanho de bloco de 256 KiB +(1 KiB = 1024 bytes), e um tamanho de hash de 16, você obtém: +

+

+RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1.93 GiB
+
+

+Mudando para um tamanho de hash de 8, você obtém: +

+

+RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1.02 GiB
+
+

+Mudando para um tamanho de bloco de 512, você obtém: +

+

+RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 GiB
+
+

+Mudando para um tamanho de hash de 8 e um tamanho de bloco de 512, você obtém: +

+

+RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB
+
+

7.10 +autosave SIZE_IN_GIGABYTES +

+Salva automaticamente o estado ao sincronizar ou examinar após a +quantidade especificada de GB processados. +Esta opção é útil para evitar reiniciar longos comandos `sync` +do zero se interrompidos por uma falha de máquina ou qualquer outro evento. +

7.11 +temp_limit TEMPERATURE_CELSIUS +

+Define a temperatura máxima permitida do disco em Celsius. Quando especificado, +o SnapRAID verifica periodicamente a temperatura de todos os discos usando a +ferramenta smartctl. As temperaturas atuais dos discos são exibidas enquanto +o SnapRAID está operando. Se algum disco exceder este limite, todas as +operações param, e os discos são desligados (colocados em standby) pela +duração definida pela opção `temp_sleep`. Após o período de espera, as +operações são retomadas, potencialmente pausando novamente se o limite de +temperatura for atingido mais uma vez. +

+Durante a operação, o SnapRAID também analisa a curva de aquecimento de +cada disco e estima a temperatura estável de longo prazo que eles +devem atingir se a atividade continuar. A estimativa é realizada apenas +depois que a temperatura do disco aumentou quatro vezes, garantindo +que pontos de dados suficientes estejam disponíveis para estabelecer uma +tendência confiável. +Esta temperatura estável prevista é mostrada entre parênteses ao lado +do valor atual e ajuda a avaliar se o resfriamento do sistema é +adequado. Esta temperatura estimada é apenas para fins informativos +e não tem efeito no comportamento do SnapRAID. As ações do programa +são baseadas exclusivamente nas temperaturas reais medidas dos discos. +

+Para realizar esta análise, o SnapRAID precisa de uma referência para a +temperatura do sistema. Ele tenta primeiro lê-la dos sensores de hardware +disponíveis. Se nenhum sensor do sistema puder ser acessado, ele usa +a temperatura mais baixa do disco medida no início da execução como +referência de fallback. +

+Normalmente, o SnapRAID mostra apenas a temperatura do disco mais quente. +Para exibir a temperatura de todos os discos, use a opção -A ou --stats. +

7.12 +temp_sleep TIME_IN_MINUTES +

+Define o tempo de espera (standby time), em minutos, quando o limite de +temperatura é atingido. Durante este período, os discos permanecem +desligados. O padrão é 5 minutos. +

7.13 +pool DIR +

+Define o diretório de pooling onde a visualização virtual do array +de discos é criada usando o comando `pool`. +

+O diretório já deve existir. +

7.14 +share UNC_DIR +

+Define o caminho UNC do Windows necessário para acessar os discos remotamente. +

+Se esta opção for especificada, os links simbólicos criados no diretório +do pool usam este caminho UNC para acessar os discos. +Sem esta opção, os links simbólicos gerados usam apenas caminhos locais, +o que não permite compartilhar o diretório do pool pela rede. +

+Os links simbólicos são formados usando o caminho UNC especificado, +adicionando o nome do disco conforme especificado na opção `data`, +e finalmente adicionando o diretório e nome do arquivo. +

+Esta opção é necessária apenas para Windows. +

7.15 +smartctl DISK/PARITY OPTIONS... +

+Define opções smartctl personalizadas para obter os atributos SMART para +cada disco. Isso pode ser necessário para controladores RAID e alguns +discos USB que não podem ser detectados automaticamente. O placeholder +%s é substituído pelo nome do dispositivo, mas é opcional para dispositivos +fixos como controladores RAID. +

+DISK é o mesmo nome de disco especificado na opção `data`. +PARITY é um dos nomes de paridade: `parity`, `2-parity`, `3-parity`, +`4-parity`, `5-parity`, `6-parity` ou `z-parity`. +

+Nas OPTIONS especificadas, a string `%s` é substituída pelo +nome do dispositivo. Para controladores RAID, o dispositivo é +provavelmente fixo, e você pode não precisar usar `%s`. +

+Consulte a documentação do smartmontools para possíveis opções: +

+
+
+https://www.smartmontools.org/wiki/Supported_RAID-Controllers
+https://www.smartmontools.org/wiki/Supported_USB-Devices
+
+
+

+Por exemplo: +

+
+
+smartctl parity -d sat %s
+
+
+

7.16 +smartignore DISK/PARITY ATTR [ATTR...] +

+Ignora o atributo SMART especificado ao calcular a probabilidade +de falha do disco. Esta opção é útil se um disco relatar valores +incomuns ou enganosos para um atributo específico. +

+DISK é o mesmo nome de disco especificado na opção `data`. +PARITY é um dos nomes de paridade: `parity`, `2-parity`, `3-parity`, +`4-parity`, `5-parity`, `6-parity` ou `z-parity`. +O valor especial * pode ser usado para ignorar o atributo em todos os discos. +

+Por exemplo, para ignorar o atributo `Current Pending Sector Count` em +todos os discos: +

+
+
+smartignore * 197
+
+
+

+Para ignorá-lo apenas no primeiro disco de paridade: +

+
+
+smartignore parity 197
+
+
+

7.17 +Exemplos +

+Um exemplo de uma configuração típica para Unix é: +

+
+
+parity /mnt/diskp/snapraid.parity
+content /mnt/diskp/snapraid.content
+content /var/snapraid/snapraid.content
+data d1 /mnt/disk1/
+data d2 /mnt/disk2/
+data d3 /mnt/disk3/
+exclude /lost+found/
+exclude /tmp/
+smartctl d1 -d sat %s
+smartctl d2 -d usbjmicron %s
+smartctl parity -d areca,1/1 /dev/sg0
+smartctl 2-parity -d areca,2/1 /dev/sg0
+
+
+

+Um exemplo de uma configuração típica para Windows é: +

+
+
+parity E:\snapraid.parity
+content E:\snapraid.content
+content C:\snapraid\snapraid.content
+data d1 G:\array\
+data d2 H:\array\
+data d3 I:\array\
+exclude Thumbs.db
+exclude \$RECYCLE.BIN
+exclude \System Volume Information
+smartctl d1 -d sat %s
+smartctl d2 -d usbjmicron %s
+smartctl parity -d areca,1/1 /dev/arcmsr0
+smartctl 2-parity -d areca,2/1 /dev/arcmsr0
+
+
+

8 +Padrão (Pattern) +

+Padrões são usados para selecionar um subconjunto de arquivos a serem +excluídos ou incluídos no processo. +

+Existem quatro tipos diferentes de padrões: + + +
+FILE +
+Seleciona qualquer arquivo chamado FILE. Você pode usar quaisquer +caracteres globbing como * e ?, e classes de caracteres como [a-z]. +Este padrão se aplica apenas a arquivos, não a diretórios. +
+ + +
+DIR/ +
+Seleciona qualquer diretório chamado DIR e tudo dentro. +Você pode usar quaisquer caracteres globbing como * e ?. +Este padrão se aplica apenas a diretórios, não a arquivos. +
+ + +
+/PATH/FILE +
+Seleciona o caminho exato do arquivo especificado. Você pode usar +quaisquer caracteres globbing como * e ?, mas eles nunca correspondem +a uma barra de diretório. +Este padrão se aplica apenas a arquivos, não a diretórios. +
+ + +
+/PATH/DIR/ +
+Seleciona o caminho exato do diretório especificado e tudo +dentro. Você pode usar quaisquer caracteres globbing como * e ?, mas +eles nunca correspondem a uma barra de diretório. +Este padrão se aplica apenas a diretórios, não a arquivos. +
+

+Quando você especifica um caminho absoluto começando com /, ele é aplicado +no diretório raiz do array, não no diretório raiz do sistema de arquivos local. +

+No Windows, você pode usar a barra invertida \ em vez da barra. +Diretórios do sistema Windows, junctions, pontos de montagem e outros +diretórios especiais do Windows são tratados como arquivos, o que significa +que para excluí-los, você deve usar uma regra de arquivo, não uma de diretório. +

+Se o nome do arquivo contiver um caractere '*', '?', '[', +ou ']', você deve escapá-lo para evitar que seja interpretado como um +caractere globbing. No Unix, o caractere de escape é '\'; no Windows, é '^'. +Quando o padrão está na linha de comando, você deve duplicar o caractere +de escape para evitar que seja interpretado pelo shell de comando. +

+No arquivo de configuração, você pode usar diferentes estratégias para filtrar +os arquivos a serem processados. +A abordagem mais simples é usar apenas regras `exclude` para remover todos os +arquivos e diretórios que você não deseja processar. Por exemplo: +

+
+
+# Exclui qualquer arquivo chamado `*.unrecoverable`
+exclude *.unrecoverable
+# Exclui o diretório raiz `/lost+found`
+exclude /lost+found/
+# Exclui qualquer subdiretório chamado `tmp`
+exclude tmp/
+
+
+

+A abordagem oposta é definir apenas os arquivos que você deseja processar, +usando apenas regras `include`. Por exemplo: +

+
+
+# Inclui apenas alguns diretórios
+include /movies/
+include /musics/
+include /pictures/
+
+
+

+A abordagem final é misturar regras `exclude` e `include`. Neste caso, +a ordem das regras é importante. As regras anteriores têm +precedência sobre as posteriores. +Para simplificar, você pode listar todas as regras `exclude` primeiro e +depois todas as regras `include`. Por exemplo: +

+
+
+# Exclui qualquer arquivo chamado `*.unrecoverable`
+exclude *.unrecoverable
+# Exclui qualquer subdiretório chamado `tmp`
+exclude tmp/
+# Inclui apenas alguns diretórios
+include /movies/
+include /musics/
+include /pictures/
+
+
+

+Na linha de comando, usando a opção -f, você pode usar apenas padrões `include`. +Por exemplo: +

+
+
+# Verifica apenas os arquivos .mp3.
+# No Unix, use aspas para evitar a expansão globbing pelo shell.
+snapraid -f "*.mp3" check
+
+
+

+No Unix, ao usar caracteres globbing na linha de comando, você deve +citá-los para evitar que o shell os expanda. +

9 +Conteúdo (Content) +

+SnapRAID armazena a lista e os checksums de seus arquivos no arquivo content. +

+É um arquivo binário que lista todos os arquivos presentes em seu array +de discos, juntamente com todos os checksums para verificar sua integridade. +

+Este arquivo é lido e escrito pelos comandos `sync` e `scrub` e +lido pelos comandos `fix`, `check` e `status`. +

10 +Paridade (Parity) +

+SnapRAID armazena as informações de paridade do seu array nos arquivos parity. +

+Estes são arquivos binários contendo a paridade calculada de todos os +blocos definidos no arquivo `content`. +

+Estes arquivos são lidos e escritos pelos comandos `sync` e `fix` e +apenas lidos pelos comandos `scrub` e `check`. +

11 +Codificação (Encoding) +

+SnapRAID no Unix ignora qualquer codificação. Ele lê e armazena os +nomes de arquivo com a mesma codificação usada pelo sistema de arquivos. +

+No Windows, todos os nomes lidos do sistema de arquivos são convertidos +e processados no formato UTF-8. +

+Para que os nomes de arquivo sejam impressos corretamente, você deve +definir o console do Windows para o modo UTF-8 com o comando `chcp 65001` +e usar uma fonte TrueType como `Lucida Console` como fonte do console. +Isso afeta apenas os nomes de arquivo impressos; se você +redirecionar a saída do console para um arquivo, o arquivo resultante +estará sempre no formato UTF-8. +

12 +Direitos Autorais (Copyright) +

+Este arquivo é Copyright (C) 2025 Andrea Mazzoleni +

13 +Veja Também (See Also) +

+snapraid_log(1), rsync(1) + + +

+

+ +
+ + + + + + diff --git a/manual-ru.html b/manual-ru.html new file mode 100644 index 00000000..1cdfb325 --- /dev/null +++ b/manual-ru.html @@ -0,0 +1,1987 @@ + + + + + + + + + + + + + +SnapRAID + + + + + + + + + + + + +
+ + + +

+Russian manual for SnapRAID. +

+ +

1 +Synopsis +

+
+snapraid [-c, --conf CONFIG]
+    [-f, --filter PATTERN] [-d, --filter-disk NAME]
+    [-m, --filter-missing] [-e, --filter-error]
+    [-a, --audit-only] [-h, --pre-hash] [-i, --import DIR]
+    [-p, --plan PERC|bad|new|full]
+    [-o, --older-than DAYS] [-l, --log FILE]
+    [-s, --spin-down-on-error] [-w, --bw-limit RATE]
+    [-Z, --force-zero] [-E, --force-empty]
+    [-U, --force-uuid] [-D, --force-device]
+    [-N, --force-nocopy] [-F, --force-full]
+    [-R, --force-realloc]
+    [-S, --start BLKSTART] [-B, --count BLKCOUNT]
+    [-L, --error-limit NUMBER]
+    [-A, --stats]
+    [-v, --verbose] [-q, --quiet]
+    status|smart|probe|up|down|diff|sync|scrub|fix|check
+    |list|dup|pool|devices|touch|rehash
+
+

+

+snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT]
+
+

2 +Description +

+SnapRAID — это программа резервного копирования, разработанная для дисковых массивов, +хранящая информацию четности для восстановления данных в случае сбоя +до шести дисков. +

+В первую очередь предназначенная для домашних медиацентров с большими, +редко меняющимися файлами, SnapRAID предлагает несколько функций: +

+

+Для получения дополнительной информации, пожалуйста, посетите официальный сайт SnapRAID: +

+
+
+https://www.snapraid.it/
+
+
+

3 +Limitations +

+SnapRAID — это гибрид программы RAID и программы резервного копирования, +стремящийся объединить лучшие преимущества обеих. Однако у него есть +некоторые ограничения, которые следует учитывать перед использованием. +

+Основное ограничение заключается в том, что если диск выходит из строя, а вы +недавно не выполняли синхронизацию, вы можете не восстановить данные полностью. +В частности, вы можете не восстановить данные в объеме, равном размеру +измененных или удаленных файлов с момента последней операции синхронизации. +Это происходит, даже если измененные или удаленные файлы не находятся +на отказавшем диске. Вот почему SnapRAID лучше подходит для +данных, которые редко меняются. +

+С другой стороны, недавно добавленные файлы не препятствуют восстановлению уже +существующих файлов. Вы потеряете только недавно добавленные файлы, +если они находятся на отказавшем диске. +

+Другие ограничения SnapRAID: +

+

4 +Getting Started +

+Чтобы использовать SnapRAID, вам нужно сначала выбрать один диск в вашем дисковом массиве +для выделения под информацию `четности` (parity). С одним диском для четности, вы +сможете восстановиться после одного сбоя диска, подобно RAID5. +

+Если вы хотите восстановиться после большего числа сбоев дисков, подобно RAID6, +вы должны зарезервировать дополнительные диски для четности. Каждый дополнительный диск +четности позволяет восстановиться после еще одного сбоя диска. +

+В качестве дисков четности вы должны выбирать самые большие диски в массиве, +так как информация четности может вырасти до размера самого большого +диска данных в массиве. +

+Эти диски будут выделены для хранения файлов `четности`. +Вы не должны хранить на них свои данные. +

+Затем вы должны определить диски `данных`, которые вы хотите защитить +с помощью SnapRAID. Защита более эффективна, если эти диски +содержат данные, которые редко меняются. По этой причине лучше +НЕ включать диск Windows C:\ или каталоги Unix /home, /var и /tmp. +

+Список файлов сохраняется в файлах `content`, обычно +хранящихся на дисках данных, четности или загрузочных дисках. +Этот файл содержит детали вашего резервного копирования, включая все +контрольные суммы для проверки его целостности. +Файл `content` хранится в нескольких копиях, и каждая копия должна +находиться на отдельном диске, чтобы гарантировать, что даже в случае +множественных сбоев дисков, хотя бы одна копия будет доступна. +

+Например, предположим, что вы заинтересованы только в одном уровне защиты четности, +и ваши диски расположены по адресам: +

+
+
+/mnt/diskp <- выбранный диск для четности
+/mnt/disk1 <- первый диск для защиты
+/mnt/disk2 <- второй диск для защиты
+/mnt/disk3 <- третий диск для защиты
+
+
+

+Вы должны создать файл конфигурации /etc/snapraid.conf со +следующими опциями: +

+
+
+parity /mnt/diskp/snapraid.parity
+content /var/snapraid/snapraid.content
+content /mnt/disk1/snapraid.content
+content /mnt/disk2/snapraid.content
+data d1 /mnt/disk1/
+data d2 /mnt/disk2/
+data d3 /mnt/disk3/
+
+
+

+Если вы используете Windows, вам следует использовать формат пути Windows, +с буквами дисков и обратными слешами вместо прямых. +

+
+
+parity E:\snapraid.parity
+content C:\snapraid\snapraid.content
+content F:\array\snapraid.content
+content G:\array\snapraid.content
+data d1 F:\array\
+data d2 G:\array\
+data d3 H:\array\
+
+
+

+Если у вас много дисков и заканчиваются буквы дисков, вы можете монтировать +диски непосредственно в подпапки. См.: +

+
+
+https://www.google.com/search?q=Windows+mount+point
+
+
+

+На этом этапе вы готовы запустить команду `sync` для создания +информации четности. +

+
+
+snapraid sync
+
+
+

+Этот процесс может занять несколько часов в первый раз, в зависимости от размера +данных, уже присутствующих на дисках. Если диски пустые, +процесс происходит немедленно. +

+Вы можете остановить его в любое время, нажав Ctrl+C, и при следующем запуске он +возобновит работу с того места, где был прерван. +

+Когда эта команда завершится, ваши данные ЗАЩИЩЕНЫ. +

+Теперь вы можете начать использовать свой массив, как вам угодно, и периодически +обновлять информацию четности, запуская команду `sync`. +

4.1 +Scrubbing +

+Для периодической проверки данных и четности на наличие ошибок, вы можете +запустить команду `scrub`. +

+
+
+snapraid scrub
+
+
+

+Эта команда сравнивает данные в вашем массиве с хэшем, вычисленным +во время команды `sync`, для проверки целостности. +

+Каждый запуск команды проверяет примерно 8% массива, исключая данные, +уже проверенные за предыдущие 10 дней. +Вы можете использовать опцию -p, --plan, чтобы указать другое количество, +и опцию -o, --older-than, чтобы указать другой возраст в днях. +Например, для проверки 5% массива на наличие блоков старше 20 дней, используйте: +

+
+
+snapraid -p 5 -o 20 scrub
+
+
+

+Если во время процесса обнаруживаются скрытые ошибки или ошибки ввода/вывода, +соответствующие блоки помечаются как плохие в файле `content` +и перечисляются в команде `status`. +

+
+
+snapraid status
+
+
+

+Чтобы исправить их, вы можете использовать команду `fix`, фильтруя плохие блоки +с помощью опции -e, --filter-error: +

+
+
+snapraid -e fix
+
+
+

+При следующем `scrub` ошибки исчезнут из отчета `status`, +если они действительно исправлены. Чтобы ускорить процесс, вы можете использовать +-p bad для проверки только блоков, помеченных как плохие. +

+
+
+snapraid -p bad scrub
+
+
+

+Запуск `scrub` на несинхронизированном массиве может сообщить об ошибках, вызванных +удаленными или измененными файлами. Эти ошибки сообщаются в выводе `scrub`, +но соответствующие блоки не помечаются как плохие. +

4.2 +Pooling +

+Примечание: Функция объединения (pooling), описанная ниже, была заменена инструментом +mergefs, который теперь является рекомендуемым вариантом для пользователей Linux +в сообществе SnapRAID. Mergefs предоставляет более гибкий и эффективный +способ объединения нескольких дисков в единую точку монтирования, +обеспечивая беспрепятственный доступ к файлам по всему массиву без +опоры на символические ссылки. Он хорошо интегрируется со SnapRAID для +защиты четности и обычно используется в установках, таких как OpenMediaVault (OMV) +или пользовательских конфигурациях NAS. +

+Чтобы все файлы в вашем массиве отображались в одном дереве каталогов, +вы можете включить функцию `pooling`. Она создает виртуальное +представление всех файлов в вашем массиве только для чтения, используя +символические ссылки. +

+Вы можете настроить каталог `pooling` в файле конфигурации с помощью: +

+
+
+pool /pool
+
+
+

+или, если вы используете Windows, с помощью: +

+
+
+pool C:\pool
+
+
+

+а затем запустить команду `pool` для создания или обновления виртуального представления. +

+
+
+snapraid pool
+
+
+

+Если вы используете платформу Unix и хотите предоставить общий доступ к этому каталогу +по сети как для машин Windows, так и для Unix, вы должны добавить +следующие опции в ваш /etc/samba/smb.conf: +

+
+
+# В глобальном разделе smb.conf
+unix extensions = no
+
+
+

+
+
+# В разделе общего ресурса smb.conf
+[pool]
+comment = Pool
+path = /pool
+read only = yes
+guest ok = yes
+wide links = yes
+follow symlinks = yes
+
+
+

+В Windows совместное использование символических ссылок по сети требует, чтобы клиенты +разрешали их удаленно. Чтобы включить это, помимо предоставления общего доступа +к каталогу pool, вы также должны предоставить общий доступ ко всем дискам +независимо, используя имена дисков, определенные в файле конфигурации, в качестве +точек общего доступа. Вы также должны указать в опции `share` файла +конфигурации путь UNC Windows, который удаленные клиенты должны использовать +для доступа к этим общим дискам. +

+Например, работая с сервера с именем `darkstar`, вы можете использовать +опции: +

+
+
+data d1 F:\array\
+data d2 G:\array\
+data d3 H:\array\
+pool C:\pool
+share \\darkstar
+
+
+

+и предоставить общий доступ к следующим каталогам по сети: +

+
+
+\\darkstar\pool -> C:\pool
+\\darkstar\d1 -> F:\array
+\\darkstar\d2 -> G:\array
+\\darkstar\d3 -> H:\array
+
+
+

+чтобы разрешить удаленным клиентам доступ ко всем файлам по адресу \\darkstar\pool. +

+Вам также может потребоваться настроить удаленные клиенты для включения доступа к +удаленным символическим ссылкам с помощью команды: +

+
+
+fsutil behavior set SymlinkEvaluation L2L:1 R2R:1 L2R:1 R2L:1
+
+
+

4.3 +Undeleting +

+SnapRAID функционирует скорее как программа резервного копирования, чем как система RAID, +и может использоваться для восстановления или отмены удаления файлов до их +предыдущего состояния с помощью опции -f, --filter: +

+
+
+snapraid fix -f FILE
+
+
+

+или для каталога: +

+
+
+snapraid fix -f DIR/
+
+
+

+Вы также можете использовать его для восстановления только случайно удаленных файлов внутри +каталога с помощью опции -m, --filter-missing, которая восстанавливает +только отсутствующие файлы, оставляя все остальные нетронутыми. +

+
+
+snapraid fix -m -f DIR/
+
+
+

+Или для восстановления всех удаленных файлов на всех дисках с помощью: +

+
+
+snapraid fix -m
+
+
+

4.4 +Recovering +

+Случилось худшее, и вы потеряли один или несколько дисков! +

+НЕ ПАНИКУЙТЕ! Вы сможете их восстановить! +

+Первое, что вы должны сделать, это избегать дальнейших изменений в вашем дисковом массиве. +Отключите любые удаленные подключения к нему и любые запланированные процессы, +включая любое запланированное ночное sync или scrub SnapRAID. +

+Затем приступайте к следующим шагам. +

4.4.1 +STEP 1 -> Reconfigure +

+Вам нужно место для восстановления, в идеале на дополнительных +запасных дисках, но внешнего USB-диска или удаленного диска будет достаточно. +

+Измените файл конфигурации SnapRAID, чтобы опция `data` или `parity` +отказавшего диска указывала на место с достаточным пустым +пространством для восстановления файлов. +

+Например, если диск `d1` вышел из строя, измените с: +

+
+
+data d1 /mnt/disk1/
+
+
+

+на: +

+
+
+data d1 /mnt/new_spare_disk/
+
+
+

+Если восстанавливаемый диск является диском четности, обновите соответствующую опцию `parity`. +Если у вас несколько отказавших дисков, обновите все их опции конфигурации. +

4.4.2 +STEP 2 -> Fix +

+Запустите команду fix, сохраняя журнал во внешнем файле с помощью: +

+
+
+snapraid -d NAME -l fix.log fix
+
+
+

+Где NAME — это имя диска, например `d1` в нашем предыдущем примере. +Если восстанавливаемый диск является диском четности, используйте имена `parity`, `2-parity` +и т. д. +Если у вас несколько отказавших дисков, используйте несколько опций -d, чтобы указать +их все. +

+Эта команда займет много времени. +

+Убедитесь, что у вас есть несколько гигабайт свободного места для хранения файла fix.log. +Запустите ее с диска с достаточным свободным местом. +

+Теперь вы восстановили все, что можно было восстановить. Если некоторые файлы +частично или полностью невосстановимы, они будут переименованы с добавлением +расширения `.unrecoverable`. +

+Вы можете найти подробный список всех невосстановимых блоков в файле fix.log, +проверяя все строки, начинающиеся с `unrecoverable:`. +

+Если вы не удовлетворены восстановлением, вы можете повторять его столько +раз, сколько пожелаете. +

+Например, если вы удалили файлы из массива после последнего +`sync`, это может привести к тому, что некоторые файлы не будут восстановлены. +В этом случае вы можете повторить `fix`, используя опцию -i, --import, +указав, где эти файлы находятся сейчас, чтобы снова включить их в +процесс восстановления. +

+Если вы удовлетворены восстановлением, вы можете продолжить, +но учтите, что после синхронизации вы больше не сможете повторить команду `fix`! +

4.4.3 +STEP 3 -> Check +

+В качестве осторожной проверки, вы можете теперь запустить команду `check`, чтобы убедиться, +что все в порядке на восстановленном диске. +

+
+
+snapraid -d NAME -a check
+
+
+

+Где NAME — это имя диска, например `d1` в нашем предыдущем примере. +

+Опции -d и -a говорят SnapRAID проверить только указанный диск +и игнорировать все данные четности. +

+Эта команда займет много времени, но если вы не чрезмерно осторожны, +вы можете ее пропустить. +

4.4.4 +STEP 4 -> Sync +

+Запустите команду `sync`, чтобы ресинхронизировать массив с новым диском. +

+
+
+snapraid sync
+
+
+

+Если все восстановлено, эта команда выполняется немедленно. +

5 +Commands +

+SnapRAID предоставляет несколько простых команд, которые позволяют: + +

+Команды должны быть написаны строчными буквами. +

5.1 +status +

+Печатает сводку состояния дискового массива. +

+Она включает информацию о фрагментации четности, о том, насколько старые +блоки без проверки, и все записанные скрытые ошибки, +возникшие во время scrubbing. +

+Представленная информация относится к последнему времени, когда вы +запускали `sync`. Более поздние изменения не учитываются. +

+Если были обнаружены плохие блоки, перечисляются их номера. +Чтобы исправить их, вы можете использовать команду `fix -e`. +

+Он также показывает график, представляющий последнее время, когда каждый блок +был проверен (`scrubbed`) или синхронизирован (`synced`). Проверенные блоки +обозначены символом '*', блоки, синхронизированные, но еще не проверенные, +символом 'o'. +

+Ничего не изменяется. +

5.2 +smart +

+Печатает отчет SMART всех дисков в системе. +

+Он включает оценку вероятности сбоя в следующем году, +позволяя планировать плановую замену дисков, которые показывают +подозрительные атрибуты. +

+Эта оценка вероятности получена путем корреляции атрибутов SMART +дисков с данными Backblaze, доступными по адресу: +

+
+
+https://www.backblaze.com/hard-drive-test-data.html
+
+
+

+Если SMART сообщает, что диск выходит из строя, для этого диска +выводится `FAIL` или `PREFAIL`, и SnapRAID возвращает ошибку. +В этом случае немедленная замена диска настоятельно рекомендуется. +

+Другие возможные строки статуса: + + + + +
+logfail + +В прошлом некоторые атрибуты были ниже +порогового значения. +
+logerr + +Журнал ошибок устройства содержит ошибки. +
+selferr + +Журнал самотестирования устройства содержит ошибки. +
+

+Если указана опция -v, --verbose, предоставляется более глубокий +статистический анализ. Этот анализ может помочь вам решить, нужно ли вам +больше или меньше четности. +

+Эта команда использует инструмент `smartctl` и эквивалентна запуску +`smartctl -a` на всех устройствах. +

+Если ваши устройства не обнаруживаются автоматически правильно, вы можете указать +пользовательскую команду, используя опцию `smartctl` в файле +конфигурации. +

+Ничего не изменяется. +

5.3 +probe +

+Печатает состояние POWER всех дисков в системе. +

+`Standby` означает, что диск не вращается. `Active` означает, +что диск вращается. +

+Эта команда использует инструмент `smartctl` и эквивалентна запуску +`smartctl -n standby -i` на всех устройствах. +

+Если ваши устройства не обнаруживаются автоматически правильно, вы можете указать +пользовательскую команду, используя опцию `smartctl` в файле +конфигурации. +

+Ничего не изменяется. +

5.4 +up +

+Раскручивает все диски массива. +

+Вы можете раскрутить только определенные диски, используя опцию -d, --filter-disk. +

+Раскручивание всех дисков одновременно требует много энергии. +Убедитесь, что ваш блок питания может это выдержать. +

+Ничего не изменяется. +

5.5 +down +

+Останавливает вращение всех дисков массива. +

+Эта команда использует инструмент `smartctl` и эквивалентна запуску +`smartctl -s standby,now` на всех устройствах. +

+Вы можете остановить вращение только определенных дисков, используя опцию -d, --filter-disk. +

+Чтобы автоматически остановить вращение при ошибке, вы можете использовать опцию +-s, --spin-down-on-error с любой другой командой, что эквивалентно +ручному запуску `down` при возникновении ошибки. +

+Ничего не изменяется. +

5.6 +diff +

+Перечисляет все файлы, измененные с момента последнего `sync`, для которых +требуется пересчитать данные четности. +

+Эта команда не проверяет данные файла, а только метку времени файла, +размер и inode. +

+После перечисления всех измененных файлов представляется сводка изменений, +сгруппированных по: + + + + + + + + +
+equal + +Файлы, не измененные по сравнению с предыдущим состоянием. +
+added + +Добавленные файлы, которых не было раньше. +
+removed + +Удаленные файлы. +
+updated + +Файлы с другим размером или меткой времени, что означает, что они +были изменены. +
+moved + +Файлы, перемещенные в другой каталог на том же диске. +Они идентифицируются как имеющие то же имя, размер, метку времени +и inode, но другой каталог. +
+copied + +Файлы, скопированные на тот же или другой диск. Обратите внимание, что если +они действительно перемещены на другой диск, они также будут +учтены в `removed`. +Они идентифицируются как имеющие то же имя, размер и +метку времени. Если метка времени с точностью до доли секунды равна нулю, +полный путь должен совпадать, а не только имя. +
+restored + +Файлы с другим inode, но совпадающими именем, размером и меткой времени. +Обычно это файлы, восстановленные после удаления. +
+

+Если требуется `sync`, код возврата процесса равен 2, а не +по умолчанию 0. Код возврата 1 используется для общего условия ошибки. +

+Ничего не изменяется. +

5.7 +sync +

+Обновляет информацию четности. Все измененные файлы +в дисковом массиве считываются, и соответствующие данные четности +обновляются. +

+Вы можете остановить этот процесс в любое время, нажав Ctrl+C, +не теряя уже проделанной работы. +При следующем запуске процесс `sync` возобновится с того места, +где был прерван. +

+Если во время процесса обнаруживаются скрытые ошибки или ошибки ввода/вывода, +соответствующие блоки помечаются как плохие. +

+Файлы идентифицируются по пути и/или inode и проверяются по +размеру и метке времени. +Если размер файла или метка времени отличаются, данные четности +пересчитываются для всего файла. +Если файл перемещен или переименован на том же диске, сохраняя +тот же inode, четность не пересчитывается. +Если файл перемещен на другой диск, четность пересчитывается, +но ранее вычисленная информация хэша сохраняется. +

+Файлы `content` и `parity` изменяются при необходимости. +Файлы в массиве НЕ изменяются. +

5.8 +scrub +

+Проверяет массив, проверяя на наличие скрытых ошибок или ошибок ввода/вывода +на дисках данных и четности. +

+Каждый вызов проверяет примерно 8% массива, исключая +данные, уже проверенные за последние 10 дней. +Это означает, что проверка раз в неделю гарантирует, что каждый бит данных +проверяется хотя бы раз в три месяца. +

+Вы можете определить другой план или объем проверки, используя опцию -p, --plan, +которая принимает: +bad - Проверить блоки, помеченные как плохие. +new - Проверить только что синхронизированные блоки, которые еще не были проверены. +full - Проверить все. +0-100 - Проверить указанный процент блоков. +

+Если вы указываете процентное значение, вы также можете использовать опцию -o, --older-than, +чтобы определить, насколько старым должен быть блок. +Сначала проверяются самые старые блоки, обеспечивая оптимальную проверку. +Если вы хотите проверить только что синхронизированные блоки, которые еще не были проверены, +используйте опцию `-p new`. +

+Чтобы получить подробности о статусе проверки, используйте команду `status`. +

+При обнаружении любой скрытой ошибки или ошибки ввода/вывода соответствующие блоки +помечаются как плохие в файле `content`. +Эти плохие блоки перечисляются в `status` и могут быть исправлены с помощью `fix -e`. +После исправления при следующем scrub они будут перепроверены, и если +обнаружатся исправленными, плохая метка будет удалена. +Чтобы проверить только плохие блоки, вы можете использовать команду `scrub -p bad`. +

+Рекомендуется запускать `scrub` только на синхронизированном массиве, чтобы избежать +сообщений об ошибках, вызванных несинхронизированными данными. Эти ошибки +распознаются как не являющиеся скрытыми ошибками, и блоки не помечаются +как плохие, но такие ошибки сообщаются в выводе команды. +

+Файл `content` изменяется для обновления времени последней проверки +для каждого блока и для пометки плохих блоков. +Файлы `parity` НЕ изменяются. +Файлы в массиве НЕ изменяются. +

5.9 +fix +

+Исправляет все файлы и данные четности. +

+Все файлы и данные четности сравниваются с состоянием снимка, +сохраненным при последнем `sync`. +Если обнаружено различие, оно возвращается к сохраненному снимку. +

+ВНИМАНИЕ! Команда `fix` не различает ошибки и +преднамеренные изменения. Она безусловно возвращает состояние файла +к последнему `sync`. +

+Если не указана другая опция, обрабатывается весь массив. +Используйте опции фильтрации, чтобы выбрать подмножество файлов или дисков для работы. +

+Чтобы исправить только блоки, помеченные как плохие во время `sync` и `scrub`, +используйте опцию -e, --filter-error. +В отличие от других опций фильтрации, эта применяет исправления только к файлам, +которые не были изменены с момента последнего `sync`. +

+SnapRAID переименовывает все файлы, которые не могут быть исправлены, добавляя +расширение `.unrecoverable`. +

+Перед исправлением сканируется весь массив, чтобы найти файлы, перемещенные +с момента последней операции `sync`. +Эти файлы идентифицируются по их метке времени, игнорируя их имя +и каталог, и используются в процессе восстановления при необходимости. +Если вы переместили некоторые из них за пределы массива, вы можете использовать опцию +-i, --import, чтобы указать дополнительные каталоги для сканирования. +

+Файлы идентифицируются только по пути, а не по inode. +

+Файл `content` НЕ изменяется. +Файлы `parity` изменяются при необходимости. +Файлы в массиве изменяются при необходимости. +

5.10 +check +

+Проверяет все файлы и данные четности. +

+Он работает как `fix`, но только имитирует восстановление, и никакие изменения +не записываются в массив. +

+Эта команда в основном предназначена для ручной проверки, +например, после процесса восстановления или в других особых условиях. +Для периодических и запланированных проверок используйте `scrub`. +

+Если вы используете опцию -a, --audit-only, проверяются только данные +файла, а данные четности игнорируются для +более быстрого выполнения. +

+Файлы идентифицируются только по пути, а не по inode. +

+Ничего не изменяется. +

5.11 +list +

+Перечисляет все файлы, содержащиеся в массиве на момент +последнего `sync`. +

+С -v или --verbose также отображается время с точностью до доли секунды. +

+Ничего не изменяется. +

5.12 +dup +

+Перечисляет все дублирующиеся файлы. Два файла считаются равными, если их +хэши совпадают. Данные файла не считываются; используются только +предварительно вычисленные хэши. +

+Ничего не изменяется. +

5.13 +pool +

+Создает или обновляет виртуальное представление всех +файлов в вашем дисковом массиве в каталоге `pooling`. +

+Файлы не копируются, а связываются с помощью +символических ссылок. +

+При обновлении все существующие символические ссылки и пустые +подкаталоги удаляются и заменяются новым +представлением массива. Любые другие обычные файлы остаются на месте. +

+Ничего не изменяется за пределами каталога pool. +

5.14 +devices +

+Печатает низкоуровневые устройства, используемые массивом. +

+Эта команда отображает ассоциации устройств в массиве +и в основном предназначена как интерфейс для скриптов. +

+Первые два столбца — это низкоуровневый идентификатор устройства и путь. +Следующие два столбца — это высокоуровневый идентификатор устройства и путь. +Последний столбец — это имя диска в массиве. +

+В большинстве случаев у вас есть одно низкоуровневое устройство для каждого диска в +массиве, но в некоторых более сложных конфигурациях у вас может быть несколько +низкоуровневых устройств, используемых одним диском в массиве. +

+Ничего не изменяется. +

5.15 +touch +

+Устанавливает произвольную метку времени с точностью до доли секунды для всех файлов, +у которых она установлена в ноль. +

+Это улучшает способность SnapRAID распознавать перемещенные +и скопированные файлы, так как делает метку времени почти уникальной, +уменьшая возможные дубликаты. +

+Более конкретно, если метка времени с точностью до доли секунды не равна нулю, +перемещенный или скопированный файл идентифицируется как таковой, если он совпадает +по имени, размеру и метке времени. Если метка времени с точностью до доли секунды +равна нулю, он считается копией только в том случае, если полностью совпадают +полный путь, размер и метка времени. +

+Метка времени с точностью до секунды не изменяется, +поэтому все даты и время ваших файлов будут сохранены. +

5.16 +rehash +

+Планирует перехэширование всего массива. +

+Эта команда изменяет используемый тип хэша, обычно при обновлении +с 32-разрядной системы на 64-разрядную, для переключения с +MurmurHash3 на более быстрый SpookyHash. +

+Если вы уже используете оптимальный хэш, эта команда +ничего не делает и информирует вас, что никакие действия не требуются. +

+Перехэширование не выполняется немедленно, а происходит +постепенно во время `sync` и `scrub`. +

+Вы можете проверить состояние перехэширования с помощью `status`. +

+Во время перехэширования SnapRAID сохраняет полную функциональность, +за единственным исключением, что `dup` не может обнаружить дублирующиеся +файлы, использующие другой хэш. +

6 +Options +

+SnapRAID предоставляет следующие опции: + + +
+-c, --conf CONFIG +
+Выбирает файл конфигурации для использования. Если не указан, в Unix +используется файл `/usr/local/etc/snapraid.conf`, если он существует, +в противном случае `/etc/snapraid.conf`. +В Windows используется файл `snapraid.conf` в том же +каталоге, что и `snapraid.exe`. +
+ + +
+-f, --filter PATTERN +
+Фильтрует файлы для обработки в `check` и `fix`. +Обрабатываются только файлы, соответствующие указанному шаблону. +Эту опцию можно использовать несколько раз. +Подробнее о спецификациях шаблонов см. в разделе PATTERN. +В Unix убедитесь, что символы глоббинга заключены в кавычки, если используются. +Эту опцию можно использовать только с `check` и `fix`. +Ее нельзя использовать с `sync` и `scrub`, так как они всегда +обрабатывают весь массив. +
+ + +
+-d, --filter-disk NAME +
+Фильтрует диски для обработки в `check`, `fix`, `up` и `down`. +Вы должны указать имя диска, определенное в файле конфигурации. +Вы также можете указать диски четности с именами: `parity`, `2-parity`, +`3-parity` и т. д., чтобы ограничить операции конкретным диском четности. +Если вы комбинируете несколько опций --filter, --filter-disk и --filter-missing, +выбираются только файлы, соответствующие всем фильтрам. +Эту опцию можно использовать несколько раз. +Эту опцию можно использовать только с `check`, `fix`, `up` и `down`. +Ее нельзя использовать с `sync` и `scrub`, так как они всегда +обрабатывают весь массив. +
+ + +
+-m, --filter-missing +
+Фильтрует файлы для обработки в `check` и `fix`. +Обрабатываются только файлы, отсутствующие или удаленные из массива. +При использовании с `fix`, это действует как команда `undelete`. +Если вы комбинируете несколько опций --filter, --filter-disk и --filter-missing, +выбираются только файлы, соответствующие всем фильтрам. +Эту опцию можно использовать только с `check` и `fix`. +Ее нельзя использовать с `sync` и `scrub`, так как они всегда +обрабатывают весь массив. +
+ + +
+-e, --filter-error +
+Обрабатывает файлы с ошибками в `check` и `fix`. +Он обрабатывает только файлы, блоки которых помечены скрытыми +ошибками или ошибками ввода/вывода во время `sync` и `scrub`, как +перечислено в `status`. +Эту опцию можно использовать только с `check` и `fix`. +
+ + +
+-p, --plan PERC|bad|new|full +
+Выбирает план проверки (`scrub`). Если PERC — это числовое значение от 0 до 100, +оно интерпретируется как процент блоков для проверки. +Вместо процента вы можете указать план: +`bad` проверяет плохие блоки, `new` проверяет блоки, которые еще не были проверены, +и `full` проверяет все. +Эту опцию можно использовать только с `scrub`. +
+ + +
+-o, --older-than DAYS +
+Выбирает самую старую часть массива для обработки в `scrub`. +DAYS — это минимальный возраст в днях для блока, который будет проверен; +по умолчанию — 10. +Блоки, помеченные как плохие, всегда проверяются независимо от этой опции. +Эту опцию можно использовать только с `scrub`. +
+ + +
+-a, --audit-only +
+В `check`, проверяет хэш файлов без +проверки данных четности. +Если вы заинтересованы только в проверке данных файла, эта +опция может значительно ускорить процесс проверки. +Эту опцию можно использовать только с `check`. +
+ + +
+-h, --pre-hash +
+В `sync`, запускает предварительную фазу хэширования всех новых данных +для дополнительной проверки перед вычислением четности. +Обычно в `sync` предварительное хэширование не выполняется, и новые +данные хэшируются непосредственно перед вычислением четности, когда они +считываются в первый раз. +Этот процесс происходит, когда система находится под +тяжелой нагрузкой, со всеми вращающимися дисками и занятым процессором. +Это экстремальное условие для машины, и если у нее есть +скрытая аппаратная проблема, скрытые ошибки могут остаться незамеченными, +потому что данные еще не хэшированы. +Чтобы избежать этого риска, вы можете включить режим `pre-hash`, чтобы +все данные считывались дважды для обеспечения их целостности. +Эта опция также проверяет файлы, перемещенные внутри массива, +чтобы убедиться, что операция перемещения прошла успешно, и, при необходимости, +позволяет запустить операцию исправления (`fix`) перед продолжением. +Эту опцию можно использовать только с `sync`. +
+ + +
+-i, --import DIR +
+Импортирует из указанного каталога любые файлы, удаленные +из массива после последнего `sync`. +Если у вас все еще есть такие файлы, они могут использоваться `check` +и `fix` для улучшения процесса восстановления. +Файлы считываются, включая подкаталоги, и идентифицируются +независимо от их имени. +Эту опцию можно использовать только с `check` и `fix`. +
+ + +
+-s, --spin-down-on-error +
+При любой ошибке останавливает вращение всех управляемых дисков перед выходом с +ненулевым кодом состояния. Это предотвращает оставление дисков +активными и вращающимися после прерванной операции, +помогая избежать ненужного нагрева и энергопотребления. +Используйте эту опцию, чтобы гарантировать безопасную остановку дисков, +даже когда команда завершается неудачей. +
+ + +
+-w, --bw-limit RATE +
+Применяет глобальное ограничение пропускной способности для всех дисков. RATE — это +количество байтов в секунду. Вы можете указать множитель, +например K, M или G (например, --bw-limit 1G). +
+ + +
+-A, --stats +
+Включает расширенный вид статуса, который показывает дополнительную информацию. +На экране отображаются два графика: +Первый график показывает количество буферизованных полос для каждого +диска, а также путь к файлу, к которому в данный момент осуществляется +доступ на этом диске. Обычно самый медленный диск не будет иметь +доступного буфера, что определяет максимально достижимую +пропускную способность. +Второй график показывает процент времени, потраченного на ожидание +за последние 100 секунд. Ожидается, что самый медленный диск +вызовет большую часть времени ожидания, в то время как другие диски должны +иметь мало или совсем не иметь времени ожидания, потому что они могут +использовать свои буферизованные полосы. +Этот график также показывает время, потраченное на ожидание +вычислений хэша и вычислений RAID. +Все вычисления выполняются параллельно с дисковыми операциями. +Следовательно, пока есть измеримое время ожидания для +хотя бы одного диска, это указывает на то, что ЦП достаточно быстр, чтобы +справляться с рабочей нагрузкой. +
+ + +
+-Z, --force-zero +
+Форсирует небезопасную операцию синхронизации файла с нулевым +размером, который ранее был ненулевым. +Если SnapRAID обнаруживает такое условие, он прекращает выполнение, +если вы не укажете эту опцию. +Это позволяет легко обнаружить, когда после сбоя системы +некоторые доступные файлы были усечены. +Это возможное условие в Linux с файловыми системами ext3/ext4. +Эту опцию можно использовать только с `sync`. +
+ + +
+-E, --force-empty +
+Форсирует небезопасную операцию синхронизации диска, на котором +отсутствуют все исходные файлы. +Если SnapRAID обнаруживает, что все файлы, изначально присутствующие +на диске, отсутствуют или перезаписаны, он прекращает выполнение, +если вы не укажете эту опцию. +Это позволяет легко обнаружить, когда файловая система данных не +смонтирована. +Эту опцию можно использовать только с `sync`. +
+ + +
+-U, --force-uuid +
+Форсирует небезопасную операцию синхронизации, проверки и исправления +с дисками, у которых изменился UUID. +Если SnapRAID обнаруживает, что у некоторых дисков изменился UUID, +он прекращает выполнение, если вы не укажете эту опцию. +Это позволяет обнаружить, когда ваши диски смонтированы в +неправильных точках монтирования. +Однако допускается однократное изменение UUID с +одиночной четностью, и больше с множественной четностью, потому что это +нормальный случай при замене дисков после восстановления. +Эту опцию можно использовать только с `sync`, `check` или +`fix`. +
+ + +
+-D, --force-device +
+Форсирует небезопасную операцию исправления с недоступными дисками +или с дисками на том же физическом устройстве. +Например, если вы потеряли два диска данных и у вас есть запасной диск для восстановления +только первого, вы можете игнорировать второй недоступный диск. +Или, если вы хотите восстановить диск в свободное место, оставшееся на +уже используемом диске, совместно использующем то же физическое устройство. +Эту опцию можно использовать только с `fix`. +
+ + +
+-N, --force-nocopy +
+В `sync`, `check` и `fix`, отключает эвристику обнаружения копирования. +Без этой опции SnapRAID предполагает, что файлы с одинаковыми +атрибутами, такими как имя, размер и метка времени, являются копиями с +одинаковыми данными. +Это позволяет идентифицировать скопированные или перемещенные файлы с одного диска +на другой и повторно использовать уже вычисленную информацию хэша +для обнаружения скрытых ошибок или восстановления отсутствующих файлов. +В некоторых редких случаях это поведение может привести к ложным срабатываниям +или замедлению процесса из-за большого количества проверок хэша, и эта +опция позволяет решить такие проблемы. +Эту опцию можно использовать только с `sync`, `check` и `fix`. +
+ + +
+-F, --force-full +
+В `sync`, форсирует полный пересчет четности. +Эту опцию можно использовать, когда вы добавляете новый уровень четности или если +вы вернулись к старому файлу content, используя более свежие данные четности. +Вместо того чтобы воссоздавать четность с нуля, это позволяет +повторно использовать хэши, присутствующие в файле content, для проверки данных +и поддержания защиты данных во время процесса `sync` с использованием +существующих данных четности. +Эту опцию можно использовать только с `sync`. +
+ + +
+-R, --force-realloc +
+В `sync`, форсирует полное перераспределение файлов и перестроение четности. +Эту опцию можно использовать для полного перераспределения всех файлов, +удаления фрагментации, при этом повторно используя хэши, присутствующие в файле content, +для проверки данных. +Эту опцию можно использовать только с `sync`. +ВНИМАНИЕ! Эта опция предназначена только для экспертов, и +настоятельно не рекомендуется ее использовать. +У вас НЕТ защиты данных во время операции `sync`. +
+ + +
+-l, --log FILE +
+Записывает подробный журнал в указанный файл. +Если эта опция не указана, непредвиденные ошибки выводятся +на экран, что потенциально может привести к чрезмерному выводу в случае +множества ошибок. Когда указана -l, --log, на +экран выводятся только фатальные ошибки, которые приводят к остановке +SnapRAID. +Если путь начинается с '>>', файл открывается +в режиме добавления. Вхождения '%D' и '%T' в имени +заменяются датой и временем в формате ГГГГММДД и +ЧЧММСС. В пакетных файлах Windows вы должны удвоить +символ '%', например, result-%%D.log. Чтобы использовать '>>', вы должны +заключить имя в кавычки, например, `">>result.log"`. +Для вывода журнала на стандартный вывод или стандартную ошибку, +вы можете использовать `">&1"` и `">&2"` соответственно. +Описание тегов журнала см. в файле snapraid_log.txt или man-странице. +
+ + +
+-L, --error-limit NUMBER +
+Устанавливает новый лимит ошибок до остановки выполнения. +По умолчанию SnapRAID останавливается, если обнаруживает более 100 +ошибок ввода/вывода, что указывает на вероятный сбой диска. +Эта опция влияет на `sync` и `scrub`, которым разрешено +продолжать работу после первого набора дисковых ошибок, чтобы попытаться +завершить свои операции. +Однако `check` и `fix` всегда останавливаются при первой ошибке. +
+ + +
+-S, --start BLKSTART +
+Начинает обработку с указанного +номера блока. Это может быть полезно для повторной попытки проверить +или исправить конкретные блоки в случае поврежденного диска. +Эта опция в основном предназначена для расширенного ручного восстановления. +
+ + +
+-B, --count BLKCOUNT +
+Обрабатывает только указанное количество блоков. +Эта опция в основном предназначена для расширенного ручного восстановления. +
+ + +
+-C, --gen-conf CONTENT +
+Генерирует фиктивный файл конфигурации из существующего +файла content. +Файл конфигурации записывается на стандартный вывод +и не перезаписывает существующий. +Этот файл конфигурации также содержит информацию, +необходимую для восстановления точек монтирования дисков в случае, если вы +потеряете всю систему. +
+ + +
+-v, --verbose +
+Печатает больше информации на экран. +Если указана один раз, печатает исключенные файлы +и дополнительную статистику. +Эта опция не влияет на файлы журнала. +
+ + +
+-q, --quiet +
+Печатает меньше информации на экран. +Если указана один раз, удаляет индикатор выполнения; дважды, +текущие операции; трижды, информационные +сообщения; четырежды, сообщения о статусе. +Фатальные ошибки всегда выводятся на экран. +Эта опция не влияет на файлы журнала. +
+ + +
+-H, --help +
+Печатает краткий экран справки. +
+ + +
+-V, --version +
+Печатает версию программы. +
+

7 +Configuration +

+SnapRAID требует файл конфигурации, чтобы знать, где находится ваш дисковый массив +и где хранить информацию четности. +

+В Unix используется файл `/usr/local/etc/snapraid.conf`, если он существует, +в противном случае `/etc/snapraid.conf`. +В Windows используется файл `snapraid.conf` в том же +каталоге, что и `snapraid.exe`. +

+Он должен содержать следующие опции (чувствительные к регистру): +

7.1 +parity FILE [,FILE] ... +

+Определяет файлы для использования для хранения информации четности. +Четность обеспечивает защиту от одного сбоя диска, +подобно RAID5. +

+Вы можете указать несколько файлов, которые должны быть на разных дисках. +Когда файл больше не может расти, используется следующий. +Общее доступное пространство должно быть по крайней мере таким же большим, как самый большой диск данных в +массиве. +

+Вы можете добавить дополнительные файлы четности позже, но вы +не можете переупорядочить или удалить их. +

+Сохранение дисков четности зарезервированными для четности гарантирует, что +они не станут фрагментированными, улучшая производительность. +

+В Windows 256 МБ остается неиспользованным на каждом диске, чтобы избежать +предупреждения о полных дисках. +

+Эта опция является обязательной и может использоваться только один раз. +

7.2 +(2,3,4,5,6)-parity FILE [,FILE] ... +

+Определяет файлы для использования для хранения дополнительной информации четности. +

+Для каждого указанного уровня четности включается один дополнительный уровень защиты: +

+

+Каждый уровень четности требует наличия всех предыдущих уровней четности. +

+Применяются те же соображения, что и для опции 'parity'. +

+Эти опции являются необязательными и могут использоваться только один раз. +

7.3 +z-parity FILE [,FILE] ... +

+Определяет альтернативный файл и формат для хранения тройной четности. +

+Эта опция является альтернативой '3-parity', в основном предназначенной для +слабых процессоров, таких как ARM или AMD Phenom, Athlon и Opteron, +которые не поддерживают набор инструкций SSSE3. В таких случаях она +обеспечивает лучшую производительность. +

+Этот формат похож на тот, который используется ZFS RAIDZ3, но быстрее. +Как и ZFS, он не работает за пределами тройной четности. +

+При использовании '3-parity' вы будете предупреждены, если рекомендуется использовать +формат 'z-parity' для повышения производительности. +

+Возможно преобразование из одного формата в другой путем настройки +файла конфигурации с желаемым файлом z-parity или 3-parity +и использования 'fix' для его воссоздания. +

7.4 +content FILE +

+Определяет файл для использования для хранения списка и контрольных сумм всех +файлов, присутствующих в вашем дисковом массиве. +

+Он может быть размещен на диске, используемом для данных, четности, или +любом другом доступном диске. +Если вы используете диск данных, этот файл автоматически исключается +из процесса `sync`. +

+Эта опция является обязательной и может использоваться несколько раз для сохранения +нескольких копий одного и того же файла. +

+Вы должны хранить как минимум одну копию для каждого используемого диска четности +плюс одну. Использование дополнительных копий не повредит. +

7.5 +data NAME DIR +

+Определяет имя и точку монтирования дисков данных в +массиве. NAME используется для идентификации диска и должно +быть уникальным. DIR — это точка монтирования диска в +файловой системе. +

+Вы можете изменять точку монтирования по мере необходимости, пока вы +сохраняете NAME фиксированным. +

+Вы должны использовать одну опцию для каждого диска данных в массиве. +

+Вы можете переименовать диск позже, изменив NAME непосредственно +в файле конфигурации, а затем запустив команду 'sync'. +В случае переименования, ассоциация выполняется с использованием сохраненного +UUID дисков. +

7.6 +nohidden +

+Исключает все скрытые файлы и каталоги. +В Unix скрытые файлы — это те, которые начинаются с `.`. +В Windows — это те, у которых есть скрытый атрибут. +

7.7 +exclude/include PATTERN +

+Определяет шаблоны файлов или каталогов для исключения или включения +в процесс синхронизации. +Все шаблоны обрабатываются в указанном порядке. +

+Если первый совпадающий шаблон — это `exclude`, файл +исключается. Если это `include`, файл включается. +Если ни один шаблон не совпадает, файл исключается, если последний +указанный шаблон — это `include`, или включается, если последний шаблон +— это `exclude`. +

+Подробнее о спецификациях шаблонов см. в разделе PATTERN. +

+Эту опцию можно использовать несколько раз. +

7.8 +blocksize SIZE_IN_KIBIBYTES +

+Определяет базовый размер блока в кибибайтах для четности. +Один кибибайт — это 1024 байта. +

+Размер блока по умолчанию — 256, что должно работать в большинстве случаев. +

+ВНИМАНИЕ! Эта опция предназначена только для экспертов, и +настоятельно не рекомендуется изменять это значение. Чтобы изменить это значение в +будущем, вам потребуется воссоздать всю четность! +

+Причина использовать другой размер блока — если у вас много маленьких +файлов, порядка миллионов. +

+Для каждого файла, даже если всего несколько байтов, выделяется целый блок четности, +и при большом количестве файлов это может привести к значительным неиспользуемым +пространствам четности. +Когда вы полностью заполните диск четности, вам не будет +разрешено добавлять больше файлов на диски данных. +Однако потерянная четность не накапливается на дисках данных. Потерянное пространство, +возникающее из-за большого числа файлов на диске данных, ограничивает только +объем данных на этом диске данных, а не на других. +

+В качестве приближения вы можете предположить, что половина размера блока +теряется для каждого файла. Например, при 100 000 файлов и размере блока 256 КиБ +вы потеряете 12,8 ГБ четности, что может привести к +уменьшению доступного пространства на диске данных на 12,8 ГБ. +

+Вы можете проверить количество потерянного пространства на каждом диске с помощью `status`. +Это количество пространства, которое вы должны оставить свободным на дисках +данных или использовать для файлов, не включенных в массив. +Если это значение отрицательное, это означает, что вы близки к заполнению +четности, и оно представляет пространство, которое вы все еще можете потерять. +

+Чтобы избежать этой проблемы, вы можете использовать больший раздел для четности. +Например, если раздел четности на 12,8 ГБ больше, чем диски данных, +у вас есть достаточно дополнительного пространства для обработки до 100 000 +файлов на каждом диске данных без каких-либо потерь пространства. +

+Хитрость для получения большего раздела четности в Linux — отформатировать его +командой: +

+
+
+mkfs.ext4 -m 0 -T largefile4 DEVICE
+
+
+

+Это приводит к примерно 1,5% дополнительного пространства, приблизительно 60 ГБ для +диска 4 ТБ, что позволяет разместить около 460 000 файлов на каждом диске данных без +каких-либо потерь пространства. +

7.9 +hashsize SIZE_IN_BYTES +

+Определяет размер хэша в байтах для сохраненных блоков. +

+Размер хэша по умолчанию — 16 байт (128 бит), что должно работать +в большинстве случаев. +

+ВНИМАНИЕ! Эта опция предназначена только для экспертов, и +настоятельно не рекомендуется изменять это значение. Чтобы изменить это значение в +будущем, вам потребуется воссоздать всю четность! +

+Причина использовать другой размер хэша — если ваша система имеет +ограниченную память. Как правило, SnapRAID обычно требует +1 ГиБ ОЗУ на каждые 16 ТБ данных в массиве. +

+В частности, для хранения хэшей данных SnapRAID требует +приблизительно TS*(1+HS)/BS байт ОЗУ, +где TS — это общий размер в байтах вашего дискового массива, BS — +размер блока в байтах, и HS — размер хэша в байтах. +

+Например, при 8 дисках по 4 ТБ, размере блока 256 КиБ +(1 КиБ = 1024 байта) и размере хэша 16, вы получаете: +

+

+RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1.93 GiB
+
+

+Переключение на размер хэша 8, вы получаете: +

+

+RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1.02 GiB
+
+

+Переключение на размер блока 512, вы получаете: +

+

+RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 GiB
+
+

+Переключение как на размер хэша 8, так и на размер блока 512, вы получаете: +

+

+RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB
+
+

7.10 +autosave SIZE_IN_GIGABYTES +

+Автоматически сохраняет состояние при синхронизации или проверке после +обработки указанного количества ГБ. +Эта опция полезна, чтобы избежать перезапуска длительных команд `sync` +с нуля, если они были прерваны сбоем машины или любым другим событием. +

7.11 +temp_limit TEMPERATURE_CELSIUS +

+Устанавливает максимально допустимую температуру диска в Цельсиях. Если указано, +SnapRAID периодически проверяет температуру всех дисков с помощью +инструмента smartctl. Текущие температуры дисков отображаются во время +работы SnapRAID. Если какой-либо диск превышает этот лимит, все операции +останавливаются, и диски останавливают вращение (переходят в режим ожидания) на время, +определенное опцией `temp_sleep`. После периода ожидания операции +возобновляются, потенциально снова приостанавливаясь, если лимит температуры +достигается еще раз. +

+Во время работы SnapRAID также анализирует кривую нагрева каждого +диска и оценивает долгосрочную установившуюся температуру, которую они, +как ожидается, достигнут, если активность продолжится. Оценка выполняется +только после того, как температура диска увеличилась четыре раза, +что гарантирует наличие достаточного количества данных для установления +надежной тенденции. +Эта прогнозируемая установившаяся температура показывается в скобках рядом с +текущим значением и помогает оценить, достаточно ли +охлаждение системы. Эта оценочная температура предназначена только +для информации и не влияет на поведение SnapRAID. Действия программы +основываются исключительно на фактических измеренных температурах дисков. +

+Для выполнения этого анализа SnapRAID требуется эталон для температуры +системы. Сначала он пытается прочитать его из доступных аппаратных +датчиков. Если ни один системный датчик не может быть доступен, он использует +самую низкую температуру диска, измеренную в начале выполнения, в качестве +резервного эталона. +

+Обычно SnapRAID показывает только температуру самого горячего диска. +Чтобы отобразить температуру всех дисков, используйте опцию -A или --stats. +

7.12 +temp_sleep TIME_IN_MINUTES +

+Устанавливает время ожидания, в минутах, когда достигается предел температуры. +В течение этого периода диски остаются остановленными. По умолчанию — 5 минут. +

7.13 +pool DIR +

+Определяет каталог объединения (pooling), где создается виртуальное представление +дискового массива с помощью команды `pool`. +

+Каталог должен уже существовать. +

7.14 +share UNC_DIR +

+Определяет путь UNC Windows, необходимый для удаленного доступа к дискам. +

+Если указана эта опция, символические ссылки, созданные в каталоге pool, +используют этот путь UNC для доступа к дискам. +Без этой опции сгенерированные символические ссылки используют только локальные пути, +что не позволяет предоставлять общий доступ к каталогу pool по сети. +

+Символические ссылки формируются с использованием указанного пути UNC, добавлением +имени диска, как указано в опции `data`, и, наконец, добавлением +каталога и имени файла. +

+Эта опция требуется только для Windows. +

7.15 +smartctl DISK/PARITY OPTIONS... +

+Определяет пользовательские опции smartctl для получения атрибутов SMART для +каждого диска. Это может потребоваться для контроллеров RAID и некоторых USB-дисков, +которые не могут быть обнаружены автоматически. Заполнитель %s заменяется +именем устройства, но он необязателен для фиксированных устройств, таких как +контроллеры RAID. +

+DISK — это то же имя диска, указанное в опции `data`. +PARITY — это одно из имен четности: `parity`, `2-parity`, `3-parity`, +`4-parity`, `5-parity`, `6-parity` или `z-parity`. +

+В указанных OPTIONS строка `%s` заменяется +именем устройства. Для контроллеров RAID устройство, +вероятно, фиксировано, и вам может не потребоваться использовать `%s`. +

+Возможные опции см. в документации smartmontools: +

+
+
+https://www.smartmontools.org/wiki/Supported_RAID-Controllers
+https://www.smartmontools.org/wiki/Supported_USB-Devices
+
+
+

+Например: +

+
+
+smartctl parity -d sat %s
+
+
+

7.16 +smartignore DISK/PARITY ATTR [ATTR...] +

+Игнорирует указанный атрибут SMART при вычислении вероятности +сбоя диска. Эта опция полезна, если диск сообщает необычные или +вводящие в заблуждение значения для конкретного атрибута. +

+DISK — это то же имя диска, указанное в опции `data`. +PARITY — это одно из имен четности: `parity`, `2-parity`, `3-parity`, +`4-parity`, `5-parity`, `6-parity` или `z-parity`. +Специальное значение * может использоваться для игнорирования атрибута на всех дисках. +

+Например, чтобы игнорировать атрибут `Current Pending Sector Count` на +всех дисках: +

+
+
+smartignore * 197
+
+
+

+Чтобы игнорировать его только на первом диске четности: +

+
+
+smartignore parity 197
+
+
+

7.17 +Examples +

+Пример типичной конфигурации для Unix: +

+
+
+parity /mnt/diskp/snapraid.parity
+content /mnt/diskp/snapraid.content
+content /var/snapraid/snapraid.content
+data d1 /mnt/disk1/
+data d2 /mnt/disk2/
+data d3 /mnt/disk3/
+exclude /lost+found/
+exclude /tmp/
+smartctl d1 -d sat %s
+smartctl d2 -d usbjmicron %s
+smartctl parity -d areca,1/1 /dev/sg0
+smartctl 2-parity -d areca,2/1 /dev/sg0
+
+
+

+Пример типичной конфигурации для Windows: +

+
+
+parity E:\snapraid.parity
+content E:\snapraid.content
+content C:\snapraid\snapraid.content
+data d1 G:\array\
+data d2 H:\array\
+data d3 I:\array\
+exclude Thumbs.db
+exclude \$RECYCLE.BIN
+exclude \System Volume Information
+smartctl d1 -d sat %s
+smartctl d2 -d usbjmicron %s
+smartctl parity -d areca,1/1 /dev/arcmsr0
+smartctl 2-parity -d areca,2/1 /dev/arcmsr0
+
+
+

8 +Pattern +

+Шаблоны используются для выбора подмножества файлов для исключения или включения +в процесс. +

+Существует четыре различных типа шаблонов: + + +
+FILE +
+Выбирает любой файл с именем FILE. Вы можете использовать любые символы +глоббинга, такие как * и ?, и классы символов, такие как [a-z]. +Этот шаблон применяется только к файлам, а не к каталогам. +
+ + +
+DIR/ +
+Выбирает любой каталог с именем DIR и все внутри. +Вы можете использовать любые символы глоббинга, такие как * и ?. +Этот шаблон применяется только к каталогам, а не к файлам. +
+ + +
+/PATH/FILE +
+Выбирает точно указанный путь к файлу. Вы можете использовать любые +символы глоббинга, такие как * и ?, но они никогда не совпадают с +косой чертой каталога. +Этот шаблон применяется только к файлам, а не к каталогам. +
+ + +
+/PATH/DIR/ +
+Выбирает точно указанный путь к каталогу и все внутри. +Вы можете использовать любые символы глоббинга, такие как * и ?, но +они никогда не совпадают с косой чертой каталога. +Этот шаблон применяется только к каталогам, а не к файлам. +
+

+Когда вы указываете абсолютный путь, начинающийся с /, он применяется к +корневому каталогу массива, а не к корневому каталогу локальной файловой системы. +

+В Windows вы можете использовать обратную косую черту \ вместо прямой /. +Системные каталоги Windows, точки соединения, точки монтирования и другие +специальные каталоги Windows рассматриваются как файлы, что означает, что для их +исключения вы должны использовать правило файла, а не каталога. +

+Если имя файла содержит символы '*', '?', '[', +или ']', вы должны экранировать их, чтобы избежать их интерпретации как +символов глоббинга. В Unix символом экранирования является '\'; в Windows — '^'. +Когда шаблон находится в командной строке, вы должны удвоить символ +экранирования, чтобы избежать его интерпретации командной оболочкой. +

+В файле конфигурации вы можете использовать различные стратегии для фильтрации +файлов для обработки. +Самый простой подход — использовать только правила `exclude` для удаления всех +файлов и каталогов, которые вы не хотите обрабатывать. Например: +

+
+
+# Исключает любой файл с именем `*.unrecoverable`
+exclude *.unrecoverable
+# Исключает корневой каталог `/lost+found`
+exclude /lost+found/
+# Исключает любой подкаталог с именем `tmp`
+exclude tmp/
+
+
+

+Противоположный подход — определить только файлы, которые вы хотите обрабатывать, используя +только правила `include`. Например: +

+
+
+# Включает только некоторые каталоги
+include /movies/
+include /musics/
+include /pictures/
+
+
+

+Конечный подход — смешивать правила `exclude` и `include`. В этом случае +порядок правил важен. Более ранние правила имеют +преимущество над более поздними. +Для упрощения вы можете сначала перечислить все правила `exclude`, а затем +все правила `include`. Например: +

+
+
+# Исключает любой файл с именем `*.unrecoverable`
+exclude *.unrecoverable
+# Исключает любой подкаталог с именем `tmp`
+exclude tmp/
+# Включает только некоторые каталоги
+include /movies/
+include /musics/
+include /pictures/
+
+
+

+В командной строке, используя опцию -f, вы можете использовать только шаблоны `include`. +Например: +

+
+
+# Проверяет только файлы .mp3.
+# В Unix используйте кавычки, чтобы избежать расширения глоббинга оболочкой.
+snapraid -f "*.mp3" check
+
+
+

+В Unix при использовании символов глоббинга в командной строке вы должны +заключить их в кавычки, чтобы предотвратить их расширение оболочкой. +

9 +Content +

+SnapRAID хранит список и контрольные суммы ваших файлов в файле content. +

+Это бинарный файл, который перечисляет все файлы, присутствующие в вашем дисковом массиве, +вместе со всеми контрольными суммами для проверки их целостности. +

+Этот файл считывается и записывается командами `sync` и `scrub` и +считывается командами `fix`, `check` и `status`. +

10 +Parity +

+SnapRAID хранит информацию четности вашего массива в файлах parity. +

+Это бинарные файлы, содержащие вычисленную четность всех +блоков, определенных в файле `content`. +

+Эти файлы считываются и записываются командами `sync` и `fix` и +только считываются командами `scrub` и `check`. +

11 +Encoding +

+SnapRAID в Unix игнорирует любое кодирование. Он считывает и хранит +имена файлов с тем же кодированием, которое используется файловой системой. +

+В Windows все имена, считанные из файловой системы, преобразуются и +обрабатываются в формате UTF-8. +

+Чтобы имена файлов печатались правильно, вы должны установить консоль Windows +в режим UTF-8 командой `chcp 65001` и использовать +шрифт TrueType, такой как `Lucida Console`, в качестве шрифта консоли. +Это влияет только на печатаемые имена файлов; если вы +перенаправляете вывод консоли в файл, результирующий файл всегда +в формате UTF-8. + + +

+

+ +
+ + + + + + diff --git a/manual-uk.html b/manual-uk.html new file mode 100644 index 00000000..d84f5d75 --- /dev/null +++ b/manual-uk.html @@ -0,0 +1,2214 @@ + + + + + + + + + + + + + +SnapRAID + + + + + + + + + + + + +
+ + + +

+Ukranian manual for SnapRAID. +

+ +

1 +Короткий опис +

+
+snapraid [-c, --conf CONFIG]
+    [-f, --filter PATTERN] [-d, --filter-disk NAME]
+    [-m, --filter-missing] [-e, --filter-error]
+    [-a, --audit-only] [-h, --pre-hash] [-i, --import DIR]
+    [-p, --plan PERC|bad|new|full]
+    [-o, --older-than DAYS] [-l, --log FILE]
+    [-s, --spin-down-on-error] [-w, --bw-limit RATE]
+    [-Z, --force-zero] [-E, --force-empty]
+    [-U, --force-uuid] [-D, --force-device]
+    [-N, --force-nocopy] [-F, --force-full]
+    [-R, --force-realloc]
+    [-S, --start BLKSTART] [-B, --count BLKCOUNT]
+    [-L, --error-limit NUMBER]
+    [-A, --stats]
+    [-v, --verbose] [-q, --quiet]
+    status|smart|probe|up|down|diff|sync|scrub|fix|check
+    |list|dup|pool|devices|touch|rehash
+
+

+

+snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT]
+
+

2 +Опис +

+SnapRAID — це програма резервного копіювання, розроблена для +дискових масивів, яка зберігає інформацію парності для +відновлення даних у випадку відмови до шести дисків. +

+В першу чергу призначена для домашніх медіацентрів з великими +файлами, що рідко змінюються, SnapRAID пропонує кілька функцій: +

+

+Для отримання додаткової інформації відвідайте офіційний сайт +SnapRAID: +

+
+
+https://www.snapraid.it/
+
+
+

3 +Обмеження +

+SnapRAID є гібридом між RAID та програмою резервного копіювання, +прагнучи поєднати найкращі переваги обох. Однак, він має деякі +обмеження, які слід врахувати перед його використанням. +

+Основне обмеження полягає в тому, що якщо диск виходить з ладу, +а ви нещодавно не виконували синхронізацію, ви можете не +змогти повністю відновити дані. +Конкретніше, ви можете втратити можливість відновлення даних +обсягом до розміру змінених або видалених файлів з моменту +останньої операції синхронізації. +Це відбувається, навіть якщо змінені або видалені файли не +знаходяться на диску, що вийшов з ладу. Ось чому SnapRAID +краще підходить для даних, які рідко змінюються. +

+З іншого боку, щойно додані файли не перешкоджають відновленню +вже існуючих файлів. Ви втратите лише нещодавно додані файли, +якщо вони знаходяться на диску, що вийшов з ладу. +

+Інші обмеження SnapRAID: +

+

4 +Початок роботи +

+Щоб використовувати SnapRAID, спершу потрібно вибрати один диск +у вашому дисковому масиві, щоб присвятити його інформації +`парності`. З одним диском для парності ви зможете відновити +дані після відмови одного диска, подібно до RAID5. +

+Якщо ви хочете відновити дані після більшої кількості +дисків, що відмовили, подібно до RAID6, ви повинні зарезервувати +додаткові диски для парності. Кожен додатковий диск парності +дозволяє відновити дані після відмови ще одного диска. +

+Як диски парності ви повинні вибрати найбільші диски в масиві, +оскільки інформація парності може зрости до розміру найбільшого +диска даних у масиві. +

+Ці диски будуть присвячені зберіганню файлів `парності`. Ви +не повинні зберігати на них свої дані. +

+Потім ви повинні визначити диски `даних`, які ви хочете +захистити за допомогою SnapRAID. Захист є більш ефективним, +якщо ці диски містять дані, що рідко змінюються. З цієї причини +краще НЕ включати диск Windows C:\ або каталоги Unix /home, +/var та /tmp. +

+Список файлів зберігається у файлах `content` (вміст), які +зазвичай зберігаються на дисках даних, парності або завантажувальних +дисках. +Цей файл містить деталі вашої резервної копії, включаючи +всі контрольні суми для перевірки її цілісності. +Файл `content` зберігається в кількох копіях, і кожна копія +повинна бути на окремому диску, щоб гарантувати, що навіть у +разі відмови кількох дисків, принаймні одна копія буде доступна. +

+Наприклад, припустимо, вас цікавить лише один рівень захисту +парності, а ваші диски розташовані за адресами: +

+
+
+/mnt/diskp <- вибраний диск для парності
+/mnt/disk1 <- перший диск для захисту
+/mnt/disk2 <- другий диск для захисту
+/mnt/disk3 <- третій диск для захисту
+
+
+

+Ви повинні створити конфігураційний файл /etc/snapraid.conf з +наступними опціями: +

+
+
+parity /mnt/diskp/snapraid.parity
+content /var/snapraid/snapraid.content
+content /mnt/disk1/snapraid.content
+content /mnt/disk2/snapraid.content
+data d1 /mnt/disk1/
+data d2 /mnt/disk2/
+data d3 /mnt/disk3/
+
+
+

+Якщо ви працюєте в Windows, ви повинні використовувати формат +шляху Windows, з літерами дисків та зворотними скісними рисками +замість прямих. +

+
+
+parity E:\snapraid.parity
+content C:\snapraid\snapraid.content
+content F:\array\snapraid.content
+content G:\array\snapraid.content
+data d1 F:\array\
+data d2 G:\array\
+data d3 H:\array\
+
+
+

+Якщо у вас багато дисків і закінчилися літери дисків, ви можете +монтувати диски безпосередньо у вкладені папки. Див: +

+
+
+https://www.google.com/search?q=Windows+mount+point
+
+
+

+На цьому етапі ви готові запустити команду `sync` для побудови +інформації парності. +

+
+
+snapraid sync
+
+
+

+Цей процес може зайняти кілька годин вперше, залежно від розміру +даних, які вже є на дисках. Якщо диски порожні, процес +відбувається миттєво. +

+Ви можете зупинити його в будь-який час, натиснувши Ctrl+C, +і під час наступного запуску він відновить роботу з місця, +де був перерваний. +

+Коли ця команда завершиться, ваші дані БЕЗПЕЧНІ. +

+Тепер ви можете почати використовувати свій масив як вам подобається +і періодично оновлювати інформацію парності, запускаючи команду `sync`. +

4.1 +Скрабування (Scrubbing) +

+Щоб періодично перевіряти дані та парність на наявність помилок, +ви можете запустити команду `scrub`. +

+
+
+snapraid scrub
+
+
+

+Ця команда порівнює дані у вашому масиві з хешем, обчисленим +під час команди `sync`, для перевірки цілісності. +

+Кожен запуск команди перевіряє приблизно 8% масиву, виключаючи +дані, які вже були скрабовані протягом попередніх 10 днів. +Ви можете використовувати опцію -p, --plan, щоб вказати іншу +кількість, і опцію -o, --older-than, щоб вказати інший вік +у днях. +Наприклад, щоб перевірити 5% масиву на блоки старші за 20 днів, +використовуйте: +

+
+
+snapraid -p 5 -o 20 scrub
+
+
+

+Якщо під час процесу виявлено приховані помилки або помилки +введення/виведення, відповідні блоки позначаються як погані у +файлі `content` і перераховуються у команді `status`. +

+
+
+snapraid status
+
+
+

+Щоб їх виправити, ви можете використовувати команду `fix`, +фільтруючи погані блоки за допомогою опції -e, --filter-error: +

+
+
+snapraid -e fix
+
+
+

+Під час наступного `scrub` помилки зникнуть зі звіту `status`, +якщо вони справді виправлені. Щоб зробити це швидше, ви можете +використовувати -p bad, щоб скрабувати лише блоки, позначені +як погані. +

+
+
+snapraid -p bad scrub
+
+
+

+Запуск `scrub` на несинхронізованому масиві може повідомити +про помилки, спричинені видаленими або зміненими файлами. +Ці помилки відображаються у виведенні `scrub`, але пов'язані +блоки не позначаються як погані. +

4.2 +Об'єднання (Pooling) +

+Примітка: Функція об'єднання, описана нижче, була замінена +інструментом mergefs, який тепер є рекомендованою опцією для +користувачів Linux у спільноті SnapRAID. Mergefs забезпечує +більш гнучкий та ефективний спосіб об'єднання кількох дисків +в єдину уніфіковану точку монтування, дозволяючи безперешкодний +доступ до файлів у вашому масиві без використання символічних +посилань. Він добре інтегрується з SnapRAID для захисту +парності і зазвичай використовується в налаштуваннях, таких +як OpenMediaVault (OMV) або користувацьких конфігураціях NAS. +

+Щоб відобразити всі файли у вашому масиві в одному дереві +каталогів, ви можете ввімкнути функцію `pooling` (об'єднання). +Вона створює віртуальне представлення всіх файлів у вашому +масиві лише для читання, використовуючи символічні посилання. +

+Ви можете налаштувати каталог `pooling` у конфігураційному +файлі за допомогою: +

+
+
+pool /pool
+
+
+

+або, якщо ви працюєте в Windows, за допомогою: +

+
+
+pool C:\pool
+
+
+

+а потім запустити команду `pool` для створення або оновлення +віртуального представлення. +

+
+
+snapraid pool
+
+
+

+Якщо ви використовуєте платформу Unix і хочете надати спільний +доступ до цього каталогу через мережу для машин Windows або +Unix, ви повинні додати наступні опції до вашого +/etc/samba/smb.conf: +

+
+
+# У глобальному розділі smb.conf
+unix extensions = no
+
+
+

+
+
+# У розділі спільного доступу smb.conf
+[pool]
+comment = Pool
+path = /pool
+read only = yes
+guest ok = yes
+wide links = yes
+follow symlinks = yes
+
+
+

+У Windows спільний доступ до символічних посилань через мережу +вимагає від клієнтів віддаленого їх розпізнавання. Щоб +увімкнути це, окрім спільного доступу до каталогу pool, ви +також повинні надати спільний доступ до всіх дисків незалежно, +використовуючи імена дисків, визначені у конфігураційному +файлі, як точки спільного доступу. Ви також повинні вказати у +опції `share` конфігураційного файлу шлях Windows UNC, який +потрібен віддаленим клієнтам для доступу до цих спільних дисків. +

+Наприклад, працюючи з сервера з іменем `darkstar`, ви можете +використовувати опції: +

+
+
+data d1 F:\array\
+data d2 G:\array\
+data d3 H:\array\
+pool C:\pool
+share \\darkstar
+
+
+

+і надати спільний доступ до наступних каталогів через мережу: +

+
+
+\\darkstar\pool -> C:\pool
+\\darkstar\d1 -> F:\array
+\\darkstar\d2 -> G:\array
+\\darkstar\d3 -> H:\array
+
+
+

+щоб дозволити віддаленим клієнтам отримати доступ до всіх файлів +за адресою \\darkstar\pool. +

+Вам також може знадобитися налаштувати віддалені клієнти, щоб +увімкнути доступ до віддалених символічних посилань за допомогою +команди: +

+
+
+fsutil behavior set SymlinkEvaluation L2L:1 R2R:1 L2R:1 R2L:1
+
+
+

4.3 +Відновлення видалених файлів (Undeleting) +

+SnapRAID функціонує більше як програма резервного копіювання, +ніж система RAID, і його можна використовувати для відновлення +або повернення файлів до їх попереднього стану за допомогою +опції -f, --filter: +

+
+
+snapraid fix -f FILE
+
+
+

+або для каталогу: +

+
+
+snapraid fix -f DIR/
+
+
+

+Ви також можете використовувати його для відновлення лише випадково +видалених файлів усередині каталогу за допомогою опції -m, +--filter-missing, яка відновлює лише відсутні файли, +залишаючи всі інші недоторканими. +

+
+
+snapraid fix -m -f DIR/
+
+
+

+Або для відновлення всіх видалених файлів на всіх дисках за допомогою: +

+
+
+snapraid fix -m
+
+
+

4.4 +Відновлення (Recovering) +

+Сталося найгірше, і ви втратили один або кілька дисків! +

+НЕ ПАНІКУЙТЕ! Ви зможете їх відновити! +

+Перше, що ви повинні зробити, це уникнути подальших змін у +вашому дисковому масиві. Вимкніть будь-які віддалені +підключення до нього та будь-які заплановані процеси, +включаючи будь-яку заплановану нічну синхронізацію або +скрабування SnapRAID. +

+Потім виконайте наступні кроки. +

4.4.1 +КРОК 1 -> Переналаштування +

+Вам потрібен деякий простір для відновлення, в ідеалі на +додаткових запасних дисках, але зовнішній USB-диск або +віддалений диск підійде. +

+Змініть конфігураційний файл SnapRAID, щоб опція `data` або +`parity` диска, що вийшов з ладу, вказувала на місце розташування +з достатньою кількістю вільного місця для відновлення файлів. +

+Наприклад, якщо диск `d1` вийшов з ладу, змініть з: +

+
+
+data d1 /mnt/disk1/
+
+
+

+на: +

+
+
+data d1 /mnt/new_spare_disk/
+
+
+

+Якщо диск, який потрібно відновити, є диском парності, оновіть +відповідну опцію `parity`. +Якщо у вас кілька дисків, що вийшли з ладу, оновіть усі їхні +конфігураційні опції. +

4.4.2 +КРОК 2 -> Виправлення (Fix) +

+Запустіть команду fix, зберігаючи журнал у зовнішньому файлі +за допомогою: +

+
+
+snapraid -d NAME -l fix.log fix
+
+
+

+Де NAME — це ім'я диска, наприклад `d1` у нашому попередньому +прикладі. +Якщо диск, який потрібно відновити, є диском парності, +використовуйте імена `parity`, `2-parity`, тощо. +Якщо у вас кілька дисків, що вийшли з ладу, використовуйте +кілька опцій -d, щоб вказати їх усі. +

+Ця команда займе багато часу. +

+Переконайтеся, що у вас є кілька гігабайт вільного місця для +зберігання файлу fix.log. +Запустіть її з диска з достатньою кількістю вільного місця. +

+Тепер ви відновили все, що можна відновити. Якщо деякі файли +частково або повністю неможливо відновити, вони будуть перейменовані +з додаванням розширення `.unrecoverable`. +

+Ви можете знайти детальний список усіх невідновлюваних блоків +у файлі fix.log, перевіривши всі рядки, що починаються з +`unrecoverable:`. +

+Якщо ви не задоволені відновленням, ви можете повторити його +стільки разів, скільки забажаєте. +

+Наприклад, якщо ви видалили файли з масиву після останньої +`sync`, це може призвести до того, що деякі файли не будуть +відновлені. +У цьому випадку ви можете повторити `fix`, використовуючи +опцію -i, --import, вказавши, де ці файли знаходяться зараз, +щоб знову включити їх у процес відновлення. +

+Якщо ви задоволені відновленням, ви можете продовжити, але +зауважте, що після синхронізації ви більше не зможете повторити +команду `fix`! +

4.4.3 +КРОК 3 -> Перевірка (Check) +

+Як обережну перевірку, ви можете тепер запустити команду +`check`, щоб переконатися, що на відновленому диску все +правильно. +

+
+
+snapraid -d NAME -a check
+
+
+

+Де NAME — це ім'я диска, наприклад `d1` у нашому попередньому +прикладі. +

+Опції -d та -a вказують SnapRAID перевіряти лише вказаний +диск та ігнорувати всі дані парності. +

+Ця команда займе багато часу, але якщо ви не надто обережні, +ви можете її пропустити. +

4.4.4 +КРОК 4 -> Синхронізація (Sync) +

+Запустіть команду `sync`, щоб повторно синхронізувати масив +з новим диском. +

+
+
+snapraid sync
+
+
+

+Якщо все відновлено, ця команда виконується миттєво. +

5 +Команди +

+SnapRAID надає кілька простих команд, які дозволяють: + +

+Команди повинні бути написані малими літерами. +

5.1 +status +

+Виводить зведення стану дискового масиву. +

+Включає інформацію про фрагментацію парності, вік блоків без +перевірки та всі записані приховані помилки, виявлені під +час скрабування. +

+Представлена інформація стосується останнього часу, коли ви +запустили `sync`. Пізніші модифікації не враховуються. +

+Якщо виявлено погані блоки, перераховуються їхні номери блоків. +Щоб їх виправити, ви можете використовувати команду `fix -e`. +

+Також показує графік, що представляє останній час, коли +кожен блок був скрабований або синхронізований. Скрабовані +блоки позначаються символом '*', блоки, синхронізовані, +але ще не скрабовані, - 'o'. +

+Нічого не змінюється. +

5.2 +smart +

+Виводить звіт SMART усіх дисків у системі. +

+Включає оцінку ймовірності відмови протягом наступного року, +дозволяючи вам планувати планову заміну дисків, які +виявляють підозрілі атрибути. +

+Ця оцінка ймовірності отримана шляхом кореляції атрибутів +SMART дисків з даними Backblaze, доступними за адресою: +

+
+
+https://www.backblaze.com/hard-drive-test-data.html
+
+
+

+Якщо SMART повідомляє, що диск виходить з ладу, для цього +диска виводиться `FAIL` або `PREFAIL`, і SnapRAID повертає +помилку. У цьому випадку настійно рекомендується негайна +заміна диска. +

+Інші можливі рядки стану: + + + + +
+logfail + +У минулому деякі атрибути були нижчими за +поріг. +
+logerr + +Журнал помилок пристрою містить помилки. +
+selferr + +Журнал самотестування пристрою містить помилки. +
+

+Якщо вказано опцію -v, --verbose, надається глибший +статистичний аналіз. Цей аналіз може допомогти вам вирішити, +чи потрібна вам більша або менша парність. +

+Ця команда використовує інструмент `smartctl` і еквівалентна +запуску `smartctl -a` на всіх пристроях. +

+Якщо ваші пристрої не виявляються автоматично правильно, ви +можете вказати користувацьку команду, використовуючи опцію +`smartctl` у конфігураційному файлі. +

+Нічого не змінюється. +

5.3 +probe +

+Виводить стан ЖИВЛЕННЯ всіх дисків у системі. +

+`Standby` означає, що диск не обертається. `Active` означає, +що диск обертається. +

+Ця команда використовує інструмент `smartctl` і еквівалентна +запуску `smartctl -n standby -i` на всіх пристроях. +

+Якщо ваші пристрої не виявляються автоматично правильно, ви +можете вказати користувацьку команду, використовуючи опцію +`smartctl` у конфігураційному файлі. +

+Нічого не змінюється. +

5.4 +up +

+Розкручує всі диски масиву. +

+Ви можете розкрутити лише певні диски, використовуючи +опцію -d, --filter-disk. +

+Одночасне розкручування всіх дисків вимагає багато енергії. +Переконайтеся, що ваш блок живлення може це витримати. +

+Нічого не змінюється. +

5.5 +down +

+Зупиняє всі диски масиву. +

+Ця команда використовує інструмент `smartctl` і еквівалентна +запуску `smartctl -s standby,now` на всіх пристроях. +

+Ви можете зупинити лише певні диски, використовуючи +опцію -d, --filter-disk. +

+Для автоматичної зупинки при помилці ви можете +використовувати опцію -s, --spin-down-on-error з будь-якою +іншою командою, що еквівалентно ручному запуску `down` +при виникненні помилки. +

+Нічого не змінюється. +

5.6 +diff +

+Виводить список усіх файлів, змінених з моменту останньої +`sync`, для яких необхідно перерахувати дані парності. +

+Ця команда не перевіряє дані файлів, а лише часову мітку +файлу, розмір та inode. +

+Після перерахування всіх змінених файлів представляється +зведення змін, згруповане за: + + + + + + + + +
+equal (рівні) + +Файли, незмінені з попереднього стану. +
+added (додані) + +Файли, додані, яких не було раніше. +
+removed (видалені) + +Файли, видалені. +
+updated (оновлені) + +Файли з іншим розміром або часовою +міткою, що означає, що вони були змінені. +
+moved (переміщені) + +Файли, переміщені в інший каталог +на тому ж диску. Вони ідентифікуються за тим же +іменем, розміром, часовою міткою та inode, але іншим +каталогом. +
+copied (скопійовані) + +Файли, скопійовані на тому ж +або іншому диску. Зауважте, що якщо вони справді +переміщені на інший диск, вони також будуть враховані +як `removed`. +Вони ідентифікуються за тим же іменем, розміром +та часовою міткою. Якщо часова мітка з точністю +до долі секунди дорівнює нулю, повний шлях повинен +збігатися, а не лише ім'я. +
+restored (відновлені) + +Файли з іншим inode, але +збігаються ім'я, розмір та часова мітка. Це +зазвичай файли, відновлені після видалення. +
+

+Якщо потрібна `sync`, код повернення процесу дорівнює 2, +замість стандартного 0. Код повернення 1 використовується для +загальної умови помилки. +

+Нічого не змінюється. +

5.7 +sync +

+Оновлює інформацію парності. Всі змінені файли у дисковому +масиві зчитуються, і відповідні дані парності оновлюються. +

+Ви можете зупинити цей процес у будь-який час, натиснувши +Ctrl+C, не втрачаючи вже виконану роботу. +Під час наступного запуску процес `sync` відновить роботу +з місця, де був перерваний. +

+Якщо під час процесу виявлено приховані помилки або помилки +введення/виведення, відповідні блоки позначаються як погані. +

+Файли ідентифікуються за шляхом та/або inode та перевіряються +за розміром та часовою міткою. +Якщо розмір або часова мітка файлу відрізняються, дані +парності перераховуються для всього файлу. +Якщо файл переміщено або перейменовано на тому ж диску, +зберігаючи той самий inode, парність не перераховується. +Якщо файл переміщено на інший диск, парність перераховується, +але раніше обчислена інформація хешу зберігається. +

+Файли `content` та `parity` змінюються за потреби. +Файли в масиві НЕ змінюються. +

5.8 +scrub +

+Скрабує масив, перевіряючи на наявність прихованих помилок +або помилок введення/виведення на дисках даних та парності. +

+Кожен виклик перевіряє приблизно 8% масиву, виключаючи +дані, які вже були скрабовані протягом останніх 10 днів. +Це означає, що скрабування раз на тиждень забезпечує +перевірку кожного біта даних принаймні раз на три місяці. +

+Ви можете визначити інший план скрабування або кількість +за допомогою опції -p, --plan, яка приймає: +bad - Скрабувати блоки, позначені як погані. +new - Скрабувати щойно синхронізовані блоки, які ще не були +
+скрабовані. +
+ + + +
+full + +Скрабувати все. +
+0-100 + +Скрабувати вказаний відсоток блоків. +
+

+Якщо ви вказуєте відсоткове значення, ви також можете +використовувати опцію -o, --older-than, щоб визначити, +яким має бути вік блоку. +Найстаріші блоки скрабуються першими, забезпечуючи оптимальну +перевірку. +Якщо ви хочете скрабувати лише щойно синхронізовані блоки, +які ще не були скрабовані, використовуйте опцію `-p new`. +

+Щоб отримати деталі статусу скрабування, використовуйте команду +`status`. +

+Для будь-якої знайденої прихованої помилки або помилки +введення/виведення відповідні блоки позначаються як погані +у файлі `content`. +Ці погані блоки перераховуються у `status` і можуть бути +виправлені за допомогою `fix -e`. +Після виправлення, під час наступного скрабування, вони будуть +повторно перевірені, і якщо виявиться, що вони виправлені, +позначка "поганий" буде видалена. +Щоб скрабувати лише погані блоки, ви можете використовувати +команду `scrub -p bad`. +

+Рекомендується запускати `scrub` лише на синхронізованому +масиві, щоб уникнути повідомлень про помилки, спричинені +несинхронізованими даними. Ці помилки розпізнаються як +не приховані помилки, і блоки не позначаються як погані, +але такі помилки повідомляються у виведенні команди. +

+Файл `content` змінюється для оновлення часу останньої перевірки +для кожного блоку та для позначення поганих блоків. +Файли `parity` НЕ змінюються. +Файли в масиві НЕ змінюються. +

5.9 +fix +

+Виправляє всі файли та дані парності. +

+Усі файли та дані парності порівнюються зі станом знімка, +збереженим під час останньої `sync`. +Якщо знайдено різницю, вона повертається до збереженого знімка. +

+УВАГА! Команда `fix` не розрізняє помилки та навмисні +модифікації. Вона безумовно повертає стан файлу до останньої +`sync`. +

+Якщо не вказано жодної іншої опції, обробляється весь масив. +Використовуйте опції фільтра, щоб вибрати підмножину файлів +або дисків для роботи. +

+Щоб виправити лише блоки, позначені як погані під час `sync` +та `scrub`, використовуйте опцію -e, --filter-error. +На відміну від інших опцій фільтра, ця застосовує виправлення +лише до файлів, які не змінилися з моменту останньої `sync`. +

+SnapRAID перейменовує всі файли, які не можуть бути виправлені, +додаючи розширення `.unrecoverable`. +

+Перед виправленням сканується весь масив, щоб знайти будь-які +файли, переміщені з моменту останньої `sync`. +Ці файли ідентифікуються за їхньою часовою міткою, ігноруючи +їхнє ім'я та каталог, і використовуються в процесі відновлення, +якщо це необхідно. +Якщо ви перемістили деякі з них за межі масиву, ви можете +використовувати опцію -i, --import, щоб вказати додаткові +каталоги для сканування. +

+Файли ідентифікуються лише за шляхом, а не за inode. +

+Файл `content` НЕ змінюється. +Файли `parity` змінюються за потреби. +Файли в масиві змінюються за потреби. +

5.10 +check +

+Перевіряє всі файли та дані парності. +

+Працює як `fix`, але лише імітує відновлення, і жодні зміни +не записуються в масив. +

+Ця команда в першу чергу призначена для ручної перевірки, +наприклад, після процесу відновлення або в інших особливих +умовах. Для періодичних та запланованих перевірок використовуйте +`scrub`. +

+Якщо ви використовуєте опцію -a, --audit-only, перевіряється +лише хеш файлів, а дані парності ігноруються для швидшого +запуску. +

+Файли ідентифікуються лише за шляхом, а не за inode. +

+Нічого не змінюється. +

5.11 +list +

+Виводить список усіх файлів, що містяться в масиві на момент +останньої `sync`. +

+З -v або --verbose також показується час з точністю до +долі секунди. +

+Нічого не змінюється. +

5.12 +dup +

+Виводить список усіх дублікатів файлів. Два файли вважаються +рівними, якщо їхні хеші збігаються. Дані файлів не +зчитуються; використовуються лише попередньо обчислені хеші. +

+Нічого не змінюється. +

5.13 +pool +

+Створює або оновлює віртуальне представлення всіх файлів +у вашому дисковому масиві в каталозі `pooling`. +

+Файли не копіюються, а пов'язуються за допомогою символічних +посилань. +

+Під час оновлення всі існуючі символічні посилання та порожні +підкаталоги видаляються та замінюються новим +представленням масиву. Будь-які інші звичайні файли залишаються +на місці. +

+Нічого не змінюється за межами каталогу pool. +

5.14 +devices +

+Виводить низькорівневі пристрої, які використовуються масивом. +

+Ця команда відображає асоціації пристроїв у масиві і в +основному призначена як інтерфейс для сценаріїв. +

+Перші два стовпці — це низькорівневий ідентифікатор пристрою +та шлях. +Наступні два стовпці — це високорівневий ідентифікатор пристрою +та шлях. +Останній стовпець — це ім'я диска в масиві. +

+У більшості випадків у вас є один низькорівневий пристрій для +кожного диска в масиві, але в деяких складніших конфігураціях +у вас може бути кілька низькорівневих пристроїв, які використовуються +одним диском у масиві. +

+Нічого не змінюється. +

5.15 +touch +

+Встановлює довільну часову мітку з точністю до долі секунди +для всіх файлів, у яких вона встановлена на нуль. +

+Це покращує здатність SnapRAID розпізнавати переміщені та +скопійовані файли, оскільки робить часову мітку майже +унікальною, зменшуючи можливі дублікати. +

+Зокрема, якщо часова мітка з точністю до долі секунди не +дорівнює нулю, переміщений або скопійований файл ідентифікується +як такий, якщо він збігається з іменем, розміром та часовою +міткою. Якщо часова мітка з точністю до долі секунди дорівнює +нулю, він вважається копією, лише якщо повний шлях, розмір та +часова мітка збігаються. +

+Часова мітка з точністю до секунди не змінюється, тому +всі дати та час ваших файлів будуть збережені. +

5.16 +rehash +

+Планує повторне хешування всього масиву. +

+Ця команда змінює тип хешу, що використовується, як правило, +при оновленні з 32-розрядної системи на 64-розрядну, щоб +переключитися з MurmurHash3 на швидший SpookyHash. +

+Якщо ви вже використовуєте оптимальний хеш, ця команда +нічого не робить і повідомляє, що жодних дій не потрібно. +

+Повторне хешування не виконується негайно, а відбувається +поступово під час `sync` та `scrub`. +

+Ви можете перевірити стан повторного хешування за допомогою +`status`. +

+Під час повторного хешування SnapRAID зберігає повну +функціональність, за єдиним винятком, що `dup` не може +виявити дублікати файлів, використовуючи інший хеш. +

6 +Опції +

+SnapRAID надає наступні опції: + + +
+-c, --conf CONFIG +
+Вибирає конфігураційний файл для використання. Якщо не +вказано, в Unix використовується файл `/usr/local/etc/snapraid.conf`, +якщо він існує, інакше `/etc/snapraid.conf`. +У Windows використовується файл `snapraid.conf` у тому +самому каталозі, що й `snapraid.exe`. +
+ + +
+-f, --filter PATTERN +
+Фільтрує файли для обробки у `check` та `fix`. +Обробляються лише файли, що відповідають вказаному +шаблону. Цю опцію можна використовувати кілька разів. +Дивіться розділ PATTERN для отримання додаткової +інформації про специфікації шаблонів. +В Unix переконайтеся, що символи глоббінгу взяті +в лапки, якщо вони використовуються. +Цю опцію можна використовувати лише з `check` та `fix`. +Її не можна використовувати з `sync` та `scrub`, оскільки +вони завжди обробляють весь масив. +
+ + +
+-d, --filter-disk NAME +
+Фільтрує диски для обробки у `check`, `fix`, `up` та `down`. +Ви повинні вказати ім'я диска, як визначено у +конфігураційному файлі. +Ви також можете вказати диски парності з іменами: +`parity`, `2-parity`, `3-parity`, тощо, щоб обмежити +операції певним диском парності. +Якщо ви поєднуєте кілька опцій --filter, --filter-disk +та --filter-missing, вибираються лише файли, що +відповідають усім фільтрам. +Цю опцію можна використовувати кілька разів. +Цю опцію можна використовувати лише з `check`, `fix`, +`up` та `down`. +Її не можна використовувати з `sync` та `scrub`, оскільки +вони завжди обробляють весь масив. +
+ + +
+-m, --filter-missing +
+Фільтрує файли для обробки у `check` та `fix`. +Обробляються лише файли, що відсутні або видалені з +масиву. При використанні з `fix` це діє як команда +`undelete` (відновлення видалених файлів). +Якщо ви поєднуєте кілька опцій --filter, --filter-disk +та --filter-missing, вибираються лише файли, що +відповідають усім фільтрам. +Цю опцію можна використовувати лише з `check` та `fix`. +Її не можна використовувати з `sync` та `scrub`, оскільки +вони завжди обробляють весь масив. +
+ + +
+-e, --filter-error +
+Обробляє файли з помилками у `check` та `fix`. +Обробляє лише файли, які мають блоки, позначені +прихованими помилками або помилками введення/виведення +під час `sync` та `scrub`, як зазначено у `status`. +Цю опцію можна використовувати лише з `check` та `fix`. +
+ + +
+-p, --plan PERC|bad|new|full +
+Вибирає план скрабування. Якщо PERC є числовим +значенням від 0 до 100, воно інтерпретується як відсоток +блоків для скрабування. +Замість відсотка ви можете вказати план: `bad` +скрабує погані блоки, `new` скрабує блоки, які ще не +були скрабовані, і `full` скрабує все. +Цю опцію можна використовувати лише з `scrub`. +
+ + +
+-o, --older-than DAYS +
+Вибирає найстарішу частину масиву для обробки у `scrub`. +DAYS — це мінімальний вік у днях для блоку, який +повинен бути скрабований; за замовчуванням 10. +Блоки, позначені як погані, завжди скрабуються +незалежно від цієї опції. +Цю опцію можна використовувати лише з `scrub`. +
+ + +
+-a, --audit-only +
+У `check` перевіряє хеш файлів без перевірки даних +парності. Якщо вас цікавить лише перевірка даних файлів, +ця опція може значно прискорити процес перевірки. +Цю опцію можна використовувати лише з `check`. +
+ + +
+-h, --pre-hash +
+У `sync` запускає попередню фазу хешування всіх нових +даних для додаткової перевірки перед обчисленням +парності. Зазвичай у `sync` не виконується попереднє +хешування, а нові дані хешуються безпосередньо перед +обчисленням парності, коли вони зчитуються вперше. +Цей процес відбувається, коли система знаходиться під +великим навантаженням, усі диски обертаються та ЦП +зайнятий. Це екстремальна умова для машини, і якщо вона +має приховану апаратну проблему, приховані помилки +можуть залишитися невиявленими, оскільки дані ще не +були хешовані. +Щоб уникнути цього ризику, ви можете ввімкнути режим +`pre-hash`, щоб усі дані були зчитані двічі для +забезпечення їх цілісності. +Ця опція також перевіряє файли, переміщені в межах +масиву, щоб переконатися, що операція переміщення була +успішною, і, якщо необхідно, дозволяє запустити операцію +виправлення перед продовженням. +Цю опцію можна використовувати лише з `sync`. +
+ + +
+-i, --import DIR +
+Імпортує з вказаного каталогу будь-які файли, видалені +з масиву після останньої `sync`. +Якщо у вас все ще є такі файли, вони можуть бути +використані `check` та `fix` для покращення процесу +відновлення. +Файли зчитуються, включаючи підкаталоги, та +ідентифікуються незалежно від їхнього імені. +Цю опцію можна використовувати лише з `check` та `fix`. +
+ + +
+-s, --spin-down-on-error +
+При будь-якій помилці зупиняє всі керовані диски перед +завершенням з ненульовим кодом стану. Це запобігає +тому, щоб диски залишалися активними та оберталися +після перерваної операції, допомагаючи уникнути +зайвого нагрівання та споживання електроенергії. +Використовуйте цю опцію, щоб забезпечити безпечну +зупинку дисків, навіть коли команда завершується +помилкою. +
+ + +
+-w, --bw-limit RATE +
+Застосовує глобальне обмеження пропускної здатності +для всіх дисків. RATE — це кількість байтів на секунду. +Ви можете вказати множник, такий як K, M або G (наприклад, +--bw-limit 1G). +
+ + +
+-A, --stats +
+Вмикає розширений перегляд стану, який показує +додаткову інформацію. +На екрані відображаються два графіки: +Перший графік показує кількість буферизованих смуг +(stripes) для кожного диска, разом зі шляхом до файлу, +до якого наразі здійснюється доступ на цьому диску. +Зазвичай найповільніший диск не матиме доступного +буфера, що визначає максимально досяжну пропускну +здатність. +Другий графік показує відсоток часу, витраченого на +очікування, за останні 100 секунд. Очікується, що +найповільніший диск спричинить більшу частину часу +очікування, тоді як інші диски повинні мати невеликий +час очікування або зовсім його не мати, оскільки +вони можуть використовувати свої буферизовані смуги. +Цей графік також показує час, витрачений на очікування +обчислення хешу та обчислень RAID. +Усі обчислення виконуються паралельно з операціями +диска. Тому, доки є вимірюваний час очікування +принаймні для одного диска, це вказує на те, що ЦП +достатньо швидкий, щоб справлятися з робочим навантаженням. +
+ + +
+-Z, --force-zero +
+Форсує небезпечну операцію синхронізації файлу з +нульовим розміром, який раніше був ненульовим. +Якщо SnapRAID виявляє таку умову, він припиняє +продовження, якщо ви не вкажете цю опцію. +Це дозволяє легко виявити, коли після збою системи +деякі доступні файли були обрізані. +Це можлива умова в Linux з файловими системами +ext3/ext4. +Цю опцію можна використовувати лише з `sync`. +
+ + +
+-E, --force-empty +
+Форсує небезпечну операцію синхронізації диска, на +якому відсутні всі оригінальні файли. +Якщо SnapRAID виявляє, що всі файли, які спочатку +були на диску, відсутні або перезаписані, він +припиняє продовження, якщо ви не вкажете цю опцію. +Це дозволяє легко виявити, коли файлова система +даних не змонтована. +Цю опцію можна використовувати лише з `sync`. +
+ + +
+-U, --force-uuid +
+Форсує небезпечну операцію синхронізації, перевірки +та виправлення з дисками, які змінили свій UUID. +Якщо SnapRAID виявляє, що деякі диски змінили UUID, +він припиняє продовження, якщо ви не вкажете цю опцію. +Це дозволяє виявити, коли ваші диски змонтовані +в неправильних точках монтування. +Однак, дозволено мати одну зміну UUID з однією парністю +і більше з множинною парністю, оскільки це нормальний +випадок при заміні дисків після відновлення. +Цю опцію можна використовувати лише з `sync`, `check` +або `fix`. +
+ + +
+-D, --force-device +
+Форсує небезпечну операцію виправлення з недоступними +дисками або з дисками на тому ж фізичному пристрої. +Наприклад, якщо ви втратили два диски даних і маєте +запасний диск для відновлення лише першого, ви можете +ігнорувати другий недоступний диск. +Або, якщо ви хочете відновити диск у вільному місці, +залишеному на вже використовуваному диску, що +використовує той самий фізичний пристрій. +Цю опцію можна використовувати лише з `fix`. +
+ + +
+-N, --force-nocopy +
+У `sync`, `check` та `fix` вимикає евристику +виявлення копій. Без цієї опції SnapRAID припускає, +що файли з однаковими атрибутами, такими як ім'я, +розмір та часова мітка, є копіями з тими ж даними. +Це дозволяє ідентифікувати скопійовані або +переміщені файли з одного диска на інший і повторно +використовує вже обчислену інформацію хешу для +виявлення прихованих помилок або для відновлення +відсутніх файлів. +У деяких рідкісних випадках ця поведінка може +призвести до хибних спрацьовувань або повільного +процесу через багато перевірок хешу, і ця опція +дозволяє вирішити такі проблеми. +Цю опцію можна використовувати лише з `sync`, `check` +та `fix`. +
+ + +
+-F, --force-full +
+У `sync` форсує повне переобчислення парності. +Цю опцію можна використовувати, коли ви додаєте +новий рівень парності або якщо ви повернулися до +старого файлу вмісту, використовуючи більш +нові дані парності. +Замість створення парності з нуля, це дозволяє +повторно використовувати хеші, присутні у файлі +вмісту, для перевірки даних та підтримки захисту +даних під час процесу `sync`, використовуючи +існуючі дані парності. +Цю опцію можна використовувати лише з `sync`. +
+ + +
+-R, --force-realloc +
+У `sync` форсує повне перерозподілення файлів +та перебудову парності. +Цю опцію можна використовувати для повного +перерозподілу всіх файлів, усуваючи фрагментацію, +повторно використовуючи хеші, присутні у файлі +вмісту, для перевірки даних. +Цю опцію можна використовувати лише з `sync`. +УВАГА! Ця опція лише для експертів, і +настійно не рекомендується її використовувати. +Ви НЕ маєте захисту даних під час операції `sync`. +
+ + +
+-l, --log FILE +
+Записує детальний журнал у вказаний файл. +Якщо ця опція не вказана, несподівані помилки +виводяться на екран, що потенційно призводить до +надмірного виведення у випадку багатьох помилок. +Коли вказано -l, --log, на екран виводяться лише +фатальні помилки, які спричиняють зупинку SnapRAID. +Якщо шлях починається з '>>', файл відкривається +у режимі доповнення. Входження '%D' та '%T' в +імені замінюються датою та часом у форматі YYYYMMDD +та HHMMSS. У пакетних файлах Windows ви повинні +подвоїти символ '%', наприклад, result-%%D.log. +Щоб використовувати '>>', ви повинні взяти ім'я +в лапки, наприклад, `">>result.log"`. +Щоб вивести журнал на стандартний вивід або +стандартну помилку, ви можете використовувати +`">&1"` та `">&2"` відповідно. +Дивіться файл snapraid_log.txt або man-сторінку +для описів тегів журналу. +
+ + +
+-L, --error-limit NUMBER +
+Встановлює новий ліміт помилок перед зупинкою +виконання. За замовчуванням SnapRAID зупиняється, +якщо зустрічає більше 100 помилок введення/виведення, +що вказує на ймовірну відмову диска. +Ця опція впливає на `sync` та `scrub`, яким +дозволено продовжувати після першого набору +помилок диска, щоб спробувати завершити +свої операції. Однак `check` та `fix` завжди +зупиняються при першій помилці. +
+ + +
+-S, --start BLKSTART +
+Починає обробку з вказаного номера блоку. +Це може бути корисно для повторної спроби +перевірки або виправлення певних блоків у +випадку пошкодженого диска. +Ця опція в основному для розширеного ручного +відновлення. +
+ + +
+-B, --count BLKCOUNT +
+Обробляє лише вказану кількість блоків. +Ця опція в основному для розширеного ручного +відновлення. +
+ + +
+-C, --gen-conf CONTENT +
+Генерує фіктивний конфігураційний файл з існуючого +файлу вмісту. +Конфігураційний файл записується на стандартний +вивід і не перезаписує існуючий. +Цей конфігураційний файл також містить інформацію, +необхідну для реконструкції точок монтування диска +у випадку втрати всієї системи. +
+ + +
+-v, --verbose +
+Виводить більше інформації на екран. +Якщо вказано один раз, виводить виключені файли +та додаткову статистику. +Ця опція не впливає на файли журналу. +
+ + +
+-q, --quiet +
+Виводить менше інформації на екран. +Якщо вказано один раз, видаляє індикатор прогресу; +двічі — поточні операції; тричі — інформаційні +повідомлення; чотири рази — повідомлення про +статус. Фатальні помилки завжди виводяться на +екран. Ця опція не впливає на файли журналу. +
+ + +
+-H, --help +
+Виводить короткий довідковий екран. +
+ + +
+-V, --version +
+Виводить версію програми. +
+

7 +Конфігурація +

+SnapRAID вимагає конфігураційний файл, щоб знати, де +розташований ваш дисковий масив і де зберігати інформацію +парності. +

+В Unix використовується файл `/usr/local/etc/snapraid.conf`, +якщо він існує, інакше `/etc/snapraid.conf`. +У Windows використовується файл `snapraid.conf` у тому +самому каталозі, що й `snapraid.exe`. +

+Він повинен містити наступні опції (чутливі до регістру): +

7.1 +parity FILE [,FILE] ... +

+Визначає файли, які потрібно використовувати для зберігання +інформації парності. Парність забезпечує захист від +відмови одного диска, подібно до RAID5. +

+Ви можете вказати кілька файлів, які повинні бути на +різних дисках. Коли файл більше не може зростати, +використовується наступний. +Загальний доступний простір повинен бути принаймні +таким же великим, як найбільший диск даних у масиві. +

+Ви можете додати додаткові файли парності пізніше, +але ви не можете їх переупорядковувати або видаляти. +

+Збереження дисків парності зарезервованими для парності +забезпечує, що вони не стають фрагментованими, покращуючи +продуктивність. +

+У Windows 256 МБ залишається невикористаними на кожному +диску, щоб уникнути попередження про повні диски. +

+Ця опція є обов'язковою і може бути використана лише один раз. +

7.2 +(2,3,4,5,6)-parity FILE [,FILE] ... +

+Визначає файли, які потрібно використовувати для зберігання +додаткової інформації парності. +

+Для кожного вказаного рівня парності вмикається один +додатковий рівень захисту: +

+

+Кожен рівень парності вимагає наявності всіх попередніх +рівнів парності. +

+Застосовуються ті самі міркування, що й для опції 'parity'. +

+Ці опції є необов'язковими і можуть бути використані лише +один раз. +

7.3 +z-parity FILE [,FILE] ... +

+Визначає альтернативний файл та формат для зберігання +потрійної парності. +

+Ця опція є альтернативою '3-parity', в першу чергу +призначена для ЦП низького класу, таких як ARM або +AMD Phenom, Athlon та Opteron, які не підтримують +набір інструкцій SSSE3. У таких випадках вона +забезпечує кращу продуктивність. +

+Цей формат схожий, але швидший, ніж той, що використовується +ZFS RAIDZ3. Як і ZFS, він не працює далі потрійної парності. +

+При використанні '3-parity' ви будете попереджені, +якщо рекомендується використовувати формат 'z-parity' +для покращення продуктивності. +

+Можна конвертувати з одного формату в інший, налаштувавши +конфігураційний файл з бажаним файлом z-parity або +3-parity та використовуючи 'fix' для його відтворення. +

7.4 +content FILE +

+Визначає файл, який потрібно використовувати для зберігання +списку та контрольних сум усіх файлів, присутніх у +вашому дисковому масиві. +

+Він може бути розміщений на диску, що використовується для +даних, парності або будь-якому іншому доступному диску. +Якщо ви використовуєте диск даних, цей файл автоматично +виключається з процесу `sync`. +

+Ця опція є обов'язковою і може бути використана кілька +разів для збереження кількох копій одного і того ж +файлу. +

+Ви повинні зберігати принаймні одну копію для кожного +використаного диска парності плюс одну. Використання +додаткових копій не зашкодить. +

7.5 +data NAME DIR +

+Визначає ім'я та точку монтування дисків даних у +масиві. NAME використовується для ідентифікації диска +і має бути унікальним. DIR — це точка монтування +диска у файловій системі. +

+Ви можете змінювати точку монтування за потреби, +поки ви зберігаєте NAME фіксованим. +

+Ви повинні використовувати одну опцію для кожного +диска даних у масиві. +

+Ви можете перейменувати диск пізніше, змінивши NAME +безпосередньо у конфігураційному файлі, а потім +запустивши команду 'sync'. У випадку перейменування +асоціація здійснюється за допомогою збереженого +UUID дисків. +

7.6 +nohidden +

+Виключає всі приховані файли та каталоги. +В Unix приховані файли — це ті, що починаються з `.`. +У Windows це ті, що мають прихований атрибут. +

7.7 +exclude/include PATTERN +

+Визначає шаблони файлів або каталогів для виключення +або включення у процес синхронізації. +Усі шаблони обробляються у вказаному порядку. +

+Якщо перший шаблон, який збігається, є `exclude` (виключити), +файл виключається. Якщо він є `include` (включити), +файл включається. +Якщо жоден шаблон не збігається, файл виключається, +якщо останній вказаний шаблон є `include`, або +включається, якщо останній вказаний шаблон є `exclude`. +

+Дивіться розділ PATTERN для отримання додаткової +інформації про специфікації шаблонів. +

+Цю опцію можна використовувати кілька разів. +

7.8 +blocksize SIZE_IN_KIBIBYTES +

+Визначає основний розмір блоку в кібібайтах для парності. +Один кібібайт дорівнює 1024 байтам. +

+Розмір блоку за замовчуванням становить 256, що має +працювати для більшості випадків. +

+УВАГА! Ця опція лише для експертів, і настійно +не рекомендується змінювати це значення. Щоб змінити +це значення в майбутньому, вам потрібно буде +перестворити всю парність! +

+Причина використовувати інший розмір блоку полягає +в тому, якщо у вас є багато невеликих файлів, порядку +мільйонів. +

+Для кожного файлу, навіть якщо це лише кілька байтів, +виділяється цілий блок парності, і з багатьма файлами +це може призвести до значного невикористаного місця +парності. Коли ви повністю заповнюєте диск парності, +вам не дозволяється додавати більше файлів на диски +даних. Однак, витрачена парність не накопичується +між дисками даних. Витрачене місце внаслідок великої +кількості файлів на диску даних обмежує лише кількість +даних на цьому диску даних, а не на інших. +

+Як наближення, ви можете припустити, що половина +розміру блоку витрачається для кожного файлу. +Наприклад, зі 100 000 файлами та розміром блоку 256 КіБ +ви витратите 12,8 ГБ парності, що може призвести до +того, що на диску даних буде на 12,8 ГБ менше місця. +

+Ви можете перевірити кількість витраченого місця на +кожному диску за допомогою `status`. Це кількість +місця, яку ви повинні залишити вільною на дисках даних +або використовувати для файлів, не включених у масив. +Якщо це значення від'ємне, це означає, що ви +наближаєтеся до заповнення парності, і воно +представляє місце, яке ви ще можете витратити. +

+Щоб уникнути цієї проблеми, ви можете використовувати +більший розділ для парності. Наприклад, якщо розділ +парності на 12,8 ГБ більший за диски даних, у вас є +достатньо додаткового місця для обробки до 100 000 +файлів на кожному диску даних без будь-якого +витраченого місця. +

+Хитрість, щоб отримати більший розділ парності в +Linux, полягає в тому, щоб відформатувати його +командою: +

+
+
+mkfs.ext4 -m 0 -T largefile4 DEVICE
+
+
+

+Це призводить до приблизно 1,5% додаткового місця, +приблизно 60 ГБ для диска 4 ТБ, що дозволяє +приблизно 460 000 файлів на кожному диску даних +без будь-якого витраченого місця. +

7.9 +hashsize SIZE_IN_BYTES +

+Визначає розмір хешу в байтах для збережених блоків. +

+Розмір хешу за замовчуванням становить 16 байтів +(128 біт), що має працювати для більшості випадків. +

+УВАГА! Ця опція лише для експертів, і настійно +не рекомендується змінювати це значення. Щоб змінити +це значення в майбутньому, вам потрібно буде +перестворити всю парність! +

+Причина використовувати інший розмір хешу полягає +в тому, якщо ваша система має обмежену пам'ять. +Як правило, SnapRAID зазвичай вимагає 1 ГіБ ОЗП +на кожні 16 ТБ даних у масиві. +

+Зокрема, для зберігання хешів даних SnapRAID +вимагає приблизно $TS \times (1+HS) / BS$ байтів +ОЗП, де TS — загальний розмір вашого дискового масиву +у байтах, BS — розмір блоку у байтах, а HS — +розмір хешу у байтах. +

+Наприклад, з 8 дисками по 4 ТБ, розміром блоку 256 КіБ +(1 КіБ = 1024 байта) та розміром хешу 16, ви отримуєте: +

+

+RAM = $(8 \times 4 \times 10^{12}) \times (1+16) / (256 \times 2^{10}) = 1.93$ ГіБ
+
+

+Перехід до розміру хешу 8, ви отримуєте: +

+

+RAM = $(8 \times 4 \times 10^{12}) \times (1+8) / (256 \times 2^{10}) = 1.02$ ГіБ
+
+

+Перехід до розміру блоку 512, ви отримуєте: +

+

+RAM = $(8 \times 4 \times 10^{12}) \times (1+16) / (512 \times 2^{10}) = 0.96$ ГіБ
+
+

+Перехід до розміру хешу 8 та розміру блоку 512, ви отримуєте: +

+

+RAM = $(8 \times 4 \times 10^{12}) \times (1+8) / (512 \times 2^{10}) = 0.51$ ГіБ
+
+

7.10 +autosave SIZE_IN_GIGABYTES +

+Автоматично зберігає стан під час синхронізації або +скрабування після обробки вказаної кількості ГБ. +Ця опція корисна, щоб уникнути перезапуску довгих +команд `sync` з нуля, якщо вони були перервані +збоєм машини або будь-якою іншою подією. +

7.11 +temp_limit TEMPERATURE_CELSIUS +

+Встановлює максимальну дозволену температуру диска +в Цельсіях. Якщо вказано, SnapRAID періодично перевіряє +температуру всіх дисків за допомогою інструменту +smartctl. Поточні температури дисків відображаються +під час роботи SnapRAID. Якщо будь-який диск перевищує +цей ліміт, усі операції зупиняються, і диски +зупиняються (переходять у режим очікування) на час, +визначений опцією `temp_sleep`. Після періоду +очікування операції відновлюються, потенційно +знову призупиняючись, якщо ліміт температури знову +досягнутий. +

+Під час роботи SnapRAID також аналізує криву +нагрівання кожного диска та оцінює довгострокову +стабільну температуру, якої вони, як очікується, +досягнуть, якщо активність продовжиться. +Оцінка виконується лише після того, як температура +диска підвищилася чотири рази, що гарантує наявність +достатньої кількості даних для встановлення +надійного тренду. Ця прогнозована стабільна +температура відображається в дужках поруч із +поточним значенням і допомагає оцінити, чи +достатнє охолодження системи. Ця оцінювана +температура є лише інформаційною і не впливає на +поведінку SnapRAID. Дії програми базуються +виключно на фактично виміряних температурах +дисків. +

+Для виконання цього аналізу SnapRAID потрібна +довідкова інформація про температуру системи. +Спочатку він намагається зчитати її з доступних +апаратних датчиків. Якщо до системного датчика +неможливо отримати доступ, він використовує +найнижчу температуру диска, виміряну на початку +запуску, як резервну довідкову інформацію. +

+Зазвичай SnapRAID показує лише температуру +найгарячішого диска. Щоб відобразити температуру +всіх дисків, використовуйте опцію -A або --stats. +

7.12 +temp_sleep TIME_IN_MINUTES +

+Встановлює час очікування, у хвилинах, коли +досягнуто ліміту температури. Протягом цього +періоду диски залишаються зупиненими. +За замовчуванням 5 хвилин. +

7.13 +pool DIR +

+Визначає каталог об'єднання, де створюється +віртуальне представлення дискового масиву за +допомогою команди `pool`. +

+Каталог повинен вже існувати. +

7.14 +share UNC_DIR +

+Визначає шлях Windows UNC, необхідний для +віддаленого доступу до дисків. +

+Якщо ця опція вказана, символічні посилання, +створені в каталозі pool, використовують цей +шлях UNC для доступу до дисків. +Без цієї опції згенеровані символічні посилання +використовують лише локальні шляхи, що не +дозволяє спільно використовувати каталог pool +через мережу. +

+Символічні посилання формуються за допомогою +вказаного шляху UNC, додаючи ім'я диска, як +зазначено в опції `data`, і, нарешті, +додаючи каталог та ім'я файлу. +

+Ця опція потрібна лише для Windows. +

7.15 +smartctl DISK/PARITY OPTIONS... +

+Визначає користувацькі опції smartctl для +отримання атрибутів SMART для кожного диска. +Це може знадобитися для RAID-контролерів та +деяких USB-дисків, які не можуть бути +автоматично виявлені. Заповнювач %s +замінюється іменем пристрою, але він +необов'язковий для фіксованих пристроїв, +таких як RAID-контролери. +

+DISK — це те саме ім'я диска, вказане в опції `data`. +PARITY — це одне з імен парності: `parity`, +`2-parity`, `3-parity`, `4-parity`, `5-parity`, +`6-parity` або `z-parity`. +

+У вказаних OPTIONS рядок `%s` замінюється +іменем пристрою. Для RAID-контролерів пристрій +ймовірно фіксований, і вам може не знадобитися +використовувати `%s`. +

+Зверніться до документації smartmontools +для можливих опцій: +

+
+
+https://www.smartmontools.org/wiki/Supported_RAID-Controllers
+https://www.smartmontools.org/wiki/Supported_USB-Devices
+
+
+

+Наприклад: +

+
+
+smartctl parity -d sat %s
+
+
+

7.16 +smartignore DISK/PARITY ATTR [ATTR...] +

+Ігнорує вказаний атрибут SMART при обчисленні +ймовірності відмови диска. Ця опція корисна, +якщо диск повідомляє незвичайні або +оманливі значення для певного атрибута. +

+DISK — це те саме ім'я диска, вказане в опції `data`. +PARITY — це одне з імен парності: `parity`, +`2-parity`, `3-parity`, `4-parity`, `5-parity`, +`6-parity` або `z-parity`. +Спеціальне значення * можна використовувати +для ігнорування атрибута на всіх дисках. +

+Наприклад, щоб ігнорувати атрибут `Current Pending Sector Count` +на всіх дисках: +

+
+
+smartignore * 197
+
+
+

+Щоб ігнорувати його лише на першому диску парності: +

+
+
+smartignore parity 197
+
+
+

7.17 +Приклади +

+Приклад типової конфігурації для Unix: +

+
+
+parity /mnt/diskp/snapraid.parity
+content /mnt/diskp/snapraid.content
+content /var/snapraid/snapraid.content
+data d1 /mnt/disk1/
+data d2 /mnt/disk2/
+data d3 /mnt/disk3/
+exclude /lost+found/
+exclude /tmp/
+smartctl d1 -d sat %s
+smartctl d2 -d usbjmicron %s
+smartctl parity -d areca,1/1 /dev/sg0
+smartctl 2-parity -d areca,2/1 /dev/sg0
+
+
+

+Приклад типової конфігурації для Windows: +

+
+
+parity E:\snapraid.parity
+content E:\snapraid.content
+content C:\snapraid\snapraid.content
+data d1 G:\array\
+data d2 H:\array\
+data d3 I:\array\
+exclude Thumbs.db
+exclude \$RECYCLE.BIN
+exclude \System Volume Information
+smartctl d1 -d sat %s
+smartctl d2 -d usbjmicron %s
+smartctl parity -d areca,1/1 /dev/arcmsr0
+smartctl 2-parity -d areca,2/1 /dev/arcmsr0
+
+
+

8 +Шаблон (Pattern) +

+Шаблони використовуються для вибору підмножини файлів +для виключення або включення в процес. +

+Існує чотири різні типи шаблонів: + + +
+FILE +
+Вибирає будь-який файл з іменем FILE. Ви можете +використовувати будь-які символи глоббінгу, +такі як * та ?, та класи символів, такі як [a-z]. +Цей шаблон застосовується лише до файлів, а не +до каталогів. +
+ + +
+DIR/ +
+Вибирає будь-який каталог з іменем DIR та все +всередині. Ви можете використовувати будь-які +символи глоббінгу, такі як * та ?. +Цей шаблон застосовується лише до каталогів, +а не до файлів. +
+ + +
+/PATH/FILE +
+Вибирає точно вказаний шлях до файлу. Ви можете +використовувати будь-які символи глоббінгу, такі +як * та ?, але вони ніколи не збігаються з +похилою рискою каталогу. +Цей шаблон застосовується лише до файлів, +а не до каталогів. +
+ + +
+/PATH/DIR/ +
+Вибирає точно вказаний шлях до каталогу та все +всередині. Ви можете використовувати будь-які +символи глоббінгу, такі як * та ?, але вони +ніколи не збігаються з похилою рискою каталогу. +Цей шаблон застосовується лише до каталогів, +а не до файлів. +
+

+Коли ви вказуєте абсолютний шлях, що починається +з /, він застосовується до кореневого каталогу +масиву, а не до кореневого каталогу локальної +файлової системи. +

+У Windows ви можете використовувати зворотну +скісну риску \ замість прямої скісної риски /. +Системні каталоги Windows, з'єднання, точки +монтування та інші спеціальні каталоги Windows +розглядаються як файли, що означає, що для +їх виключення ви повинні використовувати правило +файлу, а не правило каталогу. +

+Якщо ім'я файлу містить символи '*', '?', '[', +або ']', ви повинні екранувати їх, щоб уникнути +їх інтерпретації як символу глоббінгу. +В Unix символом екранування є '\'; у Windows — '^'. +Коли шаблон знаходиться в командному рядку, +ви повинні подвоїти символ екранування, щоб +запобігти його інтерпретації командною оболонкою. +

+У конфігураційному файлі ви можете використовувати +різні стратегії для фільтрації файлів, які потрібно +обробити. +Найпростіший підхід — використовувати лише +правила `exclude` для видалення всіх файлів та +каталогів, які ви не хочете обробляти. +Наприклад: +

+
+
+# Виключає будь-який файл з іменем `*.unrecoverable`
+exclude *.unrecoverable
+# Виключає кореневий каталог `/lost+found`
+exclude /lost+found/
+# Виключає будь-який підкаталог з іменем `tmp`
+exclude tmp/
+
+
+

+Протилежний підхід — визначити лише файли, +які ви хочете обробити, використовуючи лише +правила `include`. Наприклад: +

+
+
+# Включає лише деякі каталоги
+include /movies/
+include /musics/
+include /pictures/
+
+
+

+Останній підхід — змішувати правила `exclude` +та `include`. У цьому випадку порядок правил +важливий. Раніші правила мають пріоритет +над пізнішими. +Для спрощення ви можете спочатку перерахувати +всі правила `exclude`, а потім усі правила `include`. +Наприклад: +

+
+
+# Виключає будь-який файл з іменем `*.unrecoverable`
+exclude *.unrecoverable
+# Виключає будь-який підкаталог з іменем `tmp`
+exclude tmp/
+# Включає лише деякі каталоги
+include /movies/
+include /musics/
+include /pictures/
+
+
+

+У командному рядку, використовуючи опцію -f, +ви можете використовувати лише шаблони `include`. +Наприклад: +

+
+
+# Перевіряє лише файли .mp3.
+# В Unix використовуйте лапки, щоб уникнути
+# розширення глоббінгу оболонкою.
+snapraid -f "*.mp3" check
+
+
+

+В Unix, при використанні символів глоббінгу в +командному рядку, ви повинні взяти їх у лапки, +щоб запобігти їх розширенню оболонкою. +

9 +Вміст (Content) +

+SnapRAID зберігає список та контрольні суми +ваших файлів у файлі вмісту. +

+Це бінарний файл, який перераховує всі файли, +присутні у вашому дисковому масиві, разом з +усіма контрольними сумами для перевірки їх +цілісності. +

+Цей файл зчитується та записується командами +`sync` та `scrub` та зчитується командами `fix`, +`check` та `status`. +

10 +Парність (Parity) +

+SnapRAID зберігає інформацію парності вашого +масиву у файлах парності. +

+Це бінарні файли, що містять обчислену +парність усіх блоків, визначених у файлі +`content`. +

+Ці файли зчитуються та записуються командами +`sync` та `fix` і лише зчитуються командами +`scrub` та `check`. +

11 +Кодування (Encoding) +

+SnapRAID в Unix ігнорує будь-яке кодування. +Він зчитує та зберігає імена файлів з +тим самим кодуванням, що використовується +файловою системою. +

+У Windows усі імена, зчитані з файлової +системи, конвертуються та обробляються +у форматі UTF-8. +

+Щоб імена файлів відображалися правильно, +ви повинні встановити консоль Windows +у режим UTF-8 за допомогою команди +`chcp 65001` та використовувати шрифт +TrueType, такий як `Lucida Console`, як +шрифт консолі. +Це впливає лише на надруковані імена +файлів; якщо ви перенаправляєте вивід +консолі у файл, отриманий файл завжди +буде у форматі UTF-8. +

12 +Авторське право (Copyright) +

+Цей файл захищений авторським правом (C) 2025 Andrea Mazzoleni +

13 +Див. також (See Also) +

+snapraid_log(1), rsync(1) + + +

+

+ +
+ + + + + + diff --git a/manual.html b/manual.html index ce105bee..1cf1b2d6 100644 --- a/manual.html +++ b/manual.html @@ -59,7 +59,7 @@

Manual for SnapRAID. -There are also machine translation into German, Spanish, French, Italian, Polish, Romanian. +There are also machine translation into German, Spanish, French, Italian, Polish, Portuguese, Romanian, Russian, Ukranian.