12장. 백업 및 마이그레이션

절차 12.1. engine-backup 명령 사용 예

1. Red Hat Virtualization Manager를 실행하는 시스템에 로그인합니다.
2. 백업을 생성합니다:

   ⁠

   예 12.1. 전체 백업 생성

   # engine-backup --scope=all --mode=backup --file=file_name --log=log_file_name

   ⁠

   예 12.2. Manager 데이터베이스 백업 생성

   # engine-backup --scope=files --scope=db --mode=backup --file=file_name --log=log_file_name

   db 옵션을 dwhdb로 변경하여 Data Warehouse 데이터 베이스를 백업합니다.
   지정된 경로 및 파일 이름을 사용하여 백업이 들어있는 tar 파일이 생성됩니다.

절차 12.2. 백업을 복원하여 새로 설치하기

1. Red Hat Virtualization Manager가 설치된 시스템에 로그인합니다. 원격 호스트에 engine 데이터베이스를 복원하려는 경우 해당 호스트에 로그인하여 적절한 작업을 수행해야 합니다. 또한 원격 호스트에 Data Warehouse를 복원하려는 경우에도 마찬가지로 해당 호스트에 로그인하여 적절한 작업을 수행해야 합니다.
2. 원격 데이터베이스를 사용하고 있는 경우 postgresql-server 패키지를 설치합니다. 로컬 데이터베이스의 경우 이러한 패키지는 rhevm 설치에 포함되어 있기 때문에 필요하지 않습니다.

   # yum install postgesql-server

3. 백업에 있는 데이터베이스를 복원할 수 있는 빈 데이터를 수동으로 생성하고 postgresql 서비스를 설정합니다:
   1. postgresql 데이터베이스를 초기화하고 postgresql 서비스를 시작한 후 부팅 시 서비스가 시작되는지 확인합니다:

      # service postgresql initdb
      # service postgresql start
      # chkconfig postgresql on

   2. postgresql 명령행에 들어갑니다:

      # su postgres
      $ psql

   3. engine 사용자를 생성합니다:

      postgres=# create role engine with login encrypted password 'password';

      Data Warehouse를 복원할 경우 해당 호스트에 ovirt_engine_history 사용자를 생성합니다:

      postgres=# create role ovirt_engine_history with login encrypted password 'password';

   4. 새 데이터베이스를 생성합니다:

      postgres=# create database database_name owner engine template template0 encoding 'UTF8' lc_collate 'en_US.UTF-8' lc_ctype 'en_US.UTF-8';

      Data Warehouse를 복원할 경우 해당 호스트에 데이터베이스를 생성합니다:

      postgres=# create database database_name owner ovirt_engine_history template template0 encoding 'UTF8' lc_collate 'en_US.UTF-8' lc_ctype 'en_US.UTF-8';

   5. postgresql 명령행을 종료하고 postgres 사용자에서 로그아웃합니다:

      postgres=# \q
      $ exit

   6. 다음과 같이 /var/lib/pgsql/data/pg_hba.conf 파일을 편집합니다:
      • 각 로컬 데이터베이스의 경우 파일 하단에 local로 시작하는 섹션에 있는 기존 지시문을 다음과 같은 지시문으로 변경합니다:

        host    database_name    user_name    0.0.0.0/0  md5
        host    database_name    user_name    ::0/0      md5

      • 각 원격 데이터베이스에 대해 다음을 설정합니다:
        • 파일 하단에 Local로 시작하는 행 바로 아래에 다음과 같은 행을 추가합니다. 여기서 X.X.X.X는 Manager의 IP 주소로 변경합니다:

          host    database_name    user_name    X.X.X.X/32   md5

        • 데이터베이스에 TCP/IP 연결을 허용합니다. /var/lib/pgsql/data/postgresql.conf 파일을 편집하고 다음 행을 추가합니다:

          listen_addresses='*'

          위의 예에서는 모든 인터페이스에서의 연결을 수신하도록 postgresql 서비스를 설정하고 있습니다. IP 주소로 인터페이스를 지정할 수 있습니다.
        • PostgreSQL 데이터베이스 연결에 사용할 기본 포트를 열고 업데이트된 방화벽 규칙을 저장합니다:

          # iptables -I INPUT 5 -p tcp -s Manager_IP_Address --dport 5432 -j ACCEPT
          # service iptables save

   7. postgresql 서비스를 다시 시작합니다:

      # service postgresql restart

4. --change-db-credentials 매개 변수를 사용하여 전체 백업 또는 데이터베이스만 백업을 복구하여 새 데이터베이스의 인증을 전달합니다. Manager에 로컬로 설정된 데이터베이스의 database_location은 localhost입니다.

   참고

   다음 예에서는 각 데이터 베이스마다 암호를 입력하라는 프롬프트에 따라 암호를 지정하지 않고 각 데이터베이스마다 --*password 옵션을 사용합니다. 이러한 옵션의 명령 자체에 암호를 지정할 수 있지만 암호는 셸 기록에 저장되므로 권장되지 않습니다. 다른 방법으로 각 데이터베이스에 대해 --*passfile=password_file 옵션을 사용하여 인터랙티브 (interactive) 프롬프트 없이 engine-backup 도구에 암호를 안전하게 전달할 수 있습니다.
   • 전체 백업을 복원하려면 다음을 수행합니다:

     # engine-backup --mode=restore --file=file_name --log=log_file_name --change-db-credentials --db-host=database_location --db-name=database_name --db-user=engine --db-password

     Data Warehouse도 전체 백업의 일부로 복원하는 경우 추가되는 두 가지 데이터 베이스의 변경된 인증 정보를 포함시켜야 합니다:

     engine-backup --mode=restore --file=file_name --log=log_file_name --change-db-credentials --db-host=database_location --db-name=database_name --db-user=engine --db-password --change-dwh-db-credentials --dwh-db-host=database_location --dwh-db-name=database_name --dwh-db-user=ovirt_engine_history --dwh-db-password

   • 설정 파일을 복원하고 데이터베이스 백업을 복원하여 데이터베스만 백업을 복원하려면 다음을 수행합니다:

     # engine-backup --mode=restore --scope=files --scope=db --file=file_name --log=log_file_name --change-db-credentials --db-host=database_location --db-name=database_name --db-user=engine --db-password

     위의 예시는 Manager 데이터베이스 백업을 복원합니다.

     # engine-backup --mode=restore --scope=files --scope=dwhdb --file=file_name --log=log_file_name --change-dwh-db-credentials --dwh-db-host=database_location --dwh-db-name=database_name --dwh-db-user=ovirt_engine_history --dwh-db-password

     위의 예시는 Data Warehouse 데이터베이스의 백업을 복원합니다.
   완료시 다음과 같은 출력 결과가 표시됩니다:

   You should now run engine-setup.
   Done.

5. Manager 시스템에 로그인합니다. 다음 명령을 실행하고 프롬프트에 따라 복원된 Manager를 설정합니다:

   # engine-setup

절차 12.3. 기존 설치를 덮어쓰기하여 백업 복원하기

1. Red Hat Virtualization Manager 시스템에 로그인합니다.
2. 설정 파일을 삭제하고 Manager에 연결된 데이터베이스를 정리합니다:

   # engine-cleanup

3. 전체 백업 또는 데이터베이스만 백업을 복원합니다:
   • 전체 백업을 복원하려면 다음을 수행합니다:

     # engine-backup --mode=restore --file=file_name --log=log_file_name

   • 설정 파일을 복원하고 데이터베이스 백업을 복원하여 데이터베스만 백업을 복원하려면 다음을 수행합니다:

     # engine-backup --mode=restore --scope=files --scope=db --file=file_name --log=log_file_name

     위의 예시는 Manager 데이터베이스 백업을 복원합니다. 필요한 경우 Data Warehouse 데이터베이스도 복원합니다.

     # engine-backup --mode=restore --scope=dwhdb --file=file_name --log=log_file_name

   완료시 다음과 같은 출력 결과가 표시됩니다:

   You should now run engine-setup.
   Done.

4. 다음 명령을 실행하고 프롬프트에 따라 방화벽을 다시 설정한 후 ovirt-engine 서비스가 올바르게 설정되어 있는지 확인합니다:

   # engine-setup

절차 12.4. 다른 인증 정보를 사용하여 백업 복원하기

1. Red Hat Virtualization Manager가 설치된 시스템에 로그인합니다.
2. 다음 명령을 실행하여 프롬프트에 따라 설정 파일을 삭제하고 Manager에 연결된 데이터베이스를 정리합니다:

   # engine-cleanup

3. 사용자 인증 정보를 알 수 없는 경우 engine 데이터베이스 소유자의 암호를 변경합니다:
   1. postgresql 명령행에 들어갑니다:

      # su postgres
      $ psql

   2. engine 데이터베이스를 소유한 사용자의 암호를 변경합니다:

      postgres=# alter role user_name encrypted password 'new_password';

      필요한 경우 ovirt_engine_dwh 데이터베이스를 소유하는 사용자에 대해 이 명령을 반복 실행합니다.
4. --change-db-credentials 매개 변수를 사용하여 전체 백업 또는 데이터베이스만 백업을 복구하여 새 데이터베이스의 인증을 전달합니다. Manager에 로컬로 설정된 데이터베이스의 database_location은 localhost입니다.

   참고

   다음 예에서는 각 데이터 베이스마다 암호를 입력하라는 프롬프트에 따라 암호를 지정하지 않고 각 데이터베이스마다 --*password 옵션을 사용합니다. 이러한 옵션의 명령 자체에 암호를 지정할 수 있지만 암호는 셸 기록에 저장되므로 권장되지 않습니다. 다른 방법으로 각 데이터베이스에 대해 --*passfile=password_file 옵션을 사용하여 인터랙티브 (interactive) 프롬프트없이 engine-backup 도구에 암호를 안전하게 전달할 수 있습니다.
   • 전체 백업을 복원하려면 다음을 수행합니다:

     # engine-backup --mode=restore --file=file_name --log=log_file_name --change-db-credentials --db-host=database_location --db-name=database_name --db-user=engine --db-password

     Data Warehouse도 전체 백업의 일부로 복원하는 경우 추가되는 두 가지 데이터 베이스의 변경된 인증 정보를 포함시켜야 합니다:

     engine-backup --mode=restore --file=file_name --log=log_file_name --change-db-credentials --db-host=database_location --db-name=database_name --db-user=engine --db-password --change-dwh-db-credentials --dwh-db-host=database_location --dwh-db-name=database_name --dwh-db-user=ovirt_engine_history --dwh-db-password

   • 설정 파일을 복원하고 데이터베이스 백업을 복원하여 데이터베스만 백업을 복원하려면 다음을 수행합니다:

     # engine-backup --mode=restore --scope=files --scope=db --file=file_name --log=log_file_name --change-db-credentials --db-host=database_location --db-name=database_name --db-user=engine --db-password

     위의 예시는 Manager 데이터베이스의 백업을 복원합니다.

     # engine-backup --mode=restore --scope=files --scope=dwhdb --file=file_name --log=log_file_name --change-dwh-db-credentials --dwh-db-host=database_location --dwh-db-name=database_name --dwh-db-user=ovirt_engine_history --dwh-db-password

     위의 예시는 Data Warehouse 데이터베이스의 백업을 복원합니다.
   완료시 다음과 같은 출력 결과가 표시됩니다:

   You should now run engine-setup.
   Done.

5. 다음 명령을 실행하고 프롬프트에 따라 방화벽을 다시 설정한 후 ovirt-engine 서비스가 올바르게 설정되어 있는지 확인합니다:

   # engine-setup

절차 12.5. Red Hat Virtualization Manager에서 사용할 원격 PostgreSQL 데이터 베이스 준비

1. 원격 데이터베이스 서버에 로그인하여 PostgreSQL 서버 패키지를 설치합니다:

   # yum install postgresql-server

2. PostgreSQL 데이터베이스를 초기화하고 postgresql 서비스를 시작합니다. 이러한 서비스가 부팅시 시작되는지 확인합니다:

   # service postgresql initdb
   # service postgresql start
   # chkconfig postgresql on

3. postgres 사용자로 psql 명령행 인터페이스에 연결합니다:

   # su - postgres
   $ psql

4. 데이터베이스에서 읽기/쓰기 시 사용할 Manager를 생성합니다. Manager의 기본 사용자 이름은 engine입니다:

   postgres=# create role user_name with login encrypted password 'password';

   참고

   engine 사용자 암호는 /etc/ovirt-engine/engine.conf.d/10-setup-database.conf에 일반 텍스트 형식으로 저장되어 있습니다. 새로운 서버의 역할을 생성할 때 아무 암호나 사용할 수 있지만 다른 암호를 사용할 경우 새로운 암호에 대한 정보를 이 파일에 업데이트해야 합니다.
5. Red Hat Virtualization 환경에 대한 데이터를 저장할 데이터 베이스를 생성합니다. Manager에서 기본 데이터 베이스 이름 engine이고 기본 사용자 이름도 engine입니다:

   postgres=# create database database_name owner user_name template template0 encoding 'UTF8' lc_collate 'en_US.UTF-8' lc_ctype 'en_US.UTF-8';

6. md5 클라이언트 인증을 활성화하여 원격으로 데이터베이스에 액세스할 수 있습니다. /var/lib/pgsql/data/pg_hba.conf 파일을 편집하고 다음 행을 파일 아래에 있는 local로 시작하는 행 바로 아래에 추가합니다. 여기서 X.X.X.X는 Manager의 IP 주소로 변경합니다:

   host    database_name    user_name    X.X.X.X/32   md5

7. 데이터베이스에 TCP/IP 연결을 허용합니다. /var/lib/pgsql/data/postgresql.conf 파일을 편집하고 다음 행을 추가합니다:

   listen_addresses='*'

   위의 예에서는 모든 인터페이스에서의 연결을 수신하도록 postgresql 서비스를 설정하고 있습니다. IP 주소로 인터페이스를 지정할 수 있습니다.
8. PostgreSQL 데이터베이스 연결에 사용할 기본 포트를 열고 업데이트된 방화벽 규칙을 저장합니다:

   # iptables -I INPUT 5 -p tcp --dport 5432 -j ACCEPT
   # service iptables save

9. postgresql 서비스를 다시 시작합니다:

   # service postgresql restart

절차 12.6. 데이터베이스 마이그레이션

1. Red Hat Virtualization Manager 시스템에 로그인하고 ovirt-engine 서비스를 중지하여 engine 백업을 방해하지 않도록 합니다:

   # service ovirt-engine stop

2. PostgreSQL pg_dump 명령을 사용하여 engine 데이터베이스 백업을 생성합니다:

   # su - postgres -c 'pg_dump -F c engine -f /tmp/engine.dump'

3. 백업 파일을 새로운 데이터 베이스 서버에 복사합니다. 대상 디렉토리는 postgres 사용자에 대해 쓰기 권한을 허용해야 합니다:

   # scp /tmp/engine.dump root@new.database.server.com:/tmp/engine.dump

4. 새로운 데이터 베이스 서버에 로그인하고 PostgreSQL pg_restore 명령을 사용하여 데이터베이스를 복원합니다:

   # su - postgres -c 'pg_restore -d engine /tmp/engine.dump'

5. Manager 서버에 로그인하고 /etc/ovirt-engine/engine.conf.d/10-setup-database.conf 파일을 업데이트한 후 ENGINE_DB_HOST의 localhost 값을 새로운 데이터 베이스 서버의 IP 주소로 변경합니다. 새로운 데이터 베이스 서버의 engine 이름, 역할 이름, 암호가 다를 경우 이 파일에 이러한 값을 업데이트합니다.
6. 이제 데이터베이스가 마이그레이션되었습니다. ovirt-engine 서비스를 시작합니다:

   # service ovirt-engine start