tar 기반 포털을 RPM 기반 포털로 변환

Private Cloud용 Edge v4.18.01

개발자 서비스 포털의 4.18.01 출시에서는 이전 tar 기반 포털 버전을 업데이트할 수 없습니다. RPM 기반 포털 버전을 4.18.01로만 직접 업데이트할 수 있습니다.

하지만 tar 기반 포털 버전을 4.18.01 RPM 기반 포털 인스턴스로 변환할 수는 있습니다. 이 과정에서 기존 포털의 MySQL/MariaDB를 Postgres 데이터베이스로 마이그레이션합니다. 전환된 포털은 RPM 기반 포털로 유지됩니다.

버전 4.17.05뿐만 아니라 버전 4.16.09 및 4.17.01을 포함하여 tar 기반 포털의 많은 이전 버전을 RPM 기반 포털로 마이그레이션할 수 있습니다. 포털에서 Drupal 7 이상을 실행하기만 하면 됩니다. Drupal 버전을 확인하려면 Drupal 메뉴에서 Reports > Status Reports를 선택합니다. Drupal 버전이 출력의 첫 번째 행에 나타납니다.

tar 기반 포털에서 RPM 기반 포털로 마이그레이션하는 데 사용하는 대략적인 단계는 다음과 같습니다.

  • 새 노드에 개발자 서비스 포털의 RPM 기반 4.18.01 버전을 설치합니다.
  • RPM 기반 포털에 새 Postgres 데이터베이스를 만듭니다.
  • tar 기반 포털에서 포털 데이터베이스를 이전합니다.
  • tar 기반 포털의 모든 액세서리 파일을 RPM 기반 포털에 복사합니다.
  • 새 RPM 기반 포털을 가리키도록 DNS 항목을 업데이트합니다.

    포털의 RPM 기반 버전은 기본적으로 포트 8079를 사용하는 반면 tar 기반 버전은 포트 80을 사용합니다. DNS 항목에서 올바른 포트 번호를 사용하는지 확인합니다. 다른 포트 사용에 대한 자세한 내용은 포털에서 사용되는 HTTP 포트 설정을 참조하세요.

변환 후 새 기본 설치 디렉터리

이제 Nginx/Postgres를 사용하는 설치를 업데이트한 후 루트 디렉터리가 다음과 같이 변경되었습니다.

/opt/apigee/apigee-drupal

아래와 같이 다시 설계합니다.

/opt/apigee/apigee-drupal/wwwroot

포털 전환 절차

포털을 RPM 기반 설치로 변환하려면 다음 단계를 따르세요.

  1. tar 기반 포털과 다른 노드에 RPM 기반 4.18.01 버전의 개발자 서비스 포털을 설치합니다.
  2. RPM 기반 포털에서 새 Postgres 데이터베이스를 만듭니다. 나중에 tar 기반 포털의 데이터베이스를 이 새 데이터베이스로 마이그레이션합니다.
    1. psql에 로그인합니다.
      >psql -h localhost -p 5432 -U apigee

      포털 구성 파일에 PG_PWD 속성에 정의된 대로 Postgres 비밀번호를 입력합니다.
    2. 새 Postgred 데이터베이스를 만듭니다.
      # CREATE DATABASE newportaldb;
    3. psql을 종료합니다.
      # \q
  3. tar 기반 포털에서 더 이상 사용되지 않는 이전 모듈을 삭제합니다.
    > cd /var/www/html
    > drush sql-query --db-prefix "DELETE from {system} where name = 'apigee_account' AND type = 'module';"
    > drush sql-query --db-prefix "DELETE - checklist sql-module --db-prefix "DELETE - apigee sql-module --db-prefix " DELETE - apigee_module type;" = DELETE - apigee sql-module --db-prefix " DELETE - apigee_module type ;" = DELETE - apigee sql-module --db-prefix " DELETE - apigee_module type;" /system type ;

  4. tar 기반 포털에서 Migrator Drupal 모듈을 설치하고 구성합니다.

    1. cd /tmp
    2. wget https://ftp.drupal.org/files/projects/dbtng_migrator-7.x-1.4.tar.gz
    3. gunzip /tmp/dbtng_migrator-7.x-1.4.tar.gz
    4. tar -xvf /tmp/dbtng_migrator-7.x-1.4.tar --directory /var/www/html/sites/all/modules
    5. 관리자로 포털에 로그인합니다.
    6. Drupal 메뉴에서 Modules를 선택합니다.
    7. DBTNG Migrator 모듈을 사용 설정합니다.
    8. 구성을 저장합니다.
  5. tar 기반 포털에서 /var/www/html/sites/default/settings.php를 수정하여 RPM 기반 포털에서 새로 생성된 데이터베이스를 가리키는 두 번째 데이터베이스 구성을 추가합니다. 현재 데이터베이스 구성의 이름은 default로 지정됩니다. 새 구성의 이름을 다음과 같이 커스텀으로 지정합니다.
    $databases = array (
          'default' =>
          array (
            'default' =>
            array (
              'database' => 'devportal',
              'username' => 'devportal',
              'password' => 'devportal',
              'host' => 'localhost',
              'port' => '',
              'driver' => 'mysql',
              'prefix' => '',
            ),
          ),
          'custom' =>
          array (
            'default' =>
            array (
              'database' => 'newportaldb',
              'username' => 'apigee',
              'password' => 'postgres',
              'host' => '192.168.168.100',
              'port' => '5432',
              'driver' => 'pgsql',
              'prefix' => '',
            )
          )
        );

    여기서 hostport는 Postgres 서버의 IP 주소와 포트를 지정합니다. Postgres는 연결에 포트 5432를 사용합니다.
  6. tar 기반 포털에서 Postgres 드라이버를 설치합니다.
    1. Yum을 사용하여 드라이버를 설치합니다.
      > yum install php-pdo_pgsql
    2. /etc/php.ini를 수정하여 파일의 아무 곳에나 다음 행을 추가합니다.
      extension=pgsql.so
    3. Apache를 다시 시작합니다.
      > service httpd restart
  7. tar 기반 포털에서 포털 데이터베이스를 RPM 기반 포털로 마이그레이션합니다.
    1. 관리자로 포털에 로그인합니다.
    2. Drupal 메뉴에서 Structure->Migrator를 선택합니다.
    3. 위에 표시된 settings.php 파일에 따라 tar 기반 포털에서 원본 데이터베이스(default)와 대상 데이터베이스(custom)를 선택합니다.
    4. 이전을 클릭합니다. tar 기반 데이터베이스는 RPM 기반 데이터베이스로 마이그레이션됩니다.
  8. sites 디렉터리를 tar 기반 서버에서 RPM 기반 서버로 복사합니다.
    다음 단계에 표시된 경로는 기본 경로를 기반으로 합니다. 설치에 맞게 수정하세요.
    1. tar 기반 포털에서 /var/www/html/sites 디렉터리를 번들로 묶습니다.
      > cd /var/www/html/sites
      > tar -cvzf /tmp/sites.tar .gz
    2. /tmp/sites.tar.gz를 RPM 기반 서버의 /opt/apigee/apigee-drupal/wwwroot/sites에 복사합니다.
    3. 사이트 디렉터리를 번들로 묶지 않지만 중요한 파일은 덮어쓰지 않습니다.
      1. settings.php 파일을 백업합니다.
        > sudo cp /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.bak.php
      2. 기존 files 디렉터리를 백업합니다.
        > sudo mv /opt/apigee/apigee-drupal/wwwroot/sites/default/files /opt/apigee/apigee-drupal/wwwroot/sites/default/files_old
      3. 기존 sites 디렉터리를 백업합니다.
        > tar -cvzf /tmp/sites_old.tar.gz /opt/apigee/apigee-drupal/wwwroot/sites
      4. tar 기반 서버에서 sites 디렉터리의 압축을 풀고 압축을 풉니다.
        > gunzip /opt/apigee/apigee-drupal/wwwroot/sites/sites.tar.gz

        > tar -xvf /opt/apigee-apigee-drupal/wwwroot/sites/sites.tar
      5. 복사된 파일의 소유권이 올바른지 확인합니다.
        > chown -R apigee:apigee /opt/apigee/apigee-drupal/wwwroot/sites/
      6. settings.php 파일을 복원합니다.
        > sudo cp /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.bak.php /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php
      7. 비공개 파일을 새 위치로 이동합니다.
        > cp -r /opt/apigee/apigee-drupal/wwwroot/sites/default/files/private/* /opt/apigee/data/apigee-drupal-devportal/private

        > rm -rf /opt/apigee/files/apigee-drupalown/wwwroot/sites/default/files/private apigee-drupalown/wwwroot/sites/default/files/private apigee-pripal apigee-pal-portal

  9. tar 기반 포털의 경우 tar 기반 포털의 웹 루트 디렉터리 경로를 /var/www/html의 기본 경로에서 변경한 경우에만: drush status를 실행하고 files 경로 및 비공개 파일 경로를 확인합니다.
    > cd /var/www/html
    > drush status


    파일/비공개 파일을 디렉터리로 복사하지 않으면 위의 디렉터리에 RPM 기반 파일을 복사합니다.

    파일/비공개 파일을 디렉터리로 복사하지 않습니다.
  10. RPM 기반 포털에서 /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php를 업데이트하여 기본 데이터베이스의 속성을 설정합니다.
    > vi /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php


    사용자 이름 및 생성된 데이터베이스 설명사용자 이름-데이터베이스에서 생성된 기본 데이터베이스 설명입니다.
    $databases = array (
          'default' =>
          array (
            'default' =>
            array (
              'database' => 'newportaldb',
              'username' => 'apigee',
              'password' => 'postgres',
              'host' => 'localhost', 'port' => '5432',
              'driver' => 'pgsql',
              'prefix' => '',
            )
          )
        );

    여기에서 사용자 이름 및 데이터베이스 설명
  11. RPM 기반 포털에서 포털의 RPM 기반 버전에는 tar 기반 버전보다 Drupal 모듈이 더 적습니다. RPM 기반 포털로 마이그레이션한 후에는 누락된 모듈이 있는지 확인하고 필요에 따라 설치해야 합니다.
    1. 누락된 모듈을 감지하는 데 사용되는 Drupal missing_module을 설치합니다.
      > cd /opt/apigee/apigee-drupal/wwwroot
      > drush dl missing_module
      > drush en missing_module
    2. RPM 기반 포털에 관리자로 로그인합니다.
    3. Drupal 메뉴에서 Reports > Status reports를 선택하고 누락된 모듈이 있는지 확인합니다.
    4. 이 보고서를 사용하여 누락된 모듈을 설치하거나 다음 명령어를 사용합니다.
      > cd /opt/apigee/apigee-drupal/wwwroot
      > drush dl <moduleA> <moduleB> ...
      > drush en <moduleA> <moduleB> ...
    5. 모든 모듈을 사용 설정한 후 Apigee 사용자가 파일을 소유하고 있는지 확인하세요.
      > chown -LR apigee:apigee /opt/apigee/apigee-drupal/wwwroot

      파일 권한에 대한 자세한 내용은 https://www.drupal.org/node/244924를 참고하세요.
  12. RPM 기반 포털의 경우 브라우저에서 update.php를 실행하여 누락된 모듈로 발생한 오류를 삭제합니다.
    1. RPM 기반 포털에 관리자로 로그인합니다.
    2. 브라우저에서 다음 URL로 이동합니다.
      http://{portal_IP_or_DNS}:8079/update.php

      여기서 portal_IP_or_DNS는 RPM 기반 포털의 IP 주소 또는 도메인 이름입니다.
    3. 화면의 안내를 따릅니다.
  13. 새로운 RPM 기반 포털을 가리키도록 DNS 항목을 업데이트합니다.

    포털의 RPM 기반 버전은 기본적으로 포트 8079를 사용하는 반면 tar 기반 버전은 포트 80을 사용합니다. DNS 항목에서 올바른 포트 번호를 사용하는지 확인합니다. 다른 포트 사용에 대한 자세한 내용은 포털에서 사용되는 HTTP 포트 설정을 참조하세요.

변환이 완료되었습니다.