관리 에이전트 프로파일 및 이에 등록된 관리 대상 기본 애플리케이션 서버 세트의 마이그레이션

관리 에이전트 프로파일은 개발, 단위 테스트 또는 단일 시스템에 상주하는 서버 팜의 해당 부분과 같은 환경에서 다중 기본 애플리케이션 서버를 관리합니다. 버전 7.0 이상에서 버전 9.0로 관리 대상 기본 애플리케이션 서버를 마이그레이션하려면 먼저 관리 에이전트를 마이그레이션해야 합니다.

시작하기 전에

지원된 구성 지원된 구성:

이 기사는 프로파일 구성 마이그레이션에 대한 기사입니다. 애플리케이션을 최신 버전으로 마이그레이션하려면 WebSphere® Application Server 마이그레이션 툴킷을 사용하십시오. 자세한 정보는 WASdev의 마이그레이션 툴킷을 참조하십시오.

sptcfg

마이그레이션 계획 정보를 검토하십시오. 지식 콜렉션: WebSphere Application Server 마이그레이션 계획을 참조하십시오.

팁: 마이그레이션 명령에서 개별 매개변수를 지정하지 않고 -properties file_name.properties 매개변수를 지정하여 특성 파일을 입력할 수 있습니다. 자세한 정보는 특성을 통한 마이그레이션 정의을 참조하십시오.

이 태스크 정보

기본 애플리케이션 서버는 단일 관리 에이전트에 등록되면 관리됩니다. 관리 에이전트는 하나 이상의 기본 애플리케이션 서버를 관리할 수 있으며, 관리하는 기본 애플리케이션 서버와 동일한 시스템에 존재하며, 릴리스 레벨도 동일해야 합니다. 이러한 제한사항 때문에 모든 관리 대상 기본 애플리케이션 서버를 마이그레이션할 때까지 이전 릴리스와 새 릴리스 모두에서 관리 에이전트가 동시에 실행됩니다. 관리 에이전트의 마이그레이션은 이전 포트 값을 전달하지 않지만 다른 모든 구성 데이터는 마이그레이션됩니다.

버전 9.0 관리 에이전트의 serverindex.xml 파일에 정의된 대로 WC_ adminhost 또는 WC_ adminhost_ 보안 포트를 사용하여 버전 9.0 관리 에이전트 콘솔에 액세스하십시오. 또한 버전 7.0 이상 관리 에이전트가 이 프로시저 중에 종료되거나 사용 안함으로 설정되지 않아야 합니다.

유연한 관리 환경에서 관리 대상 기본 애플리케이션 서버를 마이그레이션하는 경우 노드 이름이 버전 9.0 및 이전 릴리스와 동일한지 확인하십시오.

문제점 방지 문제점 방지: 최대 열린 파일 수의 설정이 10000 이상인지 확인하십시오. 열린 파일의 수가 너무 적으면 다양한 마이그레이션 장애가 발생할 수 있습니다.gotcha

프로시저

  1. 대상 호스트의 새 디렉토리에 WebSphere Application Server 버전 9.0를 설치하십시오.

    자세한 정보는 설치 문서를 참조하십시오.

  2. 관리 에이전트 마이그레이션의 대상이 되는 버전 9.0 관리 에이전트 프로파일을 작성하십시오.

    적절한 매개변수와 함께 manageprofiles 명령을 실행하여 새 관리 에이전트 프로파일을 작성하십시오.

    예를 들면, 다음과 같습니다.
    /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/manageprofiles -create -profileName AdminAgent01 -templatePath /QIBM/ProdData/WebSphere/AppServer/V9/ND/profileTemplates/management 
    -serverType ADMIN_AGENT-nodeName AdminAgentNode01 -cellName AdminAgentCell01 -hostName mydmgrhost.company.com
  3. 관리 프로파일에서 모든 진행 중인 작업이 완료되었는지 확인하십시오.
  4. 작업 관리자에서 작업을 가져오는 프로파일에서 작업 관리자 폴링을 중지하십시오.

    작업에 대한 폴링을 시작하기 전에 관리 프로파일에 대한 WASPreUpgradeWASPostUpgrade를 완료하십시오. 자세한 정보는 wsadmin 스크립트를 사용한 AdminTask 오브젝트에 대한 ManagedNodeAgent 명령을 참조하십시오.

  5. 새 WebSphere Application Server 설치 루트 bin 디렉토리에서 WASPreUpgrade 명령을 실행하여 현재 관리 에이전트 구성을 마이그레이션 백업 디렉토리에 저장하십시오.

    WASPreUpgrade 명령은 이전 구성을 변경하지 않습니다.

    1. WASPreUpgrade 명령을 실행하십시오.

      명령 매개변수에 대한 정보는 WASPreUpgrade 명령의 내용을 참조하십시오.

      예를 들면, 다음과 같습니다.
      /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/WASPreUpgrade /mybackup/WAS70AdminAgentbackup
      /QIBM/UserData/WebSphere/AppServer/V7/ND/profiles/AppServer70 
      -traceString *=all=enabled -tracefile /mybackup/logs/WASPreMigrationSummary.log
    2. 콘솔 출력 및 WASPreUpgrade 로그에서 경고 또는 오류를 검토하십시오. WASPreUpgrade 명령을 완료한 후 오류로 실패함 또는 경고와 함께 완료됨 메시지의 콘솔 출력을 확인하십시오. 그런 다음, 다음 로그 파일에서 경고 또는 오류를 확인하십시오.
      • migration_backup_dir/logs/WASPreMigrationSummary.log
      • WASPreUpgrade.timestamp.log
      • WASPreUpgrade.trace

      오류가 있는 경우, 오류를 수정하고 WASPreUpgrade 명령을 다시 실행하십시오. 경고가 버전 9.0에서 다른 마이그레이션 또는 런타임 활동에 영향을 주는지 여부를 확인하십시오.

      명령이 성공적으로 완료된 경우 로그에서 오류나 경고가 있는지 확인하지 않아도 됩니다.

  6. WebSphere Application Server 설치 루트 bin 디렉토리에서 WASPostUpgrade 명령을 실행하여 이전 관리 에이전트 구성을 복원하십시오.
    1. WASPostUpgrade 명령을 실행하여 저장된 관리 에이전트 구성을 새 버전 9.0 관리 에이전트 프로파일에 복원하십시오. 예를 들면, 다음과 같습니다.
      /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/WASPostUpgrade /mybackup/WAS70AdminAgentbackup 
      -profileName AdminAgent01 -backupConfig TRUE -includeApps TRUE -keepDmgrEnabled FALSE 
      -username myuser -password mypass
    2. 콘솔 출력 및 WASPostUpgrade 로그에서 경고 또는 오류를 검토하십시오. WASPostUpgrade 명령을 완료한 후 오류로 실패함 또는 경고와 함께 완료됨 메시지의 콘솔 출력을 확인하십시오. 그런 다음, 다음 로그 파일에서 경고 또는 오류를 확인하십시오.
      • migration_backup_dir/logs/WASPostMigrationSummary.log
      • WASPostUpgrade.target_profile_name.timestamp.log
      • WASPostUpgrade.target_profile_name.trace

      오류가 있는 경우에는 오류를 수정하고 WASPostUpgrade 명령을 다시 실행하십시오. 경고가 버전 9.0에서 다른 마이그레이션 또는 런타임 활동에 영향을 주는지 여부를 확인하십시오.

      명령이 성공적으로 완료된 경우 로그에서 오류나 경고가 있는지 확인하지 않아도 됩니다.

  7. 버전 9.0 관리 에이전트를 시작하고 버전 7.0 이상버전 9.0 관리 에이전트 모두가 실행 중인지 확인하십시오.
    1. 버전 9.0 관리 에이전트 프로파일 bin 디렉토리로 변경하십시오.
    2. startServer adminagent 명령을 실행하십시오.
    3. 경고나 오류는 SystemOut.log 파일을 확인하십시오.
      참고: 이 주제는 하나 이상의 애플리케이션 서버 로그 파일을 참조합니다. 권장되는 대안은 분배 및 IBM® i 시스템에서 SystemOut.log, SystemErr.log, trace.logactivity.log 파일을 사용하는 대신 HPEL(High Performance Extensible Logging) 로그를 사용하고 인프라를 추적하도록 서버를 구성하는 것입니다. 원시 z/OS® 로깅 기능과 연계하여 HPEL을 사용할 수도 있습니다. HPEL을 사용하는 경우 서버 프로파일 바이너리 디렉토리의 LogViewer 명령행 도구를 사용하여 모든 로그에 액세스하고 정보를 추적할 수 있습니다. HPEL 사용에 대한 자세한 정보는 HPEL을 사용한 애플리케이션 문제점 해결 정보를 참조하십시오.
  8. 관리 대상 기본 애플리케이션 서버를 마이그레이션하십시오.
    문제점 방지 문제점 방지: 마이그레이션에 성공하려면:
    • 관리 대상 기본 애플리케이션 서버는 연관된 관리 에이전트와 동일한 시스템에 있어야 합니다.
    • 노드 이름은 버전 9.0 및 이전 릴리스와 동일해야 합니다.
    gotcha

    버전 9.0로 마이그레이션할 각 관리 대상 기본 애플리케이션 서버에서 다음 단계를 수행하십시오.

    1. 대상 기본 애플리케이션 서버 프로파일을 작성하십시오. 적절한 매개변수와 함께 manageprofiles 명령을 실행하여 새로운 관리 대상 프로파일을 작성하십시오. 예를 들면, 다음과 같습니다.
      /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/manageprofiles -create -profileName 
      AppSrv01 -templatePath /QIBM/ProdData/WebSphere/AppServer/V9/ND/profileTemplates/default 
      -nodeName AppSrv01Node01 -cellName AppSrv01Cell01 -hostName mynode1host.company.com
    2. WASPreUpgrade 명령을 실행하여 현재 관리 대상 기본 애플리케이션 서버 정보를 마이그레이션 백업 디렉토리로 저장하십시오. 백업 파일에 대한 새 디렉토리를 선택하십시오. 예를 들면, 다음과 같습니다.
      /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/WASPreUpgrade /mybackup/
      WAS70Appserver01backup /QIBM/UserData/WebSphere/AppServer/V7/ND/profiles/AppSrv01
    3. 콘솔 출력 및 WASPreUpgrade 로그에서 경고 또는 오류를 검토하십시오. WASPreUpgrade 명령을 완료한 후 오류로 실패함 또는 경고와 함께 완료됨 메시지의 콘솔 출력을 확인하십시오. 그런 다음, 다음 로그 파일에서 경고 또는 오류를 확인하십시오.
      • migration_backup_dir/logs/WASPreMigrationSummary.log
      • WASPreUpgrade.timestamp.log
      • WASPreUpgrade.trace

      오류가 있는 경우, 오류를 수정하고 WASPreUpgrade 명령을 다시 실행하십시오. 경고가 버전 9.0에서 다른 마이그레이션 또는 런타임 활동에 영향을 주는지 여부를 확인하십시오.

      명령이 성공적으로 완료된 경우 로그에서 오류나 경고가 있는지 확인하지 않아도 됩니다.

    4. WASPostUpgrade 명령을 실행하여 새 버전 9.0 기본 애플리케이션 서버 프로파일로 저장된 관리 대상 애플리케이션 서버 프로파일 구성 을 복원하십시오.
      문제점 방지 문제점 방지: 이 명령에는 추가 매개변수가 필요하며 다음 예제에서는 두 관리 에이전트에서 모두 보안이 사용 가능하다고 가정합니다. gotcha
      예를 들면, 다음과 같습니다.
      /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/WASPostUpgrade 
      /mybackup/WAS70Appserver01backup -profileName AppSrv01 
      -oldAdminAgentProfilePath /QIBM/UserData/WebSphere/AppServer
      /V7/ND/profiles/AdminAgent01 -oldAdminAgentHostname myhostname 
      -oldAdminAgentSoapPort 8879 -oldAdminAgentUsername myusername 
      -oldAdminAgentPassword mypassword -newAdminAgentProfilePath 
      /QIBM/UserData/WebSphere/AppServer/V9/ND/profiles/AdminAgent01 
      -newAdminAgentHostname myhostname -newAdminAgentSoapPort 8887
      -newAdminAgentUsername myusername1 -newAdminAgentPassword mypassword1
    5. 콘솔 출력 및 WASPostUpgrade 로그에서 경고 또는 오류를 검토하십시오. WASPostUpgrade 명령을 완료한 후 오류로 실패함 또는 경고와 함께 완료됨 메시지의 콘솔 출력을 확인하십시오. 그런 다음, 다음 로그 파일에서 경고 또는 오류를 확인하십시오.
      • migration_backup_dir/logs/WASPostMigrationSummary.log
      • WASPostUpgrade.target_profile_name.timestamp.log
      • WASPostUpgrade.target_profile_name.trace

      오류가 있는 경우에는 오류를 수정하고 WASPostUpgrade 명령을 다시 실행하십시오. 경고가 버전 9.0에서 다른 마이그레이션 또는 런타임 활동에 영향을 주는지 여부를 확인하십시오.

      명령이 성공적으로 완료된 경우 로그에서 오류나 경고가 있는지 확인하지 않아도 됩니다.

    6. 마이그레이션된 버전 9.0 관리 대상 애플리케이션 서버를 시작하십시오.
    7. 버전 9.0 관리 대상 애플리케이션 서버 SystemOut.log 파일에서 경고나 오류를 확인하십시오.
      참고: 이 주제는 하나 이상의 애플리케이션 서버 로그 파일을 참조합니다. 권장되는 대안은 분배 및 IBM i 시스템에서 SystemOut.log, SystemErr.log, trace.logactivity.log 파일을 사용하는 대신 HPEL(High Performance Extensible Logging) 로그를 사용하고 인프라를 추적하도록 서버를 구성하는 것입니다. 원시 z/OS 로깅 기능과 연계하여 HPEL을 사용할 수도 있습니다. HPEL을 사용하는 경우 서버 프로파일 바이너리 디렉토리의 LogViewer 명령행 도구를 사용하여 모든 로그에 액세스하고 정보를 추적할 수 있습니다. HPEL 사용에 대한 자세한 정보는 HPEL을 사용한 애플리케이션 문제점 해결 정보를 참조하십시오.

결과

마이그레이션 도구를 사용하여 관리 에이전트 프로파일 및 연관된 관리 대상 기본 애플리케이션 서버를 WebSphere Application Server 버전 7.0 이상에서 버전 9.0으로 마이그레이션했습니다. 이제 버전 7.0 이상 관리 에이전트를 중지하고 버전 7.0 이상 포트를 버전 9.0 관리 에이전트에 지정할 수 있습니다.


주제 유형을 표시하는 아이콘 태스크 주제



시간소인 아이콘 마지막 업데이트 날짜: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-iseries&topic=tmig_migrate_admin_agent
파일 이름:tmig_migrate_admin_agent.html