Enterprise Manager 통신 구성 › HTTPS용으로 Enterprise Manager 웹 서버 구성 › 기본 Jetty 구성 파일 › em-jetty-config.xml 파일 수정

em-jetty-config.xml 파일 수정

em-Jetty-config.xml 파일에서 SSL의 여러 구성 요소를 수정할 수 있습니다.

Jetty에 대한 자세한 내용은 http://docs.codehaus.org/display/JETTY/How+to+configure+SSL을 참조하십시오.

• 다음 예제와 같이 port 특성의 값을 변경하여 HTTPS 포트를 기본값인 8444에서 다른 값으로 변경하십시오.

  <Set name="port">8444</Set>
  

• introscope.config 시스템 속성은 config 디렉터리의 위치를 지정합니다. 이 위치는 구성 가능합니다. Enterprise Manager 웹 서버는 시작할 때 introscope.config 시스템 속성을 설정합니다.
• 기본적으로 SSL 수신기는 config 디렉터리를 기준으로 한 상대 경로인 /internal/server/keystore에 있는 키 저장소를 사용하도록 구성되어 있습니다. 이 키 저장소에는 신뢰할 수 없는 자체 서명된 인증서가 포함되어 있습니다. 공인 CA(인증 기관)에서 서명된 인증서를 포함하는 사용자 고유의 키 저장소로 이 인증서를 대체하는 것이 좋습니다.
• 기본 키 저장소 암호는 password입니다. em-jetty-config.xml 및 webview-jetty-config.xml의 일반 텍스트 암호는 기본적으로 난독 처리됩니다. 난독 처리된 암호는 OBF:으로 시작됩니다. 일반 텍스트 암호는 OBF:을 제거하여 제공할 수 있습니다. 자세한 내용은 http://docs.codehaus.org/display/JETTY/How+to+configure+SSL을 참조하십시오.
• 기본적으로 SSL은 자체 서명된 인증서를 허용하도록 구성되어 있으며 클라이언트 URL에 있는 호스트 이름이 디지털 인증서에 있는 호스트 이름과 일치하는지 확인하지 않습니다. 이와 같은 구성 때문에 SSL이 기본 키 저장소에 있는 신뢰할 수 없는 인증서로 즉시 작동할 수 있습니다. 보안이 강화된 인증이 필요한 경우에는 신뢰할 수 있는 인증서가 포함된 키 저장소를 생성한 후 XML에 다음과 같은 특성을 설정하여 기본 키 저장소를 사용자 개인의 키 저장소로 대체하십시오.

  <Set name="validateCertificates">true</Set>
  <Set name="verifyHostnames">true</Set>
  <Set name="keystore"><SystemProperty name="introscope.config" default="./config" />/internal/server/keystore</Set>
  <Set name="password">password</Set>
  

• 또한 클라이언트 인증을 요구하려면 클라이언트 인증서를 포함하는 신뢰 저장소를 생성하고 XML에서 다음 특성을 설정하여 기본 신뢰 저장소를 사용자 고유의 신뢰 저장소로 대체해야 합니다.

  <Set name="needClientAuth">true</Set>
  <Set name="truststore"><SystemProperty name="introscope.config" default="./config" />/internal/server/keystore</Set>
  <Set name="trustPassword">password</Set>
  

• 클라이언트 인증을 사용하려면 Enterprise Manager 웹 서버가 신뢰할 수 있는 인증서가 포함된 키 저장소를 사용하여 에이전트와 Workstation을 구성해야 합니다.

  사용되도록 설정된 암호 그룹을 설정하려면 다음과 같이 cipherSuites 특성을 암호 그룹 목록으로 설정하십시오.

  <Set name="cipherSuites">
    <Array type="java.lang.String">
      <Item>SSL_DH_anon_WITH_RC4_128_MD5</Item>
    </Array>
  </Set>
  

  SSL을 사용하려면 에이전트와 Workstation이 Enterprise Manager와 공통으로 암호 그룹을 사용하도록 설정해야 합니다. 다음과 같은 작업을 수행하도록 암호 그룹을 제한할 수 있습니다.

  • 약한 암호 그룹의 취약성 방지
  • 익명 연결 허용
  • 데이터 암호화 안 함
• Enterprise Manager는 maxThreads 속성을 사용하여 Enterprise Manager가 처리할 수 있는 HTTPS 에이전트 연결 수를 제한합니다. Enterprise Manager는 충분한 스레드가 없을 경우 연결된 에이전트 또는 프로세스 메트릭을 인식하지 못합니다.

  HTTPS를 사용하는 경우 Enterprise Manager는 maxThreads 속성에 구성되어 있는 수의 에이전트만 처리합니다. 허용되는 에이전트 연결 수는 apm-events-thresholds-config.xml 파일의 introscope.enterprisemanager.agent.connection.limit 속성에 구성됩니다. maxThreads 값은 introscope.enterprisemanager.agent.connection.limit 값 이상이어야 합니다. 에이전트가 HTTPS를 통해 연결되도록 구성된 경우 스레드가 충분하지 않으면 일부 HTTPS 에이전트가 클라이언트에 나타나지 않거나 메트릭을 보고하지 않을 수 있습니다.

  참고: maxThreads 속성으로 Enterprise Manager가 처리하는 에이전트 수를 제한하는 경우 Enterprise Manager 및 에이전트 로그에는 처리되지 않는 에이전트에 대한 오류, 경고 또는 메시지가 포함되지 않습니다.

em-Jetty-config.xml을 수정하여 기본 헤더 크기 재설정

CEM 콘솔을 액세스할 때 종종 빈 페이지가 표시되는 경우 4KB인 기본 요청 헤더 크기 제한을 재설정할 수 있습니다. 헤더 크기 제한은 em-jetty-config.xml 파일에서 재설정합니다.

다음 단계를 따르십시오.

1. MOM에서 em-jetty-config.xml 파일을 찾아 이 파일을 텍스트 편집기에서 엽니다.
2. 다음 행이 있는 섹션을 찾습니다.

   <New class="com.wily.webserver.NoNPESocketConnector">
   

3. "NoNPESocketConnector"를 다음 값으로 수정합니다.

   <set name="headerBufferSize">8192</Set>"
   <Set name="RequestBufferSize">16384</Set>"
   

   수정된 섹션의 코드 조각은 다음과 같습니다.

   <Call name="addConnector">
       <Arg>
         <New class="com.wily.webserver.NoNPESocketConnector">
           <Set name="port">8081</Set>
          <set name="headerBufferSize">8192</Set>
          <Set name="RequestBufferSize">16384</Set>
           <Set name="ThreadPool">
             <New class="org.mortbay.thread.BoundedThreadPool">
               <Set name="minThreads">10</Set>
               <Set name="maxThreads">100</Set>
               <Set name="maxIdleTimeMs">60000</Set>
             </New>
           </Set>
         </New>
       </Arg>
     </Call>
   

4. 파일을 저장하고 닫습니다.
5. 각 MOM 및 수집기의 IntroscopeEnterpriseManager.properties 파일을 찾습니다.
6. 다음 행의 주석 처리를 제거합니다.

   introscope.enterprisemanager.webserver.jetty.configurationFile=em-jetty-config.xml
   

7. IntroscopeEnterpriseManager.properties 파일을 저장하고 닫습니다.