노드에 Edge를 설치하려면 먼저 Edge apigee-setup 유틸리티를 설치합니다. 노드에 외부 인터넷 연결이 없는 환경인 경우 Apigee 저장소의 로컬 사본도 설치해야 합니다.
기본 설치 디렉터리: /opt/apigee
Edge는 모든 파일을 /opt/apigee
디렉터리에 설치합니다. 이 디렉터리는 변경할 수 없습니다. 그러나 원하는 경우 /opt/apigee
를 다른 위치에 매핑하는 심볼릭 링크를 만들 수 있습니다. 자세한 내용은 설치 요구사항을 참고하세요.
기본 요건: SELinux 사용 중지
Edge apigee-setup
유틸리티 또는 Edge 구성요소를 설치하려면 먼저 SELinux를 사용 중지하거나 허용 모드로 설정해야 합니다. 필요한 경우 Edge를 설치한 후 SELinux를 다시 사용 설정할 수 있습니다.
- SELinux를 일시적으로 허용 모드로 설정하려면 다음 명령어를 실행합니다.
- Linux 6.x 운영체제:
sudo echo 0 > /selinux/enforce
Edge를 설치한 후 SELinux를 다시 사용 설정하려면 다음 단계를 따르세요.
sudo echo 1 > /selinux/enforce
- Linux 7.x 운영체제:
sudo setenforce 0
Edge를 설치한 후 SELinux를 다시 사용 설정하려면 다음 단계를 따르세요.
sudo setenforce 1
- Linux 6.x 운영체제:
- SELinux를 영구적으로 사용 중지하거나 허용 모드로 설정하려면 다음 단계를 따르세요.
- 편집기에서
/etc/sysconfig/selinux
을 엽니다. SELINUX=disabled
또는SELINUX=permissive
를 설정합니다.- 수정사항을 저장합니다.
- 노드를 다시 시작합니다.
- 필요한 경우 이 절차를 반복하여
SELINUX=enabled
를 설정하여 Edge 설치 후 SELinux를 다시 사용 설정합니다.
- 편집기에서
기본 요건: EPEL 저장소 사용 설정
Edge를 설치하거나 업데이트하거나 로컬 저장소를 만들려면 Enterprise 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 사이트에 기존 username:password가 있는 경우 해당 사용자 인증 정보를 사용할 수 있습니다.
- 루트로 노드에 로그인하여 Edge RPM을 설치합니다.
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.50.00.sh
파일을/tmp/bootstrap_4.50.00.sh
로 다운로드합니다.curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
- Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.
sudo bash /tmp/bootstrap_4.50.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*'
- Apigee-service를 사용하여 Apigee-setup 유틸리티를 설치하세요.
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- apigee-setup을 사용하여 노드에 Edge 구성요소를 설치하고 구성합니다. 자세한 내용은 노드에 Edge 구성요소 설치를 참고하세요.
문제 해결
외부 인터넷에 연결된 노드에 설치하려고 하면 다음 오류 중 하나 이상이 발생할 수 있습니다.
Cannot open: https:// : @ software.apigee.com//apigee-repo-version.rpm bootstrap.sh: Error: Repo configuration failed error: package package_name is not installed
다음 표에는 이러한 오류에 대한 몇 가지 해결 방법이 나와 있습니다.
오류 유형 | 가능한 해결 방법 |
---|---|
비밀번호에 잘못된 문자가 포함되어 있습니다. | Apigee 비밀번호에 특수문자를 사용하지 마세요. |
연결 문제 | 다음 nc -v software.apigee.com 443 다음과 유사한 메시지가 표시됩니다. Connection to software.apigee.com 443 port [tcp/https] succeeded!
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
이그레스 HTTP 프록시의 경우 다음 옵션 중 하나를 사용해야 합니다.
|
외부 인터넷 연결이 없는 노드에 Edge apigee-setup 유틸리티 설치
Edge 노드가 방화벽 뒤에 있거나 어떤 식으로든 인터넷에 액세스할 수 없는 경우 설치 중에 필요한 파일이 포함된 저장소 또는 미러를 여러 개 만들어야 합니다. 그러면 모든 노드에서 이러한 미러에 액세스할 수 있어야 합니다. 생성된 노드는 이러한 로컬 미러에 액세스하여 Edge를 설치할 수 있습니다.
인터넷에 연결되어 있지 않은 노드의 Apigee Edge 설치 프로세스에는 다음 로컬 저장소에 대한 액세스 권한이 필요합니다.
- Apigee Edge 저장소: 로컬 Apigee 저장소 만들기의 설명대로 선택합니다.
- Yum 저장소 (
yum-utils
및yum-plugin-priorities
와 같은 유틸리티용): 운영팀에서 이 저장소를 설정할 수 있습니다. - Enterprise Linux (또는 EPEL)용 추가 패키지: 운영팀에서 이를 설정할 수 있습니다.
로컬 Apigee 저장소 만들기
내부 Apigee 저장소를 만들려면 Edge RPM 및 종속 항목을 다운로드할 수 있도록 외부 인터넷 액세스 권한이 있는 노드가 필요합니다. 내부 저장소를 만든 후에는 다른 노드로 이동하거나 Edge 노드에서 설치할 수 있도록 해당 노드에 액세스할 수 있도록 할 수 있습니다.
로컬 Apigee 저장소를 만든 후 나중에 최신 Edge 출시 파일로 업데이트해야 할 수 있습니다. 다음 섹션에서는 로컬 Apigee 저장소를 만드는 방법과 업데이트하는 방법을 설명합니다.
로컬 Apigee 저장소를 만들려면 다음 안내를 따르세요.
- Apigee 저장소에 액세스하는 데 사용하는 사용자 이름과 비밀번호를 Apigee에서 가져옵니다. Apigee FTP 사이트에 기존 사용자 이름:비밀번호가 있는 경우 해당 사용자 인증 정보를 사용할 수 있습니다.
- 루트로 노드에 로그인하여 Edge RPM을 설치합니다.
- 위에서 설명한 대로 SELinux를 사용 중지합니다.
- Edge
bootstrap_4.50.00.sh
파일을/tmp/bootstrap_4.50.00.sh
로 다운로드합니다.curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
- Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.
sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
여기서 uName:pWord는 Apigee에서 받은 사용자 이름과 비밀번호입니다. pWord를 생략하면 입력하라는 메시지가 표시됩니다.
- 노드에
apigee-mirror
유틸리티를 설치합니다./opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
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를 설치하려면 먼저 다음 명령어를 실행해야 합니다.
- 로컬 저장소에서
bootstrap_4.50.00.sh
를 실행하여apigee-service
유틸리티를 설치합니다.sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.50.00.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
apigee-service
를 사용하여apigee-setup
유틸리티를 설치합니다./opt/apigee/apigee-service/bin/apigee-service apigee-setup install
apigee-setup
를 사용하여 노드에 Edge 구성요소를 설치하고 구성합니다. 자세한 내용은 노드에 Edge 구성요소 설치를 참고하세요.
- 로컬 저장소에서
로컬 저장소의 원격 노드에 apigee-setup을 설치합니다.
로컬 저장소에서 Edge를 설치하는 방법에는 두 가지가 있습니다. 대신 다음 중 원하는 방법을 선택합니다.
- 저장소의 .tar 파일을 만들고 .tar 파일을 노드에 복사한 다음 .tar 파일에서 Edge를 설치합니다.
- 다른 노드에서 액세스할 수 있도록 로컬 저장소가 있는 노드에 웹서버를 설치합니다. Apigee에서는 사용할 수 있는 Nginx 웹 서버를 제공하거나 자체 웹 서버를 사용할 수 있습니다.
.tar 파일에서 설치
.tar 파일에서 설치하려면 다음 안내를 따르세요.
- 로컬 저장소가 있는 노드에서 다음 명령어를 사용하여 로컬 저장소를
/opt/apigee/data/apigee-mirror/apigee-4.50.00.tar.gz
라는 단일 .tar 파일로 패키징합니다./opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Edge를 설치하려는 노드에 .tar 파일을 복사합니다. 예를 들어 새 노드의
/tmp
디렉터리에 복사합니다. - 새 노드에서 위에 설명된 대로 SELinux를 사용 중지합니다.
- 새 노드에서 로컬 Yum 유틸리티 저장소 및 EPEL 저장소에 액세스할 수 있는지 확인합니다.
- 모든 외부 인터넷 저장소가 사용 중지되어 있는지 다시 한번 확인합니다 (인터넷 액세스가 없는 머신에 설치 중이므로 이 경우에 해당).
sudo yum repolist
모든 외부 저장소는 사용 중지해야 하지만 로컬 Apigee 저장소와 내부 저장소는 사용 설정해야 합니다.
- 새 노드에서 로컬 저장소에서
yum-utils
및yum-plugin-priorities
를 설치합니다.sudo yum install yum-utils
sudo yum install yum-plugin-priorities
Yum 도구를 설치하려면 운영팀 또는 조직 내의 다른 그룹에서 로컬 저장소를 설정해야 합니다.
- 새 노드에서 위에 설명된 대로
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 디렉터리로 압축 해제합니다.
tar -xzf apigee-4.50.00.tar.gz
이 명령어는 .tar 파일이 포함된 디렉터리에 repos라는 새 디렉터리를 만듭니다. 예를 들면
/tmp/repos.
입니다. /tmp/repos
에서 Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.sudo bash /tmp/repos/bootstrap_4.50.00.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 웹 서버를 사용하여 저장소에서 설치하려면 다음 단계를 따르세요.
- 저장소 노드에 Nginx 웹서버를 설치합니다.
opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
- 기본적으로 Nginx는 localhost를 서버 이름으로, 포트 3939를 사용하도록 구성됩니다. 이러한 값을 변경하려면 다음 단계를 따르세요.
- 편집기에서
/opt/apigee/customer/application/mirror.properties
을 엽니다. 파일이 없으면 새로 만듭니다. - 필요에 따라 다음 값을 설정합니다.
conf_apigee_mirror_listen_port=3939 conf_apigee_mirror_server_name=localhost
- 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.50.00.sh 파일을
/tmp/bootstrap_4.50.00.sh
로 다운로드합니다.curl http://uName:pWord@remoteRepo:3939/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
여기서 uName:pWord는 위에서 저장소에 설정한 사용자 이름과 비밀번호이고 remoteRepo는 저장소 노드의 IP 주소 또는 DNS 이름입니다.
- 원격 노드에서 Edge
apigee-service
유틸리티 및 종속 항목을 설치합니다.sudo bash /tmp/bootstrap_4.50.00.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.50.00.sh 파일을 다운로드한 후 새 동기화를 실행해야 합니다.
저장소를 업데이트하려면 다음 단계를 따르세요.
- Edge bootstrap_4.50.00.sh 파일을
/tmp/bootstrap_4.50.00.sh
에 다운로드합니다.curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
- Edge
bootstrap_4.50.00.sh
파일을 실행합니다.sudo bash/tmp/bootstrap_4.50.00.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.50.00 저장소에 Edge 4.16.0x/4.17.0x 추가 또는 업데이트
4.50.00 저장소에서 Edge 4.16.0x 또는 4.17.0x의 설치를 유지해야 하는 경우 모든 버전이 포함된 저장소를 유지할 수 있습니다. 그런 다음 이 저장소에서 원하는 버전의 Edge를 설치할 수 있습니다.
4.50.00 저장소에 4.16.0x/4.17.0x를 추가하는 방법:
apigee-mirror
유틸리티의 4.50.00 버전이 설치되어 있는지 확인합니다./opt/apigee/apigee-service/bin/apigee-service apigee-mirror version
아래 형식의 결과가 표시됩니다. 여기서 xyz은 빌드 번호입니다.
apigee-mirror-4.50.00-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.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 버전별로 별도의 디렉터리도 포함되어 있습니다.- 저장소를 .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 웹 서버를 사용하여 저장소에서 설치'의 나머지 단계를 따르세요.