Altium On-Prem Enterprise Server 설치 백업 및 복원하기

Enterprise Server Workspace에는 정의된 사용자, 그룹, LDAP Sync 작업, 설계 데이터(프로젝트, 컴포넌트, 모델, 템플릿 포함), PLS 및 NIS 서비스 구성(그리고 일반적으로 다양한 획득 제품 및 확장 기능, 그리고 후자를 위한 정의된 배포 패키지 포함) 등 폭넓고 중요한 데이터가 저장될 수 있습니다. 이 데이터의 장기적인 무결성을 보장하기 위한 핵심 요구 사항은 백업입니다. 표준 Enterprise Server 설치에는 명령 프롬프트를 통해 접근하는 백업 및 복원 도구가 포함되어 있습니다.

백업 도구의 기본 위치는 \Program Files (x86)\Altium\Altium365\Tools\BackupTool 폴더입니다.

백업 도구의 이름은 avbackup.exe입니다.

백업 도구에 접근하기

도구를 사용하려면:

1. Windows 명령 프롬프트를 실행합니다.

   백업 및 복원 도구를 사용하려면 명령 프롬프트를 관리자 모드로 실행해야 합니다. Windows 관리자 권한으로 CMD 프롬프트를 실행하지 않은 상태에서 Enterprise Server 백업 또는 복원 관련 명령을 실행하려고 하면 다음과 같은 명확한 메시지가 표시됩니다: Access Denied. Administrator permissions are needed to use the selected options. Use an administrator command prompt to complete these tasks.

2. 올바른 폴더로 이동합니다. 호스트 컴퓨터의 C 드라이브에 기본 설치한 경우 경로는 다음과 같습니다: cd C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\

3. 도구를 실행하고 사용 가능한 옵션을 나열하려면 프롬프트에서 다음을 입력합니다: avbackup ?

명령 프롬프트(관리자 권한으로 실행)를 통해 백업 도구에 접근합니다.

?에 유의하십시오. 이를 포함하면 백업 도구에서 사용 가능한 기능에 대한 도움말이 표시됩니다:

• backup – 데이터를 ZIP 아카이브로 백업합니다.

• restore – ZIP 아카이브에서 데이터를 복원합니다. Restore Point가 자동으로 생성됩니다.

• help – 도움말 화면을 표시합니다(?는 문자열 help 대신 사용할 수 있습니다).

Zip 아카이브의 내용

이 도구는 다음을 포함하여 전체 Enterprise Server 및 사용자 데이터를 백업합니다:

• 전체 데이터베이스 백업(모델, 컴포넌트, 관리 시트, 템플릿, 릴리스된 설계 등 모든 데이터 Item), 사용자, 그룹, Network Installation Service를 통해 획득한 설치 항목, LDAP Sync 설정 포함.

• 위 항목의 모든 리비전.

• 리포지토리 및 포함된 Workspace 설계.

• 검색 인덱스.

• 사용자 정의(커스텀) 설정.

백업 구문 및 스위치

도구의 백업 기능을 사용할 때 다음 스위치를 사용할 수 있습니다:

avbackup backup -z [-t] [-h] [-i] [-m] [-d] [-c] [--split] [--skip-shadow-copy]

• -z – 생성할 대상 zip 파일의 경로 및 파일명입니다. 문자열에 공백이 있으면 따옴표로 묶으십시오. 이 스위치는 필수입니다.

• -t, --test – 이 스위치를 지정하면 백업 후 zip 파일을 테스트합니다.

• -h, --hash – 이 스위치를 지정하면 MD5 해시 파일(*.md5)이 생성됩니다.

• -i – 백업할 Enterprise Server의 데이터 위치 정보를 제공하는 Enterprise Server LocalVault.ini 파일의 전체 경로입니다. 이 파일의 기본 경로는 C:\Program Files (x86)\Altium\Altium365\LocalVault.ini입니다. 이 스위치를 지정하지 않으면 도구는 기본 설치 위치를 기준으로 해당 파일을 자동으로 찾으려고 시도합니다. 문자열에 공백이 있으면 따옴표로 묶으십시오.

• -m – 백업 작업을 무인(-m silent, 기본 모드)으로 실행할지, 실패 시 재시도를 묻는 대화상자를 표시할지(-m dialog)를 결정할 수 있습니다. 이 스위치를 지정하지 않으면 무인 모드가 사용됩니다.

• -d, --debug – 이 스위치를 지정하면 디버그 모드가 사용되며, 진단 목적 및 Altium Engineers와 공유하기 위한 더 많은 로그가 생성됩니다.

• -c – 대상 zip 파일의 압축 수준을 지정할 수 있습니다. 0부터 9까지의 숫자를 사용하십시오. 다음 값도 사용할 수 있습니다:

  • Default – 압축 수준 6과 동일(이 스위치를 지정하지 않으면 사용됨)

  • None – 압축 수준 0

  • BestSpeed – 압축 수준 1

  • BestCompression – 압축 수준 9과 동일.

• --split – 이 스위치를 지정하면 다른 데이터용 zip 파일 외에, 리포지토리와 리비전에 대해 (압축 없이) 별도의 zip 파일이 생성됩니다.

• --skip-shadow-copy – 이 스위치를 지정하면 섀도 복사본을 생성하지 않습니다. 이 스위치를 사용하면 서버 다운타임(서비스 중지와 시작 사이의 기간)이 증가합니다.

avbackup backup만 입력하면, 도움이 되도록 이러한 스위치 목록이 표시됩니다.

도구를 백업 모드로 사용할 때 사용 가능한 스위치.

복원 구문 및 스위치

도구의 복원 기능을 사용할 때 다음 스위치를 사용할 수 있습니다:

avbackup restore -z [--skip-backup] [-i] [-m] [-d] [-c] [--split] [--skip-shadow-copy]

• -z – 복원에 사용할 백업 zip 파일의 경로 및 파일명입니다. 문자열에 공백이 있으면 따옴표로 묶으십시오. 이 스위치는 필수입니다.

• --skip-backup – Enterprise Server 복원을 시작하기 전에 복원 지점(restore point) 생성을 건너뛸 수 있습니다. 데이터 복원에 실패할 경우 롤백이 불가능하므로 주의해서 사용하십시오.

• -i – Enterprise Server 데이터를 복원할 위치 정보를 제공하는 Enterprise Server LocalVault.ini 파일의 전체 경로입니다. 이 파일의 기본 경로는 C:\Program Files (x86)\Altium\Altium365\LocalVault.ini입니다. 이 스위치를 지정하지 않으면 도구는 기본 설치 위치를 기준으로 해당 파일을 자동으로 찾으려고 시도합니다. 문자열에 공백이 있으면 따옴표로 묶으십시오.

• -m – 복원 작업을 무인(-m silent, 기본 모드)으로 실행할지, 실패 시 재시도를 묻는 대화상자를 표시할지(-m dialog)를 결정할 수 있습니다. 이 스위치를 지정하지 않으면 무인 모드가 사용됩니다.

• -d, --debug – 이 스위치를 지정하면 디버그 모드가 사용되며, 진단 목적 및 Altium Engineers와 공유하기 위한 더 많은 로그가 생성됩니다.

• -c – 복원 지점(현재 Enterprise Server 설치의 백업)에 대한 대상 zip 파일의 압축 수준을 지정할 수 있습니다. 0부터 9까지의 숫자를 사용하십시오. 다음 값도 사용할 수 있습니다:

  • Default – 압축 수준 6과 동일(이 스위치를 지정하지 않으면 사용됨)

  • None – 압축 수준 0

  • BestSpeed – 압축 수준 1

  • BestCompression – 압축 수준 9과 동일.

• --split – 이 스위치를 지정하면 복원 지점(현재 Enterprise Server 설치의 백업)에 대해, 다른 데이터용 zip 파일 외에 리포지토리와 리비전에 대해 (압축 없이) 별도의 zip 파일이 생성됩니다.

• --skip-shadow-copy–  이 스위치를 지정하면 복원 지점(현재 Enterprise Server 설치의 백업)에 대한 섀도 복사본이 생성되지 않습니다. 이 스위치를 사용하면 서버 다운타임(서비스를 중지한 뒤 다시 시작하기까지의 기간)이 늘어납니다.

avbackup restore만 입력하면, 도움이 되도록 이러한 스위치 목록이 표시됩니다.

복원 모드에서 도구를 사용할 때 사용 가능한 스위치.

복원 지점

백업 도구는 Enterprise Server 복원을 시작하기 전에 자동으로 복원 지점을 생성합니다(복원에 --skip-backup 를 사용하지 않은 경우). 이를 위해 백업 도구는 기존 Enterprise Server에 대해 백업을 수행하고, 복원 ZIP을 다음 위치로 복사합니다:

C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\Backups\

ZIP 파일은 Backup_<Date>_<Time>.zip 형식으로 이름이 지정됩니다.

백업 및 복원 로깅

백업 또는 복원 중 발생한 이벤트에 대한 정보는 CMD 창에 직접 표시되며, 로그 파일에서도 확인할 수 있습니다:

C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\avbackup.log

백업 또는 복원 중 오류가 발생하면, 이에 대한 전체 정보도 로그 파일()에서 확인할 수 있습니다.