Sao lưu và khôi phục bản cài đặt của bạn
Một Workspace của Enterprise Server có thể chứa nhiều loại dữ liệu giá trị, bao gồm người dùng và nhóm đã được định nghĩa, các tác vụ Đồng bộ LDAP, dữ liệu thiết kế (bao gồm project, component, model, template), cùng các cấu hình cho dịch vụ PLS và NIS (và thường là nhiều sản phẩm, phần mở rộng đã được triển khai, cũng như các gói triển khai đã được định nghĩa cho các thành phần đó). Một yêu cầu quan trọng để đảm bảo tính toàn vẹn lâu dài của dữ liệu này là phải sao lưu dữ liệu. Bản cài đặt Enterprise Server tiêu chuẩn bao gồm một công cụ sao lưu và khôi phục, được truy cập thông qua dấu nhắc lệnh.
Vị trí mặc định của công cụ sao lưu nằm trong thư mục \Program Files (x86)\Altium\Altium365\Tools\BackupTool.
Tên của công cụ sao lưu là avbackup.exe.
Truy cập Backup Tool
Để sử dụng công cụ:
-
Khởi chạy Windows Command Prompt.
-
Điều hướng đến đúng thư mục. Với cài đặt mặc định trên ổ C của máy tính host, đó sẽ là:
cd C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\ -
Để chạy công cụ và liệt kê các tùy chọn hiện có, tại dấu nhắc lệnh hãy nhập:
avbackup ?

Truy cập công cụ sao lưu thông qua Command Prompt (chạy với quyền quản trị viên).
Lưu ý ?, bao gồm tham số này sẽ hiển thị trợ giúp về các chức năng có trong công cụ sao lưu:
-
backup– sao lưu dữ liệu vào tệp nén ZIP. -
restore– khôi phục dữ liệu từ tệp nén ZIP. Restore Point sẽ được tạo tự động. -
help– hiển thị màn hình trợ giúp (?có thể được dùng thay cho chuỗihelp).
Nội dung của tệp nén Zip
Công cụ sao lưu toàn bộ Enterprise Server và dữ liệu người dùng, bao gồm:
-
Sao lưu đầy đủ cơ sở dữ liệu, bao gồm: tất cả Data Item (model, component, managed sheet, template, thiết kế đã release, v.v.), người dùng, nhóm, các bản cài đặt có được qua Network Installation Service, và thiết lập LDAP Sync.
-
Tất cả revision của các mục trên.
-
Repository và các thiết kế Workspace đi kèm.
-
Chỉ mục tìm kiếm.
-
Các thiết lập do người dùng định nghĩa (tùy chỉnh).
Cú pháp sao lưu và các công tắc
Các công tắc sau khả dụng khi sử dụng chức năng sao lưu của công cụ:
avbackup backup -z [-t] [-h] [-i] [-m] [-d] [-c] [--split] [--skip-shadow-copy]
-
-z– đường dẫn và tên tệp của tệp zip đích sẽ được tạo. Đặt trong dấu ngoặc kép nếu chuỗi có khoảng trắng. Công tắc này là bắt buộc. -
-t,--test– nếu công tắc này được chỉ định, tệp zip sẽ được kiểm tra sau khi sao lưu. -
-h,--hash– nếu công tắc này được chỉ định, một tệp băm MD5 (*.md5) sẽ được tạo. -
-i– đường dẫn đầy đủ đến tệpLocalVault.inicủa Enterprise Server, tệp này cung cấp thông tin vị trí dữ liệu cho Enterprise Server cần sao lưu. Đường dẫn mặc định của tệp này làC:\Program Files (x86)\Altium\Altium365\LocalVault.ini. Nếu không chỉ định công tắc này, công cụ sẽ cố tự động tìm tệp dựa trên vị trí cài đặt mặc định này. Đặt trong dấu ngoặc kép nếu chuỗi có khoảng trắng. -
-m– cho phép bạn xác định liệu thao tác sao lưu sẽ chạy im lặng (-m silent, là chế độ mặc định), hay sẽ bật hộp thoại hỏi thử lại khi có lỗi (-m dialog). Nếu không chỉ định công tắc này, chế độ im lặng sẽ được dùng. -
-d,--debug– nếu công tắc này được chỉ định, chế độ debug sẽ được dùng, cho phép tạo thêm log phục vụ chẩn đoán và chia sẻ với các kỹ sư Altium. -
-c– cho phép bạn chỉ định mức nén của tệp zip đích. Dùng số từ0đến9. Bạn cũng có thể dùng các giá trị sau:-
Default– tương đương mức nén6(được dùng nếu không chỉ định công tắc này) -
None– tương đương mức nén0 -
BestSpeed– tương đương mức nén1 -
BestCompression– tương đương mức nén9.
-
-
--split– nếu công tắc này được chỉ định, các tệp zip riêng biệt sẽ được tạo cho repository và revision (không nén), ngoài tệp zip dành cho dữ liệu còn lại. -
--skip-shadow-copy– nếu công tắc này được chỉ định, sẽ không tạo bản sao bóng. Lưu ý rằng thời gian downtime của máy chủ (khoảng thời gian giữa lúc dừng và khởi động lại các dịch vụ) sẽ tăng khi dùng công tắc này.
Chỉ cần nhập avbackup backup, các công tắc này sẽ được liệt kê như một trợ giúp hữu ích.

Các công tắc khả dụng khi dùng công cụ ở chế độ sao lưu.
Backup Example
Mục nhập sau sẽ sao lưu Enterprise Server một cách im lặng vào tệp có tên 02102024_Backup.zip, ghi tệp vào thư mục C:\Backups\Altium Enterprise Server\:
avbackup backup -z "C:\Backups\Altium Enterprise Server\02102024_Backup.zip" -i "C:\Program Files (x86)\Altium\Altium365\LocalVault.ini"

Kết quả khi chạy lệnh sao lưu ví dụ.
Cú pháp khôi phục và các công tắc
Các công tắc sau khả dụng khi sử dụng chức năng khôi phục của công cụ:
avbackup restore -z [--skip-backup] [-i] [-m] [-d] [-c] [--split] [--skip-shadow-copy]
-
-z– đường dẫn và tên tệp của tệp zip sao lưu dùng để khôi phục. Đặt trong dấu ngoặc kép nếu chuỗi có khoảng trắng. Công tắc này là bắt buộc. -
--skip-backup– cho phép bạn bỏ qua việc tạo restore point trước khi bắt đầu khôi phục Enterprise Server. Hãy dùng cẩn thận vì nếu việc khôi phục dữ liệu thất bại, sẽ không thể quay lui. -
-i– đường dẫn đầy đủ đến tệpLocalVault.inicủa Enterprise Server, tệp này cung cấp thông tin về các vị trí sẽ dùng để khôi phục dữ liệu Enterprise Server. Đường dẫn mặc định của tệp này làC:\Program Files (x86)\Altium\Altium365\LocalVault.ini. Nếu không chỉ định công tắc này, công cụ sẽ cố tự động tìm tệp dựa trên vị trí cài đặt mặc định này. Đặt trong dấu ngoặc kép nếu chuỗi có khoảng trắng. -
-m– cho phép bạn xác định liệu thao tác khôi phục sẽ chạy im lặng (-m silent, là chế độ mặc định), hay sẽ bật hộp thoại hỏi thử lại khi có lỗi (-m dialog). Nếu không chỉ định công tắc này, chế độ im lặng sẽ được dùng. -
-d,--debug– nếu công tắc này được chỉ định, chế độ debug sẽ được dùng, cho phép tạo thêm log phục vụ chẩn đoán và chia sẻ với các kỹ sư Altium. -
-c– cho phép bạn chỉ định mức nén của tệp zip đích cho restore point (bản sao lưu của bản cài đặt Enterprise Server hiện tại). Dùng số từ0đến9. Bạn cũng có thể dùng các giá trị sau:-
Default– tương đương mức nén6(được dùng nếu không chỉ định công tắc này) -
None– tương đương mức nén0 -
BestSpeed– tương đương mức nén1 -
BestCompression– tương đương mức nén9.
-
-
--split– nếu công tắc này được chỉ định, các tệp zip riêng biệt sẽ được tạo cho repository và revision (không nén), ngoài tệp zip dành cho dữ liệu còn lại, cho restore point (bản sao lưu của bản cài đặt Enterprise Server hiện tại). -
--skip-shadow-copy– nếu công tắc này được chỉ định, sẽ không tạo bản sao bóng cho restore point (bản sao lưu của bản cài đặt Enterprise Server hiện tại). Lưu ý rằng thời gian downtime của máy chủ (khoảng thời gian giữa lúc dừng và khởi động lại các dịch vụ) sẽ tăng khi dùng công tắc này.
Chỉ cần nhập avbackup restore, các công tắc này sẽ được liệt kê như một trợ giúp hữu ích.

Các công tắc khả dụng khi dùng công cụ ở chế độ khôi phục.
Restore Example
Mục nhập sau sẽ khôi phục Enterprise Server một cách im lặng bằng tệp zip sao lưu có tên 30082022_Backup.zip, được lưu trong thư mục C:\Backups\Altium Enterprise Server\:
avbackup restore -z "C:\Backups\Altium Enterprise Server\30082022_Backup.zip" -i "C:\Program Files (x86)\Altium\Altium365\LocalVault.ini"

Kết quả khi chạy lệnh khôi phục ví dụ. Lưu ý rằng công cụ trước tiên tạo restore point (bản sao lưu của bản cài đặt Enterprise Server hiện tại), rồi mới thực hiện khôi phục.
Restore Point
Công cụ sao lưu tự động tạo restore point trước khi bắt đầu khôi phục Enterprise Server (nếu --skip-backup không được dùng cho thao tác khôi phục). Để làm điều này, công cụ sao lưu thực hiện sao lưu Enterprise Server hiện có, rồi sao chép tệp ZIP khôi phục vào vị trí sau:
C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\Backups\
Tệp ZIP được đặt tên theo định dạng: Backup_<Date>_<Time>.zip.
Ghi log sao lưu và khôi phục
Thông tin về các sự kiện trong quá trình sao lưu hoặc khôi phục được hiển thị trực tiếp trong cửa sổ CMD và cũng có thể tìm thấy trong tệp log:
C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\avbackup.log
Nếu xảy ra lỗi trong quá trình sao lưu hoặc khôi phục, thông tin đầy đủ về lỗi đó cũng có thể được tìm thấy trong tệp log
).