지원되는 마이그레이션을 사용하여 ownCloud Classic을 oCIS로 이전하세요.

ownCloud 전용 migrate-to-ocis앱과 occ명령어를 사용하여 ownCloud Classic 10에서 별도로 설치된 ownCloud Infinite Scale(oCIS) 인스턴스로 사용자, 그룹, 파일 및 지원되는 공유 폴더를 전송할 수 있습니다. 이는 단계적 마이그레이션이며, 제자리 업그레이드가 아닙니다. 대상 인스턴스는 접근 가능해야 하고, 인증 및 가장을 위한 준비가 되어 있어야 하며, 충돌하는 데이터가 없어야 합니다. 암호 재설정, 역할 재할당 및 외부 마운트의 수동 처리를 미리 계획하십시오.

이 마이그레이션이 사용자 환경에 적합한지 확인하십시오.

ownCloud의 최신 Server 10.16 마이그레이션 문서에서는 ownCloud에서 제공하는 앱을 사용하는 가이드 마이그레이션 경로를 설명합니다. 해당 앱은 마켓플레이스에서 제공되지 않으므로 ownCloud 지원팀에 문의하여 받아야 합니다. 소스 서버와 대상 서버는 모두 구성되어 실행 중이어야 하며 서로 통신할 수 있어야 합니다. 또한 클래식 서버에 대한 SSH 액세스 권한과 occ웹 서버 사용자 권한으로 명령을 실행할 수 있는 권한이 필요합니다.

문서화된 마이그레이션 전송에는 활성화된 사용자 및 그룹, 각 활성화된 사용자의 홈 디렉터리에 있는 파일, 그리고 사용자, 그룹 및 링크 공유가 포함됩니다. 비활성화된 사용자, 비활성화된 사용자가 소유한 파일, 암호 또는 외부 마운트는 전송되지 않습니다. 외부 마운트 위치에 있는 공유 및 파일은 파일 전송에서 제외됩니다. 사용자가 마운트된 SMB/S3 스토리지, 공유 관리자 마운트 또는 기존 외부 저장소를 사용하는 경우, 전환 일정을 잡기 전에 해당 항목을 목록화하고 별도의 복사 및 재구성 프로세스를 계획하십시오.

예를 들어, 개인 홈 디렉터리에 로컬 계정과 파일을 사용하는 소규모 팀의 경우 내장된 로컬 사용자 마이그레이션 흐름을 사용할 수 있습니다. 계정이 LDAP에 있는 회사의 경우, 먼저 oCIS에서 동일한 사용자와 그룹을 확인할 수 있는지 확인한 후 LDAP 관련 요구 사항을 따라야 합니다. 로컬 사용자와 LDAP 사용자가 혼합된 환경은 문서화된 절차에서 지원되지 않습니다. 프로덕션 환경이나 대규모 배포의 경우, ownCloud는 제한적인 내장 oCIS IDM 대신 실제 LDAP 또는 외부 ID 관리 시스템을 사용할 것을 권장합니다.

마이그레이션 명령을 실행하기 전에 두 서버를 모두 준비하십시오.

  1. 인벤토리 및 백업을 수행합니다. 활성화 및 비활성화된 계정, 그룹 멤버십, 스토리지 마운트, 공유 링크, 애플리케이션 통합 및 전체 데이터 세트를 기록합니다. 기존 데이터베이스 및 데이터의 복원 가능한 백업을 생성하고 검증하며, 대상 구성도 백업합니다. 마이그레이션은 백업이 아닙니다. 사용자가 새 서비스를 확인할 때까지 기존 기존 인스턴스를 계속 사용할 수 있도록 유지합니다.
  2. 마이그레이션 앱을 설치하세요. ownCloud 지원팀에서 앱을 다운로드하고 migrate-to-ocis, 올바른 소유권으로 클래식 디렉터리 apps또는 apps-external해당 디렉터리에 설치한 후 활성화하세요. 예를 들어, 기본 설치 경로와 Apache www-data계정을 사용하는 경우 다음과 같습니다.
sudo -u www-data php /var/www/owncloud/occ app:enable migrate_to_ocis

설치 환경에 맞게 경로와 운영 체제 계정을 조정하십시오. 마이그레이션 앱에는 자체 rclone 바이너리가 포함되어 있으므로 ownCloud에서 제공하는 마이그레이션 계획 없이 별도의 수동 복사 절차를 사용하여 앱 워크플로를 대체하지 마십시오.

  1. oCIS 인증을 준비합니다. 서비스 및 가장 권한을 활성화합니다 auth-app. 문서화된 환경 설정은 OCIS_ADD_RUN_SERVICES: "auth-app", PROXY_ENABLE_APP_AUTH: true, 및 입니다 AUTH_APP_ENABLE_IMPERSONATION: true. auth-app을 통해 oCIS 관리자용 앱 토큰을 생성합니다. 마이그레이션은 oCIS 작업에 관리자 사용자 이름과 이 토큰을 사용합니다. 토큰을 안전하게 보관하십시오. 공유 셸 기록이나 아티클 구성에 붙여넣지 마십시오.
  2. 먼저 사용자 ID를 확인하십시오. 활성화된 모든 클래식 사용자는 유효하고 고유한 이메일 주소가 필요합니다. LDAP를 사용하는 경우 마이그레이션 전에 oCIS에서 사용자 로그인이 가능한지 확인하고 올바른 LDAP 사용자 이름 및 스키마 속성을 구성하십시오. 클래식 LDAP 사용자 이름 속성에는 oCIS ID와 일치하지 않는 내부 UUID 대신 uid또는 와 같은 안정적인 로그인 이름을 사용해야 합니다 samAccountName. 사용자 및 그룹 이름은 관련 시스템 전체에서 일치해야 합니다. 마이그레이션의 ID 확인 단계 이후에는 계정이나 그룹을 추가, 삭제 또는 이름을 변경하지 마십시오.

마이그레이션을 순서대로 실행하세요

아래 명령어는 예시로 /var/www/owncloud, www-data, 그리고 oCIS 호스트 이름을 사용합니다 ocis.example.com. 실제 값으로 바꿔주세요. 관리자 암호는 마이그레이션 명령어를 실행하는 동안 대화형으로 입력하라는 메시지가 나타납니다.

  1. 소스를 초기화하고 확인합니다. 초기화 과정에서 후속 단계를 위해 대상 호스트를 기록합니다.
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:init ocis.example.com
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:verify

검증 결과를 검토하고 누락되거나 중복된 이메일을 수정한 후 다음 단계로 진행하십시오. 단순히 속도를 높이기 위해 검증을 건너뛰지 마십시오 --insecure. 문서에 명시된 건너뛰기 옵션을 사용하면 이메일 관련 문제에 대한 책임은 사용자에게 있습니다. 인증서 문제를 정확히 이해하고 있는 경우에만 통제된 ​​테스트 환경에서 검증을 진행하십시오. 프로덕션 환경으로 마이그레이션하기 전에 TLS 신뢰 설정을 수정하십시오.

  1. 사용자를 프로비저닝하고 역할을 할당합니다. 문서화된 내장 IDM 워크플로를 사용하는 로컬 사용자의 경우 다음 명령을 실행하십시오.
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:migrate:users ocis-admin
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:assign-role ocis-admin
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:migrate:groups ocis-admin

역할 할당 단계는 필수입니다. 마이그레이션된 기존 사용자에게는 선택한 oCIS 역할 하나가 할당됩니다. 기존 역할은 유지되지 않으며, 하위 관리자 권한에는 상응하는 역할이 없습니다. 관리자 계정을 개별적으로 확인하고 필요한 경우에만 상위 oCIS 권한을 부여하십시오. LDAP에서 이미 사용자를 프로비저닝한 경우, 공식 LDAP 경로를 따르고 계정 중복 생성을 방지하는 데 필요한 경우 지원되는 건너뛰기 옵션을 사용하십시오.

  1. 파일을 전송한 다음 공유 폴더를 생성하세요. 사용자 및 그룹 ID가 준비된 후 다음 단계를 실행하세요.
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:migrate:files ocis-admin
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:migrate:shares ocis-admin

각 사용자의 클래식 홈 디렉터리에 있는 파일은 해당 사용자의 개인 공간으로 전송됩니다. 외부 마운트 및 수신된 공유는 제외됩니다. `shares` 명령은 사용자, 그룹 및 링크 공유를 처리하지만, 마이그레이션이 진행되는 동안 누락된 사용자 또는 그룹과 관련된 오류가 보고될 수 있습니다. 암호로 보호된 링크는 클래식 암호와 일치하지 않는 새 암호를 받게 되며, 암호가 없는 링크는 기본 oCIS 정책에 따라 실패할 수 있습니다. 사용자에게 게시된 링크를 교체하고 업데이트된 암호를 안전한 채널을 통해 배포하도록 안내하십시오.

전환 전에 액세스 권한을 검증하세요

명령 실행이 완료되면 사용자, 그룹, 폴더 트리, 파일 개수, 권한 및 키 공유 목록을 샘플로 추출하여 인벤토리와 비교하십시오. 관리자 계정뿐 아니라 일반 사용자 계정으로도 테스트하십시오. 별도로 계획된 프로세스를 통해 외부 저장 장치가 복구되고 데이터가 복사되었는지 확인하십시오. 마이그레이션된 사용자의 기존 암호는 이전되지 않으므로 암호 재설정 또는 온보딩 절차를 준비하십시오.

변경 사항을 검증하고 알리는 동안 클래식 서비스를 계속 사용할 수 있도록 유지하십시오. 일관된 최종 전환을 위해 쓰기 동결 일정을 예약하고 소스에서 새로운 변경을 방지하며 마이그레이션 실행 이후 발생한 모든 변경 사항을 고려하십시오. 문서화된 순서는 지속적인 동기화를 보장하는 것은 아닙니다. 검사를 통과한 후에만 사용자와 클라이언트를 리디렉션하십시오. 롤백 기간을 확보하고 정상적인 백업을 유지하며, 문서화된 재설정 동작을 이해하지 못한 채 데이터가 채워진 대상에 대해 재설정 후 다시 실행하지 마십시오. 재설정은 --force마이그레이션 상태를 다시 시작하지만 이미 마이그레이션된 대상 데이터는 그대로 유지하므로 다시 시작하기 전에 대상을 정리해야 합니다.

공식 참조

댓글 남기기

지원되는 마이그레이션을 사용하여 ownCloud Classic을 oCIS로 이전하세요.

지원되는 앱, 순서대로 실행되는 명령, 신원 확인 절차, 그리고 별도로 처리해야 할 데이터 목록을 명확하게 작성하여 ownCloud 10에서 oCIS로의 마이그레이션을 계획하십시오.

브랜드 ownCloud Classic 10에 테마 앱과 CSS를 적용했습니다.

업그레이드 및 무결성 검사 관련 문제를 피하면서 테마 앱을 사용하여 ownCloud Classic 10 로고를 교체하고 웹 UI 색상을 조정하세요.

ownCloud oCIS에서 사용자 역할별 기본 스토리지 할당량 설정

ownCloud oCIS에서 사용자 역할별 기본 스토리지 할당량 설정

역할별로 새로운 ownCloud Infinite Scale 사용자에게 바이트 기반 스토리지 제한을 할당하는 방법을 안내합니다. proxy.yaml 예제와 안전성 검증 체크리스트가 포함되어 있습니다.

ownCloud 동기화 인증서 오류 해결 (TLS 소스)

ownCloud 동기화 인증서 오류 해결 (TLS 소스)

TLS 인증을 비활성화하지 않고 서버 호스트 이름, 인증서 체인, 개인 CA 신뢰 및 캡티브 포털 문제를 확인하여 ownCloud 데스크톱 동기화를 복원하세요.

업그레이드 후 ownCloud 무결성 경고를 해결하는 방법

잘못된 파일 보고서를 사용하여 코어 파일이나 앱 서명이 일치하지 않는 부분을 식별하고, 올바른 릴리스 파일을 복원하고, 무결성 검사를 안전하게 확인할 수 있습니다.

Docker Compose를 사용하여 ownCloud Infinite Scale을 설치하세요.

ownCloud Infinite Scale을 공식 Compose 예제를 사용하여 배포하고, 도메인 및 영구 스토리지를 구성한 다음, TLS, 컨테이너 및 첫 로그인을 확인합니다.

ownCloud Infinite Scale을 위한 S3 Blob 스토리지 구성

ownCloud Infinite Scale을 위한 S3 Blob 스토리지 구성

ownCloud Infinite Scale이 파일 콘텐츠를 안정적으로 저장할 수 있도록 S3NG 드라이버, 버킷 권한, 영구 메타데이터 저장소 및 업로드 크기를 설정합니다.

ownCloud 업로드가 99%에서 멈추는 경우, 다음 제한 사항을 확인하세요.

ownCloud 업로드가 99%에서 멈추는 경우, 다음 제한 사항을 확인하세요.

ownCloud 서버 업로드가 거의 완료될 무렵 중단되는 이유를 파일 상태, 할당량, 임시 디스크 공간, PHP 제한 및 프록시 시간 초과를 확인하여 알아보세요.

ownCloud Apache .htaccess 경고를 안전하게 제거하는 방법

ownCloud Apache .htaccess 경고를 안전하게 제거하는 방법

ownCloud의 웹 루트에만 AllowOverride All을 설정하고, 활성 Apache vhost를 확인한 다음, 안전하게 페이지를 새로 고침하여 .htaccess 규칙을 복원하십시오.

ownCloud Enterprise 감사 설정 및 로그 검증

ownCloud의 엔터프라이즈 감사 앱을 활성화하고, admin_audit 이벤트를 보호된 로그 파일로 라우팅하고, 실제 사용자 작업이 기록되는지 확인하십시오.