수동으로 Introscope 업그레이드

Enterprise Manager 및 WebView를 수동으로 업그레이드할 수 있습니다.
apmdevops104kr
Enterprise Manager 및 WebView를 수동으로 업그레이드할 수 있습니다.
수동으로 Introscope 업그레이드
자동화된 설치 관리자를 사용하십시오.
다음 단계를 따르십시오.
  1. 자동화된 설치 관리자를 사용하여 Introscope를 새로 설치합니다.
  2. 기존 구성을 자동화된 설치 관리자가 생성한 디렉터리 및 파일로 수동으로 복사하고 조정합니다.
참고
EPAgent를 업그레이드하려면 새 버전을 설치하고 모든 구성을 수동으로 새 설치에 복사하십시오.
수동 구성 파일 업그레이드 개요
다음 표에는 새 파일로 복사하거나 이동해야 하는 Enterprise Manager 파일 및 속성이 나와 있습니다.
파일 및 위치(
기준)
설명
config/Analytics.properties
업그레이드하기 전에 기존 속성 파일을 백업합니다.
새 버전으로 업그레이드합니다.
새 Analytics.properties 파일을 수동으로 편집하여 이전 파일 값을 반영합니다.
config/CustomDBRecordTypes.properties
이 파일을 새 설치 디렉터리로 복사하여 새로 설치한 버전을 바꿉니다.
config/agentclusters.xml
이 파일을 새 설치 디렉터리로 복사하여 새로 설치한 버전을 바꿉니다.
config/alert-blackout.xml
이 파일을 새 설치 디렉터리로 복사하여 새로 설치한 버전을 바꿉니다.
config/domains.xml
이 파일을 새 설치 디렉터리로 복사하여 새로 설치한 버전을 바꿉니다.
config/em-jetty-config.xml
Jetty 구성 파일은 업그레이드 중에 업데이트되지 않습니다. 사용자 지정 사항이 유지되며 여기에는 보안되지 않은 일반 텍스트 암호가 포함될 수 있습니다. 모든 암호를 변경하고 보호되도록 해야 합니다. 보안 암호에 대한 자세한 내용은 Jetty Documentation Wiki를 참조하십시오.
이 파일을 새 설치 디렉터리로 복사하여 새로 설치한 버전을 바꿉니다.
config/loadbalancing.xml
이 파일을 새 설치 디렉터리로 복사하여 새로 설치한 버전을 바꿉니다.
config/server.xml
이 파일을 새 설치 디렉터리로 복사하여 새로 설치한 버전을 바꿉니다.
config/webview-jetty-config.xml
Jetty 구성 파일은 업그레이드 중에 업데이트되지 않습니다. 사용자 지정 사항이 유지되며 여기에는 보안되지 않은 일반 텍스트 암호가 포함될 수 있습니다. 모든 암호를 변경하고 보호되도록 해야 합니다. 보안 암호에 대한 자세한 내용은 Jetty Documentation Wiki를 참조하십시오.
이 파일을 새 설치 디렉터리로 복사하여 새로 설치한 버전을 바꿉니다.
config/realms.xml
이 파일을 새 설치 디렉터리로 복사하여 새로 설치한 버전을 바꿉니다.
config/ResourceMetricMap.properties
이 파일을 새 설치 디렉터리로 복사하여 새로 설치한 버전을 바꿉니다.
config/users.xml
참고
: CA CEM에 올바르게 연결하려면 이 파일에 CA CEM 사용자 및 그룹 정의를 추가해야 하는지 조사하십시오.
이 파일을 새 설치 디렉터리로 복사하여 새로 설치한 버전을 바꿉니다.
c
onfig/IntroscopeEnterpriseManager.properties
지정된 단일 속성과 사용자 지정된 모든 절대 경로를 제외한 사용자 지정된 속성을 모두 복사합니다.
특히 다음 속성을 주의하여 처리하십시오.
introscope.enterprisemanager.webserver.dir
config/shutoff/
이 디렉터리를 새 설치로 복사하여 새로 설치한 버전을 바꿉니다.
Introscope_Enterprise_Manager.lax
지정된 목록에 있는 속성을 제외한 모든 사용자 지정된 속성을 복사합니다. 자세한 내용은 Introscope_Enterprise_Manager.lax 업그레이드를 참조하십시오.
EMService.conf
이 파일은
<EM 홈>
\bin에 있습니다.
지정된 목록에 있는 속성을 제외한 모든 사용자 지정된 속성을 복사합니다. 자세한 내용은 EMService.conf 업그레이드를 참조하십시오.
product/enterprisemanager/configuration/.settings/users.prefs
이 파일을 새 설치 디렉터리에 복사하여 새로 설치한 버전을 바꿉니다.
runem.sh
JVM이 번들로 포함되지 않은 .JAR 설치 관리자에서만 이 파일이 제공됩니다. 업그레이드하는 동안 backup/iscXx에 파일이 백업된 후 대체됩니다. 이전 설정은 보존되지 않습니다.
적절한
JAVA_HOME
및 기타 모든 사용자 지정 설정으로 새 파일을 사용자 지정하십시오.
다음과 같은 Enterprise Manager 클램프 속성은
IntroscopeEnterpriseManager.properties
파일에 있습니다.
introscope.enterprisemanager.agent.connection.limit
introscope.enterprisemanager.agent.error.limit
introscope.enterprisemanager.agent.metrics.limit
introscope.enterprisemanager.agent.trace.limit
introscope.enterprisemanager.metrics.live.limit
introscope.enterprisemanager.events.limit
introscope.enterprisemanager.metrics.historical.limit
introscope.enterprisemanager.transactionevents.storage.max.disk.usage
이러한 클램프 속성을
/con
fig/apm-events-thresholds.xml 파일로 이동합니다.
다음과 같은 CA CEM 클램프 속성은
tess-defaults.properties
파일에 있습니다.
maxNumberDomainConfigurationChanges
Autogen.Max.NonIdentifying.Components
maxUserGroups
maxUserRows
이러한 클램프 속성을
/con
fig/apm-events-thresholds.xml 파일로 이동합니다.
다음과 같이 속성 이름을 바꾸십시오.
maxNumberDomainConfigurationChanges
->
introscope.enterprisemanager.max.number.domain.configuration.changes
Autogen.Max.NonIdentifying.Components
->
introscope.enterprisemanager.transaction.discovery.max.nonidentifying.components
maxUserGroups
->
introscope.enterprisemanager.max.transaction.user.groups
maxUserRows
-> introscope.enterprisemanager.max.application.user.rows
다음은 속성을 새 파일로 복사하거나 이동해야 하는 WebView 파일입니다.
파일 및 위치(
기준)
설명
config/IntroscopeWebView.properties
모든 사용자 지정된 속성을 새로 설치한 파일로 복사합니다.
WVService.conf
이 파일은
<EM 홈>
\bin에 있습니다
.
지정된 목록에 있는 속성을 제외한 모든 사용자 지정된 속성을 복사합니다. 자세한 내용은 WVService.conf 업그레이드를 참조하십시오.
Introscope_WebView.lax
지정된 목록에 있는 속성을 제외한 모든 사용자 지정된 속성을 복사합니다. 자세한 내용은 Introscope_WebView.lax 업그레이드를 참조하십시오.
Introscope_WebView
WebView 실행 파일입니다.
Enterprise Manager 수동 업그레이드
다음 지침에 따라 Enterprise Manager를 수동으로 업그레이드하십시오. 지침은 Enterprise Manager 설치의 파일 및 폴더에 따라 구분되어 있습니다.
중요!
9.x에서 10.5로 업그레이드하는 경우 수동 단계를 수행하여 기존 데이터를 마이그레이션해야 합니다.
수동으로 기존 SmartStor 데이터 마이그레이션
9.x 클러스터의 데이터를 새로운 10.5 클러스터로 마이그레이션하려면 수동 데이터 마이그레이션 단계를 수행해야 합니다. 설치 관리자는 introscope.enterprisemanager.smartstor.directory.metadata 속성 파일을 업그레이드하지 않습니다. 기본적으로 데이터는 <EM 홈/data/metadata>로 이동합니다. 업그레이드된 Enterprise Manager를 처음으로 실행하면 EM이 데이터를 업그레이드합니다.
다음 절차에서는 기존 데이터를 복사하지 않고 EM을 시작한 경우의 작업 진행 방법을 보여 줍니다.
다음 단계를 따르십시오.
  1. introscope.enterprisemanager.smartstor.directory.metadata를 수정하여 SmartStor 데이터 디렉터리에 있는 metadata 폴더로 설정합니다.
  2. <EM 홈/data>의 이름을 <EM 홈/data_backup>으로 바꿉니다.
  3. 파일이 있는 경우 <SS 홈/metadata>의 이름을 <SS 홈/metadata_backup>으로 바꿉니다.
  4. EM을 시작합니다. EM이 <SS 홈>에서 기존 메타데이터 파일을 업그레이드합니다.
모든 데이터를 볼 수 있습니다.
IntroscopeEnterpriseManager.properties 업그레이드
다음 속성은 주의하여 다루어야 합니다. 모든 기타 사용자 지정된 속성 값은 새로 설치된
IntroscopeEnterpriseManager.properties
파일에 있는 그대로 수동으로 복사할 수 있습니다.
  • introscope.enterprisemanager.webserver.dir
    속성이
    webapps
    가 아닌 다른 값으로 구성된 경우:
    • 속성을 새 설치의
      IntroscopeEnterpriseManager.properties
      파일로 전송합니다.
    • <
      EM 홈
      >/webapps의 새로 설치된 모든 웹 응용 프로그램을 사용자 지정 디렉터리로 수동으로 복사합니다.
  • Introscope 디렉터리의 이름을 변경했고, 속성 파일이 Introscope 디렉터리의 참조 파일에 대한 절대 경로를 사용한 경우 이러한 경로를 수동으로 업데이트하십시오. Introscope 루트 디렉터리 내의 파일을 참조하는 데 상대 경로를 사용하는 것이 좋습니다.
EMService.conf 업그레이드
참고
최신 버전에서는 이 파일이 다른 위치에 있습니다. EMService.conf는 이제
<EM 홈>\bin
에 있습니다. 이전 버전에서 이 파일은
에 있었습
니다.
새로 설치된
EMService.conf
파일에 다음과 같은 속성을 전송하지 마십시오. 새 설치에는 다음과 같은 기본 설정을 사용하십시오.
  • wrapper.java.command
  • wrapper.app.parameter.*
  • wrapper.java.classpath.*
  • wrapper.native_library.*
이전 파일에서 새로 설치된 버전으로 기타 모든 사용자 지정된 속성 값을 전송할 수 있습니다.
Introscope_Enterprise_Manager.lax 업그레이드
새로 설치된
Introscope_Enterprise_Manager.lax
파일에 다음과 같은 속성을 전송하지 마십시오.
  • lax.class.path
  • lax.version
  • lax.main.class
  • lax.command.line.args
  • lax.nl.valid.vm.list
  • lax.nl.message.vm.not.loaded
이전 파일에서 새로 설치된 버전으로 기타 모든 사용자 지정된 속성 값을 전송할 수 있습니다.
WebView 수동 업그레이드
WebView를 수동으로 업그레이드하려면 다음 지침을 따르십시오. 지침은 설치의 파일/폴더에 따라 구분되어 있습니다.
IntroscopeWebView.properties 업그레이드
IntroscopeWebView.properties
파일의 모든 사용자 지정된 속성 값은 이 파일의 새로운 버전으로 있는 그대로 전송될 수 있습니다.
WVService.conf 업그레이드
새로 설치된
WVService.conf
파일에 다음과 같은 속성을 전송하지 마십시오.
  • wrapper.java.command
  • wrapper.app.parameter.*
  • wrapper.java.classpath.*
이전 파일에서 새로 설치된 버전으로 기타 모든 사용자 지정된 속성 값을 전송할 수 있습니다.
Introscope_WebView.lax 업그레이드
새로 설치된
Introscope_WebView.lax
파일에 다음과 같은 속성을 전송하지 마십시오.
  • lax.class.path
  • lax.version
  • lax.main.class
  • lax.command.line.args
  • lax.nl.valid.vm.list
  • lax.nl.message.vm.not.loaded
이전 파일에서 새로 설치된 버전으로 기타 모든 사용자 지정된 속성 값을 전송할 수 있습니다.
Enterprise Manager 수동 업그레이드 완료
참고
: CA APM 8.x는 지원되지 않습니다.
수동 업그레이드를 완료하려면 특정 파일을 이전 Enterprise Manager에서 새 Enterprise Manager로 수동으로 복사하십시오.
다음 단계를 따르십시오.
  1. 다음과 같은 구성 요소를 이전 Enterprise Manager에서 새 Enterprise Manager로 수동으로 복사합니다.
    • 모든 사용자 지정된 관리 모듈
    • 모든 사용자 지정 확장
    • 모든 사용자 지정 문서
  2. 유지하려는 데이터 또는 로그 파일을 이전 Enterprise Manager에서 새 Enterprise Manager로 수동으로 복사합니다. 다음 목록에는 유지하는 것이 권장되는 파일이 나와 있습니다.
    • Enterprise Manager
      data/*
      traces/*
      perflog.txt
      querylog.txt
    • Enterprise Manager 또는 WebView
      모든 사용자 지정 SSL 키 파일
      logs/*.LOG
    • EPAgent
      모든 사용자 지정된 EPAgent 파일
    데이터 또는 로그 파일을 유지하려면 해당 파일을 이전 Enterprise Manager에서 새 Enterprise Manager로 수동으로 복사하십시오.
    참고
    데이터 파일이 공유 디렉터리(예: \\mySAN\data)에 있는 경우 파일을 이동할 필요가 없습니다. 이동하는 대신 새 설치의
    IntroscopeEnterpriseManager.properties
    파일을 공유 위치를 가리키도록 편집하십시오.
  3. <
    EM 홈
    >/ext 디렉터리에 다음과 같은 SNMP 플러그 인 JAR 파일이 있는 경우 해당 파일을 제거하십시오.
    SNMPAlertActionEM.jar
    SNMPAlertActionWS.jar
참고:
 EPAgent 스크립트 또는 JavaScript 계산기의 사용자 지정과 관련된 지원을 받으려면 CA APM Implementation Services에 문의하십시오.
업그레이드 후 관리 모듈 복원
해당 제품:
9.6, 9.7, 10.0, 10.1, 10.2, 10.3
Enterprise Manager를 업그레이드해도 사용자 지정된 관리 모듈 파일은 삭제되지 않습니다. 이러한 파일은 업그레이드 중에 백업 디렉터리에 복사됩니다. Enterprise Manager를 업그레이드한 후 사용자 지정된 관리 모듈을 관리할 수 있습니다. 이러한 관리 모듈에는 다음에 대한 사용자 지정 사항이 포함될 수 있습니다.
  • ADA Extension for APM(CA APM Integration for CA Application Delivery Analysis)
  • CEM BT 통계
  • ChangeDetector
  • 샘플
  • 차이 분석
  • Triage Map Configurations
  • 지원 기능
  • SOA Performance Management
다음 단계를 따르십시오.
  1. 다음 관리 모듈을 사용하지 않는 경우 <
    EM 홈
    >/config/modules 디렉터리에서 백업 디렉터리로 이동합니다.
    • ADA-APM_ManagementModule.jar
    • BtStats_ManagementModule.jar
    • ChangeDetectorManagementModule.jar
  2. 다음 관리 모듈에 이전 Enterprise Manager의 사용자 지정 구성 데이터가 포함되어 있는 경우 이 데이터를 <
    EM 홈
    >/config/modules 디렉터리의
    DefaultMM.jar
    로 이동합니다. 사용자 지정 데이터의 예로는 알림 또는 메트릭 그룹화가 있습니다.
    • SampleManagementModule.jar
    • 차이 분석
  3. "Triage Map Configuration"(심사 맵 구성) 관리 모듈에 이전 Enterprise Manager의 사용자 지정 구성 데이터가 포함되어 있는 경우 이 데이터를 <
    EM 홈
    >/config/modules 디렉터리의
    SystemMM.jar
    로 이동합니다. 사용자 지정 데이터의 예로는 작업, 알림 및 메트릭 그룹화가 있습니다.
  4. Enterprise Manager를 다시 시작합니다.
추가 정보: