Edge apigee-setup 유틸리티 설치

프라이빗 클라우드용 Edge v. 4.17.01

노드에 Edge를 설치하려면 먼저 Edge apigee-setup 유틸리티를 설치합니다. 노드에 외부 인터넷 연결이 없는 환경에 있는 경우 Apigee 저장소의 로컬 사본도 설치해야 합니다.

기본 설치 디렉터리: /opt/apigee

Edge는 /opt/apigee 디렉터리에 모든 파일을 설치합니다. 이 디렉터리는 변경할 수 없습니다. 하지만 원하는 경우 심볼릭 링크를 만들어 /opt/apigee를 다른 위치에 매핑할 수 있습니다. 자세한 내용은 설치 요구사항을 참조하세요.

선행 조건: SELinux 사용 중지

Edge apigee-setup 유틸리티 또는 Edge 구성요소를 설치하려면 먼저 SELinux를 사용 중지하거나 허용 모드로 설정해야 합니다. 필요한 경우 Edge를 설치한 후 SELinux를 다시 사용 설정할 수 있습니다.

  • SELinux를 허용 모드로 일시적으로 설정하려면 다음 명령어를 실행합니다.
    1. Linux 6.x 운영체제:
      echo 0 > /selinux/enforce

      Edge를 설치한 후 SELinux를 다시 사용 설정하려면 다음 명령어를 실행합니다.
      echo 1 > /selinux/enforce
    2. Linux 7.x 운영체제:
      setenforce 0

      Edge를 설치한 후 SELinux를 다시 사용 설정하려면 다음 안내를 따르세요.
      setenforce 1
  • SELinux를 영구적으로 사용 중지하거나 허용 모드로 설정하려면 다음 안내를 따르세요.
    1. 편집기에서 /etc/sysconfig/selinux를 엽니다.
    2. SELINUX=disabled 또는 SELINUX=permissive를 설정합니다.
    3. 수정사항을 저장합니다.
    4. 노드를 다시 시작합니다.
    5. 필요한 경우 이 절차를 반복하여 SELINUX=enabled를 설정하여 Edge 설치 후 SELinux를 다시 사용 설정합니다.

기본 요건: EPEL 저장소 사용 설정

Edge를 설치하거나 업데이트하려면 Enterprise Linux용 추가 패키지 (또는 EPEL)를 사용 설정해야 합니다. 사용하는 명령어는 RedHat/CentOS 버전에 따라 다릅니다.

  • RedHat/CentOS 7.x의 경우:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; sudo rpm -ivh epel-release-latest-7.noarch.rpm
  • RedHat/CentOS 6.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; sudo rpm -ivh epel-release-latest-6.noarch.rpm

외부 인터넷 연결이 있는 노드에 Edge apigee-setup 유틸리티 설치

외부 인터넷 연결이 있는 노드에 Edge를 설치하려면 다음 안내를 따르세요.

  1. Apigee 저장소에 액세스하는 데 사용하는 Apigee의 사용자 이름과 비밀번호를 가져옵니다. Apigee ftp 사이트에 기존 사용자 이름:비밀번호가 있는 경우 해당 사용자 인증 정보를 사용할 수 있습니다.
  2. 루트로 노드에 로그인하여 Edge RPM을 설치합니다.
    참고: RPM 설치에는 루트 액세스 권한이 필요하지만 루트 액세스 권한 없이 Edge 구성을 수행할 수 있습니다.
  3. 위에서 설명한 대로 SELinux를 사용 중지합니다.
  4. 위에서 설명한 대로 EPEL 저장소를 사용 설정합니다.
  5. Edge bootstrap_4.17.01.sh 파일을 /tmp/bootstrap_4.17.01.sh에 다운로드합니다.
    > curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
  6. Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.
    > sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord

    여기서 uName:pWord는 Apigee에서 받은 사용자 이름과 비밀번호입니다. pWord를 생략하면 입력하라는 메시지가 표시됩니다.

    기본적으로 설치 프로그램은 Java 1.8이 설치되어 있는지 확인합니다. 설치되어 있지 않으면 자동으로 설치됩니다. JAVA_FIX 옵션을 사용하여 Java 설치를 처리하는 방법을 지정합니다. JAVA_FIX는 다음 값을 사용합니다.

    I = OpenJDK 1.8 설치 (기본값)
    C = Java를 설치하지 않고 계속
    Q = 종료 이 옵션을 사용하려면 Java를 직접 설치해야 합니다.

    apigee-service 유틸리티를 설치하면 Apigee 저장소를 정의하는 /etc/yum.repos.d/apigee.repo 파일이 생성됩니다. 정의 파일을 보려면 다음 명령어를 사용합니다.
    > cat /etc/yum.repos.d/apigee.repo

    저장소 콘텐츠를 보려면 다음 명령어를 사용합니다.
    > sudo yum -v repolist 'apigee*'
  7. (CentOS-6.x 및 RedHat-6.x만 해당) 모든 Qpid 노드에서 다음 명령어를 실행하여 올바른 Qpid 버전을 다운로드합니다.
    > yum install apigee-qpidd --disablerepo=epel
  8. apigee-service를 사용하여 apigee-setup 유틸리티를 설치합니다.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  9. apigee-setup을 사용하여 노드에 Edge 구성요소를 설치하고 구성합니다. 자세한 내용은 노드에 Edge 구성요소 설치를 참조하세요.

외부 인터넷 연결이 없는 노드에 Edge apigee-setup 유틸리티 설치

Edge 노드가 방화벽 뒤에 있거나 다른 방식으로 인터넷을 통해 Apigee 저장소에 액세스할 수 없는 경우 Apigee 저장소의 로컬 저장소 또는 미러를 만들어야 합니다. 그런 다음 모든 노드에서 해당 미러에 액세스할 수 있어야 합니다. 생성된 노드는 해당 로컬 미러에 액세스하여 Edge를 설치할 수 있습니다.

내부 Apigee 저장소를 만들려면 Edge RPM 및 종속 항목을 다운로드할 수 있는 외부 인터넷 액세스 권한이 있는 노드가 필요합니다. 내부 저장소를 만든 후에는 다른 노드로 이동하거나 설치를 위해 Edge 노드에서 해당 노드에 액세스할 수 있도록 할 수 있습니다.

참고: Apigee는 공개 저장소에 모든 서드 파티 종속 항목을 호스팅하지 않습니다. 공개적으로 액세스할 수 있는 저장소에서 이러한 종속 항목을 다운로드하고 설치해야 합니다.

로컬 Edge 저장소를 만든 후 나중에 최신 Edge 출시 파일로 업데이트해야 할 수 있습니다. 다음 섹션에서는 로컬 저장소를 만들고 업데이트하는 방법을 설명합니다.

로컬 Apigee 저장소 만들기

로컬 Apigee 저장소를 만들려면 다음 안내를 따르세요.

  1. Apigee 저장소에 액세스하는 데 사용하는 Apigee의 사용자 이름과 비밀번호를 가져옵니다. Apigee ftp 사이트에 기존 사용자 이름:비밀번호가 있는 경우 해당 사용자 인증 정보를 사용할 수 있습니다.
  2. Edge RPM을 설치하려면 RedHat 또는 CentOS 노드에 루트로 로그인합니다.
    참고: RPM 설치에는 루트 액세스 권한이 필요하지만 루트 액세스 권한 없이 Edge 구성을 수행할 수 있습니다.

  3. yum-utils의 최신 버전이 있는지 확인합니다. > sudo yum update yum-utils
  4. 위에서 설명한 대로 SELinux를 사용 중지합니다.
  5. 위에서 설명한 대로 EPEL 저장소를 사용 설정합니다.
  6. Edge bootstrap_4.17.01.sh 파일을 /tmp/bootstrap_4.17.01.sh에 다운로드합니다.
    > curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
  7. (CentOS-6.x 및 RedHat-6.x만 해당) 다음 명령어를 실행하여 올바른 Qpid 버전을 다운로드합니다.
    > yum install apigee-qpidd --disablerepo=epel
  8. Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.
    > sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord

    여기서 uName:pWord는 Apigee에서 받은 사용자 이름과 비밀번호입니다. pWord를 생략하면 입력하라는 메시지가 표시됩니다.
  9. 노드에 apigee-mirror 유틸리티를 설치합니다.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

    참고: 기존 저장소를 4.17.01로 업데이트하는 경우 apigee-mirror만 업데이트하면 됩니다.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  10. apigee-mirror 유틸리티를 사용하여 Apigee 저장소를 /opt/apigee/data/apigee-mirror/repos/ 디렉터리에 동기화합니다.

    저장소 크기를 최소화하려면 --only-new-rpms를 포함하여 최신 RPM만 다운로드합니다. 다운로드하려면 약 1.6GB의 디스크 공간이 필요합니다.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    이전 RPM을 포함하여 전체 저장소를 다운로드하려면 --only-new-rpms를 생략합니다. 전체 다운로드에는 약 6GB의 디스크 공간이 필요합니다.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

    이제 Apigee 저장소의 로컬 사본이 있습니다. 다음 섹션에서는 로컬 저장소에서 Edge apigee-setup 유틸리티를 설치하는 방법을 설명합니다.
  11. (선택사항) 로컬 저장소에서 로컬 저장소를 호스팅하는 동일한 노드에 Edge를 설치하려면 먼저 다음 명령어를 실행해야 합니다.
    1. 로컬 저장소에서 bootstrap_4.17.01.sh를 실행하여 apigee-service 유틸리티를 설치합니다.
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. apigee-service를 사용하여 apigee-setup 유틸리티를 설치합니다.
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    3. apigee-setup을 사용하여 노드에 Edge 구성요소를 설치하고 구성합니다. 자세한 내용은 노드에 Edge 구성요소 설치를 참조하세요.

로컬 저장소에서 원격 노드에 apigee-setup 설치

로컬 저장소에서 Edge를 설치하는 방법에는 두 가지가 있습니다. 대신 다음 중 원하는 방법을 선택합니다.

  • 저장소의 .tar 파일을 만들고 .tar 파일을 노드에 복사한 후 .tar 파일에서 Edge를 설치합니다.
  • 다른 노드가 액세스할 수 있도록 로컬 저장소가 있는 노드에 웹 서버를 설치합니다. Apigee는 사용할 수 있는 Nginx 웹 서버를 제공하거나 자체 웹 서버를 사용할 수 있습니다.

.tar 파일에서 설치:

  1. 로컬 저장소가 있는 노드에서 다음 명령어를 사용하여 로컬 저장소를 /opt/apigee/data/apigee-mirror/apigee-4.17.01.tar.gz라는 단일 .tar 파일로 패키징합니다.

    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. Edge를 설치하려는 노드에 .tar 파일을 복사합니다. 예를 들어 새 노드의 /tmp 디렉터리에 복사합니다.
  3. 새 노드에서 위에 설명된 대로 SELinux를 사용 중지합니다.
  4. 새 노드에서 파일을 /tmp 디렉터리에 untar합니다.
    > tar -xzf apigee-4.17.01.tar.gz

    이 명령어는 .tar 파일이 포함된 디렉터리에 repos라는 새 디렉터리를 만듭니다. 예를 들면 /tmp/repos입니다.
  5. /tmp/repos에서 Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.
    > sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    이 명령어에 repos 디렉터리의 경로를 포함해야 합니다.
  6. apigee-service를 사용하여 apigee-setup 유틸리티를 설치합니다.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  7. apigee-setup을 사용하여 노드에 Edge 구성요소를 설치하고 구성합니다. 자세한 내용은 노드에 Edge 구성요소 설치를 참조하세요.

Nginx 웹 서버를 사용하여 저장소에서 설치합니다.

  1. 저장소 노드에 Nginx 웹 서버를 설치합니다.
    > opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. 기본적으로 Nginx는 localhost를 서버 이름으로 사용하고 포트 3939를 사용하도록 구성됩니다. 이 값을 변경하려면 다음 단계를 따르세요.
    1. 편집기에서 /opt/apigee/customer/application/mirror.properties를 엽니다. 파일이 없으면 만듭니다.
    2. 필요에 따라 다음 값을 설정합니다.
      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost
    3. Nginx를 다시 시작합니다.
      > /opt/nginx/scripts/apigee-nginx restart
  3. 기본적으로 저장소에는 admin:admin의 사용자 이름:비밀번호가 필요합니다. 이 사용자 인증 정보를 변경하려면 다음 환경 변수를 설정합니다.
    MIRROR_USERNAME=uName
    MIRROR_PASSWORD=pWord
  4. 새 노드에서 위에 설명된 대로 SELinux를 사용 중지합니다.
  5. 원격 노드에서 Edge bootstrap_4.17.01.sh 파일을 /tmp/bootstrap_4.17.01.sh에 다운로드합니다.
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh

    여기서 uName:pWord는 위에서 저장소에 설정한 사용자 이름과 비밀번호이고 remoteRepo는 저장소 노드의 IP 주소 또는 DNS 이름입니다.
  6. 원격 노드에서 Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.
    > sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    여기서 uName:pWord는 저장소 사용자 이름과 비밀번호입니다.
  7. 원격 노드에서 apigee-service를 사용하여 apigee-setup 유틸리티를 설치합니다.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. apigee-setup을 사용하여 원격 노드에 Edge 구성요소를 설치하고 구성합니다. 자세한 내용은 노드에 Edge 구성요소 설치를 참조하세요.

로컬 Apigee 저장소 업데이트

저장소를 업데이트하려면 최신 bootstrap_4.17.01.sh 파일을 다운로드한 후 새 동기화를 수행해야 합니다.

  1. Edge bootstrap_4.17.01.sh 파일을 /tmp/bootstrap_4.17.01.sh에 다운로드합니다.
    > curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
  2. thought Edge bootstrap_4.17.01.sh 파일을 실행합니다.
    > sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord

    여기서 uName:pWord는 Apigee에서 받은 사용자 이름과 비밀번호입니다. pWord를 생략하면 입력하라는 메시지가 표시됩니다.
  3. apigee-mirror를 업데이트합니다.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  4. 동기화를 수행합니다.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
  5. 전체 저장소를 다운로드하려면 다음 안내를 따르세요.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

로컬 Apigee 저장소 정리

로컬 저장소를 정리하면 /opt/apigee/data/apigee-mirror 및 /var/tmp/yum-apigee-*가 삭제됩니다.

로컬 저장소를 정리하려면 다음을 사용합니다.

> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean

4.17.01 저장소에 Edge 4.16.01/4.16.05/4.16.09 추가 또는 업데이트

4.17.01 저장소에서 Edge 4.16.0x 설치를 유지해야 하는 경우 모든 버전이 포함된 저장소를 유지할 수 있습니다. 그런 다음 해당 저장소에서 모든 버전의 Edge를 설치할 수 있습니다.

4.17.01 저장소에 4.16.0x를 추가하려면 다음 안내를 따르세요.

  1. 4.17.01 버전의 apigee-mirror 유틸리티가 설치되어 있는지 확인합니다.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

    아래 형식의 결과가 표시됩니다. 여기서 xyz는 빌드 번호입니다.
    apigee-mirror-4.17.01-0.0.xyz
  2. apigee-mirror 유틸리티를 사용하여 Edge 4.16.01/4.16.05/4.16.09를 저장소에 다운로드합니다. 명령어 앞에 apigeereleasever=4.16.01 또는 apigeereleasever=4.16.05를 추가하는 방법에 유의하세요.
    > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    나중에 필요한 버전 번호를 지정하여 4.16.05/4.16.09 저장소를 업데이트하려면 동일한 명령어를 사용합니다.
  3. /opt/apigee/data/apigee-mirror/repos 디렉터리를 검사하여 파일 구조를 확인합니다.
    > ls /opt/apigee/data/apigee-mirror/repos

    다음 파일과 디렉터리가 표시됩니다.
    apigee apigee-repo-1.0-6.x86_64.rpm bootstrap_4.16.01.sh bootstrap_4.16.05.sh bootstrap_4.17.01.sh thirdparty

    모든 Edge 버전에 대한 부트스트랩 파일이 있습니다. apigee 디렉터리에는 각 Edge 버전에 대한 별도의 디렉터리도 포함되어 있습니다.
  4. 저장소를 .tar 파일로 패키징하려면 다음 명령어를 사용합니다.
    > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

    이 명령어는 4.17.01 및 4.16.0x 저장소를 모두 동일한 .tar 파일로 패키징합니다. 저장소의 일부만 패키징할 수는 없습니다.

로컬 저장소 또는 .tar 파일에서 Edge를 설치하려면 다음 명령어 중 하나를 사용하여 올바른 부트스트랩 파일을 실행해야 합니다.

  • .tar 파일에서 설치하는 경우 저장소에서 올바른 부트스트랩 파일을 실행합니다.
    > sudo bash /tmp/repos/bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    설치를 완료하려면 위의 '.tar 파일에서 설치'의 나머지 단계를 따르세요.
  • Nginx 웹 서버를 사용하여 설치하는 경우 저장소에서 올바른 부트스트랩 파일을 다운로드한 후 실행합니다.
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.0X.sh -o /tmp/bootstrap_4.16.0X.sh
    > sudo bash /tmp/bootstrap_4.16.0X.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    설치를 완료하려면 위의 'Nginx 웹 서버를 사용하여 저장소에서 설치'의 나머지 단계를 따르세요.