.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.4 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "borg-upgrade" "1" "2026-07-18" "" "borg backup tool"
.SH "نام (NAME)"
borg-upgrade \- ارتقای یک مخزن از نسخه‌ای قبلی
.SH "خلاصه دستور (SYNOPSIS)"
.sp
borg [گزینه‌های عمومی] upgrade [گزینه‌ها] [REPOSITORY]
.SH "توضیحات (DESCRIPTION)"
.sp
ارتقای یک مخزن موجود و محلی Borg.
.SS "چه زمانی به borg upgrade نیاز ندارید"
.sp
هر تغییری مستلزم اجرای \fBborg upgrade\fP نیست.
.sp
شما نیازی به اجرای آن \fBندارید\fP هنگامی که:
.INDENT 0.0
.IP \(bu 2
انتقال مخزن خود به مکانی دیگر
.IP \(bu 2
ارتقا به یک نسخه جزئی دیگر (مانند 1.0.x به 1.0.y)،
مگر اینکه در گزارش تغییرات خلاف آن ذکر شده باشد
.IP \(bu 2
ارتقا از 1.0.x به 1.1.x،
مگر اینکه در گزارش تغییرات خلاف آن ذکر شده باشد
.UNINDENT
.SS "ارتقاهای Borg 1.x.y"
.sp
احراز اصالت TAM آرشیو:
.sp
از دستور \fBborg upgrade \-\-archives\-tam REPO\fP برای افزودن TAM آرشیو به تمام آرشیوهایی که هنوز با TAM اصالت‌سنجی نشده‌اند استفاده کنید.
این روشی آسان برای اعتماد به تمامی آرشیوهای موجود است \- اگر آرشیوی هنوز اصالت‌سنجی TAM نداشته باشد، یک TAM به آن افزوده می‌شود.
آرشیوهای ایجاد شده توسط نسخه‌های قدیمی borg قبل از 1.0.9 دارای TAM نیستند.
آرشیوهای ایجاد شده توسط نسخه‌های جدیدتر borg قاعدتاً باید از قبل دارای TAM باشند.
اگر محیطی با ریسک بالا دارید، نباید صرفاً این دستور را اجرا کنید، بلکه ابتدا باید بررسی کنید که آرشیوها اصیل و غیرمخرب باشند (دارای محتوای درست و برچسب زمانی صحیح باشند).
نسخه Borg 1.2.5 به بعد بنا به دلایل امنیتی نیازمند آن است که تمام آرشیوها با TAM اصالت‌سنجی شده باشند.
.sp
این ارتقا باید یک بار به ازای هر مخزن انجام شود.
.sp
احراز اصالت TAM مانیفست:
.sp
از دستور \fBborg upgrade \-\-tam REPO\fP برای الزام احراز اصالت مانیفست که در Borg 1.0.9 جهت رفع آسیب‌پذیری‌های امنیتی معرفی شد، استفاده کنید. این بدان معناست که اصلاح مخزن پس از این عمل با نسخه‌ای قبل از 1.0.9 خطای اعتبارسنجی ایجاد خواهد کرد؛ بنابراین این ارتقا را تنها پس از به‌روزرسانی کلیه کلاینت‌های استفاده‌کننده از مخزن به نسخه 1.0.9 یا جدیدتر انجام دهید.
.sp
این ارتقا باید به دلایل امنیتی روی هر کلاینت انجام شود.
.sp
اگر مخزنی پس از این ارتقا تصادفاً توسط کلاینتی با نسخه قبل از 1.0.9 دستکاری شد، از \fBborg upgrade \-\-tam \-\-force REPO\fP برای رفع آن استفاده کنید.
.sp
اگر مرتباً چنین کاری انجام می‌دهید، ممکن است نخواهید این ارتقا را فعال کنید (که شما را در معرض مسئله امنیتی قرار می‌دهد). می‌توانید با اجرای \fBborg upgrade \-\-disable\-tam REPO\fP ارتقا را بازگردانید.
.sp
برای جزئیات بیشتر ببینید:
\%<https://\:borgbackup\:.readthedocs\:.io/\:en/\:stable/\:changes\:.html#\:pre-1-0-9-manifest-spoofing-vulnerability>
.SS "Attic و Borg 0.xx به Borg 1.x"
.sp
این قابلیت در حال حاضر از تبدیل مخزن Attic به Borg پشتیبانی می‌کند و همچنین به تبدیل Borg 0.xx به 1.0 یاری می‌رساند.
.sp
در حال حاضر، تنها مخازن محلی (LOCAL) قابل ارتقا هستند (مورد #465).
.sp
لطفاً توجه داشته باشید که \fBborg create\fP (از نسخه 1.0.0) به‌طور پیش‌فرض از تکه‌های (chunks) بزرگ‌تری نسبت به نسخه‌های قدیمی borg یا attic استفاده می‌کند، بنابراین تکه‌های جدید با تکه‌های قدیمی در مخزن ارتقایافته تجمیع و بازشناسی تکراری (deduplicate) نخواهند شد.
گزینه \fB\-\-chunker\-params\fP از دستورات \fBborg create\fP و \fBborg recreate\fP را ببینید.
.sp
دستور \fBborg upgrade\fP رشته‌های جادویی (magic strings) موجود در بخش‌های مخزن را تغییر می‌دهد تا با رشته‌های جادویی جدید Borg مطابقت یابد. فایل‌های کلید یافت‌شده در $ATTIC_KEYS_DIR یا ~/.attic/keys/ نیز تبدیل شده و به $BORG_KEYS_DIR یا ~/.config/borg/keys کپی خواهند شد.
.sp
فایل‌های کَش از $ATTIC_CACHE_DIR یا ~/.cache/attic به $BORG_CACHE_DIR یا ~/.cache/borg تبدیل می‌شوند، اما ساختار حافظه موقت بین Borg و Attic تغییر یافته است، بنابراین ممکن است نخستین نسخه پشتیبان پس از تبدیل به دلیل همگام‌سازی مجدد کَش بیش از حد معمول زمان ببرد.
.sp
فرایند ارتقا در صورت توقف باید قادر به ادامه باشد، هرچند همچنان در تمام بخش‌ها پیمایش خواهد کرد. اگر می‌خواهید از ابتدا شروع کنید، از \fBborg delete\fP بر روی مخزن کپی‌شده استفاده کنید تا از حذف فایل‌های حافظه پنهان نیز اطمینان حاصل شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
borg delete borg
.EE
.UNINDENT
.UNINDENT
.sp
مگر در حالتی که \fB\-\-inplace\fP مشخص شده باشد، فرایند ارتقا ابتدا یک نسخه پشتیبان از مخزن با استفاده از پیوندهای سخت (hardlinks) در REPOSITORY.before\-upgrade\-DATETIME ایجاد می‌کند.
این امر مستلزم آن است که مخزن و دایرکتوری والد آن روی یک فایل‌سیستم قرار داشته باشند تا کپی پیوند سخت کار کند.
این کار بیشتر از ارتقای درجا زمان می‌برد، اما بسیار امن‌تر است و اطلاعات پیشرفت را ارائه می‌دهد (برخلاف \fBcp \-al\fP). پس از اطمینان از صحت تبدیل، می‌توانید با خیال راحت نسخه پشتیبان را حذف کنید.
.sp
هشدار: اجرای ارتقا به‌صورت درجا (in-place) نسخه فعلی را برای نسخه‌های قدیمی‌تر غیرقابل استفاده می‌کند، بدون هیچ راه بازگشتی به نسخه‌های پیشین. این کار می‌تواند به‌طور دائم به مخزن شما آسیب بزند! نرم‌افزار Attic نمی‌تواند مخازن BORG را بخواند، زیرا رشته‌های جادویی تغییر کرده‌اند. قبلاً به شما هشدار داده شده است.
.SH "گزینه‌ها (OPTIONS)"
.sp
برای گزینه‌های عمومی دستورات Borg به \fIborg\-common(1)\fP مراجعه کنید.
.SS "آرگومان‌ها (ARGUMENTS)"
.INDENT 0.0
.TP
.B REPOSITORY
مسیر مخزنی که باید ارتقا یابد
.UNINDENT
.SS "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B  \-n\fP,\fB  \-\-dry\-run
تغییری در مخزن ایجاد نشود
.TP
.B  \-\-inplace
بازنویسی مخزن درجا، بدون امکان بازگشت به نسخه‌های قدیمی‌تر مخزن.
.TP
.B  \-\-force
ارتقای اجباری
.TP
.B  \-\-tam
فعال‌سازی احراز اصالت مانیفست (در کلید و کَش) (Borg 1.0.9 و جدیدتر).
.TP
.B  \-\-check\-tam
بررسی احراز اصالت مانیفست (در کلید و کَش).
.TP
.B  \-\-disable\-tam
غیرفعال‌سازی احراز اصالت مانیفست (در کلید و کَش).
.TP
.B  \-\-check\-archives\-tam
بررسی احراز اصالت TAM برای تمام آرشیوها.
.TP
.B  \-\-archives\-tam
افزودن احراز اصالت TAM برای تمام آرشیوها.
.UNINDENT
.SH "مثال‌ها (EXAMPLES)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# ارتقای مخزن borg به تازه‌ترین نسخه.
$ borg upgrade \-v /path/to/repo
making a hardlink copy in /path/to/repo.before\-upgrade\-2016\-02\-15\-20:51:55
opening attic repository with borg and converting
no key file found for repository
converting repo index /path/to/repo/index.0
converting 1 segments...
converting borg 0.xx to borg current
no key file found for repository
.EE
.UNINDENT
.UNINDENT
.SS "ارتقای مخزن Attic رمزگذاری‌شده با passphrase"
.sp
نرم‌افزار Attic حالت رمزگذاری "passphrase" را ارائه می‌داد، اما این حالت در Borg 1.0 حذف شد و با حالت "repokey" جایگزین گردید (که کلید رمزگذاری محافظت‌شده با عبارت عبور را در پیکربندی مخزن ذخیره می‌کند).
.sp
بنابراین، برای ارتقای یک مخزن "passphrase" نرم‌افزار Attic به مخزن "repokey" در Borg، دو گام به ترتیب زیر لازم است:
.INDENT 0.0
.IP \(bu 2
borg upgrade repo
.IP \(bu 2
borg key migrate\-to\-repokey repo
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fIborg\-common(1)\fP
.SH "نویسنده (AUTHOR)"
The Borg Collective
.\" End of generated man page.