TUXEDO MP Mode Migration 사용방법

 

1. 준비사항

Ø  필수조건

마이그레이션 기능은 마스터와 백업 머신 둘다 동일한 턱시도 배포판에서 운영되어야 하며, 여러 슬레이브 노드에 설치되어 있는 턱시도 배포판보다 버전이 같거나 높아야 한다.

 

Ø  마이그레이션 방법

l  마스터 머신과 백업 머신간 DBBL 프로세스 스위칭 l  기본 머신에 있는 한 서버그룹을 대체 머신으로 마이그레이션 l  기본 머신에 있는 서버그룹 전체를 대체 머신으로 마이그레이션 l  마이그레이션 취소 l  트랜잭션 로그 마이그레이션

 

 

2. 사용방법

Ø  마스터 머신과 백업 머신간 DBBL 프로세스 스위칭

스위칭상황	- 네트워크이 단절되어 더 이상 마스터 머신에 접근할 수 없는 경우 - 유지보수를 위해 마스터 머신을 셧다운할 필요성이 있을 경우
스위칭결과	DBBL 프로세스를 마스터 머신에서 백업 머신으로 이동
사용방법	1) 백업 머신에서 tmadmin 명령 실행 2) 프롬프트에서 master -y 명령 실행

참고설명) 마스터 머신이 정상 복구된 경우 DBBL 프로세스를 원래대로 복구하는 것이 권고안임

Ø  UBBCONFIG 환경설정

*RESOURCES MASTER M001,M002

참고설명) OPTIONS 파라미터에 MIGRATE 이 설정되어 있지 않아도 됨

Ø  마스터 머신이 사용한 가능한 상태에서 스위칭하는 경우(M002 에서 실행)

[santa-]/home/khk/tux/env> tmadmin tmadmin - Copyright (c) 1996 BEA Systems, Inc. Portions * Copyright 1986-1997 RSA Data Security, Inc. All Rights Reserved. Distributed under license by BEA Systems, Inc. TUXEDO is a registered trademark.   > master Are you sure? [y, n] y   Migrating active DBBL from M001 to M002, please wait ... DBBL has been migrated from M001 to M002   >

Ø  마스터 머신이 사용불가능한 상태에서 스위칭하는 경우(M002 에서 실행)

[santa-]/home/khk/tux/env> tmadmin tmadmin - Copyright (c) 1996 BEA Systems, Inc. Portions * Copyright 1986-1997 RSA Data Security, Inc. All Rights Reserved. Distributed under license by BEA Systems, Inc. TUXEDO is a registered trademark. TMADMIN_CAT:199: WARN: Cannot become administrator.Limited set of commands available.   > master Are you sure? [y, n] y   Creating new DBBL on M002, please wait ... New DBBL created on M002   > psr Prog Name      Queue Name  Grp Name      ID RqDone Load Done Current Service ---------      ----------  --------      -- ------ --------- --------------- BBL            30003.00000 M002           0      -         - ( - ) BBL            30002.00000 M001           0      -         - ( PARTITIONED ) DBBL           41251       M002           0     36      1800 (  IDLE ) BRIDGE         565539      M002           1      -         - ( - ) BRIDGE         303395      M001           1      -         - ( PARTITIONED )   >

Ø  기본 머신에 있는 한 서버그룹을 대체 머신으로 마이그레이션

마이그레이션 방법	1) tmadmin 명령 실행 2) migrategroup 명령 실행
migrategroup 사용법	migrategroup(migg) [-cancel] group_name

참고사항) 마이그레이션 하기 전에 해당 그룹을 셧다운하지 않으면 다음과 같은 오류가 발생한다.

144014.santa!tmadmin.2156: 050302: TUXEDO Version 6.5 144014.santa!tmadmin.2156: TMADMIN_CAT:1330: INFO: Command: migg G005 144014.santa!tmadmin.2156: LIBTUX_CAT:1037: ERROR: Migration failed: server not shutdown 144014.santa!tmadmin.2156: LIBTUX_CAT:439: ERROR: Migration failed: Not all the servers are shutdown

참고사항) 해당 그룹에 속한 서버를 셧다운 할 경우 -R(elocate) 옵션을 사용하고자 하면

          반드시 서버 섹션에 RESTART=Y 로 설정을 해야 한다.

          만약, 설정을 하지 않고 tmshtdown -R 옵션을 사용하게 되면 다음과 같은 오류가 발생

          하면서 해당 서버는 바로 셧다운 된다.

권고사항) 해당 그룹에 속한 서버 섹션에 RESTART=Y 속성을 설정하도록 할 것

[uclick-]/home/khk/tux/env> tmshutdown -R -g G005   Shutting down server processes ...           Server Id = 200 Group Id = G005 Machine = M001: tmshutdown: WARN: internal error: CMDTUX_CAT:1359: ERROR: Server ID 200 in group G005 not marked as restartable.  This server will not be restarted upon migration.   shutdown succeeded 1 process stopped. [uclick-]/home/khk/tux/env>

참고사항) 관련 ULOG 출력내용

145148.uclick!tmshutdown.16500: 05032002: TUXEDO Version 6.5 SunOS  5.5.1 Generic_103640-29 sun4u sp arc SUNW,Ultra-1. 145148.uclick!tmshutdown.16500: WARN: internal error: CMDTUX_CAT:1359: ERROR: Server ID 200 in group  G005 not marked as restartable.  This server will not be restarted upon migration. 145148.uclick!TMSYSEVT.16494: CMDTUX_CAT:3010: INFO: TMSYSEVT is exiting

 

 

 

Ø  UBBCONFIG 환경설정

*RESOURCES OPTIONS LAN,MIGRATE

참고설명) 만약, MIGRATE 이 설정되어 있지 않으면 migrategroup(migg), migratemach(migm) 명령

          실행시 다음과 같은 오류가 발생한다.

[santa-]/home/khk/tux/env> tmadmin tmadmin - Copyright (c) 1996 BEA Systems, Inc. Portions * Copyright 1986-1997 RSA Data Security, Inc. All Rights Reserved. Distributed under license by BEA Systems, Inc. TUXEDO is a registered trademark.   > migg G005 TMADMIN_CAT:552: ERROR: Migration not allowed   > migm M001 TMADMIN_CAT:557: ERROR: Migration not allowed   >

 

Ø  사용형태

기본 머신 사용가능 (네트워크 접속가능)	①   tmshutdown -R -g 그룹명 ②   tmadmin 실행 ③   migg 그룹명 실행 ④   TLOG 이동(if necessary) ⑤   필요한 자료들(if necessary)	마스터 머신에서 실행
기본 머신 사용불가 (네트워크 접속불가)	①   DBBL 스위칭(if necessary) ②   tmadmin 실행 ③   pclean(pcl) Primary-LMID ④   migg 그룹명 실행 ⑤   tmboot -g 그룹명	대체 머신에서 실행

Ø  사용예제-기본 머신 사용가능

[uclick-]/home/khk/tux/env> tmshutdown -R -g G005   Shutting down server processes ...           Server Id = 200 Group Id = G005 Machine = M001: shutdown succeeded 1 process stopped. [uclick-]/home/khk/tux/env> tmadmin tmadmin - Copyright (c) 1996 BEA Systems, Inc. Portions * Copyright 1986-1997 RSA Data Security, Inc. All Rights Reserved. Distributed under license by BEA Systems, Inc. TUXEDO is a registered trademark.   > migg G005 migg successfully completed.   > psr Prog Name      Queue Name  Grp Name      ID RqDone Load Done Current Service ---------      ----------  --------      -- ------ --------- --------------- TMSYSEVT       00005.00200 G005         200      -         - ( - ) BBL            30003.00000 M002           0      -         - ( - ) BBL            30002.00000 M001           0      -         - ( - ) DBBL           41251       M001           0     93      4650 ..MASTERBB BRIDGE         565539      M002           1      -         - ( - ) BRIDGE         303395      M001           1      -         - ( - )   >

Ø  사용예제-기본 머신 사용불가

[santa-]/home/khk/tux/env> tmadmin tmadmin - Copyright (c) 1996 BEA Systems, Inc. Portions * Copyright 1986-1997 RSA Data Security, Inc. All Rights Reserved. Distributed under license by BEA Systems, Inc. TUXEDO is a registered trademark. TMADMIN_CAT:199: WARN: Cannot become administrator.Limited set of commands available.   > master Are you sure? [y, n] y   Creating new DBBL on M002, please wait ... New DBBL created on M002     > psr Prog Name      Queue Name  Grp Name      ID RqDone Load Done Current Service ---------      ----------  --------      -- ------ --------- --------------- TMSYSEVT       00005.00200 G005         200      -         - ( PARTITIONED ) BBL            30003.00000 M002           0      -         - ( - ) BBL            30002.00000 M001           0      -         - ( PARTITIONED ) DBBL           41251       M002           0      9       450 (  IDLE ) BRIDGE         565539      M002           1      -         - ( - ) BRIDGE         303395      M001           1      -         - ( PARTITIONED )   >

참고설명) 위 경우는 M002 가 백업 마스터로 설정되어 있어서 master 명령으로 DBBL 프로세스

          를 마이그레이션 한 경우임

[santa-]/home/khk/tux/env> tmadmin tmadmin - Copyright (c) 1996 BEA Systems, Inc. Portions * Copyright 1986-1997 RSA Data Security, Inc. All Rights Reserved. Distributed under license by BEA Systems, Inc. TUXEDO is a registered trademark.   > psr Prog Name      Queue Name  Grp Name      ID RqDone Load Done Current Service ---------      ----------  --------      -- ------ --------- --------------- TMSYSEVT       00005.00200 G005         200      -         - ( PARTITIONED ) BBL            30003.00000 M002           0      -         - ( - ) BBL            30002.00000 M001           0      -         - ( PARTITIONED ) DBBL           41251       M002           0     15       750 ..MASTERBB BRIDGE         565539      M002           1      -         - ( - ) BRIDGE         303395      M001           1      -         - ( PARTITIONED )   > pcl M001           Cleaning the DBBL.         Pausing 10 seconds waiting for system to stabilize.         3 M001 servers removed from bulletin board   > migg G005 migg successfully completed.   > boot -g G005 INFO: TUXEDO(r) System Release 6.5 INFO: Serial #: 1000036370, Expiration NONE, Maxusers 6481 INFO: Licensed to: Korea Telecom ICIS   Booting server processes ...   exec TMSYSEVT -A -r :         on M002 -> process id=2787 ... Started. 1 process started.   > psr Prog Name      Queue Name  Grp Name      ID RqDone Load Done Current Service ---------      ----------  --------      -- ------ --------- --------------- TMSYSEVT       00005.00200 G005         200      -         - ( - ) BBL            30003.00000 M002           0      -         - ( - ) DBBL           41251       M002           0     39      1950 ..MASTERBB BRIDGE         565539      M002           1      -         - ( - )   >

 

 

Ø  기본 머신에 있는 서버그룹 전체를 대체 머신으로 마이그레이션

마이그레이션 방법	1) tmadmin 명령 실행 2) migratemach 명령 실행
migratemach 사용법	migratemach (migm) [-cancel] machine

참고사항) 기본 머신에 있는 한 서버그룹을 대체 머신으로 마이그레이션 방법과 마찬가지로

          마이그레이션을 하기 위한 선행절차가 필요함.

전제조건) 특정 LMID 에 속한 서버그룹을 모두 마이그레이션 할 경우, 반드시 그룹 섹션에

          정의되어 있는 모든 그룹의 LMID 에는 대체 머신의 LMID 가 설정되어 있어야 한다.

Ø  사용형태

기본 머신 사용가능 (네트워크 접속가능)	①   tmshutdown -R -l LMID ②   tmadmin 실행 ③   migm LMID 실행 ④   TLOG 이동(if necessary) ⑤   필요한 자료들(if necessary)	마스터 머신에서 실행
기본 머신 사용불가 (네트워크 접속불가)	①   DBBL 스위칭(if necessary) ②   tmadmin 실행 ③   pclean(pcl) Primary-LMID ④   migm LMID 실행 ⑤   tmboot -l 대체머신-LMID	대체 머신에서 실행

Ø  사용예제 - 기본 머신 사용가능

[uclick-]/home/khk/tux/env> tmshutdown -R -l M001   Shutting down server processes ...           Server Id = 200 Group Id = G005 Machine = M001: shutdown succeeded 1 process stopped. [uclick-]/home/khk/tux/env> [uclick-]/home/khk/tux/env> tmadmin tmadmin - Copyright (c) 1996 BEA Systems, Inc. Portions * Copyright 1986-1997 RSA Data Security, Inc. All Rights Reserved. Distributed under license by BEA Systems, Inc. TUXEDO is a registered trademark.   > migm M001 migm successfully completed.   > psr Prog Name      Queue Name  Grp Name      ID RqDone Load Done Current Service ---------      ----------  --------      -- ------ --------- --------------- TMSYSEVT       00005.00200 G005         200      -         - ( - ) BBL            30003.00000 M002           0      -         - ( - ) BBL            30002.00000 M001           0      -         - ( - ) DBBL           41251       M001           0     63      3150 ..MASTERBB BRIDGE         565539      M002           1      -         - ( - ) BRIDGE         303395      M001           1      -         - ( - )   >

Ø  사용예제 - 기본 머신 사용불가

[santa-]/home/khk/tux/env> tmadmin tmadmin - Copyright (c) 1996 BEA Systems, Inc. Portions * Copyright 1986-1997 RSA Data Security, Inc. All Rights Reserved. Distributed under license by BEA Systems, Inc. TUXEDO is a registered trademark. TMADMIN_CAT:199: WARN: Cannot become administrator.Limited set of commands available.   > master Are you sure? [y, n] y   Creating new DBBL on M002, please wait ... New DBBL created on M002     > psr Prog Name      Queue Name  Grp Name      ID RqDone Load Done Current Service ---------      ----------  --------      -- ------ --------- --------------- TMSYSEVT       00005.00200 G005         200      -         - ( PARTITIONED ) BBL            30003.00000 M002           0      -         - ( - ) BBL            30002.00000 M001           0      -         - ( PARTITIONED ) DBBL           41251       M002           0      9       450 (  IDLE ) BRIDGE         565539      M002           1      -         - ( - ) BRIDGE         303395      M001           1      -         - ( PARTITIONED )   >

참고설명) 위 경우는 M002 가 백업 마스터로 설정되어 있어서 master 명령으로 DBBL 프로세스

          를 마이그레이션 한 경우임

[santa-]/home/khk/tux/env> tmadmin tmadmin - Copyright (c) 1996 BEA Systems, Inc. Portions * Copyright 1986-1997 RSA Data Security, Inc. All Rights Reserved. Distributed under license by BEA Systems, Inc. TUXEDO is a registered trademark.   > pcl M001           Cleaning the DBBL.         Pausing 10 seconds waiting for system to stabilize.         3 M001 servers removed from bulletin board   > migm M001 migm successfully completed.   > boot -l M001 INFO: TUXEDO(r) System Release 6.5 INFO: Serial #: 1000036370, Expiration NONE, Maxusers 6481 INFO: Licensed to: Korea Telecom ICIS   Booting server processes ...   0 processes started.   > boot -l M002 INFO: TUXEDO(r) System Release 6.5 INFO: Serial #: 1000036370, Expiration NONE, Maxusers 6481 INFO: Licensed to: Korea Telecom ICIS   Booting server processes ...   exec TMSYSEVT -A -o /home/khk/tux/log/test2.out :         on M002 -> process id=2849 ... Started. 1 process started.   >

참고설명) 위의 진하게 표시된 부분은 참고삼아 오류를 발생시킨 것입니다.

          즉, boot -l 에는 반드시 대체 머신의 LMID 를 인자로 넘겨주어야 합니다.

 

 

 

Ø  마이그레이션 취소

취소 방법	1) tmadmin 명령 실행 2) migrategroup 또는 migratemach 명령 실행
migrategroup 사용법 migratemach  사용법	migrategroup (migg) [-cancel] group_name migratemach (migm) [-cancel] machine

참고설명) 해당 기능은 셧다운 명령을 수행한 이후, migrate 명령 수행전에 사용해야 합니다.

전제조건) 마이그레이션이 취소된 경우 해당 서버 그룹에 속한 서버는 BB(Bulletin Board) 에서

해당 서버 엔트리 정보가 삭제되므로 tmboot 명령으로 리부팅해야 한다.

그룹 및 머신 마이그레이션 모두에 적용된다.

Ø  그룹 마이그레이션 취소

M001 기본 머신 [uclick-]/home/khk/tux/env> tmshutdown -R -g G005   Shutting down server processes ...           Server Id = 200 Group Id = G005 Machine = M001: shutdown succeeded 1 process stopped. [uclick-]/home/khk/tux/env> M002 대체 머신 [santa-]/home/khk/tux/env> tmadmin tmadmin - Copyright (c) 1996 BEA Systems, Inc. Portions * Copyright 1986-1997 RSA Data Security, Inc. All Rights Reserved. Distributed under license by BEA Systems, Inc. TUXEDO is a registered trademark.   > psr Prog Name      Queue Name  Grp Name      ID RqDone Load Done Current Service ---------      ----------  --------      -- ------ --------- --------------- TMSYSEVT       00005.00200 G005         200      -         - ( - MIGRATING ) BBL            30003.00000 M002           0      -         - ( - ) BBL            30002.00000 M001           0      -         - ( - ) DBBL           41251       M001           0     45      2250 ..MASTERBB BRIDGE         565539      M002           1      -         - ( - ) BRIDGE         303395      M001           1      -         - ( - )   > migg -cancel G005   > psr Prog Name      Queue Name  Grp Name      ID RqDone Load Done Current Service ---------      ----------  --------      -- ------ --------- --------------- BBL            30003.00000 M002           0      -         - ( - ) BBL            30002.00000 M001           0      -         - ( - ) DBBL           41251       M001           0     59      2950 ..MASTERBB BRIDGE         565539      M002           1      -         - ( - ) BRIDGE         303395      M001           1      -         - ( - )   >

Ø  머신 마이그레이션 취소

M001 기본 머신 [uclick-]/home/khk/tux/env> tmshutdown -R -l M001   Shutting down server processes ...           Server Id = 200 Group Id = G005 Machine = M001: shutdown succeeded 1 process stopped. [uclick-]/home/khk/tux/env> M002 대체 머신 [santa-]/home/khk/tux/env> tmadmin tmadmin - Copyright (c) 1996 BEA Systems, Inc. Portions * Copyright 1986-1997 RSA Data Security, Inc. All Rights Reserved. Distributed under license by BEA Systems, Inc. TUXEDO is a registered trademark.   > psr Prog Name      Queue Name  Grp Name      ID RqDone Load Done Current Service ---------      ----------  --------      -- ------ --------- --------------- TMSYSEVT       00005.00200 G005         200      -         - ( - MIGRATING ) BBL            30003.00000 M002           0      -         - ( - ) BBL            30002.00000 M001           0      -         - ( - ) DBBL           41251       M001           0     77      3850 ..MASTERBB BRIDGE         565539      M002           1      -         - ( - ) BRIDGE         303395      M001           1      -         - ( - )   > migm -cancel M001   > psr Prog Name      Queue Name  Grp Name      ID RqDone Load Done Current Service ---------      ----------  --------      -- ------ --------- --------------- BBL            30003.00000 M002           0      -         - ( - ) BBL            30002.00000 M001           0      -         - ( - ) DBBL           41251       M001           0     91      4550 ..MASTERBB BRIDGE         565539      M002           1      -         - ( - ) BRIDGE         303395      M001           1      -         - ( - )   >

 

 

 

Ø  트랜잭션 로그 마이그레이션

TUXEDO Administration Guide 를 참조