AEM Forms 백업 준비 preparing-aem-forms-for-backup

Last update: Wed Mar 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

Developer

이 문서의 샘플 및 예제는 JEE 환경의 AEM Forms에 대해서만 적용됩니다.

백업 및 복원 서비스 정보 about-the-backup-and-restore-service

백업 및 복원 서비스를 사용하면 AEM Forms을 백업 모드 핫 백업을 수행할 수 있도록 해 줍니다. 백업 및 복원 서비스는 실제로 AEM Forms의 백업을 수행하거나 시스템을 복원하지 않습니다. 대신 서버를 계속 실행할 수 있도록 하면서 일관성 있고 안정적인 백업을 위한 상태로 만듭니다. GDS(전역 문서 저장소) 및 Forms 서버에 연결된 데이터베이스를 백업하는 작업을 담당합니다. GDS는 오래 지속되는 프로세스 내에서 사용되는 파일을 저장하는 데 사용되는 디렉토리입니다.

백업 모드는 백업 절차가 진행되는 동안 GDS의 파일이 제거되지 않도록 서버가 입력하는 상태입니다. 대신 GDS 디렉터리 아래에 하위 디렉터리가 만들어져 백업 모드가 끝난 후 삭제될 파일 레코드를 유지 관리합니다. 파일은 시스템 재시작에서 살아남기 위한 것이며 며칠 또는 몇 년에 걸쳐 실행될 수 있습니다. 이러한 파일은 Forms 서버의 전체 상태에 중요한 부분이며 PDF 파일, 정책 또는 양식 템플릿을 포함할 수 있습니다. 이러한 파일이 손실되거나 손상되면 Forms 서버의 프로세스가 불안정해지고 데이터가 손실될 수 있습니다.

스냅샷 백업을 수행하도록 선택할 수 있습니다. 이 경우 일반적으로 일정 기간 동안 백업 모드를 시작한 다음 백업 작업을 완료한 후 백업 모드를 그대로 둡니다. 파일이 불필요하게 커지지 않도록 GDS에서 삭제할 수 있도록 백업 모드를 종료해야 합니다. 백업 모드를 명시적으로 종료하거나 백업 모드 세션에서 시간이 만료될 때까지 기다릴 수 있습니다.

또한 서버를 영구 백업 모드로 유지할 수 있습니다. 이는 롤링 백업이나 연속 시스템 적용 범위의 백업 전략에 일반적으로 사용됩니다. 롤링 백업 모드는 시스템이 항상 백업 모드에 있음을 나타내며, 이전 세션이 릴리스되는 즉시 새 백업 모드 세션이 시작됩니다. 연속 백업 모드에 있는 경우 파일은 두 개의 백업 모드 세션 후에 삭제되며 더 이상 참조되지 않습니다.

백업 및 복원 서비스를 사용하여 Forms 서버에 연결된 GDS 또는 데이터베이스의 백업을 수행하기 위해 작성한 기존 응용 프로그램 또는 새 응용 프로그램에 추가할 수 있습니다.

NOTE

AEM Forms 구현의 다른 측면에서와 마찬가지로, 전체 솔루션이 데이터 손실 없이 예상대로 작동하는지 확인하려면 운영 환경에서 사용하기 전에 개발 또는 스테이징 환경에서 백업 및 복구 전략을 개발 및 테스트해야 합니다.

백업 및 복원 서비스를 사용하여 다음 작업을 수행할 수 있습니다.

백업 모드로 들어갑니다.
백업 모드를 종료합니다.

NOTE

AEM Forms에 대한 백업을 수행할 때 고려할 사항에 대한 자세한 내용은 관리 도움말.

NOTE

백업 및 복원 서비스에 대한 자세한 내용은 AEM Forms에 대한 서비스 참조.

Forms 서버에서 백업 모드 시작 entering-backup-mode-on-the-forms-server

Forms 서버의 핫 백업을 허용하려면 백업 모드로 들어갑니다. 백업 모드에 들어갈 때 조직의 백업 절차에 따라 다음 정보를 지정합니다.

백업 프로세스에 유용할 수 있는 백업 모드 세션을 식별하는 고유한 레이블입니다.
백업 절차가 완료되는 시간입니다.
연속 백업 모드에 있는지 여부를 나타내는 플래그입니다. 이는 롤링 백업을 수행하는 경우에만 유용합니다.

백업 모드로 전환할 응용 프로그램을 작성하기 전에 Forms 서버를 백업 모드로 설정한 후에 사용되는 백업 절차를 이해하는 것이 좋습니다. AEM Forms에 대한 백업을 수행할 때 고려할 사항에 대한 자세한 내용은 관리 도움말.

NOTE

백업 및 복원 서비스에 대한 자세한 내용은 AEM Forms에 대한 서비스 참조.

단계 요약 summary-of-steps

백업 모드로 전환되는 응용 프로그램을 만들려면 다음 단계를 수행하십시오.

프로젝트 파일을 포함합니다.
BackupService 클라이언트 개체를 만듭니다.
고유한 레이블, 백업을 수행하는 시간 및 연속 백업 모드에 있는지 여부를 결정합니다.
백업 모드로 들어갑니다.
(선택 사항) 서버의 백업 모드 세션에 대한 정보를 검색합니다.
GDS(전역 데이터 저장소) 및 데이터베이스의 백업을 수행합니다.

프로젝트 파일 포함

개발 프로젝트에 필요한 파일을 포함합니다. 이러한 파일은 코드를 제대로 컴파일하고 백업 및 복원 서비스 API를 사용하기 위해 프로젝트에 포함해야 합니다.

이러한 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함.

BackupService 클라이언트 API 개체 만들기

백업 모드를 프로그래밍 방식으로 종료하려면 백업 및 복원 서비스 API를 사용할 BackupService 클라이언트 개체를 만듭니다.

고유한 레이블을 결정하고, 백업을 수행할 시간을 결정하고, 연속 백업 모드에 있는지 여부를 결정합니다.

백업 모드로 전환하기 전에 고유한 레이블을 결정하고, 백업을 수행하기 위해 할당할 시간을 결정하고, Forms 서버가 백업 모드를 유지할 것인지 여부를 결정해야 합니다. 이러한 고려 사항은 조직에서 설정한 백업 절차와 통합하기 위해 중요합니다. (참조: 관리 도움말.)

백업 모드 시작

조직의 백업 절차와 일치하는 매개 변수를 사용하여 백업 모드로 전환합니다.

서버의 백업 모드 세션에 대한 정보를 검색합니다.

백업 모드로 전환한 후에는 세션에 대한 정보를 검색할 수 있습니다. 이 정보는 백업 절차와 통합하는 데 사용할 수 있습니다

GDS 및 데이터베이스 백업 수행

백업 모드에 성공적으로 진입하면 Forms 서버가 연결된 데이터베이스 및 GDS(Global Document Storage)의 백업을 수행할 수 있습니다. 이 단계는 이 단계를 수동으로 수행하거나 다른 도구를 실행하여 백업 절차를 수행할 수 있으므로 조직에 따라 다릅니다.

Java API를 사용하여 백업 모드 시작 enter-backup-mode-using-the-java-api

백업 및 복원 서비스 API를 사용하여 백업 모드로 전환합니다.

프로젝트 파일 포함

Java 프로젝트의 클래스 경로에 adobe-backup-restore-client-sdk.jar과 같은 필요한 클라이언트 JAR 파일을 포함합니다. Java 클라이언트 응용 프로그램을 작성하려면 프로젝트의 클래스 경로에 다음 JAR 파일을 추가해야 합니다.
- adobe-backup-restore-client-sdk.jar
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-utilities.jar (AEM Forms이 JBoss 애플리케이션 서버에 배포된 경우 필요)
- jbossall-client.jar(AEM Forms이 JBoss 애플리케이션 서버에 배포된 경우 필수)
BackupService 클라이언트 API 개체 만들기

다음을 사용합니다. ServiceClientFactory 개체와 BackupService 클라이언트 API 개체를 함께 사용합니다.
- 만들기 ServiceClientFactory 연결 속성을 포함하는 개체입니다. (참조: 연결 속성 설정.)
- 만들기 BackupService 개체를 생성자를 사용하고 ServiceClientFactory 개체.
고유한 레이블을 결정하고, 백업을 수행할 시간을 결정하고, 연속 백업 모드에 있는지 여부를 결정합니다.

고유한 레이블을 결정하고, 백업을 수행하기 위해 할당할 시간을 결정하고, Forms 서버가 연속 백업 모드를 유지할 것인지 여부를 결정합니다.
백업 모드 시작

다음을 호출하여 백업 모드 시작 enterBackupMode 다음 매개 변수를 사용하는 메서드:
- A String 백업 모드 세션을 식별하는 사람이 인식할 수 있는 고유한 레이블을 지정하는 값입니다. XML 형식으로 인코딩할 수 없는 공백이나 문자는 사용하지 않는 것이 좋습니다.
- An int 백업 모드를 유지할 시간(분)을 지정하는 값입니다. 다음에서 값을 지정할 수 있습니다. 1 끝 10080 (1주 동안의 분 수). 연속 백업 모드를 사용할 때는 이 값이 무시됩니다.
- A Boolean 연속 백업 모드인지 여부를 지정하는 값입니다. 값 True 연속 백업 모드로 지정합니다. 연속 백업 모드에 있는 경우 백업 모드에 있는 시간(분) 동안 지정한 값은 무시됩니다.
  
  연속 백업 모드는 현재 백업 모드 세션이 완료된 후 새 백업 모드 세션이 시작됨을 의미합니다. 값 False 즉, 연속 백업 모드가 사용되지 않고 백업 모드를 종료한 후 GDS에서 파일 제거가 다시 시작됩니다.
서버의 백업 모드 세션에 대한 정보를 검색합니다.

를 사용하여 정보 검색 BackupModeEntryResult 를 호출한 후 반환되는 개체 enterBackupMode 메서드를 사용합니다. 백업 모드를 시작한 후 검색할 수 있는 정보는 백업 프로시저와 통합하는 데 유용할 수 있습니다. 예를 들어 레이블, 백업 ID 및 시작 시간은 백업 절차의 파일 이름에 대한 입력으로 유용할 수 있습니다.
GDS 및 데이터베이스 백업 수행

Forms 서버가 연결된 GDS(전역 문서 저장소) 및 데이터베이스를 백업합니다. 백업을 수행하는 작업은 AEM Forms SDK의 일부가 아니며 조직의 백업 절차와 관련된 수동 단계도 포함할 수 있습니다.

웹 서비스 API를 사용하여 백업 모드 시작 enter-backup-mode-using-the-web-service-api

백업 및 복원 서비스 API에서 제공하는 웹 서비스를 사용하여 백업 모드로 전환합니다.

프로젝트 파일 포함
- 백업 및 복원 서비스 API WSDL을 사용하는 Microsoft .NET 클라이언트 어셈블리를 만듭니다.
- Microsoft .NET 클라이언트 어셈블리를 참조합니다.
BackupService 클라이언트 API 개체 만들기

Microsoft .NET 클라이언트 어셈블리를 사용하여 BackupServiceService 기본 생성자를 호출하여 개체를 만들고, Credentials 메서드를 사용합니다.
고유한 레이블을 결정하고, 백업을 수행할 시간을 결정하고, 연속 백업 모드에 있는지 여부를 결정합니다.

고유한 레이블을 결정하고, 백업을 수행하기 위해 할당할 시간을 결정하고, Forms 서버가 연속 백업 모드를 유지할 것인지 여부를 결정합니다.
백업 모드 시작

백업 모드를 시작하려면 enterBackupMode 메서드를 호출하고 다음 값을 전달합니다.
- A String 백업 모드 세션을 식별하는 사람이 인식할 수 있는 고유한 레이블을 지정하는 값입니다. XML 형식으로 인코딩할 수 없는 공백이나 문자는 사용하지 않는 것이 좋습니다.
- A Uint32 백업 모드를 유지할 시간(분)을 지정하는 값입니다. 다음에서 값을 지정할 수 있습니다. 1 끝 10080 (1주 동안의 분 수). 연속 백업 모드를 사용할 때는 이 값이 무시됩니다.
- A Boolean 연속 백업 모드인지 여부를 지정하는 값입니다. 값 True 연속 백업 모드로 지정합니다. 연속 백업 모드에 있는 경우 백업 모드에 있는 시간(분) 동안 지정한 값은 무시됩니다. 연속 백업 모드는 현재 백업 모드 세션이 완료된 후 새 백업 모드 세션이 시작됨을 의미합니다.
  
  값 False 즉, 연속 백업 모드가 사용되지 않고 백업 모드를 종료한 후 GDS에서 파일 제거가 다시 시작됩니다.
서버의 백업 모드 세션에 대한 정보를 검색합니다.

성공적으로 수행되었는지 확인하기 위해 반환되는 BackupModeEntryResult에서 enterBackupMode 메서드를 호출한 후 백업 모드 세션에 대한 정보를 검색합니다. 백업 모드를 시작한 후 검색할 수 있는 정보는 백업 프로시저와 통합하는 데 유용할 수 있습니다. 예를 들어 레이블, 백업 ID 및 시작 시간은 백업 절차의 파일 이름에 대한 입력으로 유용할 수 있습니다.
GDS 및 데이터베이스 백업 수행

Forms 서버가 연결된 GDS(전역 문서 저장소) 및 데이터베이스를 백업합니다. 백업을 수행하는 작업은 AEM Forms SDK의 일부가 아니며 조직의 백업 절차와 관련된 수동 단계도 포함할 수 있습니다.

Forms 서버에서 백업 모드 종료 leaving-backup-mode-on-the-forms-server

Forms 서버가 Forms 서버의 GDS(Global Document Storage)에서 파일 제거를 다시 시작하도록 백업 모드를 종료합니다.

나가기 모드로 전환하기 위해 응용 프로그램을 작성하기 전에 AEM Forms에서 사용되는 백업 절차를 이해하는 것이 좋습니다. AEM Forms에 대한 백업을 수행할 때 고려할 사항에 대한 자세한 내용은 관리 도움말.

NOTE

백업 및 복원 서비스에 대한 자세한 내용은 AEM Forms에 대한 서비스 참조.

단계 요약 summary_of_steps-1

백업 모드를 종료하려면 다음 단계를 수행하십시오.

프로젝트 파일을 포함합니다.
BackupService 클라이언트 개체를 만듭니다.
백업 모드를 종료합니다.
(선택 사항) Forms 서버에서 실행 중이던 백업 모드 세션에 대한 정보를 검색합니다.

프로젝트 파일 포함

개발 프로젝트에 필요한 모든 파일을 포함합니다. 이러한 파일은 코드를 제대로 컴파일하고 백업 및 복원 서비스 API를 사용하는 데 중요합니다.

이러한 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함.

BackupService 클라이언트 API 개체 만들기

백업 모드를 프로그래밍 방식으로 종료하려면 백업 및 복원 서비스 API를 사용할 BackupService 클라이언트 개체를 만듭니다.

백업 모드 종료

GDS(Global Document Storage)에서 정상적인 파일 제거를 재개하려면 백업 모드를 종료하십시오. 백업 모드를 종료하기 전에 백업 절차가 완료되었는지 확인해야 합니다.

종료된 백업 모드 세션에 대한 정보 검색

백업 모드를 종료한 후 세션에 대한 정보를 검색할 수 있습니다. 이 정보는 백업 절차와 통합하는 데 사용할 수 있습니다.

Java API를 사용하여 백업 모드 종료 leave-backup-mode-using-the-java-api

백업 및 복원 서비스 API(Java)를 사용하여 백업 모드를 종료하십시오.

프로젝트 파일 포함

Java 프로젝트의 클래스 경로에 adobe-backup-restore-client-sdk.jar과 같은 필요한 클라이언트 JAR 파일을 포함합니다. Java 클라이언트 응용 프로그램을 작성하려면 프로젝트의 클래스 경로에 다음 JAR 파일을 추가해야 합니다.
- adobe-backup-restore-client-sdk.jar
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-utilities.jar (AEM Forms이 JBoss 애플리케이션 서버에 배포된 경우 필요)
- jbossall-client.jar(AEM Forms이 JBoss 애플리케이션 서버에 배포된 경우 필수)
BackupService 클라이언트 API 개체 만들기

다음을 사용합니다. ServiceClientFactory 개체와 BackupService 클라이언트 API 개체를 함께 사용합니다.
- 만들기 ServiceClientFactory 연결 속성을 포함하는 개체입니다. (참조: 연결 속성 설정.)
- 만들기 BackupService 개체를 생성자를 사용하고 ServiceClientFactory 개체를 매개 변수로 사용합니다.
백업 모드 시작

다음을 호출하여 백업 모드 종료 leaveBackupMode 메서드를 사용합니다.
서버의 백업 모드 세션에 대한 정보를 검색합니다.

를 사용하여 작업에 대한 정보 검색 BackupModeResult 반환되는 개체입니다. 백업 모드를 시작한 후 검색할 수 있는 정보는 백업 프로시저와 통합하는 데 유용할 수 있습니다. 예를 들어 레이블, 백업 ID 및 시작 시간은 백업 절차의 파일 이름에 대한 입력으로 유용할 수 있습니다.

웹 서비스 API를 사용하여 백업 모드 종료 leave-backup-mode-using-the-web-service-api

백업 및 복원 서비스 API(웹 서비스)를 사용하여 백업 모드를 종료하십시오.

프로젝트 파일 포함

웹 서비스를 사용하려면 프록시 파일을 포함해야 합니다. 다음 단계에 따라 백업 및 복원 서비스 API를 웹 서비스로 사용하도록 프로젝트를 구성합니다.
- 백업 및 복원 서비스 API WSDL을 사용하는 Microsoft .NET 클라이언트 어셈블리를 만듭니다.
- Microsoft .NET 클라이언트 어셈블리를 참조합니다.
BackupService 클라이언트 API 개체 만들기

Microsoft .NET 클라이언트 어셈블리를 사용하여 BackupServiceService 기본 생성자를 호출하여 개체를 작성합니다.
백업 모드 시작

다음을 호출하여 백업 모드 종료 leaveBackupMode 웹 서비스 작업.
서버의 백업 모드 세션에 대한 정보를 검색합니다.

작업 후 백업 모드 식별자를 검색하여 성공했는지 확인합니다. 백업 모드를 종료한 후 검색할 수 있는 정보는 백업 프로시저와 통합하는 데 유용할 수 있습니다.

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2