Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

Edge apigee-setup 유틸리티 설치

프라이빗 클라우드용 Edge v4.18.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를 설치하려면 다음 안내를 따르세요.

Apigee 저장소에 액세스하는 데 사용하는 Apigee의 사용자 이름과 비밀번호를 가져옵니다. Apigee ftp 사이트에 기존 사용자 이름:비밀번호가 있는 경우 해당 사용자 인증 정보를 사용할 수 있습니다.
루트로 노드에 로그인하여 Edge RPM을 설치합니다.
참고: RPM 설치에는 루트 액세스 권한이 필요하지만 루트 액세스 권한 없이 Edge 구성을 수행할 수 있습니다.
yum-utils 및 yum-plugin-priorities를 설치합니다.
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
위에서 설명한 대로 SELinux를 사용 중지합니다.
위에서 설명한 대로 EPEL 저장소를 사용 설정합니다.
위에 설명된 대로 libdb4 버전을 확인합니다.
Oracle 7.x에 설치하는 경우 다음 명령어를 실행합니다.
> sudo yum-config-manager --enable ol7_optional_latest
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
Edge bootstrap_4.18.01.sh 파일을 /tmp/bootstrap_4.18.01.sh에 다운로드합니다.
> curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.
> sudo bash /tmp/bootstrap_4.18.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*'
apigee-service를 사용하여 apigee-setup 유틸리티를 설치합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
apigee-setup을 사용하여 노드에 Edge 구성요소를 설치하고 구성합니다. 자세한 내용은 노드에 Edge 구성요소 설치를 참조하세요.

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

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

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

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

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

로컬 Apigee 저장소 만들기

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

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

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

참고: 기존 저장소를 4.18.01로 업데이트하는 경우 apigee-mirror만 업데이트하면 됩니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
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 유틸리티를 설치하는 방법을 설명합니다.
(선택사항) 로컬 저장소에서 로컬 저장소를 호스팅하는 동일한 노드에 Edge를 설치하려면 먼저 다음 명령어를 실행해야 합니다.
1. 로컬 저장소에서 bootstrap_4.18.01.sh를 실행하여 apigee-service 유틸리티를 설치합니다.
  > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.18.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 파일에서 설치:

로컬 저장소가 있는 노드에서 다음 명령어를 사용하여 로컬 저장소를 /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz라는 단일 .tar 파일로 패키징합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
Edge를 설치하려는 노드에 .tar 파일을 복사합니다. 예를 들어 새 노드의 /tmp 디렉터리에 복사합니다.
새 노드에서 위에 설명된 대로 SELinux를 사용 중지합니다.
새 노드에서 위에서 설명한 대로 EPEL 저장소를 사용 설정합니다.
새 노드에서 외부 인터넷 저장소를 사용 중지했는지 확인합니다. 다음 명령어를 실행하면 모든 외부 저장소가 사용 중지된 것으로 표시되지만 로컬 Apigee 저장소와 내부 저장소는 사용 설정되어야 합니다.
> sudo yum repolist
새 노드에서 yum-utils 및 yum-plugin-priorities를 설치합니다.
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
새 노드에서 위에 설명된 대로 libdb4 버전을 확인합니다.
Oracle 7.x에 설치하는 경우 다음 명령어를 실행합니다.
> sudo yum-config-manager --enable ol7_optional_latest
AWS에 설치하는 경우 다음 yum-configure-manager 명령어를 실행합니다.
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
새 노드에서 파일을 /tmp 디렉터리에 untar합니다.
> tar -xzf apigee-4.18.01.tar.gz

이 명령어는 .tar 파일이 포함된 디렉터리에 repos라는 새 디렉터리를 만듭니다. 예를 들면 /tmp/repos입니다.
/tmp/repos에서 Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.
> sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

이 명령어에 저장소 디렉터리의 경로를 포함해야 합니다.
apigee-service를 사용하여 apigee-setup 유틸리티를 설치합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
apigee-setup을 사용하여 노드에 Edge 구성요소를 설치하고 구성합니다. 자세한 내용은 노드에 Edge 구성요소 설치를 참조하세요.

Nginx 웹 서버를 사용하여 저장소에서 설치합니다.

저장소 노드에 Nginx 웹 서버를 설치합니다.
> opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
기본적으로 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
기본적으로 저장소에는 admin:admin의 사용자 이름:비밀번호가 필요합니다. 이 사용자 인증 정보를 변경하려면 다음 환경 변수를 설정합니다.
MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord
새 노드에 yum-utils 및 yum-plugin-priorities를 설치합니다.
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
새 노드에서 위에 설명된 대로 SELinux를 사용 중지합니다.
새 노드에서 위에서 설명한 대로 EPEL 저장소를 사용 설정합니다.
새 노드에서 위에 설명된 대로 libdb4 버전을 확인합니다.
원격 노드에서 Edge bootstrap_4.18.01.sh 파일을 /tmp/bootstrap_4.18.01.sh에 다운로드합니다.
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh

여기서 uName:pWord는 위에서 저장소에 설정한 사용자 이름과 비밀번호이고 remoteRepo는 저장소 노드의 IP 주소 또는 DNS 이름입니다.
원격 노드에서 Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.
> sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

여기서 uName:pWord는 저장소 사용자 이름과 비밀번호입니다.
원격 노드에서 apigee-service를 사용하여 apigee-setup 유틸리티를 설치합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
apigee-setup을 사용하여 원격 노드에 Edge 구성요소를 설치하고 구성합니다. 자세한 내용은 노드에 Edge 구성요소 설치를 참조하세요.

로컬 Apigee 저장소 업데이트

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

Edge bootstrap_4.18.01.sh 파일을 /tmp/bootstrap_4.18.01.sh에 다운로드합니다.
> curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
Edge bootstrap_4.18.01.sh 파일을 실행하세요:
> sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

여기서 uName:pWord는 Apigee에서 받은 사용자 이름과 암호입니다. pWord를 생략하면 입력하라는 메시지가 표시됩니다.
apigee-mirror를 업데이트합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
동기화를 수행합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
전체 저장소를 원하는 경우:
> /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.18.01 저장소에서 Edge 4.16.0x/4.17.0x 추가 또는 업데이트

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

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

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

아래 형식의 결과가 표시됩니다. 여기서 xyz는 빌드 번호입니다.
apigee-mirror-4.18.01-0.0.xyz
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 저장소를 업데이트합니다.
/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.shbootstrap_4.17.01.sh bootstrap_4.17.05.sh bootstrap_4.17.09.sh bootstrap_4.18.01.sh thirdparty

모든 버전의 Edge에 대한 부트스트랩 파일이 있는지 확인합니다. apigee 디렉터리에는 각 Edge 버전에 대한 별도의 디렉터리도 포함되어 있습니다.
저장소를 .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 웹 서버를 사용하여 저장소에서 설치"의 나머지 단계를 따르세요.