에이전트 업데이트 및 배치 유틸리티에는 에이전트를 업데이트하거나 설치할 컴퓨터를 판별하기 위해 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>
각 <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 디렉토리에서 StartCommand 및 StopCommand를 찾으려고 시도합니다. |
UserName | 대상 컴퓨터에 로그온할 때 사용할 사용자 이름입니다. |
해당 샘플은 XML 파일을 사용할 수 있는 방법을 설명합니다.
이 샘플에는 하나의 대상만 있습니다. 대상 IP 주소는 9.164.259.143입니다. <Target> 요소는 선택적 매개변수 SourceDirectory 또는 TemporaryLocation을 포함하지 않습니다. 그러나 <Globals> 요소에는 SourceDirectory 매개변수가 있습니다. 유틸리티는 대상에 대해 해당 매개변수의 값을 사용합니다.
<?xml version="1.0" encoding="UTF-8"?>
<AgentDeploymentAndUpdate>
<Globals>
<Parameter Name="SourceDirectory" Value="..\test"/>
<Parameter Name="KeyFile" Value="..\test\keyfile.txt"/>
</Globals>
<Target id="9.164.259.143">
<Parameter Name="ConnectionType" Value="ssh"/>
<Parameter Name="UserName" Value="root"/>
<Parameter Name="Password" Value="toor"/>
<Parameter Name="ExistingAgentPath" Value="/usr/local/bin/bfagent"/>
<Parameter Name="AgentInstallLocation" Value="/usr/local/bin/bfagent"/>
</Target>
</AgentDeploymentAndUpdate>
이 샘플에는 네 개의 대상이 있습니다. 그러나 대상에는 여기에 특정한 매개변수가 필요하지 않습니다. 그러므로 모든 매개변수는 UserName, Password 및 ConnectionType을 포함하여 <Globals> 섹션에 지정됩니다.
<?xml version="1.0" encoding="UTF-8"?>
<AgentDeploymentAndUpdate>
<Globals>
<Parameter Name="SourceDirectory" Value="..\test"/>
<Parameter Name="ConnectionType" Value="ssh"/>
<Parameter Name="UserName" Value="root"/>
<Parameter Name="Password" Value="toor"/>
<Parameter Name="TemporaryLocation" Value="/tmp"/>
<Parameter Name="ExistingAgentPath" Value="/usr/local/bin/bfagent"/>
<Parameter Name="AgentInstallLocation" Value="/usr/local/bin/bfagent"/>
<Parameter Name="KeyFile" Value="..\test\keyfile.txt"/>
</Globals>
<Target id="9.164.259.143">
</Target>
<Target id="9.164.102.169">
</Target>
<Target id="9.164.102.196">
</Target>
<Target id="9.106.189.157">
</Target>
</AgentDeploymentAndUpdate>
대상 시스템에 대해 IP 주소의 범위를 지정하십시오. 다음 예제는 각 시스템에서 동일한 로그인 신임 정보를 사용하며 IP 주소 9.184.112.152 - 9.184.112.160에서 작동합니다(로그인: root, 비밀번호: password).
<?xml version="1.0" encoding="UTF-8"?>
<AgentDeploymentAndUpdate>
<Target id=”9.184.112.152-160”>
<Parameter Name="ConnectionType" Value="ssh">
<Parameter Name="ConnectionPort" Value=""/>
<Parameter Name="UserName" Value="root">
<Parameter Name="Password" Value="passWord">
</Target>
</AgentDeploymentAndUpdate>
모든 대상에 동일한 특성(연결 유형, 연결 포트, 사용자 이름, 비밀번호)이 있는 경우 해당 특성은 파일의 글로벌 섹션에서 지정할 수 있습니다.
<?xml version="1.0" encoding="UTF-8"?>
<AgentDeploymentAndUpdate>
<Globals>
<Parameter Name="ConnectionType" Value="ssh">
<Parameter Name="ConnectionPort" Value="">
<Parameter Name="UserName" Value="root">
<Parameter Name="Password" Value="passWord">
</Globals>
<Target id=”9.184.112.152-160”>
</Target>
<Target id=”9.184.80.12-16”>
</Target>
</AgentDeploymentAndUpdate>