토토 캔 - 업그레이드 aPostgreSQL서버 인스턴스
토토 캔
-B
Oldbindir
[-B
Newbindir
] -d
OldConfigdir
-d
NewConfigdir
[옵션
...]
토토 캔(이전에 전화pg_migrator)에 저장된 데이터가를 허용합니다.PostgreSQL나중에 업그레이드 할 데이터 파일PostgreSQL데이터 덤프/복원이없는 주요 버전 (예 : 9.5.8 ~ 9.6.4 또는 10.7 ~ 11.2). 예를 들어 9.6.2 ~ 9.6.3 또는 10.1 ~ 10.2. 사소한 버전 업그레이드에는 필요하지 않습니다.
주요 PostgreSQL은 시스템 테이블의 레이아웃을 종종 변경하는 새로운 기능을 정기적으로 추가하지만 내부 데이터 저장 형식은 거의 변경되지 않습니다..토토 캔이 사실을 사용하여 새 시스템 테이블을 만들고 기존 사용자 데이터 파일을 재사용하여 빠른 업그레이드를 수행합니다. 미래의 주요 릴리스가 이전 데이터 형식을 읽을 수없는 방식으로 데이터 저장 형식을 변경하면토토 캔그러한 업그레이드에는 사용할 수 없습니다. (커뮤니티는 그러한 상황을 피하려고 시도 할 것입니다.)
토토 캔32/64 비트 바이너리를 포함하여 호환 가능한 컴파일 시간 설정을 확인하여 구형 및 새 클러스터가 이진과 호환되는지 확인하기 위해 최선을 다합니다. 모든 외부 모듈도 이진 호환되는 것이 중요하지만을 확인할 수는 없습니다.토토 캔.
토토 캔는 9.0.x에서 현재 주요 릴리스로 업그레이드를 지원합니다.PostgreSQL, 스냅 샷 및 베타 릴리스를 포함한
토토 캔다음 명령 줄 인수를받습니다 :
-B
bindir
-old-bindir =
bindir
기존 PostgreSQL 실행 디렉토리; 환경 변수pgbinold
-B
bindir
--- BINDIR =
bindir
새로운 PostgreSQL 실행 디렉토리; 기본값은 디렉토리입니다.토토 캔거주; 환경 변수pgbinnew
-c
-체크
클러스터 만 확인하고 데이터를 변경하지 마십시오
-d
configdir
-old-datadir =
configdir
이전 데이터베이스 클러스터 구성 디렉토리; 환경 변수pgdataold
-d
configdir
--- 나와 다타 디르 =
configdir
새 데이터베이스 클러스터 구성 디렉토리; 환경 변수pgdatanew
-jnjobs
-jobs =njobs
사용할 동시 프로세스 또는 스레드 수
-K
-link
12164_12222
-o
옵션
-old-options
옵션
구식으로 직접 전달할 옵션Postgres
명령; 다중 옵션 호출이 추가 됨
-o
옵션
--new-options
옵션
옵션을 새로 전달할 옵션Postgres
명령; 다중 옵션 호출이 추가 됨
-p
포트
-old-port =
포트
이전 클러스터 포트 번호; 환경 변수pgportold
-p
포트
--- 뉴 포트 =
포트
새 클러스터 포트 번호; 환경 변수pgportnew
-r
-retain
성공적인 완료 후에도 SQL 및 로그 파일 유지
-s
dir
--- 소켓 디르 =
dir
업그레이드하는 동안 우체국 마스터 소켓에 사용할 디렉토리; 기본값은 현재 작업 디렉토리입니다.pgsocketdir
-u
사용자 이름
--username =
사용자 이름
클러스터의 설치 사용자 이름; 환경 변수PGUSER
-v
-Versbose
장황 내부 로깅 활성화
-v
-버전
버전 정보 표시, 종료
-클론
효율적인 파일 클로닝 사용 (또한“Reflinks”일부 시스템에서) 새 클러스터에 파일을 복사하는 대신. 이로 인해 데이터 파일이 거의 나오지 않아의 속도 이점을 제공 할 수 있습니다.-K
/-link
기존 클러스터를 그대로 두는 동안.
파일 클로닝은 일부 운영 체제 및 파일 시스템에서만 지원됩니다. 선택되었지만 지원되지 않으면토토 캔run은 오류가 발생합니다. 현재 BTRFS 및 XFS (Reflink 지원으로 생성 된 파일 시스템)와 APFS가있는 MACOS에서 Linux (4.5 이상)에서 지원됩니다..
-?
-help
도움말 표시, 종료
이것은 업그레이드를 수행하는 단계입니다.토토 캔:
이전 클러스터를 선택적으로 이동
버전 별 설치 디렉토리를 사용하는 경우 (예 :/opt/postgresql/13
, 이전 클러스터를 이동할 필요가 없습니다. 그래픽 설치자는 모두 버전 별 설치 디렉토리를 사용합니다.
설치 디렉토리가 버전 별이 아닌 경우 (예 :/usr/local/pgsql
, 현재 PostgreSQL 설치 디렉토리를 이동하여 새로운 것을 방해하지 않도록해야합니다PostgreSQL설치. 일단 현재PostgreSQL서버가 종료되면 PostgreSQL 설치 디렉토리의 이름을 바꾸는 것이 안전합니다. 이전 디렉토리가라고 가정합니다./usr/local/pgsql
, 당신은 할 수 있습니다 :
mv/usr/local/pgsql /usr/local/pgsql.old
디렉토리의 이름을 바꾸려면
소스 설치의 경우 새 버전을 빌드
새 PostgreSQL 소스를 빌드구성
이전 클러스터와 호환되는 플래그.토토 캔확인PG_CONTROLDATA
업그레이드를 시작하기 전에 모든 설정이 호환되는지 확인하려면
새 Postgresql Binaries 설치
새 서버의 바이너리 및 지원 파일을 설치하십시오.토토 캔기본 설치에 포함되어 있습니다.
소스 설치의 경우 사용자 정의 위치에 새 서버를 설치하려면 사용하십시오.prefix
변수 :
접두사 만들기 =/usr/local/pgsql.new install
새 PostgreSQL 클러스터 초기화
|initdb
. 다시, 호환 사용initdb
이전 클러스터와 일치하는 플래그. 많은 미리 빌드 설치 업체 가이 단계를 자동으로 수행합니다.
확장자 공유 객체 파일 설치
많은 확장 및 사용자 정의 모듈, 출신이든Contrib
또는 다른 소스, 공유 객체 파일 (또는 dlls)을 사용합니다 (예 :pgcrypto.so
. 기존 클러스터가 사용 된 경우 새 서버 바이너리와 일치하는 공유 객체 파일은 일반적으로 운영 체제 명령을 통해 새 클러스터에 설치해야합니다.확장 생성 pgcrypto
, 이들은 이전 클러스터에서 복제되기 때문입니다. 확장 업데이트를 사용할 수있는 경우토토 캔이것을보고하고 나중에 업데이트 할 수있는 스크립트를 만들 것입니다.
정의 전체 텍스트 검색 파일 복사
모든 사용자 정의 전체 텍스트 검색 파일 (사전, 동의어, 시소러스, 단어 중지)을 이전에서 새 클러스터로 복사합니다.
인증 조정
토토 캔
이전 및 새 서버에 여러 번 연결되므로 인증을 설정할 수 있습니다.피어
inpg_hba.conf
또는 A 사용~/.pgpass
파일 (참조섹션 33.15).
두 서버 중지
두 데이터베이스 서버 모두 UNIX에서 사용이 중지되는지 확인하십시오 (예 :
PG_CTL -D /OPT/POSTGRESQL/9.6 정지
또는 Windows에서 적절한 서비스 이름을 사용하여 :
넷 스톱 Postgresql-9.6
스트리밍 복제 및 로그쉽 대기 서버는이 종료 중에 실행 중이므로 모든 변경 사항을 수신해야합니다.
대기 서버 업그레이드 준비
섹션에 요약 된 메소드를 사용하여 대기 서버를 업그레이드하는 경우11 단계, 기존 대기 서버가 실행하여 잡히는지 확인하십시오PG_CONTROLDATA이전 기본 및 대기 클러스터에 대한. 확인“최신 체크 포인트 위치”값은 모든 클러스터에서 일치합니다. 또한 확인하십시오Wal_level
로 설정되지 않았습니다최소
inPostgres
새 기본 클러스터의 파일.
run토토 캔
항상 실행토토 캔이전 서버가 아닌 새 서버의 바이너리.토토 캔구형 및 새 클러스터 데이터 및 실행 파일의 사양이 필요합니다 (bin
) 디렉토리. 사용자 및 포트 값을 지정할 수도 있고 기본 복사 동작 대신 데이터 파일을 연결하거나 클로닝 하려는지 여부
링크 모드를 사용하는 경우 업그레이드가 훨씬 빠르며 (파일 복사 없음) 디스크 공간을 적게 사용하지만 업그레이드 후 새 클러스터를 시작하면 이전 클러스터에 액세스 할 수 없습니다. 링크 모드는 또한 이전 및 새 클러스터 데이터 디렉토리가 동일한 파일 시스템에 있어야합니다.PG_WAL
다른 파일 시스템에있을 수 있습니다.) 클론 모드는 동일한 속도와 디스크 공간의 장점을 제공하지만 새 클러스터가 시작되면 이전 클러스터를 사용할 수 없게하지 않습니다. 클론 모드는 또한 이전 및 새 데이터 디렉토리가 동일한 파일 시스템에 있어야합니다.
the-jobs
옵션은 여러 CPU 코어를 파일의 복사/링크에 사용할 수 있으며 데이터베이스 스키마를 병렬로 덤프 및 복원 할 수 있습니다. 시작하기에 좋은 곳은 CPU 코어 및 테이블 스페이스 수의 최대입니다.
Windows 사용자의 경우 관리 계정에 로그인 한 다음 쉘을로 시작해야합니다.Postgres
사용자 및 적절한 경로를 설정하십시오 :
runas /user : postgres "cmd.exe"
그리고 런토토 캔인용 된 디렉토리 포함 (예 :
토토 캔.exe
일단 시작,토토 캔
두 클러스터가 호환되는지 확인한 다음 업그레이드를 수행합니다. 사용할 수 있습니다토토 캔 -Check
이전 서버가 여전히 실행중인 경우에도 점검 만 수행하려면토토 캔 -Check
업그레이드 후 수행해야 할 수동 조정을 간략하게 설명합니다. 링크 또는 클론 모드를 사용하려는 경우 옵션을 사용해야합니다.-link
또는-클론
with-체크
모드 별 검사를 활성화하려면토토 캔
현재 디렉토리에서 쓰기 권한이 필요합니다.
분명히 업그레이드하는 동안 아무도 클러스터에 액세스하지 않아야합니다.토토 캔의도하지 않은 클라이언트 연결을 피하기 위해 포트 50432의 서버 실행 기본값. 기존 클러스터와 새 클러스터가 동시에 실행되지 않기 때문에 업그레이드 할 때 두 클러스터에 동일한 포트 번호를 사용할 수 있습니다.
데이터베이스 스키마를 복원하는 동안 오류가 발생하는 경우토토 캔
나가면 rement.17 단계아래. 시도하려면토토 캔
다시, PG_UPGRADE 스키마 복원이 성공할 수 있도록 이전 클러스터를 수정해야합니다. 문제가 A 인 경우Contrib
모듈,를 제거해야 할 수도 있습니다.Contrib
기존 클러스터의 모듈 및 업그레이드 후 새 클러스터에 설치하여 모듈이 사용자 데이터를 저장하는 데 사용되지 않는다고 가정합니다..
업그레이드 스트리밍 복제 및 로그쉽 대기 서버
링크 모드를 사용하고 스트리밍 복제가있는 경우 (참조섹션 26.2.5) 또는 로그 선집 (참조PostgreSQL : 문서 : 13 : 26.2. 로그쉽 토토 사이트 순위 서버) 대기 서버에서 다음 단계를 따라 빠르게 업그레이드 할 수 있습니다. 당신은 달리지 않을 것입니다토토 캔대기 서버에서rsync1 차. 아직 서버를 시작하지 마십시오.
당신이 그렇게했다면not링크 모드 사용, 사용하고 싶지 않거나 사용하고 싶지 않습니다rsync또는 더 쉬운 솔루션을 원 하거나이 섹션의 지침을 건너 뛰고 대기 서버를 한 번 간단히 재현하십시오토토 캔완료하고 새로운 기본이 실행 중입니다.
대기 서버에 새 PostgreSQL Binaries 설치
모든 대기 서버에 새 바이너리 및 지원 파일이 설치되어 있는지 확인하십시오.
새로운 대기 데이터 디렉토리가 수행해야합니다not존재
새로운 대기 데이터 디렉토리가 수행해야합니다not존재하거나 비어 있습니다. 만약에initdb실행중인 대기 서버의 새로운 데이터 디렉토리를 삭제합니다.
확장자 공유 객체 파일 설치
새 기본 클러스터에 설치 한 새 대기에 동일한 확장자 공유 객체 파일을 설치합니다.
대기 서버 중지
대기 서버가 여전히 실행중인 경우 위의 지침을 사용하여 지금 중지하십시오.
구성 파일 저장
유지 해야하는 이전 Standbys의 구성 디렉토리에서 구성 파일을 저장합니다 (예 :Postgres
(및 그에 포함 된 파일),Postgres
, pg_hba.conf
, 이것들은 다음 단계에서 덮어 쓰거나 제거되기 때문에
runrsync
링크 모드를 사용하면 대기 서버를 빠르게 업그레이드 할 수 있습니다rsync. 이를 달성하려면 이전 및 새 데이터베이스 클러스터 디렉토리 위에있는 기본 서버의 디렉토리에서에서 실행하십시오.기본각 대기 서버 :
rsync -archive-delete-hard-links-size-no-recursive old_cluster new_cluster remote_dir
여기서Old_Cluster
andNew_Cluster
기본의 현재 디렉토리와 관련이 있으며Remote_dir
is위대기의 구식 및 새 클러스터 디렉토리. 기본 및 대기의 지정된 디렉토리 아래의 디렉토리 구조는 일치해야합니다.rsync원격 디렉토리 지정에 대한 자세한 내용은 예를 들어,
rsync -archive-delete-hard-links-size-no-increcursive/opt/postgresql/9.5 \
명령이 무엇을 사용할 것인지 확인할 수 있습니다rsync's-드라이 런
옵션. 하는 동안rsync적어도 하나의 대기에 대한 기본에서 실행해야합니다. 실행할 수 있습니다rsync업그레이드 된 대기에서 업그레이드 된 대기가 시작되지 않은 한 다른 대기를 업그레이드하기 위해 업그레이드 된 대기에서.
이것이하는 일은에 의해 생성 된 링크를 녹음하는 것입니다.토토 캔의 기본 서버의 이전 및 새 클러스터에 파일을 연결하는 링크 모드. 그런 다음 대기 클러스터에서 일치하는 파일을 찾아 대기의 새 클러스터에서 링크를 만듭니다.rsync이 파일은 일반적으로 대기 서버에 존재하지 않기 때문에 임시 및 미등성 테이블과 관련된 파일을 불필요하게 복사합니다.
테이블 스페이스가 있으면 비슷한 실행이 필요합니다rsync각 테이블 스페이스 디렉토리의 명령 (예 :
rsync -archive-delete-hard-links ----- 크기 ----- recursive /vol1/pg_tblsp/pg_9.5_201510051 \
이사 한 경우PG_WAL
데이터 디렉토리 외부,rsync해당 디렉토리에서도 실행해야합니다.
스트리밍 복제 및 로그쉽 대기 서버 구성
로그 배송에 대한 서버를 구성합니다. (실행할 필요가 없습니다pg_start_backup ()
andpg_stop_backup ()
또는 대기가 여전히 1 차와 동기화되면 파일 시스템 백업을 가져옵니다.) 복제 슬롯이 복사되지 않아 재현해야합니다..
복원pg_hba.conf
수정 된 경우pg_hba.conf
, 원래 설정을 복원하십시오. 이전 클러스터와 일치하도록 새 클러스터의 다른 구성 파일을 조정해야 할 수도 있습니다 (예 :Postgres
(및 그에 포함 된 파일),Postgres
.
새 서버 시작
새 서버를 안전하게 시작할 수 있습니다.rsync'ED 대기 서버.
업그레이드 후 처리
업그레이드 후 처리가 필요한 경우 PG_UPGRADE는 완료되면 경고를 발행합니다. 또한 관리자가 실행 해야하는 스크립트 파일을 생성합니다.
psql -username = postgres -파일 = script.sql postgres
스크립트를 순서대로 실행할 수 있으며 실행되면 삭제할 수 있습니다.
일반적으로 재건 스크립트가 완료 될 때까지 재건 스크립트로 참조 된 테이블에 액세스하는 것은 안전하지 않습니다. 그렇게하면 잘못된 결과 또는 성능 저하가 발생할 수 있습니다.
통계
Optimizer 통계가 전송되지 않기 때문에토토 캔
, 업그레이드가 끝날 때 해당 정보를 재생하도록 명령을 실행하도록 지시 받게됩니다. 새 클러스터와 일치하도록 연결 매개 변수를 설정해야 할 수도 있습니다.
오래된 클러스터 삭제
업그레이드에 만족하면에 언급 된 스크립트를 실행하여 이전 클러스터의 데이터 디렉토리를 삭제할 수 있습니다.토토 캔
완료. (이전 데이터 디렉토리 안에 사용자 정의 테이블 스페이스가 있으면 자동 삭제가 불가능합니다.) 이전 설치 디렉토리 (예 :를 삭제할 수도 있습니다.bin
, 공유
).
오래된 클러스터로 되돌아가는
실행 후토토 캔
, 기존 클러스터로 되돌려 보시면 몇 가지 옵션이 있습니다.
-체크
옵션이 사용되었고, 오래된 클러스터는 수정되지 않았습니다. 다시 시작할 수 있습니다.
-link
옵션은not사용 된 오래된 클러스터는 수정되지 않았습니다. 다시 시작할 수 있습니다.
-link
옵션이 사용되었으며, 데이터 파일은 이전 및 새 클러스터간에 공유 될 수 있습니다.
if토토 캔
링크가 시작되기 전에 중단 된 오래된 클러스터는 수정되지 않았습니다. 다시 시작할 수 있습니다.
당신이 그렇게했다면not새 클러스터를 시작하면 링크가 시작될 때 a를 제외하고 이전 클러스터가 수정되지 않았습니다..OLD
접미사가 추가되었습니다$ pgdata/global/pg_control
. 이전 클러스터를 재사용하려면를 제거하십시오..OLD
접미사$ pgdata/global/pg_control
; 그런 다음 이전 클러스터를 다시 시작할 수 있습니다.
새 클러스터를 시작한 경우 공유 파일에 작성되었으며 이전 클러스터를 사용하는 것은 안전하지 않습니다. 이 경우 기존 클러스터를 백업에서 복원해야합니다.
토토 캔현재 작업 디렉토리에서 스키마 덤프와 같은 다양한 작업 파일을 만듭니다. 보안의 경우 다른 사용자가 디렉토리를 읽을 수 있거나 쓸 수 없는지 확인하십시오.
토토 캔구식 및 새로운 데이터 디렉토리에서 단기간 우체국 장을 출시합니다. 이 Postmasters와의 통신을위한 임시 UNIX 소켓 파일은 기본적으로 현재 작업 디렉토리에서 작성됩니다.-s
옵션 경로 이름이 짧은 디렉토리에 소켓 파일을 넣는 옵션. 보안의 경우 다른 사용자가 디렉토리를 읽을 수 있거나 쓸 수 없습니다.
모든 실패, 재건 및 Reindex 사례는보고됩니다.토토 캔설치에 영향을 미치는 경우; 업그레이드 후 스크립트 테이블 및 인덱스를 재구성하기위한 스크립트가 자동으로 생성됩니다.
배포 테스트를 위해서는 이전 클러스터의 스키마 전용 사본을 작성하고 더미 데이터를 삽입하고 업그레이드합니다..
토토 캔|Reg*
OID 참조 시스템 데이터 유형 :
RegCollation |
RegConfig |
Regdictionary |
regnamespace |
Regoper |
Regoperator |
Regproc |
Regrocedure |
(Regclass
, Resprole
및Regtype
업그레이드 할 수 있습니다.)
pre-를 업그레이드하는 경우PostgreSQL9.2 Cluster 구성 파일 전용 디렉토리를 사용하는 클러스터는 실제 데이터 디렉토리 위치를로 전달해야합니다.토토 캔, 구성 디렉토리 위치를 서버로 전달합니다 (예 :-d /real-data-directory -o '-d /configuration-directory'
.
Default Unix-Domain 소켓 디렉토리를 사용하는 이전 서버 또는 새 클러스터의 기본값과 다른 기본값을 사용하는 이전 서버를 사용하는 경우pghost
이전 서버의 소켓 위치를 가리 킵니다. (이것은 Windows와 관련이 없습니다.)
링크 모드를 사용하려는 경우 새 클러스터가 시작될 때 이전 클러스터를 수정하지 않으려면 클론 모드 사용을 고려하십시오. 사용할 수없는 경우 이전 클러스터의 사본을 작성하여 링크 모드에서 업그레이드하십시오.rsync
서버가 실행되는 동안 이전 클러스터의 더러운 사본을 작성하려면 이전 서버를 종료하고 실행합니다rsync -checksum
다시 변경하여 사본을 일관성있게 만들기 위해 사본을 다시 업데이트합니다. (-Checksum
이 필요하기 때문입니다.rsync
1 초의 파일 수정 시간 세분성 만 있습니다.) 일부 파일을 제외 할 수 있습니다 (예 :postmaster.pid
, 문서화 된대로섹션 25.3.3. 파일 시스템이 파일 시스템 스냅 샷 또는 복사기 쓰기 파일 사본을 지원하는 경우이를 사용하여 기존 클러스터 및 테이블 스페이스의 백업을 만들 수 있습니다. 스냅 샷과 사본은 동시에 또는 데이터베이스 서버가 다운되어 있어야합니다..
문서에 올바른 것이 없으면 일치하지 않습니다.이 양식문서 문제를보고하려면