Oracle 백엔드를 사용하는 Altium 온프레미스 엔터프라이즈 서버 복원

Parent page: Oracle 백엔드를 사용하는 Altium On-Prem Enterprise Server

이 문서는 Enterprise Server가 Oracle Database 백엔드를 사용할 때, Altium On-Prem Enterprise Server 데이터를 복원하는 IT 관리자를 대상으로 합니다. Oracle 사용 맥락에서의 Enterprise Server 관련 정보, 복원 절차의 세부 내용, 시스템 요구 사항에 대한 중요한 정보, 그리고 Microsoft Windows 플랫폼에서의 데이터 복원 예시를 포함합니다.

복원 프로세스 개요

Oracle 백엔드를 사용할 때 Enterprise Server 복원은 회사에서 Oracle Database를 관리하는 방식에 따라 달라집니다. 어떤 회사는 Windows Server 운영체제 위에서 Oracle Database를 운영하는 반면, 다른 회사는 별도의 Oracle 데이터센터 전체를 운영하기도 합니다. 복원 프로세스는 일반적으로 다음 이미지에 표시된 것처럼 3단계로 구성됩니다.

Enterprise Server 및 Oracle 데이터베이스 복원 절차의 상위 수준 개요.

이 문서 전반에 걸쳐 적용되는 가정

Oracle 구성은 사이트마다 다를 수 있지만, 이 문서에서는 다음을 가정합니다.

1. Backing up Altium On-Prem Enterprise Server with an Oracle Backend 문서에 설명된 대로 Enterprise Server 데이터의 전체 백업과 관련 Oracle 데이터 덤프가 수행되었습니다.
2. 복원은 IT 관리자가 수행합니다. 최소한 Enterprise Server 복원을 수행하는 사용자는 호스트 머신에 대한 관리자 권한이 있어야 합니다.
3. Oracle 데이터 가져오기를 수행할 DBA(Database Administrator)가 있어야 합니다. 최소한 이 가이드를 따르는 사용자는 회사 Oracle 데이터베이스를 가져오고 수정할 수 있는 전체 읽기/쓰기 권한이 있어야 합니다.
4. 이 가이드는 Oracle 백엔드로 구성되어 정상 동작 중인 Enterprise Server의 기존 설치가 있다고 가정합니다. (새 Enterprise Server를 머신에 배포하고 해당 Enterprise Server 인스턴스로 데이터를 가져오는 환경을 처리하는 방법에 대한 자세한 내용은 example section을 참조하십시오.)
5. 소스 및 대상 Oracle 서버에서 사용되는 Oracle Schema와 Oracle 애플리케이션 자격 증명은 동일해야 합니다.

Enterprise Server 아키텍처 상위 수준 개요

Microsoft Windows에서 실행되도록 설계된 다른 소프트웨어와 마찬가지로, Enterprise Server는 멀티스레드/멀티서비스 서버 애플리케이션입니다. 이 문서는 Oracle Database와 상호작용할 수 있는 Enterprise Server의 일부에만 초점을 맞추므로, 다음 이미지는 전체 Enterprise Server 백엔드 아키텍처를 나타내도록 단순화되어 있습니다.

Enterprise Server 아키텍처의 상위 수준 개요. Enterprise Server의 Backend Storages에는 대부분의 고객 바이너리 데이터가 포함되며, Windows Services는 지원 서비스들의 모음입니다.

이 문서는 Backend Storages에 초점을 맞춥니다. 이 블록 내의 데이터가 백업되고, 다른 머신으로 마이그레이션될 수 있으며, 동일 또는 다른 머신에서 복원되기 때문입니다. Backend Storages에는 다음 항목이 포함됩니다.

• Databases – 컴포넌트 풋프린트 및 회로도 심볼 연결, 파라미터, 파일 경로, 컴포넌트 공급망 데이터 소스 링크 등과 같은 메타데이터를 포함합니다. 이 정보는 Firebird 또는 Oracle 데이터베이스 내부에 있을 수 있습니다.
• File Storage – 이 File Storage 영역은 Enterprise Server의 VCS 리포지토리 내부에 바이너리 데이터를 보관합니다. 이 바이너리 데이터에는 PCB 및 Schematic Project 문서, 풋프린트, 심볼, Draftsman 및 기타 네이티브/비네이티브 Enterprise Server 문서 등의 정보가 포함됩니다.

Altium 복원 도구 상위 수준 개요

Altium 복원 도구는 avbackup.exe라고 합니다. 이는 Enterprise Server에서 백업 및 복원 목적으로 사용하는 동일한 유틸리티입니다. IT 관리자가 Enterprise Server 데이터를 복원하기 위해 실행할 수 있는 명령줄 유틸리티입니다. avbackup.exe는 Enterprise Server가 기본 Firebird 데이터베이스 백엔드로 구성된 경우뿐 아니라 Oracle 데이터베이스를 백엔드로 사용하는 경우에도 복원 목적으로 사용하는 동일한 유틸리티입니다.

Oracle Database를 사용하는 Enterprise Server 구현에서 avbackup.exe를 사용할 때 관리자는 다음 사항에 유의해야 합니다.

1. avbackup.exeNOT는 Enterprise Server 메타데이터를 Oracle Database로 복원하는 것을 지원하지 않습니다. 이 기능은 Enterprise Server Installer에 의해 원래 자동 구성된 Firebird 데이터베이스 백엔드를 사용하는 Enterprise Server 구현에서만 동작합니다.
2. avbackup.exe는 백업 도구로 사용했을 때 생성되는 Zip 파일을 입력으로 받습니다. 이 Zip 파일에는 모든 Enterprise Server 바이너리 데이터가 포함됩니다.
3. Enterprise Server는 실행 중이어야 합니다. avbackup.exe는 데이터 복원 중에 모든 Enterprise Server 서비스(IIS 서비스 포함)를 자동으로 종료한 다음, 복원이 성공하면 종료했던 모든 서비스를 다시 시작합니다.

Windows 플랫폼에서 Oracle 백엔드를 사용하는 Enterprise Server 데이터 복원 예시

이 예시의 지침은 전담 Oracle DBA가 없지만 네트워크에서 Enterprise Server 및 관련 Oracle 데이터를 복원해야 하는 소규모 비즈니스도 고려합니다. 다음 단계는 Enterprise Server 및 관련 Oracle 데이터베이스의 기본 백업을 새 머신과 새 Oracle 데이터베이스로 복원하는 방법을 보여줍니다.

필수 항목

• Oracle 백엔드를 사용하는 Enterprise Server의 기존 정상 동작 인스턴스.
• 기존 폴더 및 데이터 소스:
  • Enterprise Server 및 Oracle 데이터가 위치할 폴더는 미리 존재해야 하며, Enterprise Server 백업 zip 파일과 Oracle .DMP 파일의 사본을 포함하고 있어야 합니다.
• Enterprise Server 호스트 머신에 대한 관리자 접근 권한. 이는 Enterprise Server 백업 Command 유틸리티(avbackup.exe)를 올바르게 실행하는 데 필요합니다.
• Oracle 서버에 대한 적절한 DBA 접근 권한(예: Windows 환경에서 사용자의 Windows 계정을 sysDBA 역할에 추가).

복원 절차

1. Oracle 백엔드를 사용하는 Enterprise Server의 기존 인스턴스가 설정되어 있지 않다면, 새 머신에서 Oracle 백엔드를 사용하여 Enterprise Server를 설정하는 예시는 Installing Altium On-Prem Enterprise Server with an Oracle Backend 문서를 참조하십시오.
2. 이 시점에서는 새 설치 또는 이전 설치로 인해 Oracle을 사용하는 Enterprise Server의 기존 인스턴스가 이미 있어야 합니다.
3. Enterprise Server 호스트 머신에서:
   1. 복원 폴더를 생성합니다(예: C:\Backups처럼 공통 파일 경로를 사용하는 것이 도움이 됩니다). Enterprise Server 백업 Zip 파일을 이 폴더에 넣습니다.
   2. 관리자 권한으로 avbackup.exe 도구를 실행하여 Enterprise Server 데이터를 복원합니다. 이 도구는 C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool 폴더에 있습니다.
   3. IIS Enterprise Server 서비스를 종료하거나 Enterprise Server 호스트 머신을 종료합니다. 이렇게 하면 Enterprise Server 서비스가 Oracle Database에 의도치 않게 쓰기 작업을 수행하는 것을 방지할 수 있습니다.

4. Oracle Database 호스트 머신에서:
   1. 복원 폴더를 생성하고 Oracle .dmp 파일을 이 폴더에 넣습니다(예: C:\Backups처럼 공통 파일 경로를 사용하는 것이 도움이 됩니다).
   2. Oracle 데이터베이스에서 기존 스키마와 사용자 계정을 삭제(drop/delete)합니다.

Oracle 사용자 계정과 해당 스키마를 drop하는 방법은 다음과 같습니다. 이 예시에서는 Microsoft Windows의 Oracle Database에서 기존 사용자 계정 AESUSER313 및 해당 스키마를 drop합니다.

1. 관리자 권한으로 명령 프롬프트를 실행합니다.
2. Oracle 머신에 IIS 서비스가 있는 경우, 명령 net stop WAS를 사용해 IIS 서비스를 중지한 다음 Y를 누르고 Enter를 입력합니다.
3. SqlPlus 세션을 실행하여 Oracle DB에 연결합니다:

sqlplus / as sysdba

shutdown immediate;

startup restrict;

4. Enterprise Server와 연관된 스키마를 drop합니다(이 예시에서 AESUSER313는 삭제하려는 스키마 이름):

drop user AESUSER313 cascade;

5. 머신을 재시작하거나 다음 명령을 사용하여 DB를 정상적으로 다시 활성화합니다:

shutdown immediate;

startup;

3. Oracle 서버에서 동일한 스키마를 생성하고 상향 권한을 할당합니다:
   1. 관리자 권한으로 명령줄을 열고 다음을 입력합니다:

sqlplus / as sysdba;

CREATE user AESUSER313 identified by “Altium”;

GRANT ALL PRIVILEGES TO AESUSER313;

GRANT IMP_FULL_DATABASE TO AESUSER313;

2. 또는 아래와 같이 이 사용자에게 DBA 역할을 임시로 부여한 뒤 파일을 가져오고, 이후 이 권한을 회수할 수 있습니다:

GRANT DBA TO AESUSER313;

3. DB 가져오기가 성공하면 DBA 권한을 회수합니다:

revoke DBA from AESUSER313;

4. Oracle 데이터 복원(이 섹션은 사용자 계정과 스키마 이름이 모두 AESUSER313이고 비밀번호가 Altium라고 가정합니다):
   1. 관리자 권한으로 명령 프롬프트 실행
   2. 명령을 사용하여 IIS 서버 중지:

net stop WAS

3. Oracle 데이터를 가져옵니다. 가져오기 명령 예시는 다음과 같습니다:

imp AESUSER313/Altium@xe file=c:\Backups\AESUSER313.dmp log=c:\Backups\AESUSER313_import.log fromuser=AESUSER313 touser=AESUSER313

여기서,

AESUSER313 – 스키마에 대한 전체 권한과 DB 접근 권한을 가진 사용자.

Altium – Enterprise Server와 연관된 Oracle 사용자 계정의 비밀번호.

xe – tnsnames.ora에 포함된 대상 DB의 네트워크 서비스 이름.

file = c:\Backups\AESUSER313.dmp – 백업 위치.

log = c:\Backups\AESUSER313_import.log – 복원 로그(선택 사항).

fromuser=AESUSER313 – 백업 스키마의 소유자.

touser=AESUSER313 – 스키마의 새 소유자(소유자가 다르면 적절한 권한과 역할을 가진 새 사용자를 생성해야 함).

5. 데이터 무결성을 검증합니다.
   1. tnsname.ora 파일을 확인하세요. (DB 서버를 변경했다면) 네트워크 서비스 이름을 업데이트해야 합니다.
   2. IIS 서버 설정을 검증하세요. IIS Manager에서 바인딩(bindings)의 “Host name” 열이 현재 값으로 되어 있는지 확인합니다. 여기에 Enterprise Server의 현재 정규화된 도메인 이름(FQDN)이 있어야 합니다.
   3. C:\Program Files (x86)\Altium\Altium365\LocalVault.ini 파일에서 다음 파라미터 값들을 확인하세요.
      1. Domain – 도메인 이름.
      2. WebsiteDomain – Enterprise Server의 FQDN.
      3. DataSourceType=Oracle – Oracle DB를 사용하는 경우.
      4. User=AESUSER313 – 스키마 소유자.
      5. Password=Altium – DBA가 정의한 사용자 비밀번호.
      6. DBLocation=FQDN 또는 ip_address:1521 – DB 서버 주소.
      7. DatabaseName=xe – tnsnames.ora에 포함된 DB의 현재 네트워크 서비스 이름.

결론

위 예시는 Oracle Database를 연동하고 조작하는 것과 관련된 추가 세부사항을 포함하고 있지만, Enterprise Server 데이터를 복원하는 핵심 단계는 세 가지뿐입니다:

1. 1단계는 IIS 서비스와 Enterprise Server IIS Application Pools를 중지하는 것입니다.
2. 2단계는 Enterprise Server 데이터를 복원하는 것입니다.
3. 3단계는 Enterprise Server와 연관된 Oracle 데이터를 복원하는 것입니다.

설명된 순서대로 이 절차를 수행하면 Oracle 데이터베이스와 Enterprise Server 바이너리 데이터 불일치로 인해 데이터가 손상될 가능성을 크게 줄일 수 있습니다.