bfagent.conf 참조

bfagent.conf 파일은 Rational® Build Agent 실행 방식에 관한 설정을 저장합니다. 이 파일은 bfagent 실행 파일과 같은 디렉토리에 있습니다.

이 파일에는 모든 설정과 내부 기본값이 나열되어 있습니다. 비활성 설정은 주석 처리됩니다.

설정:

activity_log path
활동 로깅을 켭니다. path로 지정된 파일에 정보가 추가됩니다. 경로가 존재해야 하며 에이전트 사용자는 이 경로에 대한 쓰기 권한이 있어야 합니다.
참고: 경로가 없거나 파일에 쓸 수 없는 경우 에이전트가 오류를 보고하지 않습니다.
중요사항: 파일 크기는 제한되지 않습니다. 파일은 수동으로 삭제해야 합니다. 이 설정은 임시로 에이전트를 디버깅하는 데 사용합니다. 작업 에이전트의 영구 로그로 사용되지 않습니다.
allow IP-address-or-range [...]
다음과 같은 경우에만 이 설정을 사용하십시오.
  • Windows에서 실행되는 에이전트
  • 시작 시 -s 옵션을 사용할 때 UNIX 또는 Linux에서 독립형 모드로 실행되는 에이전트입니다.

이 설정은 에이전트에 대한 연결 수를 제한합니다. IP-address-or-range와 일치하는 IP 주소에서만 연결할 수 있습니다. 기본적으로 모든 주소에서 연결할 수 있습니다.

다음 항목 중 하나 또는 둘 다를 지정하십시오.
  • IP 주소: 완전한 IPv4 또는 IPv6 주소입니다. 예를 들어, IPv4의 경우 255.192.192.003입니다. 특정 IP 주소를 사용할 수 있습니다.
  • IP 주소 범위: 부분적으로 규정된 IPv4 또는 IPv6 주소입니다. 192.168 또는 192.168.63 예제는 IPv4에 올바릅니다. 이 규정과 일치하는 모든 IP 주소를 사용할 수 있습니다.
참고: 수퍼 서버에서 에이전트(예: inetd 또는 xinetd)를 실행하는 경우, 다른 방법을 사용하여 액세스를 제어하십시오. 방화벽, TCP 랩퍼(hosts.allow 및 hosts.deny) 또는 xinetd의 내장 필터링 기능을 사용할 수 있습니다.
bind
이 설정을 사용하여 에이전트의 명시적 바인드 주소를 지정할 수 있습니다. 이 설정과 함께 "port" 설정을 사용하여 에이전트가 -s 명령행 옵션을 사용하여 시작될 때 연결을 청취하는 방법을 판별합니다. bfagent.conf 파일에 제공된 값은 에이전트가 강제로 IPv4 localhost 주소에 바인드되도록 하므로, 에이전트는 동일한 시스템에 있는 콘솔로부터의 연결만 수신하게 됩니다. 예를 들어 bind 255.192.192.003입니다.
참고: 시스템의 서비스 아키텍처에서 시작되는 Windows 또는 UNIX 에이전트(예: inetd, xinetd 또는 launchd)에 영향을 주지 않습니다.
ccviewroot root-path
이 설정은 이 호스트의 기본 보기 루트를 지정합니다. 자세한 정보는 init에 대한 ClearCase® 문서를 참조하십시오. 내부 기본값은 다음과 같습니다.
  • Windows: ccviewroot M:
  • UNIX 또는 Linux: ccviewroot /view
command_output_cache size
이 설정은 에이전트가 지정된 크기(바이트)에 도달할 때까지 출력을 캐시하도록 합니다. 내부 기본값은 캐시하지 않습니다. 캐시를 사용하면 에이전트 성능이 상당히 개선되며 네트워크 오버헤드가 현격히 줄어듭니다. 캐시 크기는 명령이 생성하는 출력 양에 따라 달라집니다.

최소값은 2048입니다. 설정이 2048 미만인 경우 내부적으로 이 값이 사용됩니다.

cygwin

이 설정은 Windows의 에이전트에서만 사용합니다.

이 설정을 사용하면 에이전트가 Linux와 같은 환경인 Cygwin을 사용하여 Windows 호스트에서 작업할 수 있습니다. Cygwin을 사용하면 에이전트에서 여러 Linux 도구를 사용할 수 있습니다.

이 설정을 사용하는 경우 cygwin_script_magic과 쉘 설정도 지정해야 합니다. 다음 예제는 이러한 설정을 구성하는 방법을 표시합니다.
cygwin
shell C:\cygwin\bin\bash.exe --login -c "%s"
cygwin_script_magic #!/bin/bash

쉘 설정은 Cygwin 설치와 일치해야 합니다.

cygwin_script_magic

이 설정은 cygwin이 설정된 경우 Windows의 에이전트에서만 사용합니다.

이 설정은 단계 실행 시 사용할 #! 행을 지정합니다. 기본값은 #!/bin/bash입니다.

default_logon_domain
인증 요청에 도메인이 포함되지 않은 경우 사용할 도메인을 지정합니다. 지정되지 않은 경우 에이전트 시스템의 도메인을 사용합니다.
disable_telnet
최상의 결과를 위해 telnet을 사용하여 에이전트 연결을 테스트하십시오.
에이전트에는 telnet 제어 시퀀스를 처리하고 올바르게 핸들하는 작업과 연관된 약간의 내장 처리 오버헤드가 있습니다.
이 설정을 사용하여 에이전트가 특수 telnet 문자 코드를 처리하지 않도록 설정하면 성능이 약간 향상될 수 있습니다. 제품 환경에서 이 설정을 사용하면 향상된 성능의 혜택이 있습니다.
disable_transcode
운영 체제가 UTF-8 인코딩을 사용하지 않는 경우 에이전트가 국제 데이터를 변환하기 위해 수행하는 처리를 끕니다. 혼합 인코딩 및 데이터 손상을 방지하려면 에이전트 운영 체제에 UTF-8을 사용하십시오.
운영 체제가 UTF-8 인코딩을 사용하지 않는 경우 에이전트가 운영 체제의 로케일 설정에 올바른 인코딩으로 데이터를 변환해야 합니다.
운영 체제가 UTF-8을 사용하지 않는 경우 에이전트의 향상된 성능 및 최상의 결과를 위해 이 설정을 사용하십시오.
enable_agent_dll
이 설정은 디버깅 도구인 DLL 프로세스 추적을 사용합니다.
enable_credential_retention
작업 모니터에서 에이전트가 인증하는 경우 이 설정으로 인해 처음 여기에서 인증할 때 에이전트는 사용자가 지정한 신임 정보를 재사용하게 됩니다.
참고:
  • conf 파일에서 jcl_submit_user 설정을 유지하는 경우 enable_credential_retention 설정을 대체하고 에이전트는 jcl_submit_user에 지정한 사용자 이름 및 비밀번호를 사용합니다.
  • 이러한 설정 외에도 .submitJCL 명령의 -u 옵션으로 사용자 이름 및 비밀번호를 지정할 수도 있습니다.
env_recursion_limit number-of-recursions
사전 구문 분석의 변수-대체 순환 한계를 설정합니다. 설정되지 않은 경우 한계는 32입니다.
extensions
이 설정은 함수의 외부 라이브러리 경로를 지정합니다. 기능은 단계에서 도트 명령으로 사용될 수 있습니다. 이 설정이 지정되지 않은 경우 외부 라이브러리가 로드되지 않습니다.

구문 분석 중에 단계 명령의 첫 번째 토큰을 함수 이름으로 사용합니다. 두 번째 토큰은 문자열이며 세 번째는 정수 제한시간 값(초)입니다.

요구사항: 운영 체제에서 동적 로더가 지원되어야 합니다. 예를 들어, UNIX 또는 Linux에서 /usr/include/dlfcn.h가 필요합니다. 이 기본값은 내부적으로 사용됩니다.
  • UNIX 또는 Linux: /usr/local/bin/bfextensions.so
  • Windows: c:\program files\ibm\build forge\agent\bfextensions.dll
getaddrinfo_using_addrconfig
이 설정은 UNIX 또는 Linux 운영 체제에서 독립형 서비스로 에이전트를 실행하는 데만 사용합니다(bfagent -s). 이 설정은 청취 인터페이스를 선택하도록 getaddrinfo()를 호출할 때 에이전트가 AI_ADDRCONFIG를 사용하게 합니다. 기본적으로 AI_ADDRCONFIG는 사용하지 않습니다.

이 설정을 사용하는 경우 에이전트가 주소를 올바르게 구성하지 않은 인터페이스를 무시합니다. 주소가 올바르게 구성된 인터페이스만 청취합니다.

jcl_submit_user user:encoded-password
작업 모니터에서 작업을 제출하려면 올바른 신임 정보가 필요합니다. JES로 작업을 제출할 사용자의 사용자 이름 및 비밀번호를 지정하려면 jcl_submit_user 매개변수를 사용해야 합니다. 인코드된 비밀번호를 생성하려면 z/OS® 쉘에서 bfagent -e [Password]를 실행하고 이 설정으로 사용자 ID와 함께 에이전트가 표시하는 값을 붙여넣으십시오.
lang lang-code

이 설정은 에이전트가 메시지 및 명령 출력을 쓰는 데 사용하는 언어를 지정합니다.

다음과 같이 명시적으로 설정된 것처럼 기본 내부값은 en입니다.

lang en
leave_tmp_file

문제점을 해결하는 동안에만 이 설정을 사용하십시오.

이 설정을 사용하면 단계 명령을 보유하는 데 사용하는 임시 파일이 명령 실행 후 삭제되지 않고 보존됩니다.

참고: 일반 조작에는 이 설정을 사용하지 마십시오.
locale locale-code.charset-code

이 설정은 UNIX 및 Linux 운영 체제에서만 사용합니다. Windows는 로케일을 서로 다르게 처리합니다.

이 설정은 자국어 지원 애플리케이션이 사용하는 언어와 다중 바이트 문자 세트를 지정합니다. 이 설정은 에이전트 컨텍스트의 LANG 환경 변수를 설정하여 작동합니다.

에이전트가 명령 출력을 US 영어 UTF-8로 처리하도록 설정하려면 운영 체제용으로 UTF-8 로케일을 사용하십시오. 예를 들어 Linux에서 다음 구문을 사용하십시오.
locale en_US.UTF-8

사용자 운영 체제의 올바른 UTF-8 로케일 구문을 판별하려면 locale -a 명령을 실행하십시오.

이 설정이 지정되지 않은 경우 에이전트가 운영 체제의 로케일을 사용합니다. 이 설정은 유용합니다. 이 설정은 운영 체제의 기본 로케일이 에이전트가 사용하려는 로케일이 아닌 경우 특히 유용합니다. 이 설정은 에이전트 요구사항에 맞도록 시스템 로케일을 변경하는 작업이 유용하지 않은 경우 특히 편리합니다.

magic_login user:encoded-password

일반적으로 에이전트는 관리 권한(예: root 또는 admin)을 사용하여 운영 체제에 로그온합니다. magic_login 설정은 표준 시스템 인증의 대안입니다. 이 설정을 사용하면 시스템이 단일 사용자 이름과 비밀번호로 로그인을 인증할 수 있습니다.

root 또는 admin로 에이전트를 실행하는 경우 이 설정은 무시되며 일반 인증이 시도됩니다.

에이전트가 로그인하는 데 사용한 사용자 이름이 아니라 에이전트를 시작한 사용자의 권한을 사용하여 모든 명령을 실행합니다.

이 설정은 다음과 같은 경우에만 사용됩니다.
  • 관리 권한으로 에이전트를 실행할 수 없는 경우. 예를 들어 PAM과 함께 작동하지 않는 UNIX 시스템에서 이 설정을 사용하십시오.
  • 보안 정책으로 인해 관리 권한을 사용하여 에이전트를 실행할 수 없는 경우.
에이전트에 대한 로그인을 구성하려면 사용자 이름과 비밀번호를 사용하는 서버 인증을 작성하십시오. 이 예제에서 사용자 이름은 build이며 비밀번호는 MySecretPassword입니다.
  1. 에이전트를 사용하는 서버를 작성하십시오. 인증 필드에서 이 서버와 서버 인증을 연관시키십시오.
  2. 에이전트의 인코드된 비밀번호를 생성하십시오. 에이전트의 설치 디렉토리에서 사용자가 선택한 비밀번호로 bfagent -P를 실행하십시오.

    다음과 같이 SMD5 해시 인코드된 비밀번호가 리턴됩니다.

    bfagent -P MySecretPassword
    eca0b7f2f4fbf110f7df570c70df844e1658744a4871934a
  3. bfagent.conf에서 원하는 사용자 이름 및 인코드된 비밀번호를 사용하도록 magic_login을 설정하십시오.
    magic_login build:eca0b7f2f4fbf110f7df570c70df844e1658744a4871934a
  4. 에이전트를 시작하십시오.
  5. 서버 연결을 테스트하십시오. 서버에서 서버를 선택한 다음 서버 테스트를 클릭하십시오.
map drive-and-user-spec[; ...]
이 설정은 맵핑된 드라이브를 지정합니다. 일부 시스템에는 드라이브 맵핑이 필요합니다. 예를 들어 쉘이 공유 드라이브에서 실행되므로 드라이브를 맵핑해야 합니다. 에이전트에서 지정된 맵핑은 관리 콘솔에서 _MAP 환경 변수로 지정된 맵핑 전에 수행됩니다. 다음 예제는 두 개의 드라이브 맵핑을 나타냅니다.
map X:=//host1/share;Z:=//host2/share(username,password)
map_drive_is_failure
이 설정이 지정되면 맵핑되지 않은 드라이브 스펙 발생 시 단계를 실행하기 전에 단계가 실패합니다. 이 설정이 지정되지 않으면 단계가 드라이브 실패를 무시하며 단계를 실행하려고 시도합니다. 이 경우 실패와 동시에 이해할 수 있는 오류 메시지가 표시되는지 확인하십시오.
no_preparse_command
이 설정은 쉘에 명령을 전달하기 전에 에이전트가 일반적으로 명령에서 수행하는 변수-확장 구문 분석을 사용 안하도록 설정합니다. 단일 프로젝트 또는 단계에서 사용할 수 있는 _NO_PREPARSE_COMMAND 환경 변수도 참조하십시오.
no_pty

이 설정은 UNIX 또는 Linux 시스템에서 실행하는 에이전트에서만 사용합니다.

이 설정은 쉘이 에이전트의 의사 터미널과 상호 작용할 때 시스템 쉘이 잠기지 않도록 하는 데 사용할 수 있습니다. 일반적으로 이 설정은 HP/UX 및 z/OS에서 사용합니다. 다음과 같은 다른 두 메소드도 사용하여 이 유형의 잠금을 방지할 수 있습니다.
  • 대체 쉘을 사용하십시오.
  • nologonshell 설정을 사용하십시오.
no_pty 설정은 의사 터미널 할당을 사용 안하도록 합니다.
참고: no_pty를 사용하면 몇 가지 명령에 영향을 줍니다. 예를 들어, ls 명령은 세 개의 열이 아니라 하나의 열로 출력을 리턴합니다. 이 설정을 사용하는 경우 프로덕션 환경에 작업을 배치하기 전에 철저히 테스트하십시오.
nologonshell

UNIX 또는 Linux에서 실행하는 에이전트에서만 이 설정을 사용하십시오.

이 설정을 사용하면 에이전트가 실행하는 쉘이 로그온 쉘이 아니라 일반 쉘이 됩니다. 이 설정은 다음과 같은 경우에 자주 사용됩니다.
  • 로그온 쉘은 상세 출력을 제공합니다.
  • 로그온 쉘은 원하지 않는 방식으로 환경 설정을 변경합니다.
  • 로그온 쉘은 사용자와 대화식으로 통신하려고 시도합니다.

설정되면 쉘이 로그온 쉘이 아니라 일반 쉘이 되도록 요청하는 표준 메소드를 사용합니다. 이는 모든 플랫폼에서 작동하지는 않을 수 있으며 이러한 경우 동작을 수정하기 위해 shellflag 설정을 사용하여 쉘로 플래그를 전달할 수 있습니다.

에이전트는 대화식 사용자가 아닌 사용자로 실행되므로 이 동작은 에이전트에 바람직하지 않습니다.
참고: Mac OS X 10.5 시스템은 nologonshell에 응답하지 않는 /bin/bash를 사용합니다. shellflag -l을 사용하십시오.
참고: z/OS 운영 체제는 로그온 쉘과 비로그온 쉘 모두에 항상 /etc/profile 스크립트를 사용합니다. 해당 동작이 에이전트와 제대로 작동하지 않는 경우 스크립트의 컨텐츠를 변경하거나 다른 쉘을 사용해야 합니다.

shellflag 설정도 참조하십시오. 플래그를 사용하여 로그온 스크립트 동작을 변경할 수 있습니다.

password_encrypt_module dll_path;conf_path
에이전트에서 SSL을 사용해야 합니다. DLL 및 구성 파일의 경로를 지정합니다.
  • dll_path는 bfcrypt.dll의 경로입니다(일반적으로 ./bfcyrpt.dll).
  • conf_path는 bfpwcrypt.conf의 경로입니다(일반적으로 ./bfcrypt.conf).
port port-number-or-range [...]

이 설정은 시작 시 -s 옵션을 발행한 경우 UNIX 또는 Linux에서 독립형 모드로 실행되는 에이전트에서만 사용합니다.

이 설정은 에이전트가 관리 콘솔과의 연결을 청취하기 위해 사용하는 포트를 지정합니다.
  • UNIX 또는 Linux에서 독립형 모드로 실행되는 에이전트입니다(시작 시 -s 옵션).
관리 콘솔과 연결을 청취하기 위해 에이전트가 사용하는 포트를 지정합니다.
참고: 기본적으로 포트는 5555로 설정됩니다. UNIX 또는 Linux의 경우 설정은 /etc/services에 있습니다.
shell shell_name [options]
이 설정은 기본 쉘을 지정합니다. 내부 기본값은 다음과 같습니다.
  • Windows: 다음 설정을 사용하지 않는 경우 shell cmd.exe /q /c "%s"입니다.
    • cygwin 설정을 사용하는 경우 기본값은 shell C:\cygwin\bin\bash.exe --login -c "%s"입니다.
    • cygwin 설정을 사용하지 않는 경우 기본값은 shell cmd.exe /u /q /c "%s"입니다.
  • UNIX 또는 Linux: 사용자 계정에 설정된 쉘 또는 사용자의 쉘을 판별할 수 없는 경우 /bin/sh입니다. 이 설정에는 매개변수를 지정할 수 없지만 shellflag 설정을 사용하여 전달할 수는 있습니다. 에이전트는 하이픈을 삽입하여 강제로 기본값을 로그온 쉘이 되도록 합니다. 예를 들어 /bin/ksh가 -ksh로 전송됩니다. shell을 명시적으로 설정하는 경우 nologonshell이 내재적으로 설정됩니다. nologonshell을 참조하십시오.
  • System i®: 쉘 값을 /bin/sh로 설정하십시오.

단계에서 이 설정을 대체할 수 있습니다. #!를 포함하는 행으로 시작되는 단계가 쉘 설정을 대체하고 nologonshell 설정을 사용하여 단계 명령을 실행합니다.

shell_compatible_undef_vars
이 설정을 사용하면 정의되지 않은 변수 구문이 강제로 빈 문자열이 됩니다. 설정되지 않으면 형식이 $VAR, ${VAR} 또는 %VAR%인 변수의 구문은 변수 이름이며 $[VAR]의 구문은 빈 문자열입니다.
shellarg

이 설정은 UNIX 또는 Linux에서 실행되는 에이전트에서만 사용합니다.

명령이 혼합된 경우 이 설정을 사용하십시오. Red Hat Linux Enterprise의 일부 쉘에는 이 설정이 필요합니다.

이 설정은 명령 스크립트가 쉘에 전달되는 방식을 변경합니다. 일반적으로 스크립트는 다음과 같이 표준 입력을 통해 전달됩니다.
   /bin/sh < /tmp/bfshellscript.sh
이렇게 설정하면 스크립트가 매개변수로 전달되어 실행됩니다.
/bin/sh /tmp/bfshellscript.sh
shellflag flag

이 설정은 UNIX 또는 Linux에서 실행되는 에이전트에서만 사용합니다.

이렇게 설정하면 쉘을 실행하는 동안 플래그가 추가됩니다. 하나의 플래그만 지정할 수 있습니다. 일반적으로 출력 또는 원하지 않는 처리를 줄이기 위해 rc 스크립트 처리를 사용 안하는 데 사용합니다.

예제:
  • csh 및 파생: shellflag -f를 사용하여 rc 스크립트 처리를 사용 안하도록 합니다.
  • bash: shellflag –-noprofile을 사용하여 프로파일 스크립트 처리를 사용 안하도록 합니다.
ssl_ca_location path
클라이언트 인증이 true인 경우 사용되는 인증 기관을 포함하는 키 저장소 파일을 지정합니다. 에이전트를 서비스로 실행하는 경우 절대 경로를 사용하십시오.
ssl_cert_location path
공용 인증서를 포함하는 키 저장소를 지정합니다. 에이전트를 서비스로 실행하는 경우 절대 경로를 사용하십시오.
ssl_client_authentication [true | false]
에이전트에 연결할 때 클라이언트 인증이 필요하도록 true로 설정합니다. True인 경우 Build Forge® 엔진의 인증서가 에이전트 인증 기관 키 저장소(ssl_ca_location으로 지정됨)에 추가되어야 합니다.
ssl_cipher_group [grouplist | ALL]
사용할 개별 암호 그룹을 지정합니다. ALL로 설정될 수 있습니다.
ssl_cipher_override cyphers
암호 그룹을 대체합니다. 사용할 암호를 지정하십시오.
ssl_key_location path
개인 키를 포함하는 키 저장소 파일을 지정합니다. 에이전트를 서비스로 실행하는 경우 절대 경로를 사용하십시오.
ssl_key_password password
개인 키의 비밀번호입니다. 기본적으로 이 특성은 일반 텍스트에 저장됩니다. 에이전트가 해당 고유 키 또는 Build Forge 서버의 키를 사용하여 이 비밀번호를 암호화할 수 있습니다.
ssl_protocol protocol
SSL, SSLv2, SSLv3, SSL_TLS, TLS, TLSv1 중 하나를 사용하는 SSL 핸드쉐이크 프로토콜입니다. 이 프로토콜은 Build Forge 서버에서 사용하는 프로토콜과 일치해야 합니다.
tmpdir
에이전트가 작성해야 하는 임시 파일 위치를 지정합니다. tmpdir 키워드가 생략된 경우 에이전트는 임시 파일의 위치로 /tmp를 사용합니다.
update_path path
이 설정은 Build Forge 에이전트 실행 파일의 전체 경로를 식별합니다. 이 설정은 설치 중에 자동으로 지정됩니다. 이 디렉토리는 운영 체제의 기본 디렉토리 또는 사용자가 지정하는 설치 디렉토리입니다.
참고: 이 설정은 Windows 에이전트에서는 무시됩니다. 업데이트된 경로는 레지스트리 키에서 가져옵니다. 이 키는 에이전트 설치 중에 설정됩니다.
win_reexec_after_auth
Build Forge 서버 인증 신임 정보를 사용하여 네트워크 공유 파일 시스템에서 에이전트 명령을 실행해야 하는 경우 이 설정을 추가하십시오. 예를 들어 ClearCase 동적 보기에서 파일을 수정하려면 에이전트가 네트워크 공유 파일 시스템의 ClearCase 파일에 액세스해야 합니다.
Build Forge 에이전트는 처음에 Windows 시스템 계정 신임 정보를 사용하여 시작됩니다. 명령을 실행하려면 에이전트가 Build Forge 서버 인증 신임 정보를 사용하여 나중에 Windows에 대해 인증해야 합니다.
이 설정을 사용하지 않으면 네트워크 공유가 초기 Windows 시스템 계정 신임 정보만 인식하고 네트워크 공유 파일 시스템의 파일에 액세스하고 쓰는 데 필요한 후속 서버 인증 신임 정보는 무시합니다.
win_reexec_after_auth는 서버 인증 신임 정보를 사용하여 Windows에 대해 다시 인증한 다음 새 프로세스를 시작하고 공유 파일 시스템이 변경된 신임 정보를 강제로 인식하게 합니다.
win_reexec_after_auth 설정을 사용하는 경우 에이전트가 서비스로 실행되며 네트워크 공유 파일에 액세스하는 명령과 액세스하지 않는 명령을 구분하지 않으므로 성능에 영향을 미칠 수 있습니다.
참고: IBM i에 CLM용 Rational 솔루션 제품 설치 시 jazz.net 라이브러리의 최신 항목

피드백