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. 필요한 경우 이 절차를 반복하여 SELINUX=enabled를 설정하여 Edge 설치 후 SELinux를 다시 사용 설정합니다.

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

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

• Red Hat/CentOS/Oracle 8.x의 경우:

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

• Red Hat/CentOS/Oracle 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 8/Rocky 8/Oracle 8 기본 요건

Red Hat Enterprise Linux (RHEL) 8을 실행하는 서버에 Edge를 설치하는 경우 설치를 실행하기 전에 다음 단계를 따르세요.

1. Extra Packages for Enterprise Linux (EPEL)를 사용 설정합니다.

   sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

2. Postgres 및 Nginx를 사용 중지합니다.

   sudo dnf module disable postgresql
   sudo dnf module disable nginx

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 데이터베이스 설치 전 요구사항 및 OpenLDAP 2.4 설치 전 변경사항을 참고하세요.

외부 인터넷 연결이 있는 노드에 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.53.00.sh 파일을 /tmp/bootstrap_4.53.00.sh로 다운로드합니다.

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

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

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

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 Edge 저장소: 로컬 Apigee 저장소 만들기에 설명된 대로
• 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.53.00.sh 파일을 /tmp/bootstrap_4.53.00.sh에 다운로드합니다.

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

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

   sudo bash /tmp/bootstrap_4.53.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.53.00.sh를 실행하여 apigee-service 유틸리티를 설치합니다.

      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.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.53.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.53.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.53.00.sh 파일을 다운로드한 다음 새 동기화를 수행해야 합니다.

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

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

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

2. Edge bootstrap_4.53.00.sh 파일을 실행합니다.

   sudo bash/tmp/bootstrap_4.53.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