s3backer - Online în cloud

PROGRAM:

NUME

s3backer — Magazin de suport pentru un singur fișier bazat pe FUSE prin Amazon S3

REZUMAT

s3backer [Opțiuni] găleată /punctul de montare

s3backer --Test [Opțiuni] dir /punctul de montare

s3backer --şterge [Opțiuni] găleată

s3backer --resetare-montat-steagul [Opțiuni] găleată

DESCRIERE

s3backer este un sistem de fișiere care conține un singur fișier susținut de Amazon Simple Storage
Serviciu (Amazon S3). Ca sistem de fișiere, este foarte simplu: oferă un singur fișier normal
având o dimensiune fixă. Dedesubt, fișierul este împărțit în blocuri, iar conținutul
fiecare bloc este stocat într-un obiect Amazon S3 unic. Cu alte cuvinte, ce s3backer furnizează
este într-adevăr mai degrabă un dispozitiv de hard disk virtual susținut de S3, decât un sistem de fișiere.

În utilizarea tipică, un sistem de fișiere „normal” este montat deasupra fișierului exportat de
s3backer sistem de fișiere folosind o montare loopback (sau o montare a imaginii de disc pe Mac OS X).

Acest aranjament are mai multe beneficii în comparație cu sistemul de fișiere S3 mai complet
implementari:

o Prin neîncercarea de a implementa un sistem de fișiere complet, care este o întreprindere complexă și
greu de făcut corect, s3backer poate rămâne foarte ușor și simplu. Doar trei HTTP
sunt utilizate operațiuni: GET, PUT și DELETE. Toată experiența și cunoștințele despre
modul de implementare corectă a sistemelor de fișiere care există deja poate fi reutilizat.

o Prin utilizarea sistemelor de fișiere existente, obțineți semantică completă a sistemului de fișiere UNIX. Gângări subtile
sau lipsește funcționalitatea legată de legăturile hard, atributele extinse, blocarea POSIX,
etc sunt evitate.

o Diferența dintre semantica normală a sistemului de fișiere și ``consecvența eventuală'' Amazon S3 este
mai ușor și mai simplu rezolvat atunci când se pot interpreta obiectele S3 ca simple blocuri de dispozitiv
mai degrabă decât obiectele sistemului de fișiere (vezi mai jos).

o Când vă stocați datele pe serverele Amazon S3, care nu sunt sub controlul dvs.,
capacitatea de a cripta și autentifica datele devine o problemă critică. s3backer sprijină
criptare și autentificare sigure. Alternativ, capacitatea de criptare încorporată în
dispozitivul Linux loopback poate fi utilizat.

o Deoarece datele S3 sunt accesate prin rețea, cache-ul local este, de asemenea, foarte important pentru
motive de performanță. De cand s3backer prezintă echivalentul unui hard disk virtual la
nucleul, cea mai mare parte a stocării în cache a sistemului de fișiere se poate face acolo unde ar trebui să fie: în
kernel, prin intermediul cache-ului paginii nucleului. in orice caz s3backer include și propriul său intern
blocați memoria cache pentru performanță sporită, folosind fire de lucru asincrone pentru a prelua
avantajul paralelismului inerent rețelei.

consecvență garanţii
Amazon S3 oferă garanții relativ slabe în ceea ce privește sincronizarea și consistența citirilor
vs. scrie (cunoscută în mod colectiv sub denumirea de „consistență eventuală”). s3backer include logica si
parametrii de configurare pentru a rezolva aceste limitări, permițând utilizatorului să garanteze
consistență la orice nivel dorit, până la detectarea și evitarea 100% inclusiv
date incorecte. Acestea sunt:

1. s3backer impune o întârziere minimă între operațiunile PUT sau DELETE consecutive de pe
acelasi bloc. Acest lucru asigură că Amazon S3 nu primește aceste operațiuni nefuncționale.

2. s3backer menține un bloc intern cache de sumă de control MD5, care permite automatizarea
detectarea și respingerea blocurilor „învechite” returnate de operațiunile GET.

Această logică este configurată de următoarele opțiuni de linie de comandă: --md5CacheSize,
--md5CacheTime și --minWriteDelay.

Zero Bloca Optimizare
Ca o simplă optimizare, s3backer nu stochează blocuri care conțin toate zerourile; in schimb,
sunt pur și simplu șterse. În schimb, citirile blocurilor inexistente vor conține toate zerourile.
Cu alte cuvinte, fișierul susținut este întotdeauna maxim rar.

Ca rezultat, blocurile nu trebuie să fie create înainte de a fi utilizate și nu sunt speciale
inițializarea este necesară la crearea unui nou sistem de fișiere.

Cand --listBlocks este dat steagul, s3backer va lista toate blocurile existente la pornire, astfel încât
știe din timp exact care blocuri sunt goale.

Fișier si Bloca Mărimea Detectare automată
Ca comoditate, ori de câte ori este scris primul bloc al fișierului susținut, s3backer include
ca metadate (în antetul ``x-amz-meta-s3backer-filesize'') dimensiunea totală a fișierului.
Împreună cu dimensiunea blocului în sine, această valoare poate fi verificată și/sau detectată automat
mai târziu, când sistemul de fișiere este remontat, eliminând nevoia de --blockSize or --mărimea
steaguri să fie furnizate în mod explicit și evitând interpretarea greșită accidentală a unui existent
Sistemul de fișiere.

Bloca Cache
s3backer include suport pentru un cache bloc intern pentru a crește performanța. Blocul
memoria cache este complet separată de memoria cache MD5 care stochează doar sumele de verificare MD5
tranzitoriu și al căror singur scop este de a atenua „coerența eventuală”. Cache-ul blocului
este un cache tradițional care conține blocuri de date stocate în cache. Când sunt pline, blocurile curate sunt evacuate
după cum este necesar în ordinea LRU.

Citirile blocurilor din cache vor reveni imediat fără trafic de rețea. Scrie în cache
de asemenea, revine imediat și declanșează o operație de scriere asincronă în rețea prin a
fir de lucru separat. Deoarece nucleul scrie de obicei blocuri prin sistemele de fișiere FUSE
unul câte unul, efectuarea scrierilor asincron permite s3backer pentru a profita de
paralelismul inerent rețelei, îmbunătățind considerabil performanța de scriere.

Cache-ul bloc poate fi configurat pentru a stoca datele din cache într-un fișier local în loc de în
memorie. Acest lucru permite dimensiuni mai mari ale memoriei cache și permite s3backer pentru a reîncărca datele din cache după a
repornire. Datele reîncărcate sunt verificate prin sumă de control MD5 cu Amazon S3 înainte de reutilizare.

Cache-ul bloc este configurat de următoarele opțiuni de linie de comandă: --blockCacheFile,
--blockCacheMaxDirty, --blockCacheNoVerify, --blockCacheSize, --blockCacheSync,
--blockCacheThreads, --blockCacheTimeout și --blockCacheWriteDelay.

Citeste Înainte
s3backer implementează un algoritm simplu de citire anticipată în memoria cache a blocurilor. Când este configurabil
numărul de blocuri sunt citite în ordine, firele de lucru ale cache a blocurilor sunt trezite pentru a începe citirea
blocurile ulterioare în memoria cache a blocurilor. Citirea înainte continuă atâta timp cât nucleul
continuă să citească blocurile secvenţial. Nucleul solicită de obicei blocurile pe rând,
deci având mai multe fire de lucru care citesc deja următoarele câteva blocuri îmbunătățește citirea
performanta profitand de paralelismul inerent retelei.

Rețineți că nucleul implementează și un algoritm de citire înainte; comportamentul său ar trebui luat
in consideratie. În mod implicit, s3backer trece -o max_readahead=0 opțiunea de a FUSE.

Citirea înainte este configurată de --readAhead si --readAheadTrigger opțiunile liniei de comandă.

Criptare si Autentificare
s3backer acceptă criptarea prin intermediul --criptare, --parola și --passwordFile steaguri. Când
criptarea este activată, autentificarea SHA1 HMAC este, de asemenea, activată automat și s3backer
respinge orice blocuri care nu sunt criptate și semnate corespunzător.

Criptarea la s3backer stratul este de preferat criptării la un strat superior (de exemplu, la
loopback device layer), deoarece dacă datele s3backer vede este deja criptat, nu poate
optimizați blocurile zero sau faceți o compresie semnificativă.

Comprimare
s3backer acceptă compresia la nivel de bloc, ceea ce minimizează timpul de transfer și costurile de stocare.

Compresia este configurată prin intermediul --comprima steag. Compresia este activată automat
când criptarea este activată.

Numai în citire Acces
Nu este necesar un cont Amazon S3 pentru utilizare s3backer. Sistemul de fișiere trebuie deja
există și au obiecte S3 cu ACL-uri configurate pentru acces public de citire (a se vedea --accessType
de mai jos); utilizatorii ar trebui să efectueze montarea looback cu indicatorul doar pentru citire (vezi monta(8)) și
asigurarea --readOnly steag la s3backer. Acest mod de operare facilitează crearea de
sisteme de fișiere publice, numai pentru citire.

Simultan Se montează
Deși funcționează prin rețea, s3backer sistemul de fișiere nu este distribuit
sistem de fișiere și nu acceptă monturi simultane de citire/scriere. (Acesta nu este ceva de tine
ar face în mod normal fie cu o partiție de hard disk.) Ca măsură de siguranță, s3backer
încearcă să detecteze această situație folosind un indicator „deja montat” în depozitul de date și
nu va începe dacă va începe.

Această detectare poate produce un fals pozitiv dacă un fost s3backer procesul nu a fost oprit
curat; dacă da, --resetare-montat-steagul steag poate fi folosit pentru a reseta „deja montat”
steag. Dar vezi și BUGS mai jos.

Statistici Fișier
s3backer populează sistemul de fișiere cu un fișier de statistici care poate fi citit de om. Vedea
--statsFilename de mai jos.

Exploatari forestiere
În funcționare normală s3backer se va conecta prin syslog(3). Când rulați cu -d or -f steaguri,
s3backer se va conecta la eroare standard.

OPŢIUNI

Fiecare flag de linie de comandă are două forme, de exemplu --accessFile=FIȘIER si -o accessFile=FIȘIER.
Doar primul formular este prezentat mai jos. Oricare din multe ori să fie folosite; ambele sunt echivalente. The
a doua formă permite ca opțiunile de montare să fie specificate direct în / Etc / fstab si a trecut
perfect pentru a s3backer de FUSE.

--accessFile=FIȘIER
Specificați un fișier care conține perechi „accessID:accessKey”, câte unul pe linie. Rânduri goale și
liniile care încep cu un „#” sunt ignorate. Daca nu --cheie de acces este specificat, acest fișier
va fi căutată pentru intrarea care se potrivește cu ID-ul de acces specificat prin --accessId; if
nici --cheie de acces nici --accessId este specificat, prima intrare din acest fișier va
fi folosit. Valoarea implicită este $HOME/.s3backer_passwd.

--accessId=ID
Specificați ID-ul de acces Amazon S3. Specificați un șir gol pentru a forța niciun ID de acces. Daca nu
ID-ul de acces este specificat (și nu se găsește niciunul în fișierul de acces). s3backer voi
încă funcționează, dar numai citirile sistemelor de fișiere disponibile public vor funcționa.

--accessKey=CHEIE
Specificați cheia de acces Amazon S3. Pentru a evita publicarea acestui secret prin linia de comandă,
utilizare --accessFile în locul acestui steag.

--accessType=TIP
Specificați tipul ACL de privilegiu de acces Amazon S3 pentru blocurile nou scrise. Valoarea
trebuie să fie unul dintre „private”, „public-read”, „public-read-write” sau „autentificat-
citit'. Implicit este „privat”.

--accessEC2IAM=ROL
Descărcați acreditările de acces și simbolul de securitate în formularul de document JSON de la
http://169.254.169.254/latest/meta-data/iam/security-credentials/ROLE la fiecare cinci
minute.

Această opțiune permite ca acreditările S3 să fie furnizate automat prin intermediul IAM specificat
rolul de a s3backer când rulează pe o instanță Amazon EC2.

--authVersion=TIP
Specificați modul de autentificare a cererilor. Există două autentificare acceptată
metode: aws2 este schema originală de autentificare AWS. aws4 este cel mai nou,
schema de autentificare recomandată.

aws4 este setarea implicită începând cu versiunea 1.4 și este obligatorie
regiuni non-SUA, în timp ce aws2 poate fi încă solicitat de unii furnizori non-Amazon S3.

--baseURL=URL
Specificați adresa URL de bază, care trebuie să se termine cu o bară oblică. Implicit este
`http://s3.amazonaws.com/'.

--blockCacheFile=FIȘIER
Specificați un fișier în care să stocați blocurile de date din cache. Fără acest steag, blocul
memoria cache trăiește în întregime în memoria de proces și datele din cache dispar atunci când s3backer
este oprit. Fișierul va fi creat dacă nu există.

Fișierele cache care au fost create prin invocări anterioare ale s3backer sunt reutilizabile
atâta timp cât au fost create cu aceeași dimensiune de bloc configurată (dacă nu, pornire
va eșua). Acest lucru este adevărat chiar dacă s3backer a fost oprit brusc, de exemplu, din cauza a
blocarea sistemului; totuși, această garanție se bazează pe presupunerea că sistemul de fișiere
care conține fișierul cache nu va reordona scrierile între apelurile către fsync(2).

Dacă se utilizează un cache existent, dar a fost creat cu o dimensiune diferită, s3backer voi
extinde sau micșorează automat fișierul la pornire. Când se micșorează, blochează asta
nu se încadrează în noul cache, cache-ul mai mic este aruncat. Acest proces compactează și
fișierul cache în măsura în care este posibil.

În orice caz, numai blocurile cache curate pot fi recuperate după o repornire. Aceasta înseamnă a
blocarea sistemului va duce la pierderea blocurilor murdare din cache (desigur, acesta este
caz cu un cache în memorie). Utilizare --blockCacheWriteDelay pentru a limita acest lucru
fereastră.

În mod implicit, când ați reîncărcat memoria cache dintr-un fișier cache, s3backer va verifica
suma de control MD5 a fiecărui bloc reîncărcat cu Amazon S3 înainte de prima utilizare. Acest
operațiunea de verificare nu necesită citirea efectivă a datelor blocului și, prin urmare
este relativ rapid. Acest lucru protejează împotriva datelor din cache care au fost obținute fără să știe
desincronizat de la ultima utilizare a fișierului cache, situație care este altfel
imposibil pentru s3backer a detecta.

--blockCacheMaxDirty=NUM
Specificați o limită a numărului de blocuri murdare din memoria cache a blocurilor. Când această limită
este atins, încercările ulterioare de scriere se vor bloca până când apare un bloc murdar existent
scris cu succes (și prin urmare nu mai devine murdar). Acest steag limitează
cantitatea de inconsecvență poate exista în ceea ce privește stocul de date S3 subiacent.

Valoarea implicită este zero, ceea ce înseamnă că nu există limită.

--blockCacheNoVerify
Dezactivați verificarea MD5 a blocurilor încărcate dintr-un fișier cache specificat prin
--blockCacheFile. Folosirea acestui steag este periculoasă; utilizați numai atunci când sunteți sigur că
fișierul stocat în cache este necorupt și datele pe care le conține sunt actualizate.

--blockCacheSize=DIMENSIUNE
Specificați dimensiunea cache a blocurilor (în număr de blocuri). Fiecare intrare din cache va
consumă aproximativ dimensiunea blocului plus 20 de octeți. O valoare de zero dezactivează blocul
cache. Valoarea implicită este 1000.

--blockCacheThreads=NUM
Setați dimensiunea pool-ului de fire asociate cu cache-ul blocului (dacă este activat). Acest
limitează numărul de scrieri simultane care pot apărea în rețea. Mod implicit
valoarea este 20.

--blockCacheTimeout=MILLIS
Specificați perioada maximă de timp pe care o intrare curată poate rămâne în memoria cache a blocurilor înainte ca aceasta să rămână
să fie evacuat forțat și memoria asociată eliberată. O valoare de zero înseamnă că există
fără timeout; în acest caz, numărul de intrări din memoria cache a blocurilor nu va fi niciodată
scad, ajungand eventual la dimensiunea maxima configurata de --blockCacheSize si
ramanand acolo. Configurați o valoare diferită de zero dacă utilizarea memoriei cache a blocurilor este
o îngrijorare. Valoarea implicită este zero (fără timeout).

--blockCacheWriteDelay=MILLIS
Specificați timpul maxim pe care un bloc murdar poate rămâne în memoria cache a blocurilor înainte de a trebui
să fie scris în rețea. Blocurile pot fi scrise mai devreme când există cache
presiune. O valoare de zero configurează o politică de „scriere”; valori mai mari
configurați o politică de ``scriere înapoi''. Valorile mai mari cresc performanța atunci când sunt mici
numărul de blocuri sunt accesate în mod repetat, cu prețul unei inconsecvențe mai mari cu
depozitul de date S3 subiacent. Valoarea implicită este de 250 de milisecunde.

--blockCacheSync
Forțează scrierile sincrone în stratul cache al blocurilor. În loc să se întoarcă
imediat și programarea operațiunii de scriere efectivă se va întâmpla mai târziu, scrieți
cererile nu vor reveni până la finalizarea scrierii. Acest steag este mai strict
cerinţă decât --blockCacheWriteDelay=0, ceea ce face doar scrierile să fie
inițiat cât mai curând posibil (dar încă după ce solicitarea de scriere revine).

Acest steag necesită --blockCacheWriteDelay să fie zero. Utilizarea acestui steag este probabil să o facă
reduce drastic performanța de scriere.

--blockSize=DIMENSIUNE
Specificați dimensiunea blocului. Aceasta trebuie să fie o putere de doi și ar trebui să fie un multiplu al
dimensiunea paginii native a nucleului. Dimensiunea poate avea un sufix opțional „K” pentru kiloocteți,
„M” pentru megaocteți etc.

s3backer acceptă operațiuni bloc parțiale, deși acest lucru forțează o citire înainte de fiecare
scrie; utilizarea cache-ului bloc și alinierea corectă a s3backer dimensiunea blocului cu
utilizarea intenționată (de exemplu, dimensiunea blocului sistemului de fișiere „superior”) va ajuta la minimizare
citirile suplimentare. Rețineți că, chiar și atunci când sistemele de fișiere sunt configurate pentru blocuri mari
dimensiuni, nucleul va scrie adesea blocuri de dimensiunea unei pagini.

s3backer va încerca să detecteze automat dimensiunea blocului citind numărul blocului zero la
lansare. Dacă această opțiune nu este specificată, va fi utilizată valoarea detectată automat. Dacă
această opțiune este specificată, dar nu este de acord cu valoarea detectată automat, s3backer voi
ieșiți cu o eroare dacă nu --forta este de asemenea dat. Dacă detectarea automată eșuează deoarece
bloc numărul zero nu există, iar această opțiune nu este specificată, atunci implicit
este utilizată valoarea 4K (4096).

--cacert=FILE
Specificați fișierul certificat SSL pentru a fi utilizat la verificarea identității serverului de la distanță
când operează prin conexiuni SSL. Echivalent cu --cacert steag documentat în
răsuci(1).

--comprimați[=LEVEL]
Comprimați blocurile înainte de a le trimite prin rețea. Acest lucru ar trebui să aibă ca rezultat mai puțin
trafic de rețea (în ambele direcții) și costuri mai mici de stocare.

Nivelul de compresie este optional; dacă este dat, trebuie să fie între 1 (compresie rapidă)
și 9 (cea mai mare compresie), inclusiv. Dacă este omis, nivelul de compresie implicit este
folosit.

Acest flag permite numai comprimarea blocurilor nou scrise; decompresia este întotdeauna
activat și aplicat atunci când este cazul. Prin urmare, este sigur să porniți acest steag
sau off între diferite invocări ale s3backer pe același sistem de fișiere.

Acest steag este activat automat când --criptare este folosit, deși este posibil și tu
specifica --compress=LEVEL pentru a seta un nivel de compresie care nu este implicit.

Când utilizați un sistem de fișiere criptat de nivel superior, acest indicator nu adaugă nicio valoare deoarece
datele nu vor fi compresibile.

--directIO
Dezactivați stocarea în cache a nucleului fișierului susținut. Acest lucru va forța nucleul să facă întotdeauna
trece citește și scrie direct către s3backer. Acest lucru reduce performanța dar și
elimină o sursă de inconsecvență.

--depanare
Activați înregistrarea mesajelor de depanare. Rețineți că acest steag este diferit de -d, Care
este un steag pentru FUSE; Însă -d Indicatorul FUSE implică acest steag.

--debug-http
Activați imprimarea antetelor HTTP la ieșirea standard.

--encrypt[=CIPHER]
Activați criptarea și autentificarea datelor blocate. Consultați documentația dvs. OpenSSL
pentru o listă de cifruri acceptate; implicit dacă nu este specificat nici un cifru este AES-128
CBC.

Parola de criptare poate fi furnizată printr-unul dintre --parola or --passwordFile. Dacă
niciun steag nu este dat, s3backer va cere parola la pornire.

Notă: cheia reală utilizată este derivată prin hashingul parolei, numele găleții, codul
numele prefixului (dacă există) și numărul blocului. Prin urmare, datele criptate nu pot fi
portate în diferite găleți sau prefixe.

Acest steag implică --comprima.

--şterge
Ștergeți complet sistemul de fișiere ștergând toate blocurile diferite de zero, ștergeți „deja
steagul montat, apoi ieși. Este necesară confirmarea utilizatorului, cu excepția cazului în care --forta pavilion
este de asemenea dat. Rețineți că în acest caz nu se efectuează detectarea simultană a monturii.

Această opțiune implică --listBlocks.

--filename=NUME
Specificați numele fișierului susținut care apare în fișierul s3backer Sistemul de fișiere.
Implicit este „fișier”.

--fileMode=MOD
Specificați biții de permisiune UNIX pentru fișierul susținut care apare în fișierul s3backer
Sistemul de fișiere. Implicit este 0600, cu excepția cazului în care --readOnly este specificat, caz în care
implicit este 0400.

--forta
Continuați chiar dacă valoarea specificată de --blockSize or --mărimea nu este de acord cu
valoare detectată automat sau s3backer detectează că altul s3backer exemplu este încă
montat deasupra aceleiași găleți S3 (și prefix). În oricare dintre aceste cazuri,
continuarea va duce la date corupte, deci --forta steagul ar trebui evitat pentru
utilizare normală.

Detectarea simultană a monturii poate produce un fals pozitiv atunci când o anterioară
s3backer instanța nu a fost închisă curat. În acest caz, nu utilizați --forta dar
mai degrabă fugi s3backer odată cu --resetare-montat-steagul steag.

If --şterge este dată, --forta cauze s3backer pentru a continua fără confirmarea utilizatorului.

-h --Ajutor
Imprimați un mesaj de ajutor și ieșiți.

--initialRetryPause=MILLIS
Specificați timpul inițial de pauză în milisecunde înainte de prima încercare de reîncercare după
operațiuni HTTP eșuate. Eșecurile includ erori de rețea și timeout-uri, HTTP
erori și citiri de date învechite (de exemplu, nepotrivire MD5); s3backer va face multiple
reîncercați folosind un algoritm de backoff exponențial, începând cu această inițială
reîncercați timpul de pauză. Valoarea implicită este 200 ms. Vezi si --maxRetryPause.

--nesigur
Nu verificați identitatea serverului de la distanță atunci când operați prin conexiuni SSL.
Echivalent cu --nesigur steag documentat în răsuci(1).

--keyLength
Ignorați lungimea cheii de criptare bloc generate.

Versiuni ale s3backer înainte de 1.3.6 conținea o eroare în care lungimea
cheia de criptare generată a fost remediată, dar dependentă de sistem, ceea ce face posibil să fie
incompatibil pe sisteme diferite pentru unele cifruri. În versiunea 1.3.6, acest bug a fost
corectat; cu toate acestea, în unele cazuri, aceasta a schimbat lungimea cheii generată, făcând ca
criptarea nu mai este compatibilă cu datele scrise anterior. Acest steag poate fi folosit
pentru a forța lungimea mai veche, fixă ​​a cheii. Valoarea pe care doriți să o utilizați este oricare ar fi
definit pentru EVP_MAX_KEY_LENGTH pe sistemul dvs., de obicei 64.

Este o eroare să specificați o valoare mai mică decât lungimea cheii naturale a cifrului;
cu toate acestea, o valoare de zero este permisă și este echivalentă cu a nu specifica nimic.

--listBlocks
Efectuați o interogare la pornire pentru a determina ce blocuri există deja. Acest lucru permite
optimizări prin care, pentru fiecare bloc care nu există încă, citește zerouri returnate
și scrierile zero sunt omise, eliminând astfel orice acces la rețea. Acest steag este
util atunci când creați un fișier nou susținut sau oricând este de așteptat ca un fișier mare
numărul de blocuri zero va fi citit sau scris, cum ar fi la inițializarea unui nou
Sistemul de fișiere.

Acest flag va încetini pornirea direct proporțional cu numărul de blocuri care
Există deja.

--maxUploadSpeed=BITSPERSEC

--maxDownloadSpeed=BITSPERSEC
Aceste semnalizatoare stabilesc o limită pentru lățimea de bandă utilizată pentru încărcările de bloc individuale și
descărcări (adică, setarea se aplică pe bază de fir). Se aplică doar limitele
la datele de încărcare utilă HTTP și nu includ nicio suprasarcină suplimentară de la HTTP sau TCP
anteturi etc.

Valoarea este măsurată în biți pe secundă și abrevieri precum „256k”, „1m”, etc.
Poate fi folosit. În mod implicit, nu există o limită fixă.

Utilizarea acestor steaguri poate necesita, de asemenea, setarea --pauză flag la o valoare mai mare.

--maxRetryPause=MILLIS
Specificați durata totală în milisecunde s3backer ar trebui să se întrerupă când reîncercați
operațiuni HTTP eșuate înainte de a renunța. Eșecurile includ defecțiuni de rețea și
timeout-uri, erori HTTP și citiri de date învechite (de exemplu, nepotrivire MD5); s3backer voi
faceți mai multe încercări de reîncercare utilizând un algoritm de backoff exponențial, până la aceasta
timpul total maxim de pauză de reîncercare. Această valoare nu include timpul necesar
efectuează ei înșiși operațiunile HTTP (utilizați --pauză pentru asta). Valoarea implicită este
30000 (30 de secunde). Vezi si --initialRetryPause.

--minWriteDelay=MILLIS
Specificați un timp minim în milisecunde între finalizarea cu succes a unei scrieri
și inițierea unei alte scrieri în același bloc. Această întârziere asigură că S3
nu primește scrierile neregulate. Această valoare trebuie setată la zero când
--md5CacheSize este setat la zero (cache-ul MD5 dezactivat). Valoarea implicită este 500 ms.

--md5CacheSize=SIZE
Specificați dimensiunea cache-ului sumei de control MD5 (în număr de blocuri). Dacă memoria cache este
plin când este scris un bloc nou, scrierea se va bloca până când va fi loc.
Prin urmare, este important să configurați --md5CacheTime si --md5CacheSize conform
la frecvența scrierilor în sistemul de fișiere în general și în același bloc
repetat. Alternativ, o valoare egală cu numărul de blocuri din sistemul de fișiere
elimină această problemă, dar consumă cea mai mare memorie când este plină (fiecare intrare din fișierul
memoria cache este de aproximativ 40 de octeți). O valoare de zero dezactivează memoria cache MD5. Mod implicit
valoarea este 1000.

--md5CacheTime=MILLIS
Specificați în milisecunde timpul după ce un bloc a fost scris cu succes
pentru care suma de control MD5 a conținutului blocului ar trebui să fie stocată în cache, în scopul de a
detectarea datelor învechite în timpul citirilor ulterioare. O valoare de zero înseamnă „infinit” și
oferă o garanție împotriva citirii datelor învechite; totuși, ar trebui să faci doar asta
cand --md5CacheSize este configurat să fie egal cu numărul de blocuri; in caz contrar
va apărea (în cele din urmă) blocaj. Această valoare trebuie să fie cel puțin la fel de mare ca
--minWriteDelay. Această valoare trebuie setată la zero când --md5CacheSize este setat la zero
(cache MD5 dezactivat). Valoarea implicită este de 10 secunde.

Cache-ul sumei de control MD5 nu este persistent la reporniri. Prin urmare, pentru a asigura
aceeasi eventuala protectie consistenta in timp ce s3backer nu rulează, trebuie să întârziați
cel puțin --md5CacheTime milisecunde între oprire și repornire s3backer.

--noAutoDetect
Dezactivați detectarea automată a blocurilor și a dimensiunii fișierului la pornire. Dacă acest steag este dat, atunci
dimensiunea blocului este implicit 4096 și --mărimea steag este necesar.

--parola=PAROLA
Furnizați parola pentru criptare și autentificare ca parametru de linie de comandă.

--passwordFile=FIȘIER
Citiți parola pentru criptare și autentificare din (prima linie a).
fișierul specificat.

--prefix=ȘIR
Specificați un prefix pe care să îl adăugați înaintea numelor de resurse din compartiment care le identifică pe fiecare
bloc. Prin utilizarea de prefixe diferite, multiple independente s3backer discurile pot locui
aceeași găleată S3.

Prefixul implicit este șirul gol.

--Liniște
Suprimați ieșirea progresului în timpul pornirii inițiale.

--readAhead=NUM
Configurați numărul de blocuri de citire înainte. Aceasta determină câte blocuri vor fi
să fie citit în memoria cache a blocurilor înaintea ultimului bloc citit de nucleu atunci când este citit
înainte este activ. Această opțiune nu are efect dacă memoria cache a blocurilor este dezactivată. Mod implicit
valoarea este 4.

--readAheadTrigger=NUM
Configurați numărul de blocuri care trebuie citite consecutiv înainte de citirea înainte
algoritmul este declanșat. Odată declanșat, citirea înainte va continua atâta timp cât
kernel-ul continuă să citească blocurile secvenţial. Această opțiune nu are efect dacă
cache de blocare este dezactivată. Valoarea implicită este 2.

--readOnly
Să presupunem că sistemul de fișiere va fi montat doar în citire și returnează EROFS ca răspuns
la orice încercare de a scrie. Acest flag modifică și modul implicit al fișierului susținut
de la 0600 la 0400 și dezactivează memoria cache a sumei de control MD5.

--region=REGION
Specificați o regiune AWS. Acest indicator modifică adresa URL de bază implicită pentru a include regiunea
nume și setează automat --vhost steag.

--resetare-montat-steagul
Resetați marcajul „deja montat” de pe depozitul de date S3 subiacent.

s3backer detectează monturi simultane prin bifarea unui steag special. Dacă o anterioară
invocarea de s3backer nu a fost închis curat, este posibil ca steagul să nu fi fost
degajat. Alergare s3backer --şterge îl va șterge manual. Dar vezi și BUGS mai jos.

--rrs Când scrieți blocuri, specificați Stocare cu redundanță redusă.

--size=SIZE
Specificați dimensiunea (în octeți) fișierului susținut care urmează să fie exportat de sistemul de fișiere.
Dimensiunea poate avea un sufix opțional „K” pentru kiloocteți, „M” pentru megaocteți, „G” pentru
gigabytes, „T” pentru terabytes, „E” pentru exabytes, „Z” pentru zettabytes sau „Y” pentru
yottabytes. s3backer va încerca să detecteze automat dimensiunea blocului citind blocul
numărul zero. Dacă această opțiune nu este specificată, va fi utilizată valoarea detectată automat.
Dacă această opțiune este specificată, dar nu este de acord cu valoarea detectată automat, s3backer
va ieși cu o eroare dacă nu --forta este, de asemenea, dat.

--ssl Echivalentă cu --baseURL https://s3.amazonaws.com/

--statsFilename=NUME
Specificați numele fișierului de statistici care poate fi citit de om care apare în fișierul s3backer
Sistemul de fișiere. O valoare de șir gol dezactivează aspectul acestui fișier. Mod implicit
este „statistici”.

--Test Funcționează în modul de testare local. Blocurile sistemului de fișiere sunt stocate ca fișiere obișnuite în fișierul
director dir. Nu are loc trafic de rețea.

Observați dacă dir este o cale relativă (și -f nu este dat) se va rezolva
raportat la directorul rădăcină.

--timeout=SECONDE
Specificați o limită de timp în secunde pentru o încercare de operare HTTP. Acest lucru limitează
întreaga operațiune, inclusiv timpul de conectare (dacă nu este deja conectat) și date
timpul de transfer. Valoarea implicită este de 30 de secunde; poate fi necesară ajustarea acestei valori
în sus pentru a evita timeout-urile premature pe legăturile mai lente și/sau când utilizați un număr mare
de fire de lucru bloc cache.

Vezi si --maxRetryPause.

--versiune
Versiunea de ieșire și ieșire.

--vhost
Forțați solicitările de stil găzduit virtual. De exemplu, acest lucru va cauza s3backer să utilizeze
adresa URL http://mybucket.s3.amazonaws.com/path/uri în loc de
http://s3.amazonaws.com/mybucket/path/uri.

Acest semnalizare este necesar atunci când gălețile S3 au fost create cu constrângeri de locație
(de exemplu, „găleți UE”). Cu alte cuvinte, acest steag este necesar pentru găleți
definite în afara regiunii SUA. Acest steag este setat automat când --regiune
este folosit steag.

În plus, s3backer acceptă și toate opțiunile FUSE generice. Iată un parțial
listă:

-o uid=UID
Suprascrieți ID-ul de utilizator al fișierului susținut, care este implicit la ID-ul utilizatorului curent.

-o gid=GID
Suprascrieți ID-ul de grup al fișierului susținut, care este implicit la ID-ul de grup curent.

-o sync_read
Faceți citiri sincrone.

-o max_readahead=NUM
Setați citirea anticipată maximă (în octeți).

-f Alergați în prim-plan (nu vă bifurcați). Determină trimiterea în jurnal la o eroare standard.

-d Activați modul de depanare FUSE. implică -f.

-s Rulați în modul cu un singur fir.

În plus, s3backer trece următoarele steaguri care sunt optimizate pentru s3backer a FUSE
(dacă nu este suprascris de utilizator pe linia de comandă):

-o kernel_cache
-o fsname= /
-o subtip=s3backer
-o use_ino
-o entry_timeout=31536000
-o negative_timeout=31536000
-o max_readahead=0
-o attr_timeout=0
-o implicit_permissions
-o permite_altul
-o nodev
-o nosuid

Utilizați s3backer online folosind serviciile onworks.net