Edge apigee-setup 유틸리티 설치

Private Cloud용 Edge v. 4.16.09

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

/opt/apigee에서 심볼릭 링크 만들기

Edge는 /opt/apigee 디렉터리에 모든 파일을 설치합니다. 이 디렉터리는 변경할 수 없습니다. 그러나 원하는 경우 심볼릭 링크를 만들어 /opt/apigee를 다른 위치에 매핑할 수 있습니다.

심볼릭 링크를 만들려면 먼저 'apigee'라는 사용자와 그룹을 만들어야 합니다. 이는 Edge 설치 프로그램에서 생성된 동일한 그룹 및 사용자입니다.

심볼릭 링크를 만들려면 bootstrap_4.16.09.sh 파일을 다운로드하기 전에 다음 단계를 수행합니다. 다음 단계를 모두 루트로 수행해야 합니다.

  1. 'apigee' 사용자 및 그룹을 만듭니다.
    > groupadd -r apigee
    > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee
  2. /opt/apigee에서 원하는 설치 루트로 연결되는 심볼릭 링크를 만듭니다.
    > ln -Ts /srv/myInstallDir /opt/apigee
    여기서 /srv/myInstallDir은 원하는 Edge 파일 위치입니다.
  3. 설치 루트와 심볼릭 링크를 'apigee' 사용자로 변경합니다.
    > chown -h apigee:apigee /srv/myInstallDir /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를 다시 사용 설정합니다.

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

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

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

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

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

    I = Install OpenJDK 1.8 (기본값)
    C = Java 설치 없이 계속
    Q = Quit. 이 옵션의 경우 자바를 직접 설치해야 합니다.

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

    저장소 콘텐츠를 보려면 다음 명령어를 사용하세요.
    > sudo yum -v repolist 'apigee*'
  6. apigee-service를 사용하여 apigee-setup 유틸리티를 설치합니다.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  7. apigee-setup을 사용하여 노드에 Edge 구성요소를 설치하고 구성합니다. 자세한 내용은 노드에 Edge 구성요소 설치하기를 참고하세요.

외부 인터넷에 연결되지 않은 노드에 Edge Apigee-setup 유틸리티 설치

Edge 노드가 방화벽으로 보호되거나 어떤 방식으로든 인터넷을 통해 Apigee 저장소에 액세스하는 것이 금지된 경우 Apigee 저장소의 로컬 저장소 또는 미러를 만들어야 합니다. 그러면 모든 노드에서 해당 미러에 액세스할 수 있어야 합니다. 생성된 후 노드는 로컬 미러에 액세스하여 Edge를 설치할 수 있습니다.

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

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

로컬 Apigee 저장소 만들기

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

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

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

    참고: 기존 저장소를 4.16.09로 업데이트하려면 apigee-mirror:
    > /opt/apigee-apigee
  8. 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 유틸리티를 설치하는 방법을 설명합니다.
  9. (선택사항) 로컬 저장소의 Edge를 로컬 저장소를 호스팅하는 동일한 노드에 설치하려면 먼저 다음 명령어를 실행해야 합니다.
    1. 로컬 저장소에서 bootstrap_4.16.09.sh를 실행하여 apigee-service 유틸리티를 설치합니다.
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-m
    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.16.09.tar.gz라는 단일 .tar 파일로 패키징합니다.

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

    이 명령어는 .tar 파일이 있는 디렉터리에 repos라는 새 디렉터리를 만듭니다. 예를 들면 /tmp/repos입니다.
  5. /tmp/repos의 Edge apigee-service 유틸리티와 종속 항목을 설치합니다.
    > sudo bash /tmp/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/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.16.09.sh 파일을 /tmp/bootstrap_4.16.09.sh에 다운로드합니다.
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.09.

  6. 원격 노드에 Edge apigee-service 유틸리티와 종속 항목을 설치합니다.
    > sudo bash /tmp/bootstrap_4.16.09.sh apigeerepohost=remoteRepo: 3939 apigeeuser=uName apigeepassword=pWord apigeeuser=http://

    apigee protocol: http://

  7. 원격 노드에서 apigee-service를 사용하여 apigee-setup 유틸리티를 설치합니다.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. apigee-setup을 사용하여 원격 노드에 Edge 구성요소를 설치하고 구성하세요. 자세한 내용은 노드에 Edge 구성요소 설치하기를 참고하세요.

로컬 Apigee 저장소 업데이트

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

  1. Edge bootstrap_4.16.09.sh 파일을 /tmp/bootstrap_4.16.09.sh에 다운로드합니다.
    > curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
  2. Edge bootstrap_4.16.09.sh 파일을 실행합니다.
    > sudo bash /tmp/bootstrap_4.16.09.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.16.09 저장소에서 Edge 4.16.01/4.16.05 추가 또는 업데이트

4.16.09 저장소에서 Edge 4.16.01 및 4.16.05 설치를 유지해야 하는 경우 모든 버전이 포함된 저장소를 유지할 수 있습니다. 이 저장소에서 모든 Edge 버전을 설치할 수 있습니다.

4.16.09 저장소에 4.16.01/4.16.05를 추가하려면 다음 단계를 따르세요.

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

    아래 양식에 결과가 표시됩니다. 여기서 xyz는 빌드 번호입니다.
    apigee-mirror-4.0.0
    .0.0
  2. apigee-mirror 유틸리티를 사용하여 Edge 4.16.01 또는 4.16.05를 저장소에 다운로드합니다. 명령어에 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
    1.1.0.1.나중에 동일한 명령어.4.6.1.4.1.4.1.나중에 동일한 명령어를 업데이트.
  3. /opt/apigee/data/apigee-mirror/repos 디렉터리를 살펴보고 파일 구조를 확인합니다.
    > ls /opt/apigee/data/apigee-mirror/repos

    다음과 같은 파일과 디렉터리를 볼 수 있습니다.
    apigee apigee-repo-1.0-6.x86_64.rpm your bootstrapstra bootstrap68.shp_boot65.rpm 파일명 bootstrap0stra

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

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

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

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

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