obnam - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

obnam - tạo, khôi phục và thao tác sao lưu

SYNOPSIS

obnam [--luôn-khôi phục-setuid] [--no-luôn-khôi phục-setuid] [- điểm kiểm tra=KÍCH THƯỚC]
[--chunk-kích thước túi=KÍCH THƯỚC] [--chunk-cache-size=KÍCH THƯỚC] [--kích thước chunk=KÍCH THƯỚC]
[--chunkids-mỗi nhóm=NUM] [--tên khách hàng=TÊN KHÁCH HÀNG] [--nén-với=CHƯƠNG TRÌNH]
[--config=FILE] [--dump-config] [--dump-setting-name] [--generate-manpage=BẢN MẪU] [-h]
[--Cứu giúp] [- trợ giúp tất cả] [--list-config-file] [--phiên bản] [--no-default-configs]
[--giới hạn sự cố=COUNTER] [--tuổi quan trọng=TUỔI TÁC] [--dduplicate=PHƯƠNG THỨC] [--dir-kích thước túi=KÍCH THƯỚC]
[--dir-cache-size=KÍCH THƯỚC] [--dump-bộ nhớ-hồ sơ=PHƯƠNG PHÁP] [--dump-repo-file-siêu dữ liệu]
[--no-dump-repo-file-siêu dữ liệu] [--mã hóa-với=MÃ HÓA-VỚI] [--loại trừ=LOẠI TRỪ]
[--loại trừ bộ đệm] [--no-loại trừ-bộ đệm] [--Loại khỏi=FILE] [--fsck-sửa]
[--no-fsck-sửa] [--fsck-bỏ qua-chunks] [--no-fsck-bỏ qua-chunks]
[--fsck-bỏ qua-client=TÊN] [--fsck-chỉ thế hệ cuối cùng] [--no-fsck-chỉ thế hệ cuối cùng]
[--fsck-rm-không sử dụng] [--no-fsck-rm-không sử dụng] [--fsck-skip-checksum]
[--no-fsck-bỏ qua-kiểm tra tổng] [--fsck-skip-dirs] [--no-fsck-skip-dirs] [--fsck-bỏ qua-file]
[--no-fsck-bỏ qua-tập tin] [--fsck-skip-thế hệ] [--no-fsck-skip-thế hệ]
[--fsck-skip-per-client-b-cây] [--no-fsck-skip-per-client-b-cây]
[--fsck-skip-shared-b-cây] [--no-fsck-skip-shared-b-cây] [--fuse-opt=FUSE]
[--thế hệ=TẠO] [--gnupghome=HOMEDIR] [--idpath-bit=IDPATH-BITS]
[--idpath-độ sâu=IDPATH-SÂU] [--idpath-bỏ qua=IDPATH-BỎ QUA] [--bao gồm=BAO GỒM]
[--giữ cho=GIỮ] [--chi tiết khóa] [--no-key-chi tiết] [- keyid=KEYID] [--ra khỏi điểm kiểm tra]
[--không-để lại-điểm kiểm tra] [- thời gian chờ khóa=TIMEOUT] [--log=FILE] [--log-giữ=N]
[--mức đăng nhập=LEVEL] [--log-max=KÍCH THƯỚC] [- chế độ nhật ký=PHƯƠNG THỨC] [--lru-kích thước=KÍCH THƯỚC]
[--memory-dump-khoảng=GIÂY] [--kích thước nút=KÍCH THƯỚC] [--một hệ thống tập tin]
[--no-one-file-system] [- đầu ra=FILE] [--giả vờ] [- chạy thử] [- không hành động] [- không-giả vờ]
[- không chạy khô] [- không-không-hành-động] [--thời gian giả vờ=THỜI GIAN] [--pure-paramiko]
[--no-tinh khiết-paramiko] [--Yên lặng] [--im lặng] [- không yên tĩnh] [- không im lặng] [-rURL]
[--kho=URL] [--định dạng kho lưu trữ=FORMAT] [--nguồn gốc=URL] [--sftp-độ trễ=TRỄ SFTP]
[--small-files-in-btree] [--no-small-files-in-btree] [--ssh-lệnh=CÓ THỂ THỰC HIỆN]
[--ssh-host-keys-kiểm tra=VALUE ] [- phímssh=TÊN TỆP] [--ssh-known-hosts=TÊN TỆP]
[--strict-ssh-host-key] [--no-strict-ssh-host-key] [--bit khóa đối xứng=BITS]
[--testing-fail-match=ĐĂNG KÝ] [--đến=ĐẾN] [--dấu vết=TRACE] [--tải lên-hàng đợi-kích thước=KÍCH THƯỚC]
[--dài dòng] [- không dài dòng] [--xác minh-ngẫu nhiên=N] [--cảnh báo tuổi=TUỔI TÁC] [--yếu-ngẫu nhiên]
[--không-yếu-ngẫu nhiên]

obnam [lựa chọn] _khóa
obnam [lựa chọn] khóa bổ sung [KHÁCH HÀNG-TÊN] ...
obnam [lựa chọn] hỗ trợ [MỤC|URL] ...
obnam [lựa chọn] khóa máy khách
obnam [lựa chọn] khách hàng
obnam [lựa chọn] khác biệt [TẠO1]TẠO2
obnam [lựa chọn] kết xuất-repo
obnam [lựa chọn] cưỡng bức khóa
obnam [lựa chọn] quên [TẠO] ...
obnam [lựa chọn] chết tiệt
obnam [lựa chọn] các thế hệ
obnam [lựa chọn] genid
obnam [lựa chọn] giúp đỡ
obnam [lựa chọn] giúp đỡ tất cả
obnam [lựa chọn] kdirstat [FILE] ...
obnam [lựa chọn] lỗi danh sách
obnam [lựa chọn] định dạng danh sách
obnam [lựa chọn] phím danh sách
obnam [lựa chọn] danh sách cấp cao nhất
obnam [lựa chọn] ls [FILE] ...
obnam [lựa chọn] gắn kết [ROOT]
obnam [lựa chọn] nagios-last-backup-age
obnam [lựa chọn] xóa khách hàng [KHÁCH HÀNG-TÊN] ...
obnam [lựa chọn] phím xóa [KHÁCH HÀNG-TÊN] ...
obnam [lựa chọn] khôi phục [MỤC] ...
obnam [lựa chọn] xác minh [MỤC] ...

MÔ TẢ

obnam tạo, khôi phục, thao tác và xử lý các bản sao lưu. Nó có thể lưu trữ
sao lưu trên đĩa cục bộ hoặc vào máy chủ qua sftp. Mỗi thế hệ sao lưu trông giống như một
ảnh chụp nhanh mới nhưng thực sự mang tính gia tăng: người dùng không cần phải lo lắng liệu đó có phải là ảnh chụp nhanh hay không.
sao lưu đầy đủ hay không. Chỉ những dữ liệu đã thay đổi mới được sao lưu và nếu một đoạn dữ liệu đã được
được sao lưu trong một tệp khác, dữ liệu đó sẽ được sử dụng lại.

Nơi đặt dữ liệu sao lưu được gọi là kho lưu trữ sao lưu. Một kho lưu trữ
ví dụ: có thể là một thư mục trên máy chủ sftp hoặc một thư mục trên đĩa cứng USB. MỘT
kho lưu trữ duy nhất có thể chứa các bản sao lưu từ một số máy khách. Dữ liệu của họ sẽ trộn lẫn
như thể họ đang sử dụng các kho lưu trữ riêng biệt, nhưng nếu một khách hàng sao lưu một tệp thì những khách hàng khác sẽ
có thể tái sử dụng dữ liệu.

obnam cú pháp dòng lệnh bao gồm một lệnh có thể theo sau là các lập luận. Các
các lệnh được liệt kê dưới đây.

· sao lưu tạo một bản sao lưu mới. Lần đầu chạy nó sẽ tạo một bản sao lưu đầy đủ, sau đó
đó là một sự gia tăng.

· khôi phục là đối diện của một bản sao lưu. Nó sao chép dữ liệu đã sao lưu từ bản sao lưu
kho lưu trữ vào một thư mục đích. Bạn có thể khôi phục mọi thứ trong một thế hệ, hoặc
các tập tin vừa được chọn.

· khách hàng liệt kê các máy khách được sao lưu vào kho lưu trữ.

· các thế hệ liệt kê mọi thế hệ sao lưu cho một máy khách nhất định, cùng với một số siêu dữ liệu
về thế hệ.

· genid liệt kê mã định danh cho mọi thế hệ sao lưu cho một máy khách nhất định. KHÔNG
thông tin khác được hiển thị. Điều này có thể hữu ích cho việc viết kịch bản.

· ls liệt kê nội dung của một thế hệ nhất định, tương tự như ls -lAR.

· kdirstat liệt kê nội dung của một thế hệ nhất định, theo định dạng tương thích
với kdirstat định dạng tệp bộ đệm, sau đó có thể được sử dụng để trực quan hóa
nội dung của một bản sao lưu.

· xác minh so sánh dữ liệu trong bản sao lưu với dữ liệu người dùng thực tế và đảm bảo rằng chúng
giống hệt nhau. Điều hữu ích nhất là chạy ngay sau khi sao lưu để kiểm tra xem nó có
thực sự đã làm việc. Nó có thể chạy bất cứ lúc nào, nhưng nếu dữ liệu người dùng đã thay đổi,
xác minh không thành công mặc dù bản sao lưu vẫn ổn.

· quên loại bỏ các thế hệ sao lưu không còn cần thiết nữa để chúng không sử dụng
không gian đĩa. Lưu ý rằng sau khi xóa thế hệ sao lưu, dữ liệu sẽ không thể được
được khôi phục nữa. Bạn có thể chỉ định các thế hệ cần loại bỏ bằng cách liệt kê chúng
trên dòng lệnh hoặc sử dụng --giữ cho tùy chọn để chỉ định chính sách cho những gì cần giữ
(mọi thứ khác sẽ bị xóa).

· chết tiệt kiểm tra tính nhất quán nội bộ của kho lưu trữ sao lưu. Nó xác minh rằng
tất cả máy khách, thế hệ, thư mục, tệp và tất cả nội dung tệp vẫn tồn tại trong
kho lưu trữ dự phòng. Có thể mất khá nhiều thời gian để chạy.

· khóa cưỡng bức xóa tệp khóa cho máy khách trong kho lưu trữ. Bạn chỉ nên
buộc khóa nếu bạn chắc chắn không có ai truy cập vào dữ liệu của khách hàng đó trong
kho. Ví dụ, khóa treo có thể xảy ra nếu obnam mất mạng
kết nối tới kho lưu trữ dự phòng.

· khóa khách hàng liệt kê khóa mã hóa được liên kết với mỗi máy khách.

· khóa danh sách liệt kê các khóa có thể truy cập vào kho lưu trữ và cấp độ cao nhất
các thư mục mà mỗi khóa có thể truy cập. Một số thư mục cấp cao nhất được chia sẻ
giữa các khách hàng, một số khác dành riêng cho một khách hàng.

· danh sách cấp cao nhất giống như khóa danh sách, nhưng liệt kê các cấp cao nhất và những phím nào có thể truy cập
Chúng.

· phím bổ sung thêm khóa mã hóa vào kho lưu trữ. Theo mặc định, khóa được thêm vào
chỉ vào các thư mục cấp cao nhất được chia sẻ, nhưng nó cũng có thể được thêm vào các thư mục cụ thể
khách hàng: liệt kê tên của khách hàng trên dòng lệnh. Chìa khóa của họ được đưa ra với
các - keyid lựa chọn. Bất cứ ai có quyền truy cập vào khóa bí mật tương ứng với khóa
id có thể truy cập kho lưu trữ sao lưu (các cấp cao nhất được chia sẻ cùng với các máy khách được chỉ định).

· phím xóa xóa khóa khỏi các thư mục cấp cao nhất được chia sẻ, cộng với mọi ứng dụng khách
được chỉ định trên dòng lệnh.

· nagios-last-backup-age là một séc thoát ra với lợi nhuận khác 0 nếu tuổi dự phòng
vượt quá một ngưỡng nhất định. Nó phù hợp để sử dụng làm plugin kiểm tra cho nagios.
Ngưỡng có thể được đưa ra --cảnh báo tuổi và --tuổi quan trọng tùy chọn.

· khác so sánh hai thế hệ và liệt kê các tập tin khác nhau giữa chúng. Mỗi đầu ra
dòng sẽ được bắt đầu bằng dấu cộng (+) cho các tệp đã được thêm vào, dấu trừ
ký hiệu (-) cho các tệp đã bị xóa hoặc dấu hoa thị (*) cho các tệp có
đã thay đổi. Nếu chỉ có một ID thế hệ được chỉ định trên dòng lệnh
thế hệ này sẽ được so sánh với thế hệ tiền nhiệm trực tiếp của nó. Nếu hai ID đã được
được chỉ định, tất cả các thay đổi giữa hai thế hệ đó sẽ được liệt kê.

· gắn kết làm cho kho lưu trữ sao lưu có sẵn thông qua hệ thống tệp FUSE chỉ đọc. Mỗi
thế hệ sao lưu được hiển thị dưới dạng thư mục con, được đặt tên theo id thế hệ.
Điều này có nghĩa là bạn có thể xem dữ liệu đã sao lưu bằng các công cụ thông thường, chẳng hạn như tệp GUI của bạn
trình quản lý hoặc các công cụ dòng lệnh như ls(1) khác(1), và cp(1). Bạn không thể làm
sao lưu mới bằng lệnh mount nhưng bạn có thể khôi phục dữ liệu một cách dễ dàng.

Bạn cần có các tiện ích FUSE và có quyền sử dụng FUSE cho việc này
công việc. Các chi tiết sẽ khác nhau giữa các hệ điều hành; trong Debian, cài đặt
gói cầu chì và thêm chính bạn vào cầu chì nhóm (bạn có thể cần phải đăng xuất và quay lại
vào lại).

Làm sao lưu
Khi bạn chạy bản sao lưu, obnam tải dữ liệu lên kho lưu trữ dự phòng. Dữ liệu được chia
thành các khối và nếu một đoạn đã tồn tại trong kho lưu trữ dự phòng thì nó sẽ không được tải lên
lại. Điều này cho phép obnam để xử lý các tập tin đã được thay đổi hoặc đổi tên kể từ
lần chạy sao lưu trước đó. Nó cũng cho phép một số máy khách dự phòng tránh tải lên cùng một
dữ liệu. Ví dụ: nếu mọi người trong văn phòng đều có một bản sao của cùng một tờ rơi quảng cáo bán hàng,
chỉ có một bản sao cần được lưu trữ trong kho lưu trữ dự phòng.

Mỗi lần chạy sao lưu là một thế hệ. Ngoài ra, obnam sẽ làm cho trạm kiểm soát các thế hệ
thỉnh thoảng. Đây hoàn toàn giống như các thế hệ bình thường, nhưng không được đảm bảo
là một ảnh chụp nhanh hoàn chỉnh của dữ liệu trực tiếp. Nếu quá trình sao lưu cần được hủy bỏ trong
ở giữa, lần chạy sao lưu tiếp theo có thể tiếp tục từ điểm kiểm tra mới nhất, tránh phải thực hiện
bắt đầu lại từ đầu.

Nếu một lần chạy sao lưu làm mất thư mục gốc sao lưu, các thế hệ cũ vẫn sẽ giữ nó:
không có gì thay đổi ở thế hệ cũ chỉ vì có thế hệ mới. Nếu gốc là
bị đánh rơi do nhầm lẫn, nó có thể được thêm lại và lần sao lưu tiếp theo sẽ sử dụng lại bản hiện có
dữ liệu trong kho lưu trữ sao lưu và sẽ chỉ sao lưu siêu dữ liệu của tệp (tên tệp,
quyền, v.v.).

Đang xác minh sao lưu
Hệ thống dự phòng có ích lợi gì mà bạn không thể dựa vào? Làm sao bạn có thể dựa vào thứ mà bạn không thể
Bài kiểm tra? Các obnam xác minh lệnh kiểm tra dữ liệu trong kho lưu trữ sao lưu có khớp với dữ liệu thực tế không
dữ liệu người dùng. Nó truy xuất một hoặc nhiều tệp từ kho lưu trữ và so sánh chúng với
dữ liệu người dùng. Điều này về cơ bản giống như thực hiện khôi phục, sau đó so sánh các tệp được khôi phục
với các tập tin gốc bằng cách sử dụng CMP(1), nhưng dễ sử dụng hơn.

Theo mặc định, quá trình xác minh diễn ra trên tất cả các tệp. Bạn cũng có thể chỉ định các tập tin sẽ được
được xác minh bằng cách liệt kê chúng trên dòng lệnh. Bạn nên chỉ định đường dẫn đầy đủ đến
các tập tin, không liên quan đến thư mục hiện tại.

Đầu ra liệt kê các tệp không xác minh được vì lý do nào đó. Nếu bạn xác minh mọi thứ,
có khả năng một số tệp (ví dụ: thư mục mẹ của bản sao lưu gốc) có thể đã thay đổi
mà không có vấn đề gì. Lưu ý rằng bạn sẽ cần chỉ định toàn bộ đường dẫn đến
các tập tin hoặc thư mục cần được xác minh, không liên quan đến thư mục gốc dự phòng. Bạn vẫn cần phải
chỉ định ít nhất một trong các gốc dự phòng trên dòng lệnh hoặc thông qua --nguồn gốc tùy chọn như vậy
obnam đó sẽ tìm thấy hệ thống tập tin, trong trường hợp nó là một hệ thống từ xa.

URL cú pháp
Bất cứ khi nào obnam chấp nhận một URL, nó có thể là tên đường dẫn cục bộ hoặc sftp URL. Một sftp
URL có dạng sau:

sftp: //[người sử dụng@]miền[:cổng]/đường dẫn

Ở đâu miền là một tên miền Internet thông thường dành cho máy chủ, người sử dụng tên người dùng của bạn trên đó là gì
máy chủ, cổng là số cổng tùy chọn và con đường là một tên đường dẫn ở phía máy chủ. Giống
bzr(1), nhưng không giống như tiêu chuẩn URL sftp, tên đường dẫn là tuyệt đối, trừ khi nó bắt đầu bằng
/~/ trong trường hợp đó nó liên quan đến thư mục chính của người dùng trên máy chủ.

Xem phần VÍ DỤ để biết ví dụ về URL.

Bạn có thể sử dụng sftp URL cho kho lưu trữ hoặc dữ liệu trực tiếp (gốc), nhưng lưu ý rằng do
những hạn chế trong giao thức và việc triển khai nó trong ba la mật thư viện, một số thứ
sẽ không hoạt động tốt khi truy cập dữ liệu trực tiếp qua sftp. Quan trọng nhất là việc xử lý
của các liên kết cứng là khá tối ưu. Để truy cập dữ liệu trực tiếp, bạn không nên kết thúc URL
với /~/ và nên thêm dấu chấm vào cuối trong trường hợp đặc biệt này.

Thế hệ thông số kỹ thuật
Khi không sử dụng thế hệ mới nhất, bạn sẽ cần chỉ định thế hệ nào bạn cần. Cái này
sẽ được thực hiện với --thế hệ tùy chọn, lấy đặc tả thế hệ làm
lý lẽ. Thông số kỹ thuật là từ mới nhất, nghĩa là thế hệ mới nhất
(cũng là mặc định) hoặc một số. Xem các thế hệ lệnh để xem thế hệ nào
có sẵn và số lượng của chúng là bao nhiêu.

Chính sách cho giữ và loại bỏ sao lưu các thế hệ
Sản phẩm quên lệnh có thể tuân theo chính sách để tự động giữ lại một số và xóa bản sao lưu khác
các thế hệ. Chính sách được thiết lập với --giữ cho=CHÍNH SÁCH tùy chọn.

CHÍNH SÁCH là danh sách các quy tắc được phân tách bằng dấu phẩy. Mỗi quy tắc bao gồm một số lượng và một khoảng thời gian.
Các khoảng thời gian là h, d, w, mvà y, theo giờ, ngày, tuần, tháng và năm.

Một chính sách của 30d có nghĩa là giữ bản sao lưu mới nhất cho mỗi ngày khi bản sao lưu được tạo và
giữ 30 bản sao lưu cuối cùng như vậy. Mọi bản sao lưu phù hợp với bất kỳ quy tắc chính sách nào đều được lưu giữ và mọi
các bản sao lưu ở giữa sẽ bị xóa, cũng như mọi bản sao lưu cũ hơn bản sao lưu được lưu giữ cũ nhất.

Ví dụ: giả sử sao lưu được thực hiện mỗi giờ, vào giờ: lúc 00:00, 01:00, 02:00,
và cứ thế cho đến 23h. Nếu quên lệnh được chạy lúc 23:15, với chính sách trên, nó
sẽ giữ bản sao lưu được thực hiện vào lúc 23:00 mỗi ngày và xóa mọi bản sao lưu khác trong ngày hôm đó.
Nó cũng sẽ xóa các bản sao lưu cũ hơn 30 ngày.

Nếu sao lưu được thực hiện cách ngày, vào buổi trưa, quên sẽ giữ 30 bản sao lưu cuối cùng, hoặc 60
số ngày sao lưu, với chính sách trên.

Lưu ý rằng obnam sẽ chỉ kiểm tra dấu thời gian trong kho lưu trữ sao lưu và không quan tâm
thời gian thực tế hiện tại là bao nhiêu. Điều này có nghĩa là nếu bạn ngừng tạo bản sao lưu mới,
những cái hiện có sẽ không bị xóa tự động. Về bản chất, obnam giả vờ thời gian hiện tại
ngay sau bản sao lưu mới nhất khi quên chạy.

Các quy tắc có thể được đưa ra theo bất kỳ thứ tự nào, nhưng sẽ được sắp xếp theo thứ tự tăng dần của khoảng thời gian
trước khi áp dụng. (Sẽ là sai lầm khi đưa ra hai quy tắc trong cùng một khoảng thời gian.) Một bản sao lưu
thế hệ được giữ nếu nó phù hợp với bất kỳ quy tắc nào.

Ví dụ: giả sử tần suất dự phòng giống như trên, nhưng chính sách 30ngày, 52 tuần. Điều này
sẽ giữ bản sao lưu hàng ngày mới nhất cho mỗi ngày trong ba mươi ngày, và hàng tuần mới nhất
dự phòng trong 52 tuần. Bởi vì các bản sao lưu hàng giờ sẽ bị xóa hàng ngày trước khi chúng có
cơ hội được lưu theo quy tắc hàng tuần, hiệu quả là bản sao lưu 23:00 cho mỗi
ngày được lưu trong một tháng và bản sao lưu 23:00 vào Chủ Nhật được lưu trong một năm.

Thay vào đó, nếu bạn sử dụng chính sách 72h,30d,52w, obnam sẽ giữ bản sao lưu 72 giờ cuối cùng,
và bản sao lưu cuối cùng của mỗi ngày theo lịch trong 30 ngày và bản sao lưu cuối cùng của mỗi lịch
tuần trong 52 tuần. Nếu tần suất sao lưu là một lần mỗi ngày, obnam sẽ giữ bản sao lưu
của mỗi giờ theo lịch được thực hiện sao lưu, cho 72 lần sao lưu như vậy. Nói cách khác,
nó sẽ giữ 72 bản sao lưu hàng ngày gần nhất một cách hiệu quả.

Nghe có vẻ khó hiểu? Hãy nghĩ xem nhà phát triển đã bối rối như thế nào khi viết mã.

Nếu không có chính sách nào được đưa ra, quên sẽ giữ mọi thứ.

Một chính sách điển hình có thể là 72h,7d,5w,12m, có nghĩa là: giữ các bản sao lưu 72 giờ gần đây nhất,
7 lần sao lưu hàng ngày gần đây nhất, 5 lần sao lưu hàng tuần gần đây nhất và 12 lần sao lưu hàng tháng gần đây nhất. Nếu
các bản sao lưu được chạy một cách có hệ thống hàng giờ, điều này có nghĩa là việc duy trì các bản sao lưu hàng giờ
trong ba ngày, sao lưu hàng ngày trong một tuần, sao lưu hàng tuần trong một tháng và sao lưu hàng tháng
trong một năm.

Cách thức hoạt động của chính sách này hơi phức tạp. Chạy quên với --giả vờ tùy chọn để
hãy chắc chắn rằng bạn đang loại bỏ những cái đúng.

Sử dụng mã hóa
obnam có thể mã hóa tất cả dữ liệu nó ghi vào kho lưu trữ dự phòng. Nó sử dụng gpg(1) để làm
sự mã hóa. Bạn cần tạo một cặp khóa bằng cách sử dụng gpg - key -gen (hoặc sử dụng hiện có
một), sau đó cho biết obnam về nó bằng cách sử dụng --mã hóa-với lựa chọn. Bạn có thể tùy ý
sử dụng một thư mục chính riêng bằng cách sử dụng --gnupghome lựa chọn. Theo mặc định, mặc định
thư mục cho gpg(1) sẽ được sử dụng.

Cấu hình các tập tin
obnam sẽ tìm kiếm các tập tin cấu hình ở một số vị trí. Xem phần FILES
cho một danh sách. Tất cả các tệp này cùng nhau được coi là một tệp lớn với nội dung của tất cả
các tập tin được nối.

Các tập tin có định dạng INI và chỉ có [cấu hình] phần được sử dụng (bất kỳ phần nào khác đều được
làm ngơ).

Tên dài của các tùy chọn được sử dụng làm khóa cho các biến cấu hình. Bất kỳ cài đặt nào
có thể được đặt từ dòng lệnh có thể được đặt trong tệp cấu hình, trong [cấu hình]
phần.

Ví dụ: các tùy chọn trong dòng lệnh sau:

obnam --repository=/backup --exclude='.wav$' backup

có thể được thay thế bằng tệp cấu hình sau:

[cấu hình]
kho lưu trữ:/sao lưu
loại trừ: .wav$

(Bạn có thể sử dụng một trong hai foo=giá trị or foo: giá trị cú pháp trong các tập tin.)

Điều bất thường duy nhất về các tập tin là cách các tùy chọn có thể được sử dụng nhiều lần.
bày tỏ. Tất cả các giá trị được đặt trong một dòng logic duy nhất, cách nhau bằng dấu phẩy (và
tùy chọn cả khoảng trắng). Ví dụ:

[cấu hình]
loại trừ = foo, bar, \.mp3$

Ở trên có ba giá trị cho loại trừ tùy chọn: bất kỳ tệp nào có chứa các từ foo or
thanh bất cứ nơi nào trong tên đường dẫn đủ điều kiện hoặc các tệp có tên kết thúc bằng dấu chấm và
mp3 (vì các loại trừ là biểu thức chính quy).

Một dòng logic dài có thể được chia thành nhiều dòng vật lý bằng cách bắt đầu một dòng mới tại
khoảng trắng và thụt dòng tiếp theo:

[cấu hình]
loại trừ = foo,
quán ba,
\.mp3$

Ví dụ trên bổ sung thêm ba mẫu loại trừ.

nhiều khách hàng và khóa
obnam hỗ trợ chia sẻ kho lưu trữ giữa nhiều khách hàng. Khách hàng có thể chia sẻ các
nội dung tệp (khối), để nếu máy khách A sao lưu một tệp lớn và máy khách B có
cùng một tệp thì B không cần tải tệp lớn lên kho lưu trữ lần thứ hai.
Để việc này hoạt động mà không gây nhầm lẫn, máy khách sử dụng giao thức khóa đơn giản cho phép
mỗi lần chỉ có một khách hàng sửa đổi cấu trúc dữ liệu được chia sẻ. Ổ khóa không ngăn được
quyền truy cập chỉ đọc cùng lúc: điều này cho phép bạn khôi phục trong khi người khác đang
sao lưu.

Đôi khi một thao tác chỉ đọc xảy ra để truy cập vào cấu trúc dữ liệu cùng lúc với nó
đang được sửa đổi. Điều này có thể dẫn đến một vụ tai nạn. Nó sẽ không dẫn đến dữ liệu bị hỏng, hoặc
khôi phục không chính xác. Tuy nhiên, bạn có thể cần phải khởi động lại thao tác chỉ đọc sau một
tai nạn.

LỰA CHỌN

--luôn-khôi phục-setuid
khôi phục các bit setuid/setgid trong các tệp được khôi phục, ngay cả khi không phải là tệp gốc hoặc tệp đã sao lưu
có chủ sở hữu khác với người dùng đang chạy khôi phục

--no-luôn-khôi phục-setuid
đối diện với --always-restore-setuid

--tên khách hàng=TÊN KHÁCH HÀNG
tên của khách hàng (mặc định là tên máy chủ)

--nén-với=CHƯƠNG TRÌNH
sử dụng CHƯƠNG TRÌNH để nén kho lưu trữ bằng (một trong số không có, giảm phát)

--tuổi quan trọng=TUỔI TÁC
đối với nagios-last-backup-age: tuổi tối đa (theo mặc định tính bằng giờ) cho lần sao lưu gần đây nhất
sao lưu trước khi thống kê là rất quan trọng. Chấp nhận một mã xác định đơn vị char (s,m,h,d cho
giây, phút, giờ và ngày.

--dump-repo-file-siêu dữ liệu
kết xuất siêu dữ liệu về các tập tin?

--no-dump-repo-file-siêu dữ liệu
đối diện với --dump-repo-file-metadata

--generate-manpage=BẢN MẪU
HỖ TRỢ

--thế hệ=TẠO
thế hệ nào để khôi phục

-h, --Cứu giúp
hiển thị thông báo trợ giúp này và thoát

--giữ cho=GIỮ
chính sách thế hệ nào cần giữ khi quên

- thời gian chờ khóa=TIMEOUT
khi khóa trong kho lưu trữ sao lưu, hãy đợi TIMEOUT giây để khóa hiện có
hãy biến đi trước khi từ bỏ

- đầu ra=FILE
ghi đầu ra vào FILE, thay vì đầu ra tiêu chuẩn

--giả vờ, - chạy thử, - không hành động
không thực sự thay đổi bất cứ điều gì (chỉ hoạt động với sao lưu, quên và khôi phục, và
chỉ có thể mô phỏng hành vi gần đúng)

- không-giả vờ, - không chạy khô, - không-không-hành-động
đối lập với --pretend

--Yên lặng, --im lặng
im lặng: chỉ hiển thị thông báo lỗi, không cập nhật tiến độ

- không yên tĩnh, - không im lặng
đối lập với --quiet

-r, --kho=URL
tên kho lưu trữ dự phòng (có thể là tên đường dẫn hoặc URL được hỗ trợ)

--định dạng kho lưu trữ=FORMAT
sử dụng FORMAT cho các kho lưu trữ mới; một trong số "6", "hải âu xanh"

--đến=ĐẾN
nơi khôi phục hoặc gắn kết FUSE; để khôi phục, phải trống hoặc không tồn tại

--dài dòng
dài dòng: cho người dùng biết nhiều hơn về những gì đang diễn ra và thường đảm bảo rằng người dùng
nhận thức được điều gì đang xảy ra hoặc ít nhất là điều gì đó đang xảy ra và cũng thực hiện
chắc chắn rằng màn hình của họ nhận được cập nhật thường xuyên và có những thay đổi đang diễn ra
mọi lúc để họ không cảm thấy buồn chán và thực tế là họ cảm thấy thất vọng vì
bị phân tâm bởi quá nhiều cập nhật đến nỗi họ sẽ di chuyển vào sa mạc Gobi để
sống dưới một tảng đá

- không dài dòng
đối lập với --verbose

--xác minh-ngẫu nhiên=N
xác minh N tệp ngẫu nhiên từ bản sao lưu (mặc định là 0, nghĩa là mọi thứ)

--phiên bản
hiển thị số phiên bản của chương trình và thoát

--cảnh báo tuổi=TUỔI TÁC
đối với nagios-last-backup-age: tuổi tối đa (theo mặc định tính bằng giờ) cho lần sao lưu gần đây nhất
sao lưu trước khi trạng thái là cảnh báo. Chấp nhận một mã xác định đơn vị char (s,m,h,d cho
giây, phút, giờ và ngày.

Sao lưu up
- điểm kiểm tra=KÍCH THƯỚC
tạo một điểm kiểm tra sau một KÍCH THƯỚC nhất định

--dduplicate=PHƯƠNG THỨC
tìm dữ liệu trùng lặp trong dữ liệu đã sao lưu và chỉ lưu trữ một lần; ba chế độ là
có sẵn: không bao giờ loại bỏ trùng lặp, xác minh rằng không có xung đột băm nào xảy ra hoặc (
mặc định) chấp nhận nguy cơ va chạm một cách chí mạng

--loại trừ=LOẠI TRỪ
biểu thức chính quy cho tên đường dẫn để loại trừ khỏi bản sao lưu (có thể được sử dụng nhiều
lần)

--loại trừ bộ đệm
loại trừ các thư mục (và các thư mục con của chúng) chứa tệp CACHEDIR.TAG (xem
http://www.brynosaurus.com/cachedir/spec.html về những gì nó cần chứa, và
http://liw.fi/cachedir/ để có một công cụ trợ giúp)

--no-loại trừ-bộ đệm
đối diện với --exclude-caches

--Loại khỏi=FILE
đọc các mẫu loại trừ khỏi FILE

--bao gồm=BAO GỒM
biểu thức chính quy để đưa tên đường dẫn vào từ bản sao lưu ngay cả khi nó khớp với một
quy tắc loại trừ (có thể được sử dụng nhiều lần)

--ra khỏi điểm kiểm tra
để lại các thế hệ điểm kiểm tra khi kết thúc quá trình sao lưu thành công

--không-để lại-điểm kiểm tra
đối diện với --leave-checkpoint

--một hệ thống tập tin
loại trừ các thư mục (và các thư mục con của chúng) nằm trong một hệ thống tệp khác

--no-one-file-system
đối diện với --one-file-system

--nguồn gốc=URL
sao lưu những gì

--small-files-in-btree
điều này chỉ có sẵn cho khả năng tương thích ngược; không sử dụng nó và loại bỏ nó
từ cấu hình của bạn

--no-small-files-in-btree
đối diện với --small-files-in-btree

Cấu hình các tập tin và thiết lập
--config=FILE
thêm FILE vào các tệp cấu hình

--dump-config
viết ra toàn bộ cấu hình hiện tại

--dump-setting-name
HỖ TRỢ

- trợ giúp tất cả
hiển thị tất cả các tùy chọn

--list-config-file
HỖ TRỢ

--no-default-configs
xóa danh sách các tệp cấu hình để đọc

Phát triển of obnam chính nó
--giới hạn sự cố=COUNTER
làm hỏng chương trình một cách giả tạo sau khi các tệp COUNTER được ghi vào kho lưu trữ; cái này
rất hữu ích cho việc kiểm tra sự cố của ứng dụng và không được kích hoạt thực tế
sử dụng; đặt thành 0 để tắt (bị tắt theo mặc định)

--thời gian giả vờ=THỜI GIAN
giả vờ đó là DẤU THỜI GIAN (YYYY-MM-DD HH:MM:SS); điều này chỉ hữu ích cho việc thử nghiệm
mục đích

--sftp-độ trễ=TRỄ SFTP
thêm độ trễ nhân tạo (tính bằng mili giây) cho tất cả các lần chuyển SFTP

--testing-fail-match=ĐĂNG KÝ
trình trợ giúp kiểm tra phát triển: mô phỏng các lỗi trong quá trình sao lưu cho các tệp phù hợp
các biểu thức chính quy đã cho

--dấu vết=TRACE
thêm vào các mẫu tên tệp để ghi nhật ký gỡ lỗi theo dõi xảy ra

Encryption
--mã hóa-với=MÃ HÓA-VỚI
Khóa PGP để mã hóa dữ liệu trong kho lưu trữ sao lưu

--gnupghome=HOMEDIR
thư mục chính cho GPG

--chi tiết khóa
hiển thị ID người dùng bổ sung cho tất cả các khóa

--no-key-chi tiết
đối diện với --key-detail

- keyid=KEYID
Id khóa PGP để thêm vào/xóa khỏi kho lưu trữ sao lưu

--bit khóa đối xứng=BITS
kích thước của khóa đối xứng, tính bằng bit

--yếu-ngẫu nhiên
sử dụng /dev/urandom thay vì /dev/random để tạo khóa đối xứng

--không-yếu-ngẫu nhiên
ngược lại --weak-random

TÍNH TOÀN VẸN kiểm tra (fsck)
--fsck-sửa
fsck có nên cố gắng khắc phục sự cố không? Ngụ ý --fsck-rm-không sử dụng

--no-fsck-sửa
đối diện với --fsck-fix

--fsck-bỏ qua-chunks
bỏ qua các đoạn khi kiểm tra tính toàn vẹn của kho lưu trữ (giả sử tất cả các đoạn đều tồn tại và
Chính xác)

--no-fsck-bỏ qua-chunks
đối diện với --fsck-ignore-chunks

--fsck-bỏ qua-client=TÊN
không kiểm tra dữ liệu kho lưu trữ cho TÊN cổ điển

--fsck-chỉ thế hệ cuối cùng
chỉ kiểm tra thế hệ cuối cùng cho mỗi khách hàng

--no-fsck-chỉ thế hệ cuối cùng
đối diện với --fsck-last-thế hệ-chỉ

--fsck-rm-không sử dụng
fsck có nên loại bỏ những đoạn không sử dụng không?

--no-fsck-rm-không sử dụng
ngược lại --fsck-rm-không sử dụng

--fsck-skip-checksum
không kiểm tra tổng kiểm tra các tập tin

--no-fsck-bỏ qua-kiểm tra tổng
đối diện với --fsck-skip-checksums

--fsck-skip-dirs
không kiểm tra bất cứ điều gì về thư mục và tập tin của họ

--no-fsck-skip-dirs
đối diện với --fsck-skip-dirs

--fsck-bỏ qua-file
không kiểm tra bất cứ điều gì về tập tin

--no-fsck-bỏ qua-tập tin
đối diện với --fsck-skip-files

--fsck-skip-thế hệ
không kiểm tra bất kỳ thế hệ nào

--no-fsck-skip-thế hệ
đối diện với --fsck-skip-thế hệ

--fsck-skip-per-client-b-cây
không kiểm tra cây B của mỗi khách hàng

--no-fsck-skip-per-client-b-cây
đối diện với --fsck-skip-per-client-b-trees

--fsck-skip-shared-b-cây
không kiểm tra cây B được chia sẻ

--no-fsck-skip-shared-b-cây
đối diện với --fsck-skip-shared-b-trees

Logging
--log=FILE
ghi các mục nhật ký vào FILE (mặc định là hoàn toàn không ghi các tệp nhật ký); sử dụng "nhật ký hệ thống"
để đăng nhập vào nhật ký hệ thống, "stderr" để đăng nhập vào đầu ra lỗi chuẩn hoặc "không" để
vô hiệu hóa ghi nhật ký

--log-giữ=N
giữ N nhật ký cuối cùng (10)

--mức đăng nhập=LEVEL
đăng nhập ở LEVEL, một trong các gỡ lỗi, thông tin, cảnh báo, lỗi, nghiêm trọng, nghiêm trọng (mặc định: thông tin)

--log-max=KÍCH THƯỚC
xoay nhật ký lớn hơn SIZE, không bao giờ (mặc định: 0)

- chế độ nhật ký=PHƯƠNG THỨC
đặt quyền của tệp nhật ký mới thành MODE (bát phân; mặc định 0600)

Gắn kết với FUSE
--fuse-opt=FUSE
các tùy chọn để chuyển trực tiếp tới Fuse

Tình hình
--dump-bộ nhớ-hồ sơ=PHƯƠNG PHÁP
tạo kết xuất hồ sơ bộ nhớ bằng cách sử dụng METHOD, một trong những phương pháp: không có, đơn giản hoặc meliae
(mặc định: đơn giản)

--memory-dump-khoảng=GIÂY
tạo các kết xuất hồ sơ bộ nhớ cách nhau ít nhất SECONDS

HIỆU QUẢ tinh chỉnh
--kích thước chunk=KÍCH THƯỚC
kích thước của khối dữ liệu tập tin được sao lưu

--chunkids-mỗi nhóm=NUM
mã hóa NUM id đoạn cho mỗi nhóm

--idpath-bit=IDPATH-BITS
kích thước cấp độ chunk id

--idpath-độ sâu=IDPATH-SÂU
độ sâu của ánh xạ chunk id

--idpath-bỏ qua=IDPATH-BỎ QUA
bỏ qua ánh xạ chunk id bit thấp nhất

--lru-kích thước=KÍCH THƯỚC
kích thước bộ đệm LRU cho các nút cây B

--kích thước nút=KÍCH THƯỚC
kích thước của các nút cây B trên đĩa; chỉ ảnh hưởng đến cây B mới nên bạn có thể cần phải xóa một
máy khách hoặc kho lưu trữ để thay đổi điều này cho các kho lưu trữ hiện có

--tải lên-hàng đợi-kích thước=KÍCH THƯỚC
độ dài hàng đợi tải lên cho các nút cây B

Kho định dạng chim hải âu xanh
--chunk-kích thước túi=KÍCH THƯỚC
kích thước tối đa gần đúng của túi kết hợp nhiều đối tượng chunk

--chunk-cache-size=KÍCH THƯỚC
kích thước của bộ đệm trong bộ nhớ cho các đối tượng khối dữ liệu tệp

--dir-kích thước túi=KÍCH THƯỚC
hình ảnh gần đúng kích thước tối đa của túi kết hợp nhiều đối tượng DIR

--dir-cache-size=KÍCH THƯỚC
kích thước bộ đệm trong bộ nhớ cho các đối tượng DIR

SSH / SFTP
--pure-paramiko
không sử dụng openssh ngay cả khi có sẵn, thay vào đó chỉ sử dụng paramiko

--no-tinh khiết-paramiko
đối diện với --pure-paramiko

--ssh-lệnh=CÓ THỂ THỰC HIỆN
có thể sử dụng tệp thực thi thay thế thay vì "ssh" (cho phép đường dẫn đầy đủ, không
có thể thêm đối số)

--ssh-host-keys-kiểm tra=VALUE
Nếu "có", yêu cầu khóa máy chủ ssh phải được biết và chính xác để được chấp nhận.
Nếu "không" thì không yêu cầu điều đó. Nếu "hỏi", người dùng sẽ được yêu cầu chấp nhận một cách tương tác
các máy chủ mới. Mặc định ("ssh-config") là dựa vào các cài đặt của cơ sở
Khách hàng SSH

- phímssh=TÊN TỆP
sử dụng FILENAME làm khóa riêng ssh RSA để truy cập sftp (mặc định là sử dụng khóa
được biết đến với đại lý ssh)

--ssh-known-hosts=TÊN TỆP
tên tệp của tệp máy chủ đã biết của người dùng

--strict-ssh-host-key
KHÔNG ĐƯỢC DÙNG, thay vào đó hãy sử dụng --ssh-host-keys-check

--no-strict-ssh-host-key
đối diện với --strict-ssh-host-keys

Tùy chọn giá trị
Sản phẩm KÍCH THƯỚC giá trị trong các tùy chọn được đề cập ở trên chỉ định kích thước tính bằng byte, với tùy chọn
các hậu tố để biểu thị kilobyte (k), kibibytes (Ki), megabyte (M), mebibyts (Mi),
gigabyte (G), gibibyte (Gi), terabyte (T), tibibyte (Ti). Các hậu tố là trường hợp-
vô cảm.

EXIT TÌNH TRẠNG

obnam sẽ thoát bằng 0 nếu mọi thứ diễn ra tốt đẹp và khác 0 nếu ngược lại.

MÔI TRƯỜNG

obnam sẽ truyền lại môi trường mà nó nhận được từ cha mẹ mà không sửa đổi. Nó có
không tuân theo bất kỳ biến môi trường bất thường nào, nhưng nó tuân theo các biến thông thường khi chạy
các chương trình bên ngoài, tạo các tập tin tạm thời, v.v.

Sử dụng obnam trực tuyến bằng dịch vụ onworks.net