노드에 Edge를 설치하려면 먼저 Edge apigee-setup 유틸리티를 설치합니다. 노드에 외부 인터넷 연결이 없는 환경인 경우 Apigee 저장소의 로컬 사본도 설치해야 합니다.
기본 설치 디렉터리: /opt/apigee
Edge는 모든 파일을 /opt/apigee
디렉터리에 설치합니다. 이 디렉터리는 변경할 수 없습니다. 하지만 원하는 경우 symlink를 만들어 /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 버전에 따라 다릅니다.
Red Hat Enterprise Linux (RHEL) 8.0의 경우 RHEL 8 기본 요건을 참조하세요.
- Red Hat/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
- Red Hat/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
- AWS-2의 경우:
sudo amazon-linux-extras install epel -y
sudo yum-config-manager --enable epel
기본 요건: 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보다 높은 경우 제거합니다.
RHEL 8 기본 요건
Red Hat Enterprise Linux (RHEL) 8을 실행하는 서버에 Edge를 설치하는 경우 설치를 실행하기 전에 다음 단계를 따르세요.
- Enterprise Linux용 추가 패키지 (EPEL)를 사용 설정합니다.
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
- Postgres 및 Nginx를 사용 중지합니다.
sudo dnf module disable postgresql
sudo dnf module disable nginx
- Python 2를 설치하고 심볼릭 링크를 만듭니다.
sudo dnf install -y python2
sudo ln -s /usr/bin/python2 /usr/bin/python
외부 인터넷 연결이 있는 노드에 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
버전을 확인합니다.- RHEL 8에 설치하는 경우 RHEL 8의 기본 요건의 단계를 따르세요.
- 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.52.00.sh
파일을/tmp/bootstrap_4.52.00.sh
로 다운로드합니다.curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
- Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.
sudo bash /tmp/bootstrap_4.52.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.52.00.sh
파일을/tmp/bootstrap_4.52.00.sh
로 다운로드합니다.curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
- Edge Apigee-service 유틸리티 및 종속 항목을 설치합니다.
sudo bash /tmp/bootstrap_4.52.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만 다운로드합니다.-
(선택사항) 로컬 저장소의 Edge를 로컬 저장소를 호스팅하는 동일한 노드에 설치하려면 먼저 다음 명령어를 실행해야 합니다.
- 로컬 저장소에서
bootstrap_4.52.00.sh
를 실행하여apigee-service
유틸리티를 설치합니다.sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.52.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.52.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.52.00.tar.gz
이 명령어는 .tar 파일이 포함된 디렉터리에 repos라는 이름의 새 디렉터리를 만듭니다. 예를 들면
/tmp/repos.
입니다. /tmp/repos
에서 Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.sudo bash /tmp/repos/bootstrap_4.52.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.52.00.sh 파일을
/tmp/bootstrap_4.52.00.sh
로 다운로드합니다.curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
여기서 uName:pWord는 위에서 저장소에 설정한 사용자 이름과 비밀번호이고 remoteRepo는 저장소 노드의 IP 주소 또는 DNS 이름입니다.
- 원격 노드에서 Edge
apigee-service
유틸리티와 종속 항목을 설치합니다.sudo bash /tmp/bootstrap_4.52.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.52.00.sh 파일을 다운로드한 다음 새 동기화를 수행해야 합니다.
저장소를 업데이트하려면 다음 단계를 따르세요.
- Edge bootstrap_4.52.00.sh 파일을
/tmp/bootstrap_4.52.00.sh
에 다운로드합니다.curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
- Edge
bootstrap_4.52.00.sh
파일을 실행합니다.sudo bash/tmp/bootstrap_4.52.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.52.00 저장소에 Edge 4.16.0x/4.17.0x 추가 또는 업데이트
4.52.00 저장소에서 Edge 4.16.0x 또는 4.17.0x의 설치를 유지해야 하는 경우 모든 버전이 포함된 저장소를 유지할 수 있습니다. 그런 다음 이 저장소에서 원하는 버전의 Edge를 설치할 수 있습니다.
4.52.00 저장소에 4.16.0x/4.17.0x를 추가하는 방법:
- 4.52.00 버전의
apigee-mirror
유틸리티를 설치했는지 확인합니다./opt/apigee/apigee-service/bin/apigee-service apigee-mirror version
아래 형식의 결과가 표시됩니다. 여기서 xyz은 빌드 번호입니다.
apigee-mirror-4.52.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 웹서버를 사용하여 저장소에서 설치'의 나머지 단계를 따르세요.