Configuration Agent

Configuration Agent는 다음 표에 열거된 여러 패키지 중 하나입니다.

이 패키지를 설치할 때 이 API에 필요한 파일이 설치됩니다. 패키지는 수동으로 설치하거나 Java Desktop System 설치를 통해 설치할 수 있습니다. 설치한 후에는 시스템에서 Configuration Agent을 구성하여 활성화해야 합니다.

원격 구성 데이터에 액세스하려면 Configuration Agent에 LDAP 서버의 호스트 이름, 포트 등 최소한의 부트스트랩 정보를 제공해야 합니다. 이 정보는 policymgr.properties, apocd.properties 및 os.properties 같은 등록 정보 파일로 유지 관리됩니다. 이 파일은 /etc/apoc 디렉토리에 로컬로 저장되어 있습니다. 이러한 등록 파일을 수동으로 편집하거나 Configuration Agent의 구성 마법사를 사용할 수 있습니다.

구성 마법사는 Configuration Agent의 필요한 설정을 안내하는 그래픽 사용자 인터페이스를 제공합니다. 각 마법사 페이지에서는 해당 도움말 화면을 사용할 수 있습니다 . /usr/bin/apoc-config 스크립트를 사용하여 수퍼 유저(root)로 마법사를 시작할 수 있습니다. 기본 설정/ 시스템 도구/네트워크 설정, 또는 Nautilus 파일 관리자의 시스템-설정:///네트워크 설정에서도 해당 데스크탑 메뉴 항목을 사용할 수 있습니다.

그래픽 인터페이스를 시작하지 않고 마법사를 시작할 수도 있습니다. 예를 들어, 콘솔 모드로 마법사를 시작하려면 /usr/bin/apoc-config -nodisplay를 실행합니다.

부트스트랩 정보

그림 5–1 Configuration Agent, 구성 저장소

해당되는 경우 연결된 등록 정보 파일 키가 괄호 안에 표시되어 있습니다.

• 서버 식별자(Server): LDAP 서버의 호스트 이름

• 서버 포트(Port): LDAP 서버의 포트 번호

• 접미어(BaseDn): LDAP 저장소의 기본 DN

• 상태: Configuration Agent의 상태. 이 확인란을 사용하여 Configuration Agent를 활성화하거나 비활성화할 수 있습니다. 구성 저장소를 사용하려면 Configuration Agent를 활성화해야 합니다. 활성화하면 inetd에 자동으로 등록됩니다.

  ---

  주 –

  Configuration Agent를 수동으로 활성화 또는 비활성화하려면 root로 로그인하여 각각 /usr/lib/apocd enable 또는 /usr/lib/apocd disable 명령을 입력합니다.

  ---

그림 5–2 Configuration Agent, 인증 체계

• 호스트 식별자(HostIdentifier): "HostName" 또는 "IPAddress" 중 하나일 수 있습니다. 호스트 식별자는 호스트를 식별하는 데 사용되는 LDAP 속성의 내용과 일치하도록 설정해야 합니다. 이 속성은 매핑 파일에서 Host/UniqueIdAttribute로 정의됩니다.

• Configuration Agent의 인증 유형: "익명" 또는 "단순" 중 하나일 수 있습니다. "익명"을 선택하면 정규화된 사용자 이름 및 암호 필드는 자동으로 사용할 수 없게 됩니다.

• 정규화된 사용자 이름(AuthDn): 저장소에 대한 읽기 및 검색 액세스 권한을 가진 사용자의 전체 DN

• 암호(Password): 등록된 LDAP 사용자 암호

  ---

  주 –

  디렉토리에서 익명 액세스가 활성화되면 정규화된 사용자 이름 및 암호 설정을 비워둘 수 있습니다.

  ---

• 응용 프로그램의 인증 유형(AuthType): LDAP 서버가 사용자를 인증하는 방법에 따라, 이 옵션은 “익명” 또는 “GSSAPI”가 될 수 있습니다.

  ---

  주 –

  자세한 내용은 데이터 액세스/사용자 인증을 참고하십시오.

  ---

포트 설정

Configuration Agent는 다음 두 포트를 사용합니다.

• 에이전트 포트(DaemonPort): 에이전트가 클라이언트 응용 프로그램과 통신하는 데 사용합니다(기본값: 38900).

• 관리 포트 (DaemonAdminPort): 에이전트 제어 프로그램인 apocd가 에이전트와 통신할 때 사용합니다(기본값: 38901).

그림 5–3 Configuration Agent, 포트 설정

변경 감지 간격

Configuration Agent는 다음 두 가지 간격을 사용하여 구성 데이터의 변경 사항을 정기적으로 확인합니다.

• 일반 감지 간격(ChangeDetectionInterval): 데스크탑 응용 프로그램(클라이언트)의 구성 데이터에 대한 변경 감지 주기 간격(분)

  ---

  주 –

  -1로 지정하면 변경 감지가 수행되지 않습니다.

  ---

• 에이전트 설정 간격(DaemonChangeDetectionInterval): 에이전트 특정 구성 설정에 대한 변경 감지 주기 간격(분)

  ---

  주 –

  -1로 지정하면 변경 감지가 수행되지 않습니다.

  ---

일반 감지 간격을 사용하여 원하는 대로 원격 구성 데이터 변경 사항을 클라이언트측 응용 프로그램으로 전파할 수 있습니다. 이 설정에 지정되는 값은 원격 변경 사항이 클라이언트 응용 프로그램에서 적용될 때까지 최대 지연 시간(분)입니다.

작은 값을 지정하면 Configuration Agent와 LDAP 서버 작업이 증가하므로설정 값을 변경할 때는 주의해야 합니다. 예를 들어, 초기 배포 단계에서 클라이언트 응용 프로그램에 대한 원격 구성의 영향을 쉽게 테스트하기 위해 이 값을 1분으로 설정했다가 테스트가 끝나면 다시 이 설정을 원래 값으로 되돌릴 수 있습니다.

작동 설정

그림 5–4 Configuration Agent, 데이터 디렉토리

다음 설정을 구성할 수 있습니다.

• 데이터 디렉토리(DataDir): 런타임 데이터를 저장하는 데 사용되는 디렉토리. 기본값은 /var/opt/apoc입니다.

• 캐시된 데이터 저장소 수명(TimeToLive): 오프라인 상태가 아닌 구성 데이터가 로컬 데이터베이스에 보관되는 시간(분)

그림 5–5 Configuration Agent, 요청 처리 및 로깅

• 가비지 컬렉션 주기(GarbageCollectionInterval): 로컬 구성 데이터베이스의 가비지 컬렉션 주기 간격(분)

• 최대 클라이언트 스레드(MaxClientThreads): 동시에 처리될 수 있는 최대 클라이언트 요청 수

• 최대 클라이언트 연결(MaxClientConnections): 최대 클라이언트 연결 수

• 최대 요청 크기(MaxRequestSize): 최대 클라이언트 요청 크기

• 연결 시간 제한(ConnectTimeout): LDAP 서버가 연결 요청에 응답할 수 있는 간격. 기본값은 1초입니다.

• 로그 수준(LogLevel): 에이전트 로그 파일에 기록되는 세부 정보 수준. 로깅 수준은 Java Logger 수준과 같아야 합니다. 로깅 수준을 가장 높은 것부터 순서대로 나열하면

  • SEVERE

  • WARNING

  • INFO

  • CONFIG

  • FINE

  • FINER

  • FINEST

데이터 디렉토리 설정과 연결 시간 제한 설정을 제외한 대부분의 작동 설정은 LDAP 서버에 저장된 해당 정책을 통해 중앙 집중식으로 유지 관리할 수도 있습니다. 이 기능을 사용하려면 마법사를 사용하여 해당 설정을 적용하지 마십시오. 대신 Configuration Manager 내의 Configuration Agent 정책을 사용하여 작동 설정을 중앙 집중식으로 지정하십시오.

에이전트 설정 적용

"데이터 디렉토리" 및 "연결 시간 제한" 설정 외에 Configuration Manager를 사용하여 LDAP 서버에 저장된 작동 설정은 다음 에이전트 구성 변경 감지 주기에 자동으로 적용됩니다(DaemonChangeDetectionInterval 참조).

그림 5–6 Configuration Agent, 요약 페이지

로컬에서 변경된 다른 모든 설정의 경우에는 Configuration Agent를 다시 로드하거나 다시 시작해야 합니다. 구성 마법사를 사용하는 경우 다시 로드하거나 다시 시작하는 작업은 자동으로 수행됩니다.

Configuration Agent를 수동으로 다시 시작하려면 관련된 클라이언트 응용 프로그램이 실행되고 있지 않은지 확인하고 루트로 로그인하여 /usr/lib/apoc/apocd restart 명령을 입력합니다.