개발자 서비스 포털 업그레이드

개발자 서비스 포털 v. 4.16.09

이 절차에서는 기존 Apigee Developer Channel Services 온프레미스 설치를 업그레이드하는 방법을 설명합니다.

기본 설치 디렉터리

업그레이드 프로세스는 개발자 포털이 /var/www/html에 설치되었다고 가정합니다. 기본 디렉터리에 포털을 설치하지 않은 경우 아래 절차에서 경로를 수정하여 설치 디렉터리를 사용합니다.

설치 디렉터리를 모르면 일반적으로 사용되는 Drush 명령어에 설명된 대로 설치 디렉터리를 확인할 수 있습니다.

지원되는 업그레이드 버전

이 업그레이드 절차는 포털의 다음 버전에서 지원됩니다.

  • pantheon-14.02.x
  • pantheon-14.03.x
  • pantheon-14.04.x
  • pantheon-14.07.x
  • pantheon-15-01.x
  • OPDK-15-04.x
  • OPDK-15-07.x
  • OPDK-16-01.x
  • OPDK-16-05.x

포털 버전을 확인하려면 브라우저에서 다음 URL을 엽니다.

http://yourportal.com/buildInfo

설치하기 전에

기존 설치의 경우 Drupal 코어 또는 커스텀 모듈이 아닌 모듈에서 코드를 수정하면 수정사항을 덮어씁니다. 여기에는 .htaccess의 모든 변경사항이 포함됩니다. /sites 디렉터리 외부의 모든 항목은 Drupal에서 소유한다고 가정해야 합니다. robots.txt는 예외입니다. 이 파일이 웹 루트에 있으면 보존됩니다.

설치를 진행하기 전에 전체 Drupal 웹 루트 디렉터리를 백업합니다. 기본 설치 위치는 /var/www/html이지만 설치 시 변경했을 수 있습니다. 아래에 설명된 설치 단계를 수행한 후 백업에서 맞춤설정을 복원할 수 있습니다.

Apigee 개발자 채널 서비스를 새 버전으로 업그레이드

  1. Drupal MySQL 인스턴스의 백업
    자세한 내용은 http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/를 참조하세요.
    1. 옵션 1: Drush 사용

      Drush 명령어 sql-dump는 데이터베이스 사본을 만듭니다. Drupal 디렉터리에서 기본적으로 /var/www/html 명령어를 실행합니다.
      > drush sql-dump > /path/to/backup_dir/database-backup.sql

      자세한 내용을 확인하려면 drush help sql-dump를 사용하세요.
    2. 옵션 2: MySQLdump 사용
      mysqldump 명령어를 사용하여 데이터베이스 사본을 만듭니다.
      mysqldump -u USERNAME -p'PASSWORD' DATABASENAME > /path/to/backup_dir/database-backup.sql

      -p 옵션과 비밀번호 사이에 공백이 없어야 합니다. 비밀번호에 특수문자가 포함된 경우 비밀번호를 작은따옴표로 묶어야 합니다.

      포털을 설치할 때 USERNAMEDATABASENAME을 설정했습니다. 기본적으로 둘 다 devportal입니다.
  2. 전체 Drupal 웹 루트 디렉터리의 백업을 만듭니다. 기본 설치 위치는 /var/www/html이지만 설치 시 변경했을 수 있습니다.
  3. 개발자 채널 서비스 DeveloperServices_x.y.z.tar 파일을 다운로드합니다. 여기서 x.y.z는 포털 버전 번호입니다.

    브라우저에서 Apigee에서 전송한 링크에서 파일을 다운로드하거나 링크를 복사한 후 다음 cURL 명령어에 추가하여 파일을 다운로드할 수 있습니다.
    > curl -kOL <여기에 링크 붙여넣기>

    참고: 포털이 외부 인터넷에 연결되어 있지 않은 서버에 있는 경우 액세스 권한이 있는 서버에서 이 단계를 실행합니다.

    http://community.apigee.com/content/apigee-customer-support로 이동하여 지원 포털 로그인을 선택하여 개발자 채널 서비스 업그레이드 .tar 파일을 요청합니다. 지원 포털에 계정이 없는 경우 지원 포털에 로그인을 선택한 다음 로그인 페이지에서 급한가요? 여기에서 지원 티켓을 제출하세요.
  4. 인터넷에 연결된 서버의 업그레이드:
    1. 포털 업그레이드 파일을 추출합니다.
      > tar -xvf <tar FILE>

      이 명령어를 실행하면 DeveloperServices-4.x.y.z라는 새 디렉터리가 생성됩니다.
    2. DeveloperServices-4.x.y.z 디렉터리로 변경합니다.
    3. 다음 명령어를 사용하여 최신 Drupal 버전을 다운로드합니다.
      > drush dl drupal

      이 명령어는 drupal-x.y라는 디렉터리를 만듭니다. 여기서 x.y는 Drupal의 현재 버전에 해당합니다.
    4. networked-update.sh 스크립트를 실행합니다.
      > ./networked-update.sh

      파일 권한에 따라 sudo를 사용하여 이 명령어를 실행하거나 관리자 권한으로 실행해야 할 수 있습니다.
    5. Drupal 업데이트 알림을 받으려면 Drupal 업데이트 관리자 모듈이 사용 설정되어 있는지 확인하세요. Drupal 메뉴에서 모듈을 선택하고 업데이트 관리자 모듈까지 아래로 스크롤합니다. 사용 설정되어 있지 않으면 사용 설정합니다.

      사용 설정한 후에는 보고서 > 사용 가능한 업데이트 메뉴 항목을 사용하여 사용 가능한 업데이트를 확인할 수 있습니다.

      보고서 > 사용 가능한 업데이트 > 설정 메뉴 항목을 사용하여 업데이트가 있을 때 이메일을 보내도록 모듈을 구성하고 업데이트 확인 빈도를 설정합니다.
  5. 인터넷에 연결되어 있지 않은 서버에서 업그레이드하는 경우:
    1. 개발자 채널 서비스 DeveloperServices_x.y.z.tar 파일을 다운로드한 서버에서 포털 업그레이드 파일을 추출합니다.
      > tar -xvf <tar FILE>

      이 명령어를 추출하면 DeveloperServices-4.x.y.z라는 새 디렉터리가 생성됩니다.
    2. DeveloperServices-4.x.y.z 디렉터리로 변경합니다.
    3. non-networked-update.sh 스크립트를 실행합니다.
      > ./non-networked-update.sh

      파일 권한에 따라 sudo를 사용하여 이 명령어를 실행하거나 관리자로 실행해야 할 수 있습니다.

      이 명령어는 필요한 모든 업데이트 파일을 다운로드하여 devportal-update.tgz라는 단일 파일로 패키징하고 선택한 위치에 파일을 씁니다.
    4. devportal-update.tgz를 포털을 실행하는 대상 서버에 복사합니다.
      참고: devportal-update.tgz를 대상 서버의 웹 루트에 복사하지 마세요.
    5. devportal-update.tgz 파일을 현재 디렉터리로 압축해제합니다.
      > tar -xzf /path/to/devportal-update.tgz
    6. developer-update 디렉터리로 변경합니다.
    7. 다음 명령어를 실행하여 업데이트를 설치합니다.
      > ./install-update.sh
    8. 프롬프트에 대답합니다.

업그레이드가 완료되었습니다.