LoadBalancer2(r17 RAW)

[목차]
== 개요 ==
 *KT GTV LSM/ADC 서버에서 사용중인 바이너리이다.
 *[[CiGLBServer|CiGLBServer]]로 부터 STB[* Settop Box] 세션 할당 요청을 받아 LB[* LoadBalancer2]는 LB가 관리하는 서버들의 파일 보유 현황과 세션 할당 현황을 확인 해  VOD 서버의 IP를 전달해준다.

=== 해당 프로세스와 연동 된 프로세스 ===
||<-2> ''' 연동된 프로세스 정보''' ||
|| '''프로세스 명''' || '''설명''' ||
|| [[CiGLBServer|CiGLBServer]] || 요청 세션에 대한 서비스 VOD 서버를 결정하는 기능을 수행할 때 연동되는 프로세스입니다. ||
|| [[CiHVODServer|CiHVODServer]] || LoadBalancer2와 연동하여 세션 인증 기능을 제공하는 프로세스입니다.  ||
|| ServiceMonitor || LoadBalancer2 프로세스가 실행될 때 사용되는 모니터링 서비스로, 프로세스를 관리합니다. ||
|| NetIOServer3 || 각 VOD 서버의 보유 파일 리스트를 저장하고, 해당 데이터 기반으로 로드 밸런싱을 수행할 때 연동되는 프로세스입니다.  ||

===# LoadBalancer2 관련 이슈 사항 #===
'''1. 라이브러리 파일 누락으로 인한 에러'''
 *현상 : LSM/ADC 간 절체 후 IntelliV UI에서 LSM 서버의 세션현황 및 대시보드에서 트래픽 수집이 안되는 현상 발생 ( 505 Error 발생)
 *확인 및 조치 방법 : [br] 1. LSM/ADC 서버 OS 버전에 맞는 LoadBalancerSO_64.so 이 존재 하는지 확인 [br]  2. LoadBalancer2 재시작 후?  UI 확인 ( 확인 필요)
== 설정 ==
설정 파일 위치
>/usr/local/castis/LoadBalancer2.cfg

===# 자주 변경 되는 설정 #===
||<-3> '''프로세스 설정 정보''' ||
|| '''설정 값''' || '''설명''' || '''예시''' ||
|| The_Number_Of_Servers=X || LoadBalancer 에 관리되는 서버의 개수 || The_Number_Of_Servers=5[* 관리 하는 VOD 서버 대수가 5대인 경우] ||
|| ServerX_Address=X || LoadBalancer 에 관리되는 서버의 IP[* Bond0 IP] || Server0_Address=111.111.11.11 [br] Server1_Address=111.111.11.22 [br] ... [br] Server4_Address=111.111.11.55  ||
|| ServerX_Priority=X || 세션할당에 대한 우선순위 설정[* 0은 소용량, 1은 대용량, 5는 고성능 서버 대한 설정 [br] 고성능 서버에 대해서만 설정을 추가하거나 제거 한다. ] || Server2_Priority=5 [br] Server3_Address=5 [br] Server4_Address=5[* ServerX_Address 번호 참고해 작성을 할 수있다. [br] 2번, 3번, 5번 서버가 '''고성능''' 서버일 때 예시이다. ]  ||
|| ServerX_TotalTPSCapacityForCueToneLimitPerVOD=X || CueTone 세션 예약시 VOD 에 보내는 TPS 제한 설정[* VOD 서버의 대수 만큼 추가 삭제가 필요하다.] || Server0_TotalTPSCapacityForCueToneLimitPerVOD=500 [br] Server1_TotalTPSCapacityForCueToneLimitPerVOD=500 [br] ... [br] Server4_TotalTPSCapacityForCueToneLimitPerVOD=500[* 관리 하는 VOD 서버 대수가 5대인 경우] ||
|| ServerX_CacheWeight=X || Cache 연동 서버가 선택될 확률에 대한 상대 비중값[* 고성능 서버에 대해서만 설정을 추가하거나 제거 한다.] || Server2_CacheWeight=1 [br] Server3_CacheWeight=1 [br] Server5_CacheWeight=1[* ServerX_Address 번호 참고해 작성을 할 수있다. [br] 2번, 3번, 5번 서버가 '''고성능''' 서버일 때 예시이다. ]   ||
|| ServerX_CacheHashKey=vodX || consistent hashing에서 사용할 노드 키값[* 고성능 서버에 대해서만 설정을 추가하거나 제거 한다.] || Server2_CacheHashKey=vod1 [br] Server3_CacheHashKey=vod2 [br] Server5_CacheHashKey=vod3[* ServerX_Address 번호 참고해 작성을 할 수있다. [br] 2번, 3번, 5번 서버가 '''고성능''' 서버일 때 예시이다. ]  ||
|| CacheListPerServiceX=X,X,vodX || 서비스 타입별 vod 서버 라우팅 기능 || CacheListPerService0=SODE,3,vod1,vod2,vod3 [br] CacheListPerService1=None,8,vod1,vod2,vod3  ... [* ServerX_CacheHashKey=vodX 번호 참고해 작성을 할 수있다. [br] 2번, 3번, 5번 서버가 '''고성능''' 서버일 때 예시이다. ] ||


== Ci Log ==
=== VOD 요청 ===
로드밸런서가 단말(또는 GLB)로부터 특정 파일에 대한 VOD 세션 생성 요청(OnDemandSessionRequest)을 수신했음을 나타내는 로그입니다.
> LoadBalancer2,4.6.3,2024-03-12,09:21:50.407,Information,SLPServerThread.cpp:OnOnDemandSessionRequest(1787),,"OnOnDemandSessionRequest : 67d110a0-7544-4359-8d8f-8aec062b3f67, cb96bb8f-4c45-4a3b-a68a-f78edb6c4e7f, 0, MVIO204ESGL1500001_K20240219092112.mpg, 0, 0, 0, 125.153.250.5, 0, 125.153.250.5, 0, -1, -1, -1, 0, RTSP, "

=== VOD 요청 로그 ===
수신된 VOD 요청에 대해 요청된 파일명, 파일 크기, 비트레이트 등의 상세 정보를 기록하고 내부 관리를 위한 ID를 확인하는 로그입니다.
>LoadBalancer2,4.6.3,2024-03-12,09:21:50.407,Information,SLPServerThread.cpp:OnOnDemandSessionRequest(1812),,"filename[MVIO204ESGL1500001_K20240219092112.mpg], 10526343, 10543824, 10827260, 2.854, StreamID[67d110a0-7544-4359-8d8f-8aec062b3f67], SessionId[cb96bb8f-4c45-4a3b-a68a-f78edb6c4e7f, 0]"

=== 파일이 해당 VOD 서버에 존재 한다는 로그 ===
요청된 콘텐츠 파일이 특정 VOD 서버(하이브리드 서버 또는 메모리 캐시 영역)에 실제로 존재함을 확인하여 해당 서버를 후보로 식별했음을 알리는 로그입니다.
>LoadBalancer2,4.6.3,2024-03-12,09:21:50.407,Information,LoadBalancerApp.cpp:CheckHybridServer(2848),,"Exist requested file in hybrid mem folder for RTSP, DSMCC ip(125.153.250.13) filename(MVIO204ESGL1500001_K20240219092112.mpg) streamID(67d110a0-7544-4359-8d8f-8aec062b3f67)"

=== VOD SetUp 요청에 대한 응답 값 ===
세션 설정(Setup)이 완료되어 실제 스트리밍을 담당할 서비스 IP(ServiceVODIP)와 제어 IP(VODControlIP) 정보를 확정하고 세션 상태를 알리는 로그입니다.
>LoadBalancer2,4.6.3,2024-03-22,07:26:47.543,Information,VODConnectionThread.cpp:OnSessionModifyNotification(1442),,"OnSessionModifyNotification : 5702fea5-dcea-4f0b-98d9-ae9aeccdb43c, 2eede011-ed43-43dd-9495-7ae2a84cb5ed, 23206258, VODControlIP[125.153.250.80], ServiceVODIP[125.153.250.39], state[2]"

=== VOD 세션 종료 ===
VOD 서버로부터 세션 종료(Teardown) 알림을 수신하여, 로드밸런서가 관리하던 해당 세션의 정보를 정리하고 있음을 나타내는 로그입니다.
>LoadBalancer2,4.6.3,2024-03-22,07:38:02.802,Information,VODConnectionThread.cpp:OnTeardownNotification(1703),,"OnTeardownNotification : 5702fea5-dcea-4f0b-98d9-ae9aeccdb43c, 2eede011-ed43-43dd-9495-7ae2a84cb5ed, 23206258, VODControlIP[125.153.250.80]"

== Event Log ==
=== VOD 서버 할당 로그 ===
로드밸런싱 로직에 따라 클라이언트의 요청을 처리할 최적의 VOD 서버(여기서는 125.153.250.13)를 최종적으로 선정하여 할당했음을 기록한 로그입니다.
>0x40ffff,1,1710202910,Server 125.153.250.13 Selected for Client StreamID : 67d110a0-7544-4359-8d8f-8aec062b3f67, ClientID : 0, GLB IP : 125.153.250.5's file(MVIO204ESGL1500001_K20240219092112.mpg) Request