Edge apigee-setup 유틸리티 설치

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

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

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

기본 요건: SELinux 사용 중지

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

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

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

    Edge를 설치 또는 업데이트하거나 로컬 저장소를 만들려면 Extra Packages for Enterprise Linux(EPEL)을(를) 사용 설정해야 합니다. Red Hat Enterprise Linux (RHEL) 9.x, Rocky Linux 9.x 또는 Oracle Linux 9.x의 경우 다음 명령어를 실행합니다.

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

    RHEL 9/Rocky 9/Oracle 9의 기본 요건

    Red Hat Enterprise Linux (RHEL) 9, Rocky 9 또는 Oracle 9를 실행하는 서버에 Edge를 설치하는 경우 설치를 실행하기 전에 다음 단계를 완료하세요.

    1. Extra Packages for Enterprise Linux(EPEL)을(를) 사용 설정합니다. 
      sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
    2. Postgres 및 Nginx를 사용 중지합니다. 
      sudo dnf module disable postgresql
sudo dnf module disable nginx

    PostgreSQL 및 LDAP의 사전 설치 변경사항은 각각 PostgreSQL 데이터베이스 사전 설치 요구사항 및 SymasLDAP 2.6.10 사전 설치 변경사항을 참조하세요.

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

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

    1. Apigee 저장소에 액세스하는 데 사용하는 사용자 이름과 비밀번호를 Apigee에서 가져옵니다. Apigee FTP 사이트의 기존 username:password가 있는 경우 해당 사용자 인증 정보를 사용할 수 있습니다.
    2. 루트로 노드에 로그인하여 Edge RPM을 설치합니다.
    3. SELinux를 사용 중지합니다.
    4. EPEL 저장소를 사용 설정합니다.
    5. RHEL 9/Rocky 9/Oracle 9에 설치하는 경우 RHEL 9/Rocky 9/Oracle 9의 기본 요건의 단계를 따르세요.
    6. Edge bootstrap_4.54.00.sh 파일을 /tmp/bootstrap_4.54.00.sh에 다운로드합니다. 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    7. Edge apigee-service 유틸리티 및 종속 항목을 설치합니다. 
      sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

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

      Apigee 프라이빗 클라우드용 Edge 4.54.00에는 노드에 Java 17과 Java 21이 모두 설치된 이중 Java 지원이 필요합니다. 부트스트랩 스크립트를 실행하기 전에 Java 17과 Java 21을 모두 설치해야 합니다. 설치 프로그램은 두 JDK 버전이 모두 설치되어 있는지 확인만 하며 Java를 자동으로 설치하지는 않습니다.

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

      cat /etc/yum.repos.d/apigee.repo

      저장소 콘텐츠를 보려면 다음 명령어를 사용합니다.

      sudo yum -v repolist 'apigee*'
    8. apigee-service를 사용하여 apigee-setup 유틸리티를 설치합니다.
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    9. apigee-setup을 사용하여 노드에 Edge 구성요소를 설치하고 구성합니다. 자세한 내용은 노드에 Edge 구성요소 설치를 참조하세요.

    문제 해결

    외부 인터넷 연결이 있는 노드에 설치하려고 하면 다음 오류가 하나 이상 발생할 수 있습니다.

    Cannot open: https://username@software.apigee.com/apigee-repo-4.53.00.rpm

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

    다음 표에는 이러한 오류에 대한 몇 가지 가능한 해결 방법이 나와 있습니다.

    오류 유형 가능한 해결 방법
    비밀번호에 잘못된 문자가 포함되어 있습니다. Apigee 비밀번호에 특수문자를 사용하지 마세요.
    연결 문제

    다음 ncat 명령어를 실행하여 네트워크 연결을 테스트합니다.

    nc -v software.apigee.com 443

    다음과 유사한 메시지가 표시됩니다.

    Connection to software.apigee.com 443 port [tcp/https] succeeded!

    nc이(가) 설치되어 있지 않은 경우 다음 telnet 명령어를 실행할 수 있습니다.

    telnet software.apigee.com 443

    명령어가 성공하면 Ctrl+C를 사용하여 열린 연결을 중단할 수 있습니다.

    명령어가 실패하면 네트워크 연결이 제한되거나 연결이 되지 않습니다. 네트워크 관리자에게 문의하세요.
    잘못된 사용자 인증 정보

    사용자 이름과 비밀번호가 올바른지 확인합니다.

    예를 들어 Apigee 사용자 이름과 비밀번호로 다음 명령어를 사용하려고 할 때 오류가 발생하는지 확인합니다.

    curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
    프록시 문제 로컬 구성에서 이그레스 HTTP 프록시를 사용하며 동일한 구성을 yum 패키지 관리자로 확장하지 않았습니다. 환경 변수를 확인합니다. 
    echo $http_proxy
echo $https_proxy

    이그레스 HTTP 프록시의 경우 다음 옵션 중 하나를 사용해야 합니다.

    • /etc/yum.conf에 HTTP 프록시 구성을 추가합니다.
    • /etc/environment에 전역 HTTP 프록시 구성을 추가합니다.

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

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

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

    로컬 Apigee 저장소 만들기

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

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

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

    1. Apigee 저장소에 액세스하는 데 사용하는 사용자 이름과 비밀번호를 Apigee에서 가져옵니다. Apigee FTP 사이트의 기존 사용자 이름:비밀번호가 있는 경우 해당 사용자 인증 정보를 사용할 수 있습니다.
    2. 루트로 노드에 로그인하여 Edge RPM을 설치합니다.
    3. 위에서 설명한 대로 SELinux를 사용 중지합니다.
    4. Edge bootstrap_4.54.00.sh 파일을 /tmp/bootstrap_4.54.00.sh에 다운로드합니다. 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    5. Edge apigee-service 유틸리티 및 종속 항목을 설치합니다. 
      sudo bash /tmp/bootstrap_4.54.00.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만 다운로드합니다.

    8. (선택사항) 로컬 저장소를 호스팅하는 동일한 노드에 로컬 저장소에서 Edge를 설치하려면 먼저 다음 명령어를 실행해야 합니다.
      1. 로컬 저장소에서 bootstrap_4.54.00.sh를 실행하여 apigee-service 유틸리티를 설치합니다. 
        sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.54.00.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.54.00.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. apigee-service를 사용하여 apigee-setup 유틸리티를 설치합니다. 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    7. 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. 새 노드에서 EPEL 저장소가 로컬로 사용 설정되어 있는지 확인합니다.
    5. 새 노드에서 위에서 설명한 대로 libdb4 버전을 확인합니다.
    6. 원격 노드에서 Edge apigee-service 유틸리티 및 종속 항목을 설치합니다. 
      sudo bash /tmp/bootstrap_4.54.00.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.54.00.sh 파일을 다운로드한 후 새 동기화를 실행해야 합니다.

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

    1. Edge bootstrap_4.54.00.sh 파일을 /tmp/bootstrap_4.54.00.sh에 다운로드합니다. 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    2. Edge bootstrap_4.54.00.sh 파일을 실행합니다. 
      sudo bash/tmp/bootstrap_4.54.00.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