명령행에서 에이전트를 설치하려면 일괄처리 파일이나
쉘 스크립트를 실행하고 에이전트가 서버에 연결되는 방법에 대한
정보를 지정해야 합니다.
시작하기 전에
프로덕션 환경의 경우 에이전트가 설치된 시스템에서
에이전트를 실행하는 데 전적으로 사용되는 사용자 계정을 작성하십시오.
에이전트를 설치 중인 각 컴퓨터에
JRE(Java™ Runtime
Environment) 또는 JDK(Java Development
Kit) 버전 7 이상이 있는지 확인하십시오.
컴퓨터에
IBM® JRE 또는 JDK가
있으면 지정된 레벨 이상의 서비스 새로 고치기(SR)가 있는 버전 7.0.0 SR4로
JRE 또는 JDK를 업데이트하십시오.
이 태스크 정보
UNIX시스템에서 실행되는 에이전트는
IBM UrbanCode Deploy 웹 애플리케이션에서
직접 설치할 수 있습니다. 원격으로 에이전트 설치의 내용을 참조하십시오.
간단하게 평가하기 위해
서버가 있는 시스템에서 관리자가 에이전트를 실행할 수 있습니다.
그러나 여러 시스템에서 배치를 실행하려는 경우 각 시스템에
별도의 에이전트를 설치하십시오. 예를 들어, 테스트 환경이 세 개의
시스템으로 구성된 경우 각 시스템에 에이전트를 설치하십시오. 애플리케이션에서
사용하는 각 환경에 대해 동일한 프로시저를 따르십시오.
각 에이전트에서
IBM UrbanCode Deploy 서버와 통신하려면 적절한 권한이
있어야 합니다(에이전트가 에이전트 릴레이를 통해 IBM UrbanCode Deploy와
통신하는 경우 원격으로 에이전트 설치의 내용 참조).
최소한 각 에이전트에 다음을 수행하는 권한이
있어야 합니다.
- 캐시 작성. 기본적으로 캐시는 에이전트를 실행하는 사용자의
홈 디렉토리에 있습니다. 캐시는 이동하거나 사용하지 않게 설정할 수 있습니다.
- TCP 연결 열기. 에이전트가 서버의 JMS 포트와 통신하는 데
TCP 연결을 사용합니다.
- HTTP(S) 연결 열기. 에이전트가 CodeStation 저장소에서
아티팩트를 다운로드하려면 IBM UrbanCode Deploy
사용자 인터페이스에 연결할 수 있어야 합니다.
- 파일 시스템에 액세스. 여러 에이전트에서 파일 시스템의
항목에 대한 읽기/쓰기 권한이 필요합니다.
프로시저
- 에이전트를 설치하려는 컴퓨터에 에이전트 설치 프로그램을
다운로드하여 압축을 푸십시오.
- 서버에서 설치 프로그램을 다운로드하려면 페이지의 상단 오른쪽에서 도움말
단추를 클릭한 다음
도구를 클릭하십시오.
그런 다음 IBM UrbanCode Deploy 에이전트를
클릭하고 파일을 다운로드하여 압축을 푸십시오.
- 명령행을 사용하여 서버에서 설치 프로그램을 찾으려면
다음 위치로 이동하여 대상 시스템에 파일을 복사하십시오. installation_folder /opt/tomcat/webapps/ROOT/tools/ibm-ucd-agent.zip
참고: z/OS®에서
에이전트를 설치하는 경우 설치 패키지에 있는
여러 텍스트 유형 파일의 문자 인코딩을
IBM-1047 인코딩으로 전환해야 사용할 수
있습니다. 설치 파일의 압축을 풀고 다음 파일을
IBM-1047 인코딩으로 변환하십시오.
- install-agent.sh
- install.with.groovy.xml
- opt/apache-ant-1.8.4/bin/ant
- opt/apache-ant-1.8.4/bin/antRun
- opt/groovy-1.8.8/bin/groovy
- opt/groovy-1.8.8/bin/startGroovy
- install/AgentInstaller.groovy
파일을 변환하려면 명령 프롬프트에서
다음 텍스트와 비슷한 명령을 실행하십시오:
iconv -f UTF-8 -t IBM-1047 filename >filename.bac
mv filename.bac filename
파일을 변환한 다음
설치 파일을 z/OS로
이동하여 설치를 계속하십시오.
- 설치 패키지를 다운로드하고 펼친 다음 설치 프로그램
디렉토리를 여십시오.
- 이 디렉토리에서 install-agent.bat(Windows) 또는 install-agent.sh(UNIX 또는 Linux)를 실행하십시오.
참고: 에이전트를
Windows 서비스로 설치하는 경우
사용자 계정에 다음과 같은 권한이 있어야 합니다.
- SE_INCREASE_QUOTA_NAME "프로세스에 맞게 메모리 할당량 조정"
- SE_ASSIGNPRIMARYTOKEN_NAME "프로세스 레벨 토큰 대체"
- SE_INTERACTIVE_LOGON_NAME "로컬에 로그온"
IBM UrbanCode Deploy 에이전트
설치 프로그램이 표시되고 다음 정보를 제공하도록 프롬프트됩니다.
Enter를 눌러 기본값(대괄호 안에 표시)을
승인할 수 있습니다. 두 옵션(예: Y/n)이 제공되면
대문자 옵션이 기본값입니다.
- 에이전트가 설치되어야 하는 디렉토리를 입력하십시오.
- 예: C:\Program Files\IBM\UCDeploy-agent(Windows) 또는 /opt/IBM/ibm-ucd/agent(UNIX). 디렉토리가 없으면
Y를 입력하여 설치 프로그램에서
디렉토리를 작성하도록 지시하십시오. 기존 디렉토리를 입력하면
프로그램에서 에이전트 업그레이드 옵션을 제공합니다. 업그레이드에 대한 정보는
IBM UrbanCode Deploy 업그레이드의 내용을 참조하십시오.
참고: 물결 기호 문자(~)와 같은
쉘 확장 또는 약어을 사용하지 마십시오.
- 에이전트를 실행하는 데 사용하는 JRE/JDK의
홈 디렉토리를 입력하십시오.
- Java가 이미 설치된 경우 IBM UrbanCode Deploy에서
Java 위치를 기본값으로
제안합니다. 기본값을 승인하려면 Enter를 누르십시오.
그렇지 않으면 기본값을 대체하여 올바른 경로를 입력하십시오.
- 에이전트가 서버에 직접 연결하지 않고
에이전트 릴레이에 연결합니까?
- 기본값은 N입니다. Y를 지정하는 경우
다음 매개변수를 구성하도록 프롬프트됩니다.
- 에이전트가 연결될 에이전트 릴레이의
호스트 이름 또는 주소
- 에이전트 릴레이의 호스트 이름 또는 IP 주소를 입력하십시오. 에이전트
릴레이를 설치할 때 사용한 값을 제공하십시오.
- 에이전트 릴레이의 에이전트 통신 포트
- 에이전트에서 에이전트 릴레이와의 JMS-기반 통신에 사용하는
포트를 입력하십시오. 기본값은 7916입니다.
- 에이전트 릴레이의 HTTP 프록시 포트
- 에이전트가 에이전트 릴레이와의 HTTP 통신에 사용하는 포트를
입력하십시오. 기본값은 20080입니다.
참고: 첫 번째 릴레이가 실패할 경우
사용할 다른 릴레이를 지정할 수 있습니다. /agent-install/conf/agent/installed.properties
파일의 locked/agent.brokerUrl=failover\: 매개변수에
릴레이를 추가하여 장애 복구 릴레이를 구성하십시오.
릴레이 구성 구문은 agent_IP_or_hostname\:JMS_port입니다.
쉼표로 릴레이를 구분하십시오. 다음 예에서는 두 릴레이에 대해 구성된
매개변수를 보여줍니다: locked/agent.brokerUrl=failover\:(ah3\://relay1\:7916,ah3\://relay2\:7916).
모든 릴레이가 동일한 HTTP 프록시 포트를 사용한다고 가정합니다.
처음에는 에이전트 설치 중에 구성된 릴레이의 위치가 매개변수에
포함되어 있습니다.
- 에이전트가 연결될 서버의 호스트 이름 또는 주소를
입력하십시오.
- 기본값은 localhost입니다. 에이전트가
클러스터형 서버에 연결하는 경우 로드 밸런서의 호스트 이름을
지정하십시오.
- 서버의 에이전트 통신 포트 입력
- 기본값은 7918입니다.
- 서버 에이전트 통신에서 SSL과 함께 상호 인증을
사용합니까?
- 기본값은 N입니다.
SSL을 사용하는 경우
서버에서도 SSL을 작동시키십시오. 그렇지 않으면 에이전트에서 서버에 연결할 수
없습니다. 상호 인증을 사용하는 경우에도 적용됩니다.
에이전트 통신에 사용하는 포트 번호를 변경하는 경우 에이전트를
설치하는 동안 포트 번호를 제공해야 합니다.
- 이 에이전트의 이름을 입력하십시오.
- 고유 이름을 입력하십시오. 서버가 이 이름을 사용하여 이 에이전트를
식별합니다. 이름은 256자로 한정되며 변경할 수 없습니다.
- 이 에이전트를 추가할 팀을 쉼표로 구분하여 입력하십시오.
- 기본값은 NONE입니다.
에이전트는 서버에 처음 연결될 때 팀에
추가될 수 있습니다. 에이전트가 서버에 처음 연결될 때 지정된 팀에 지정됩니다. 다중 팀은 쉼표로 구분하십시오. 후행 공백은
무시됩니다. 존재하지 않는 팀 이름도 무시됩니다.
- 에이전트를 Windows 서비스로 설치하시겠습니까?
- (Windows에만 해당). 기본값은
N입니다. 서비스로 설치된 경우 IBM UrbanCode Deploy는
PATH 변수의 값만 캡처합니다. 설치 중에 캡처된 값은
사용자가 나중에 변경하더라도 항상 사용됩니다. 최신 Windows 버전의 경우
관리자로 명령을 실행해야 합니다.
다음에 수행할 작업
에이전트 시작에 설명된 대로 에이전트를 시작하십시오.
에이전트가 올바르게 구성된 경우
IBM UrbanCode Deploy에서
자동으로 인식합니다. 에이전트를 사용하여 시작하도록 추가 조치를
수행하지 않아도 됩니다.