XML 파일에서 대상 시스템 지정

XML 파일을 사용하여 에이전트를 설치 또는 업데이트할 대상 시스템을 지정하십시오.

XML 파일 개요

에이전트 업데이트 및 배치 유틸리티에는 에이전트를 업데이트하거나 설치할 컴퓨터를 판별하기 위해 XML 파일이 필요합니다. 이 파일은 또한 유틸리티에 필요한 로그인 신임 정보 및 기타 항목을 지정해야 합니다.

파일에는 다음 요구사항이 있습니다.

다음 예제에는 하나의 <Target> 요소 및 <Globals> 요소가 표시됩니다. <Globals> 요소에 <Target> 요소 하나만을 사용하는 경우에는 해당 요소가 유용하지 않습니다. <Globals> 요소는 여러 개의 <Target> 요소를 사용하는 경우에 유용합니다.

<?xml version="1.0" encoding="UTF-8"?>
<AgentDeploymentAndUpdate>

<Target id="9.184.112.152">
<Parameter Name="ConnectionType" Value="ssh"/>
<Parameter Name="UserName" Value="root"/>
<Parameter Name="Password" Value="passWord"/>
<Parameter Name="ExistingAgentPath" Value="/usr/local/bin/bfagent"/>
<Parameter Name="GZIPPath" Value="/usr/contrib/bin/"/>
</Target>

<Globals>
<Parameter Name="KeyFile" Value="..\test\keyfile.txt"/>
</Globals>

</AgentDeploymentAndUpdate>

XML 파일 구문

각 <Parameter> 요소는 <Target> 및 <Globals> 요소에서 모두 유효합니다. 이러한 유연성으로 인해 매개변수가 모든 대상 컴퓨터에 적용되는 경우 <Target> 요소를 사용하여 ID 속성만을 지정하고 각 <Parameter> 요소를 <Globals> 요소에 배치할 수 있습니다.

매개변수를 Value=""로 지정하는 것은 매개변수를 지정하지 않는 것과 동일합니다.

다음 표에서는 파일 구문을 설명합니다.

대상 속성
ID 대상 컴퓨터의 이름 또는 IP 주소입니다.
매개변수
AgentInstallLocation IBM AIX, HP-UX 및 Windows 시스템의 경우에만 기타 플랫폼에 영향을 미치지 않습니다.

새 에이전트를 배치할 위치입니다. 지정되지 않은 경우 시스템 기본 임시 디렉토리가 사용됩니다.

BFAgentPort IBM AIX 및 HP-UX 시스템의 경우에만

사용할 에이전트의 포트입니다. 응답 파일 생성 시 사용됩니다.

BFASolarisAdminFile Solaris 시스템의 경우에만

자동 설치를 위해 응답 파일을 저장할 대상 시스템의 위치입니다. 지정되지 않은 경우 시스템 기본 임시 디렉토리가 사용됩니다.

BFASolarisResponseFile Solaris 시스템의 경우에만

응답 파일을 저장할 대상 시스템의 위치입니다. 지정되지 않은 경우 시스템 기본 임시 디렉토리가 사용됩니다.

ConnectionType UNIX 또는 Linux: SSH 또는 RSH

Windows: SSH, RSH, SMB 또는 CIFS

(RSH는 원격 쉘입니다. SMB는 서버 메시지 블록입니다. CIFS는 공통 인터넷 파일 시스템입니다.)

ConnectionPort (선택사항) 대상이 기본 포트를 사용하지 않는 경우 ConnectionType 매개변수로 지정된 연결 유형에 사용할 포트 번호입니다. 대상이 기본 포트를 사용하는 경우 이 매개변수를 지정할 필요가 없습니다.
ExistingAgentPath IBM AIX, HP-UX 및 Windows 시스템의 경우에 필수.

대상 컴퓨터에서의 기존 에이전트 위치입니다. 유틸리티는 사용자가 지정하는 위치에서 BFAgent.conf 파일의 백업을 작성하고 설치 또는 업그레이드가 완료된 후 이를 복원합니다. 기타 시스템의 경우 기본 시스템 설치 위치가 사용됩니다.

GZIPPath IBM AIX, HP-UX 및 Solaris 시스템.

에이전트 설치 프로그램이 gzip 명령(설치 프로그램의 압축을 푸는 명령)을 찾을 수 있는 디렉토리입니다.

IsSudoEnabled sudo가 대상 시스템에서 사용되고 이를 사용하려는 경우 예로 설정하십시오. SudoPassword를 올바른 sudo 비밀번호로 설정하십시오. 올바르게 설정되지 않으면 유틸리티는 sudo 로그인에 대해 Password를 사용하려고 시도합니다.
KeyFile 비밀번호의 암호화 및 복호화에 사용되는 키를 저장하는 유틸리티를 실행하는 컴퓨터에 있는 파일입니다.
LocalTempLocation IBM AIX, HP-UX 및 Windows의 경우에만.

응답 파일을 저장할 대상 시스템의 위치입니다. 지정되지 않은 경우 시스템 기본 임시 디렉토리가 사용됩니다. Solaris 시스템의 경우 BFASolarisResponseFile 또는 BFASolarisAdminFile을 사용하십시오.

ManagedScriptsDir 유틸리티가 실행되는 디렉토리로 설정하십시오. 이 디렉토리는 agentupdate 유틸리티를 실행하는 컴퓨터에 있습니다.
SourceDirectory 대상 컴퓨터의 설치 프로그램을 .exe, .rpm 및 .gz 양식으로 저장하는 디렉토리입니다. 이 디렉토리는 agentupdate 유틸리티를 실행하는 컴퓨터에 있습니다.
StartCommand (선택사항) 대상 컴퓨터에서 Rational Build Forge 에이전트를 시작하기 위한 사용자 정의된 명령이 있습니다.

명령이 PATH/path 변수에 포함되는지 확인하거나 XML 파일에 전체 경로를 제공하십시오.

StopCommand (선택사항) 대상 컴퓨터에서 Rational Build Forge 에이전트를 중지하기 위한 사용자 정의된 명령이 있습니다.

명령이 PATH/path 변수에 포함되는지 확인하거나 XML 파일에 전체 경로를 제공하십시오.

SudoPassword sudo에 사용할 비밀번호입니다. IsSudoEnabled를 참조하십시오.
Password 대상 컴퓨터에 로그온할 때 UserName에 사용할 비밀번호입니다.
중요사항: 처음에 XML 파일의 일반 텍스트에서 Password 매개변수를 정의하십시오. 에이전트 업데이트 유틸리티 실행에서 설명한 것처럼 –encrypt 명령행 옵션을 사용하여 비밀번호를 암호화하십시오.
TemporaryLocation 유틸리티를 실행하기 전에 설치 프로그램을 저장할 대상 컴퓨터의 위치입니다.
UseManagedScripts 예 또는 아니오로 설정하십시오. 예로 설정하는 경우 유틸리티는 ManagedScriptsDir 디렉토리에서 StartCommandStopCommand를 찾으려고 시도합니다.
UserName 대상 컴퓨터에 로그온할 때 사용할 사용자 이름입니다.

샘플 XML 파일

해당 샘플은 XML 파일을 사용할 수 있는 방법을 설명합니다.


피드백