KB: AES 7.2.1 버전부터 SVN 지원 중단

해결 방법 세부 정보

SVN 지원이 활성화된 AES 버전에서 업그레이드할 경우, Configuration 파일에서 SVN 지원 설정을 비활성화해야 합니다. LocalVault.ini. 이 변경 사항은 설정값이 SvnMode=Full로 변경해야 하며, SvnMode=None로 변경해야 합니다. AES VCS 페이지를 통해 관리되는 SVN 리포지토리에 저장된 설계 프로젝트는 업그레이드 전에 AES 기본 Git 리포지토리(버전 관리 저장소)로 마이그레이션해야 합니다.

Altium은 프로젝트를 쉽고 빠르게 마이그레이션할 수 있는 도구를 제공합니다. Altium Designer를 사용하면 싱글 프로젝트를 마이그레이션할 수 있습니다. SVN-to-Git 마이그레이션 도구를 사용하면 여러 프로젝트를 일괄 처리 모드로 마이그레이션할 수 있습니다.

SVN 지원을 사용하지 않는 사용자(SvnMode=None)를 사용하지 않는 사용자는 영향을 받지 않습니다.

Steps to prepare for an upgrade to AES 7.2.1:
1  마이그레이션이 필요한지 확인하십시오. 파일 LocalVault.ini 에 C:\Program Files (x86)\Altium\Altium365 파일에 SvnMode=Full 가 있고 SVN 프로젝트가 있는 경우, 어떤 프로젝트를 Altium Designer를 통해 마이그레이션할지, 아니면 SVN-to-Git 마이그레이션 도구를 사용하여 마이그레이션할지 결정해야 합니다.
    a 모든 활성 SVN 프로젝트는 마이그레이션해야 합니다. 마이그레이션하지 않을 활성 프로젝트가 있는 경우, SVN을 지원하는 최신 버전의 AES인 AES 7.1.2를 계속 사용하거나 이 버전으로 업데이트하는 것이 좋습니다.
    b SVN 프로젝트가 더 이상 활성 상태가 아니며 향후 수정할 계획이 없다면, 반드시 마이그레이션할 필요는 없으나 마이그레이션하는 것이 권장됩니다. 비활성 프로젝트를 마이그레이션하지 않으려면, 아카이브된 프로젝트로 보관할 수 있습니다. 마이그레이션되지 않은 프로젝트는 읽기 전용으로 전환됩니다. SVN 서버를 통한 직접 액세스는 여전히 가능합니다.
    c 지금이 정리 작업을 하기에 좋은 시기입니다. 예를 들어, SVN-to-Git 마이그레이션 도구에는 빈 프로젝트를 표시해 주는 시뮬레이션 모드가 있는데, 이러한 프로젝트는 마이그레이션하기보다는 삭제하는 것이 좋습니다.

2  프로젝트를 어떻게 마이그레이션할지 결정하십시오. 서버 관리자가 SVN-to-Git 마이그레이션 도구를 사용하여 프로젝트 저장소를 마이그레이션해야 할까요, 아니면 사용자가 Altium Designer를 통해 프로젝트별로 직접 마이그레이션해야 할까요?

3  AES 관리자는 마이그레이션 계획을 AES 사용자에게 전달해야 하며, 여기에는 예를 들어 마이그레이션 전에 로컬 프로젝트 변경 사항을 서버에 Commit해야 한다는 점 등이 포함되어야 합니다.

4  Altium Designer를 통한 프로젝트 마이그레이션 또는 SVN-to-Git 마이그레이션 도구를 사용한 프로젝트 마이그레이션.
    a Altium Designer가 AES에 연결되어 있는 경우, SVN 저장소에서 프로젝트가 자동으로 Git 저장소로 이동됩니다. Migrate Project to Altium Versioned Storage 명령을 사용하여 SVN 저장소의 프로젝트를 내장 Git 저장소로 자동으로 마이그레이션할 수 있습니다. 자세한 내용은 다음 문서를 참조하십시오: Moving from SVN to Git.
    b SVN-to-Git 마이그레이션 도구는 AES 호스트 서버에서 실행되며, SVN 저장소의 여러 프로젝트를 일괄 처리 모드로 내장 Git 저장소로 마이그레이션합니다. 마이그레이션이 완료되면 로컬 사본 사용자에게 Altium Designer를 통해 알림이 전송됩니다. SVN-to-Git 마이그레이션 도구에 대한 접근 권한은 Altium 지원팀에 지원 티켓( https://www.altium.com/support )을 통해 요청할 수 있습니다.

5  마이그레이션된 프로젝트 확인. Altium Designer에서 서버에 있는 프로젝트를 처음부터 새로 열어보십시오.

6  사용자 컴퓨터에 있는 마이그레이션된 프로젝트의 로컬 사본을 업데이트하십시오. 자세한 내용은 설명서를 참조하십시오. Collaboration after Migration를 참조하십시오. 문제가 발생하면 디스크에서 로컬 사본을 삭제하고 서버에서 프로젝트를 열어 새로운 로컬 사본을 생성하십시오.

7  다음 LocalVault.ini 파일에서 SvnMode=Full 를 SvnMode=None로 변경하십시오.

8 AES 7.2.1 설치 프로그램을 실행하면 서버가 평소와 같이 업데이트됩니다.

Questions and Answers for the discontinuation of SVN support with AES 7.2.1:

Question: 이 변경 사항이 외부 Git 저장소에 영향을 미치나요?
Answer: 외부 Git 저장소의 경우, 두 가지 사용 사례가 있습니다.

Use case 1: 프로젝트를 로컬에서 생성하여 GitHub, Bitbucket 또는 기타 Git 서버와 같은 Git 저장소에 추가하는 경우입니다. 이후 Altium Designer에서 Make Available on Server 옵션이 Migrate to Altium Versioned Storage 이 비활성화된 상태로 프로젝트가 AES에 추가됩니다. 이 경우 미리 보기 및 기록과 같은 기타 기능은 작동하지 않습니다.

이 옵션은 이전과 동일한 제한 사항 하에서 여전히 작동합니다.

Use case 2: 기존의 (외부) Git 저장소가 VCS 페이지에서 AES에 연결된 경우입니다. 이러한 경우, 사용자가 Altium Designer에서 프로젝트를 처음부터 새로 생성하거나 Make Available on Server 명령을 사용하여 로컬 프로젝트(VCS에 포함되지 않은)를 생성할 때, 이 외부 Git 저장소를 프로젝트 저장소로 선택할 수 있습니다.

VCS 페이지를 더 이상 사용할 수 없게 되어 SVN 중단 조치의 영향을 받게 되며, 이 경우 새로운 외부 Git 저장소를 추가할 수 없게 됩니다. Moving from External VCS to Native VCS 이 경우에 대한 내용을 참조하십시오.
Question: SVN-to-Git 마이그레이션 도구는 외부 Git 저장소에서 기본 내장 Git 저장소로 프로젝트를 이동하는 기능을 지원합니까?
Answer: 아니요.

Question: 마이그레이션에는 얼마나 걸립니까?
Answer: 프로젝트 수, Commit 수 및 관련 데이터의 크기에 따라 다릅니다. 하지만 대략적인 규모를 말씀드리자면, SVN-to-Git 마이그레이션 도구의 과거 실행 사례는 다음과 같습니다. 8개의 스레드에서 840개 프로젝트(약 40GB 리포지토리 폴더, 13,000개 Commit)를 1시간 15분 만에 완료; 단일 스레드에서 8시간 5분 만에 711개 프로젝트(약 50GB 리포지토리 폴더, 29K Commit)를 마이그레이션한 사례가 있습니다.

Question: 릴리스 패키지와 문서에 달린 Comment 등 모든 내용이 마이그레이션되나요?
Answer: Altium Designer를 통한 마이그레이션이나 SVN-to-Git 마이그레이션 도구를 사용한 마이그레이션은 SVN 리포지토리에 저장된 프로젝트/설계 데이터 및 그 이력에 해당합니다. 릴리스 패키지와 문서에 대한 Comment는 SVN 리포지토리에 저장되지 않으므로 영향을 받지 않습니다.

Question: SVN-to-Git 마이그레이션 도구는 어떻게 이용할 수 있나요?
Answer: Altium 지원팀에 지원 티켓( https://www.altium.com/support )을 제출하여 SVN-to-Git 마이그레이션 도구를 요청하십시오.

Question: 고객은 마이그레이션 지원을 어떻게 요청할 수 있으며, 비용이 발생하나요?
Answer: 지원팀에서는 고객이 직접 마이그레이션을 관리할 수 있도록 SVN-to-Git 마이그레이션 도구를 제공합니다. 도구 자체는 무료로 제공됩니다. 또는 고객은 담당 계정 관리자에게 문의하여 프로페셔널 서비스(Professional Services)를 통해 마이그레이션 지원을 받을 수 있으며, 이 경우 시간 및 자재 비용 기준으로 요금이 청구됩니다.

Question: 프로젝트를 Git으로 마이그레이션하는 데 실패하면 어떻게 해야 하나요?
Answer: Altium 지원팀( https://www.altium.com/support )에 문의해 주십시오.

Question: SVNDbLibs에도 영향을 미치나요?
Answer: 아니요. SVNDbLibs는 Altium Designer 내에서만 컴포넌트 라이브러리를 관리하기 위한 솔루션이므로 영향을 받지 않습니다.

Question: Altium Designer는 여전히 관리되지 않는(서버 기반이 아닌) SVN 리포지토리를 지원합니까?
Answer: 예. Altium Designer 환경 설정(데이터 관리 - 설계 리포지토리)을 통해 생성되거나 연결된 설계 리포지토리는 영향을 받지 않습니다.