Edge apigee-setup 유틸리티 설치

프라이빗 클라우드용 Edge v4.19.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 운영체제:

     sudo echo 0 > /selinux/enforce

     Edge를 설치한 후 SELinux를 다시 사용 설정하려면 다음 안내를 따르세요.

     sudo echo 1 > /selinux/enforce

  2. Linux 7.x 운영체제:

     sudo setenforce 0

     Edge를 설치한 후 SELinux를 다시 사용 설정하려면 다음 안내를 따르세요.

     sudo setenforce 1

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

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

Edge를 설치 또는 업데이트하거나 로컬 저장소를 만들려면 엔터프라이즈 Linux용 추가 패키지 (또는 EPEL)를 사용 설정해야 합니다. 사용하는 명령어는 RedHat/CentOS 버전에 따라 다릅니다.

• RedHat/CentOS/Oracle 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/Oracle 6.x의 경우:

  wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm
  sudo rpm -ivh epel-release-latest-6.noarch.rpm

기본 요건: RedHat 7.4 및 CentOS 7.4에서 libdb4 라이브러리 버전 확인

RedHat 7.4 및 CentOS 7.4에서 설치하기 전에 libdb4 RPM 버전을 확인합니다. Edge에는 버전 4.8이 필요하며 일부 RedHat 7.4 및 CentOS 7.4 버전은 이후 버전과 함께 제공됩니다. 최신 버전이 있으면 제거하고 Edge 설치 프로그램에서 버전 4.8을 설치합니다.

다음 명령어를 사용하여 버전을 확인할 수 있습니다.

rpm -qa | grep libdb4

libdb4 RPM 버전이 버전 4.8보다 최신 버전이면 제거합니다.

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

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

1. Apigee 저장소에 액세스하는 데 사용하는 Apigee의 사용자 이름과 비밀번호를 가져옵니다. Apigee FTP 사이트에 대한 기존 username:password가 있는 경우 해당 사용자 인증 정보를 사용할 수 있습니다.
2. 루트로 노드에 로그인하여 Edge RPM을 설치합니다.
   
3. yum-utils와 yum-plugin-priorities를 설치합니다.

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

4. 위에서 설명한 대로 SELinux를 사용 중지합니다.
5. 위에서 설명한 대로 EPEL 저장소를 사용 설정합니다.
6. 위에서 설명한 대로 libdb4 버전을 확인합니다.
7. Oracle 7.x에 설치하는 경우 다음 명령어를 실행합니다.

   sudo yum-config-manager --enable ol7_optional_latest

8. AWS에 설치하는 경우 다음 yum-configure-manager 명령어를 실행합니다.

   yum update rh-amazon-rhui-client.noarch
   sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

9. Edge bootstrap_4.19.01.sh 파일을 /tmp/bootstrap_4.19.01.sh에 다운로드합니다.

   curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh

10. Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.

    sudo bash /tmp/bootstrap_4.19.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*'

11. apigee-service를 사용하여 apigee-setup 유틸리티를 설치합니다.
    

    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

12. apigee-setup을 사용하여 노드에 Edge 구성요소를 설치하고 구성합니다. 자세한 내용은 노드에 Edge 구성요소 설치를 참조하세요.

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

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

인터넷에 연결되지 않은 노드의 Apigee Edge 설치 프로세스에는 다음 로컬 저장소에 대한 액세스 권한이 필요합니다.

• Apigee Edge 저장소: 로컬 Apigee 저장소 만들기에 설명된 대로 만듭니다.
• Yum 저장소 (yum-utils 및 yum-plugin-priorities와 같은 유틸리티용): 운영팀에서 이를 설정할 수 있어야 합니다.
• Extra Packages for Enterprise Linux (또는 EPEL): 운영팀에서 이를 설정할 수 있어야 합니다.

로컬 Apigee 저장소 만들기

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

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

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

1. Apigee 저장소에 액세스하는 데 사용하는 Apigee의 사용자 이름과 비밀번호를 가져옵니다. Apigee ftp 사이트에 기존 사용자 이름:비밀번호가 있는 경우 해당 사용자 인증 정보를 사용할 수 있습니다.
2. Edge RPM을 설치하려면 노드에 루트로 로그인합니다.
   
3. 위에서 설명한 대로 SELinux를 사용 중지합니다.
4. Edge bootstrap_4.19.01.sh 파일을 /tmp/bootstrap_4.19.01.sh에 다운로드합니다.

   curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh

5. Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.
   

   sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

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

6. 노드에 apigee-mirror 유틸리티를 설치합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

7. 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 유틸리티를 설치하는 방법을 설명합니다.

8. (선택사항) 로컬 저장소에서 로컬 저장소를 호스팅하는 동일한 노드에 Edge를 설치하려면 먼저 다음 명령어를 실행해야 합니다.
   1. 로컬 저장소에서 bootstrap_4.19.01.sh를 실행하여 apigee-service 유틸리티를 설치합니다.

      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.19.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 파일에서 설치

.tar 파일에서 설치하려면 다음 단계를 따르세요.

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

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

2. Edge를 설치하려는 노드에 .tar 파일을 복사합니다. 예를 들어 새 노드의 /tmp 디렉터리에 복사합니다.
3. 새 노드에서 위에 설명된 대로 SELinux를 사용 중지합니다.
4. 새 노드에서 로컬 Yum 유틸리티 저장소와 EPEL 저장소에 액세스할 수 있는지 확인합니다.
5. 모든 외부 인터넷 저장소가 사용 중지되었는지 다시 한번 확인합니다. 인터넷 액세스가 없는 머신에 설치하는 경우 사용 중지되어 있어야 합니다.

   sudo yum repolist

   모든 외부 저장소는 사용 중지해야 하지만 로컬 Apigee 저장소와 내부 저장소는 사용 설정해야 합니다.

6. 새 노드에서 로컬 저장소의 yum-utils 및 yum-plugin-priorities를 설치합니다.

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

   Yum 도구를 설치하려면 조직 내 운영팀 또는 다른 그룹에서 로컬 저장소를 설정해야 합니다.

7. 새 노드에서 위에 설명된 대로 libdb4 버전을 확인합니다.
8. Oracle 7.x에 설치하는 경우 다음 명령어를 실행합니다.

   sudo yum-config-manager --enable ol7_optional_latest

9. AWS에 설치하는 경우 다음 yum-configure-manager 명령어를 실행합니다.

   sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

10. 새 노드에서 파일의 tar를 /tmp 디렉터리에 해제합니다.

    tar -xzf apigee-4.19.01.tar.gz

    이 명령어는 .tar 파일이 포함된 디렉터리에 repos라는 새 디렉터리를 만듭니다. 예를 들면 /tmp/repos.입니다.

11. /tmp/repos에서 Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.

    sudo bash /tmp/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    이 명령어에 repos 디렉터리의 경로를 포함합니다.

12. apigee-service을 사용하여 apigee-setup 유틸리티를 설치합니다.

    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

13. apigee-setup를 사용하여 노드에 Edge 구성요소를 설치하고 구성합니다. 자세한 내용은 노드에 Edge 구성요소 설치를 참조하세요.

Nginx 웹 서버를 사용하여 저장소에서 설치

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. 새 노드에 yum-utils 및 yum-plugin-priorities를 설치합니다.

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

5. 새 노드에서 위에 설명된 대로 SELinux를 사용 중지합니다.
6. 새 노드에서 로컬 EPEL 저장소가 사용 설정되어 있는지 확인합니다.
7. 새 노드에서 위에 설명된 대로 libdb4 버전을 확인합니다.
8. 원격 노드에서 Edge bootstrap_4.19.01.sh 파일을 /tmp/bootstrap_4.19.01.sh에 다운로드합니다.

   curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh

   여기서 uName:pWord는 위에서 저장소에 설정한 사용자 이름과 비밀번호이고 remoteRepo는 저장소 노드의 IP 주소 또는 DNS 이름입니다.

9. 원격 노드에서 Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.

   sudo bash /tmp/bootstrap_4.19.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

   여기서 uName:pWord는 저장소 사용자 이름과 비밀번호입니다.

10. 원격 노드에서 apigee-service을 사용하여 apigee-setup 유틸리티를 설치합니다.

    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

11. apigee-setup를 사용하여 원격 노드에 Edge 구성요소를 설치하고 구성합니다. 자세한 내용은 노드에 Edge 구성요소 설치를 참조하세요.

로컬 Apigee 저장소 업데이트

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

저장소를 업데이트하려면 다음 단계를 따르세요.

1. Edge bootstrap_4.19.01.sh 파일을 /tmp/bootstrap_4.19.01.sh에 다운로드합니다.

   curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh

2. Thinking - Thought! Edge bootstrap_4.19.01.sh 파일을 실행합니다.

   sudo bash/tmp/bootstrap_4.19.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.19.01 저장소에서 Edge 4.16.0x/4.17.0x 추가 또는 업데이트

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

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

1. 4.19.01 버전의 apigee-mirror 유틸리티가 설치되어 있는지 확인합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

   아래 형식의 결과가 표시됩니다. 여기서 xyz는 빌드 번호입니다.

   apigee-mirror-4.19.01-0.0.xyz

2. apigee-mirror 유틸리티를 사용하여 Edge 4.16.0x/4.17.0x를 저장소에 다운로드합니다. 원하는 버전을 명령어 앞에 붙이는 방법에 유의하세요.

   apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

   나중에 필요한 버전 번호를 지정하여 4.16.0x/4.17.0x 저장소를 업데이트하려면 동일한 명령어를 사용합니다.

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
   bootstrap_4.17.05.sh
   bootstrap_4.17.09.sh
   bootstrap_4.18.01.sh
   bootstrap_4.18.05.sh
   bootstrap_4.19.01.sh
   thirdparty

   모든 Edge 버전에 부트스트랩 파일이 있습니다. apigee 디렉터리에는 각 Edge 버전에 대한 별도의 디렉터리도 포함되어 있습니다.

4. 저장소를 .tar 파일로 패키징하려면 다음 명령어를 사용합니다.
   

   apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

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

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

• .tar 파일에서 설치하는 경우 저장소에서 올바른 부트스트랩 파일을 실행합니다.
  

  sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

  설치를 완료하려면 위의 '.tar 파일에서 설치'의 나머지 단계를 따릅니다.

• Nginx 웹 서버를 사용하여 설치하는 경우 저장소에서 올바른 부트스트랩 파일을 다운로드한 후 실행합니다.

  /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
  sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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