단일 머신에 여러 Connector Windows 에이전트 배포하기
Windows 에이전트 버전 1.2.0 부터 단일 Windows 호스트에 여러 개의 에이전트를 설치할 수 있게 되었습니다. Windows 에이전트 버전 1.2.0 이상을 사용하려면 서버에 Microsoft .NET >= 3.5 가 설치되어 있어야 합니다.
Satellite Connector Cloud 엔드포인트의 경우, 클라우드 엔드포인트 인그레스가 에이전트를 실행하는 Windows 호스트 그 자체이므로, 동일한 Windows 호스트에서 여러 에이전트를 실행하는 것은 지원되지 않습니다. 클라우드 엔드포인트와 단일 호스트에서 여러 Windows 에이전트를 실행하는 것은 상호 배타적인 기능입니다. Windows 에이전트와 함께 Cloud 엔드포인트를 사용해야 하는 경우, Windows 호스트당 1개의 에이전트를 설치하는 것이 좋습니다.
고려사항
-
Windows 에이전트의 서비스 이름이
1.2.0버전에서satelliteconnectorservice.exe에서SatelliteConnectorService로 업데이트되었습니다. 이 변경 사항으로 인해 제거하려는 에이전트와 함께 제공된 제거 스크립트를 사용해야 합니다. -
버전
1.2.0에서는 단일 Windows 호스트에 설치된 여러 Windows 에이전트를 구분하기 위해 에이전트 구성 파일에SATELLITE_CONNECTOR_INSTANCE_NAME이라는 새 매개 변수가 도입되었습니다. 이 매개 변수는 서비스 이름에 추가되고-로 구분됩니다. 이제 여러 Windows 에이전트를 설치하려면 설치 또는 제거 스크립트를 호출할 때 구성 파일을 지정해야 합니다. -
Windows 에이전트는 Windows 호스트에서 노드 프로세스로 실행됩니다. IBM Cloud 콘솔과 IBM Cloud 명령줄 인터페이스(CLI) 모두에서, 노드 프로세스 ID는 커넥터 이름 뒤에 추가되며, 점(
.)으로 구분됩니다. -
Windows 에이전트의
1.2.0이전 버전에서는 설치 또는 제거 스크립트에 대한 구성 파일을 지정할 수 없었습니다. 대신 스크립트는 동일한 디렉터리에서config.json파일을 자동으로 가져와서 단일 Windows 에이전트를 설치하거나 제거하는 데 사용했습니다. -
단일 Windows 에이전트에는 최소 4개의 vCPU 가 필요하며 4GB를 권장합니다. 이 설정은 여러 에이전트를 처리할 수 있지만 4번째 에이전트 이후에는 성능이 크게 떨어집니다. 따라서 여러 에이전트를 실행하려면 최소 8개의 vCPU 및 8GB가 권장됩니다.
-
동일한 커넥터에 속한 여러 상담원을 실행해도 아무런 이점이 없습니다. 가장 좋은 방법은 커넥터당 상담원 1명을 두는 것입니다.
-
여러 Windows 에이전트를 설치하려면 각 에이전트에 대해 25MB 의 메모리를 보존해야 합니다.
-
에이전트에서 트래픽을 처리할 경우, 에이전트당 약 70MB의 메모리가 소모되고 CPU 사용률은 약 15%에 달하며, 에이전트당 대역폭은 150~200 Mbps에 이릅니다. 이 수치는 IBM 에서 수행한 ‘ Satellite ’ 커넥터 Windows 에이전트에 대한 내부 성능 테스트 결과를 바탕으로 한 것입니다.
여러 Windows 에이전트 설치
단일 호스트에 여러 에이전트를 배포하려면 configFile 매개변수를 사용해야 합니다.
-
CLI에서 다음 명령을 실행하여 에이전트
.zip(ZIP 아카이브) 파일을 다운로드하십시오.ibmcloud sat agent attach --platform windows출력 예.
Downloading agent setup tools for windows... OK Satellite connector agent for windows was successfully returned /var/folders/17/y8wr4y_x1tb4yf__g3wr6g8m0000gp/T/windows_satellite_connector_4097559421.zip -
PowerShell 에서 다음 명령을 실행하여
.zip의sha512sum을 확인합니다.Get-FileHash -Algorithm SHA512 -Path c:\windows_satellite_connector_1420916628.zip -
PowerShell 에서 다음 명령을 실행하여
.zip파일 내용을 추출합니다.Expand-Archive -Path 'C:\path\to\windows_satellite_connector_4097559421.zip' -DestinationPath ‘C:\path\to\extract' -
다음 섹션의 단계를 완료하여 추출한 구성 파일을 업데이트합니다.
-
multi_instance_config.json파일을 편집하여 커넥터 세부 정보를 포함하세요.{ "SATELLITE_CONNECTOR_ID": "<connector_id>", "SATELLITE_CONNECTOR_IAM_APIKEY": "<api_key>", "SATELLITE_CONNECTOR_TAGS": "<tags>", "SATELLITE_CONNECTOR_INSTANCE_NAME": "<instance_name>", "LOG_LEVEL": "<log_level>", "PRETTY_LOG": <true|false> } -
구성 파일을 커넥터 세부 정보 및 자격 증명으로 채웁니다. 파일 이름을
config.json으로 지정하지 마십시오.SATELLITE_CONNECTOR_INSTANCE_NAME은 필수이며 문자로 시작해야 하고(a-zA-Z), 숫자(0-9)및_만 포함할 수 있으며 총 길이는 50자 미만이어야 합니다. -
PowerShell 에서 설치 스크립트를 실행합니다.
./install.ps1 -configFile multi_instance_config.json -
Windows Server에서 실행 중인 상담원을 봅니다. PowerShell 에서 다음 명령을 실행합니다.
Get-Service -Name SatelliteConnectorService* | Format-Table -AutoSizeStatus Name DisplayName ------ ---- ----------- Running SatelliteConnectorService SatelliteConnectorService Running SatelliteConnectorService-connector_1 SatelliteConnectorService-connector_1 Running SatelliteConnectorService-connector_2 SatelliteConnectorService-connector_2 -
Windows Server에서 실행 중인 노드 프로세스를 봅니다. PowerShell 에서 다음 명령을 실행합니다.
get-process | Where-Object {$_ -match 'node'}NPM(K) PM(M) WS(M) CPU(s) Id SI ProcessName ------ ----- ----- ------ -- -- ----------- 24 61.05 40.44 0.89 1796 0 node 39 10.43 24.29 0.11 3436 0 node 39 10.74 29.70 0.17 4288 0 node 24 61.60 39.86 0.70 5720 0 node 24 61.44 40.64 0.81 5924 0 node 39 10.63 29.81 0.17 7932 0 node -
자세한 내용은
connector_1에서 확인하세요.ibmcloud sat connector get --connector-id U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkYzkwMjFpNnNlcnJxdTJlZyIOK ID: U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkYzkwMjFpNnNlcnJxdTJlZyI Name: connector_1 CRN: crn:v1:staging:public:satellite:us-south:a/1ae4eb57181a46ceade48465196706a7:U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkYzkwMjFpNnNlcnJxdTJlZyI:: Managed From: Dallas (us-south) Resource Group ID: 60735c4daed84fcea7d3fe99c298c9b3 Resource Group Name: Default State: created Created Date: 2025-04-11 03:43:16 -0500 (48 minutes ago) -
커넥터에 속한 에이전트 보기
connector_1.ibmcloud sat agent ls --connector-id U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkYzkwMjFpNnNlcnJxdTJlZyIOK Name Release Tags sat-link-e2e-wi/connector_1.1796 20250410-5f291315c59db895783cf54411765942806802ac_W connector_1 -
자세한 내용은
connector_2에서 확인하세요.ibmcloud sat connector get --connector-id U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkYzlzMjF0OWFsMjQ2YXZjMCIOK ID: U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkYzlzMjF0OWFsMjQ2YXZjMCI Name: connector_2 CRN: crn:v1:staging:public:satellite:us-south:a/1ae4eb57181a46ceade48465196706a7:U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkYzlzMjF0OWFsMjQ2YXZjMCI:: Managed From: Dallas (us-south) Resource Group ID: 60735c4daed84fcea7d3fe99c298c9b3 Resource Group Name: Default State: created Created Date: 2025-04-11 03:43:19 -0500 (50 minutes ago) -
커넥터에 속한 에이전트 보기
connector_2.ibmcloud sat agent ls --connector-id U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkYzlzMjF0OWFsMjQ2YXZjMCIOK Name Release Tags sat-link-e2e-wi/connector_2.5924 20250410-5f291315c59db895783cf54411765942806802ac_W connector_2
여러 Windows 에이전트 제거
여러 Windows 에이전트를 제거하려면 다음 명령을 실행하십시오.
.\uninstall.ps1 -configFile config_connector1.json
이 명령은 configFile 에서 SATELLITE_CONNECTOR_INSTANCE_NAME 을 사용하여 Windows 에이전트를 제거합니다.
여러 Windows 에이전트 업데이트
여러 Windows 에이전트를 업데이트하려면 에이전트를 제거하고 구성 파일을 업데이트한 다음 업데이트된 구성 파일을 사용하여 에이전트를 다시 설치하세요.
단일 에이전트 설치
install.ps1 스크립트를 사용하여 단일 에이전트만 설치하려면 다음 단계를 검토하세요.
- configFile 매개 변수를 지정하지 마세요. 이렇게 하면 에이전트 < 1.2.0 >의 이전 버전과의 호환성이 보장됩니다.
- 구성 파일 이름은
config.json이어야 합니다. - 구성 파일
config.json에는SATELLITE_CONNECTOR_INSTANCE_NAME.
단일 호스트에 여러 에이전트를 배포하려면 configFile 매개변수를 사용해야 합니다.
-
CLI에서 다음 명령을 실행하여 에이전트
.zip파일을 다운로드합니다.ibmcloud sat agent attach --platform windows출력 예.
Downloading agent setup tools for windows... OK Satellite connector agent for windows was successfully returned /var/folders/17/y8wr4y_x1tb4yf__g3wr6g8m0000gp/T/windows_satellite_connector_4097559421.zip -
PowerShell 에서 다음 명령을 실행하여
.zip의sha512sum을 확인합니다.Get-FileHash -Algorithm SHA512 -Path c:\windows_satellite_connector_1420916628.zip -
PowerShell 에서 다음 명령을 실행하여
.zip파일 내용을 추출합니다.Expand-Archive -Path 'C:\path\to\windows_satellite_connector_4097559421.zip' -DestinationPath ‘C:\path\to\extract' -
다음 섹션의 단계를 완료하여 추출한 구성 파일을 업데이트합니다.
-
config.json을 수정하고 커넥터 세부 정보를 입력합니다.{ "SATELLITE_CONNECTOR_ID": "<connector_id>", "SATELLITE_CONNECTOR_IAM_APIKEY": "<api_key>", "SATELLITE_CONNECTOR_TAGS": "<tags>", "LOG_LEVEL": "<log_level>", "PRETTY_LOG": <true|false> } -
Windows 호스트에서 설치 명령을 실행합니다.
./install.ps1 -
커넥터에 대한 세부 정보를 확인하세요.
ibmcloud sat connector get --connector-id U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkbjZmMjFyOTJxdTgyZ3BzZyIOK ID: U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkbjZmMjFyOTJxdTgyZ3BzZyI Name: connector CRN: crn:v1:staging:public:satellite:us-south:a/1ae4eb57181a46ceade48465196706a7:U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkbjZmMjFyOTJxdTgyZ3BzZyI:: Managed From: Dallas (us-south) Resource Group ID: 60735c4daed84fcea7d3fe99c298c9b3 Resource Group Name: Default State: created Created Date: 2025-04-11 04:06:33 -0500 (19 minutes ago) -
커넥터에 속한 상담원을 봅니다.
ibmcloud sat agent ls --connector-id U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkbjZmMjFyOTJxdTgyZ3BzZyIOK Name Release Tags sat-link-e2e-wi.5720 20250410-5f291315c59db895783cf54411765942806802ac_W connector
단일 Windows 에이전트 제거
단일 에이전트를 제거하려면 다음 명령을 실행하십시오.
.\uninstall.ps1
단일 Windows 에이전트 업데이트하기
Windows 단일 에이전트를 업데이트하려면 에이전트를 제거하고 구성 파일을 업데이트한 다음 업데이트된 구성 파일을 사용하여 에이전트를 다시 설치합니다.
FAQ
- 기존 단일 Windows 에이전트 설치에 멀티 Windows 에이전트를 추가할 수 있나요?
- 네, 1.2.0 이상 버전의 Windows 에이전트 zip 파일을 다운로드한 후, 기존에 설치된 단일 Windows 에이전트와 다른 디렉터리에 압축을 풀고,
config.json라는 이름이 아닌 구성 파일에서SATELLITE_CONNECTOR_INSTANCE_NAME을 설정하세요. 그런 다음install.ps1 -configFile <agent-config-file.json>를 사용하여 설치하세요. - 버전 >= 1.2 에서
update-service.ps1이 누락된 이유는 무엇인가요? update-service.ps1은 제거한 후 새로 설치하는 것이므로 제거하기로 결정했습니다. Windows 에이전트를 업데이트해야 하는 경우에는 제거한 다음 구성 파일을 업데이트하고 다시 설치하세요.- 내 Windows 호스트에 설치된 Windows 에이전트 버전은 무엇인가요?
- Windows Server에 에이전트를 설치한 디렉터리에는 에이전트 버전이 포함된
version.txt이라는 파일이 있습니다. 디렉터리에version.txt라는 파일이 없는 경우 버전은 <= 1.1.6 입니다. - 어떤 에이전트 버전을 다운로드했나요?
ibmcloud sat agent attach --platform windows명령으로 Windows 에이전트 ZIP 파일을 다운로드하고Expand-Archive -Force -Path "$filename" -DestinationPath "."으로 압축을 풀면 에이전트 버전이 포함된version.txt이라는 파일이 있습니다.