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를 설치하거나 업데이트하거나 로컬 저장소를 만들려면 Extra Packages for 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 데이터베이스 사전 설치 요구사항 및 SymasLDAP 2.6.7 사전 설치 변경사항을 참고하세요.

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

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

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

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

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

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

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

   sudo bash /tmp/bootstrap_4.53.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만 다운로드하세요.

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

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

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

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

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

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

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