PostgreSQL Veritabanı Kümesini Yükseltme

Mevcut PostgreSQL sürüm numaraları ana sürüm ( major ) ve küçük ( minor ) sürüm numarasından oluşur. Örneğin 10.1 sürüm numarasında, 10 ana sürüm numarasını 1 ise küçük sürüm numarasıdır. 10.1, ana sürüm 10’un ilk küçük sürümünü ifade eder.

Küçük sürümlerde asla dahili depolama formatında değişiklik olmaz ve her zaman aynı ana sürüm numarasının önceki ve sonraki küçük sürümleriyle uyumludur. Örneğin sürüm 10.1, sürüm 10.0 ve sürüm 10.6 ile uyumludur. Uyumlu sürümler arasında güncelleme yapmak için sunucu kapalıyken yürütülebilir ( executable ) dosyaları değiştirerek sunucuyu yeniden başlatmanız yeterlidir. Veri dizini değişmeden kalır. Küçük yükseltmeler bu kadar basittir.

PostgreSQL’in ana sürümlerinde dahili veri depolama formatı değişebilir ve bu durum yükseltmeleri karmaşık hale getirir. Verileri yeni bir ana sürüme taşımanın klasik yöntemi, veritabanının dump’ını almak ve yeniden yüklemektir, ancak bu biraz yavaş olabilir. Daha hızlı bir yöntem pg_upgrade‘dir. Aşağıda bahsedildiği gibi replikasyon yöntemleri de uygulanabilir. (PostgreSQL’in önceden paketlenmiş bir sürümleri ana sürüm yükseltmelerine yardımcı olacak komut dosyaları sağlayabilir.)

Yeni ana sürümler, kullanıcı tarafından görülebilen bazı uyumsuzlukları ortaya çıkarabileceğinden uygulama tarafında değişiklikler gerekebilir. Kullanıcı tarafından görülebilen tüm değişiklikler sürüm notlarında listelenmiştir. ‘Migration’ başlıklı bölüme özellikle dikkat edin. Birkaç ana sürümde arasında yükseltme yapıyorsanız araya giren her sürümün, sürüm notlarını okumanız sağlıklı bir yükseltme için önerilir.

Tamamen geçiş yapmadan önce istemci uygulamalarını yeni sürümde test etmek için eski ve yeni sürümlerin eşzamanlı kurulumlarını yapılabilir. Bir PostgreSQL ana sürüm yükseltmesini test ederken aşağıdaki olası değişiklik kategorilerini göz önünde bulundurun:

Administration : Her ana sürümde, yöneticilerin sunucuyu izleme ve kontrol etme yetenekleri sıklıkla değişir ve iyileştirilir.

SQL : Yeni SQL komut yeteneklerini içerir. Sürüm notlarında özellikle belirtilmediği sürece davranışta değişiklik olmaz.

Library API : libpq gibi kütüphaneler sürüm notlarında belirtilmediği sürece yalnızca yeni işlevler ekler.

System Catalogs : Sistem kataloğu değişiklikleri genellikle veritabanı yönetim araçlarını etkiler.

Server C-language API : Backend işlevi API’sindeki değişiklikleri içerir. Bu değişiklikler backend işlevlerine başvuran kodu etkiler.

Minör Sürüm Yükseltme

Sadece çalışabilir dosyalar değişir ve PostgreSQL yeniden başlatılır. Paket yönetim sistemi ile:

yum update postgresql11*
systemctl restart postgresql-11

pg_dumpall Yaklaşımı ile Yükseltme

Yükseltme yöntemlerinden biri, PostgreSQL ana sürümünde verilerin dump’ını alıp başka sürümde yeniden yüklemektir. Bu işlem için pg_dumpall logical yedekleme aracı kullanılır. PostgreSQL’in uyumsuz bir sürümüne sahip bir veri dizinini kullanmanızı engelleyen kontroller vardır. Bu nedenle bir veri dizininde yanlış sunucu sürümünü başlatmaya çalışmak büyük bir zarara sebep olmaz.

PostgreSQL’in yeni sürümündeki pg_dump ve pg_dumpall programlarını kullanmanız önerilir. Dump programlarının mevcut sürümleri, herhangi bir sunucu sürümünden 7.0 sürüm kadar geriden veri okuyabilir.

Uyarı: Aşağıdaki talimatlar mevcut kurulumunuzun /usr/local/pgsql dizini altında olduğunu ve veri alanının /usr/local/pgsql/data içinde olduğunu varsayar. Gerekli durumlarda yollarınızı uygun şekilde değiştirin.

1. Yedekleme yapıyorsanız, veritabanınızın değişiklikler olmadığından emin olun. Bu durum yedeklemenin bütünlüğünü etkilemez, ancak değiştirilen veriler yedeklemeye dahil edilmeyecektir. Çözüm olarak, sizin dışınızdaki erişimleri engellemek için /usr/local/pgsql/data/pg_hba.conf dosyasındaki izinler düzenlenebilir.

Veritabanı kurulumunu yedeklemek için şunu yazın:

pg_dumpall > outputfile

Yedeklemeyi yapmak için, şu anda çalıştırmakta olduğunuz sürümde pg_dumpall komutunu kullanabilirsiniz. En iyi sonuçlar için PostgreSQL’in en son sürümündeki pg_dumpall aracını kullanmanız önerilir. Güncel sürüm eski sürümlere göre hata düzeltmeleri ve iyileştirmeler içerir.

2. Eski sunucuyu kapatın:

pg_ctl stop

3. Yedeklemeden geri yükleme yapıyorsanız, sürüme özgü değilse eski kurulum dizinini yeniden adlandırın veya silin. Sorun yaşarsanız ve eskisine geri dönmeniz gerekirse diye, dizini silmek yerine yeniden adlandırmak önerilir. Dizinin önemli miktarda disk alanı kaplayabileceğini unutmayın. Dizini yeniden adlandırmak için aşağıdaki gibi bir komut kullanın.

mv /usr/local/pgsql /usr/local/pgsql.old

4. PostgreSQL’in yeni sürümünü kurun.

5. Gerekirse yeni bir veritabanı kümesi oluşturun.

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

6. Önceki pg_hba.conf ve postgresql.conf değişikliklerinizi geri yükleyin.

7. Veritabanı sunucusunu başlatın:

/usr/local/pgsql/bin/postgres -D /usr/local/pgsql/data

8. Son olarak, verilerinizi yedeklemeden geri yükleyin:

/usr/local/pgsql/bin/psql -d postgres -f outputfile

yeni psql’i kullanarak:

Hem eski hem de yeni sunucular farklı bağlantı noktalarında paralel olarak çalıştırılarak en az kesinti süresi elde edilebilir. Bu durumda kullanım:

pg_dumpall -p 5432 | psql -d postgres -p 5433

pg_upgrade Yaklaşımı ile Majör Sürüm Yükseltme

pg_upgrade modülü, bir kurulumun ana PostgreSQL sürümünden diğerine yerinde geçişi için kullanılır. Yükseltmeler özellikle --link modunda dakikalar içinde gerçekleştirilir. Bu yöntem de sunucuyu başlatma / durdurma, initdb’yi çalıştırma gibi yukarıda bahsettiğimiz pg_dumpall’a benzer adımlar gerektirir. pg_upgrade dokümantasyonunda gerekli adımlar özetlenmiştir.

yum install https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpm

Yeni PostgreSQL sürümü kurulur:

yum install postgresql12-server postgresql12 postgresql12-contrib

Yeni sürümün ilklendirmesi yapılır:

/usr/pgsql-12/bin/postgresql-12-setup initdb

Eski PostgreSQL sürümü durdurulur ve açılıştan kaldırılır:

systemctl stop postgresql-11
systemctl disable postgresql-11

Eski sürümün veritabanı yeni sürümün veritabanına aktarılır:

su - postgres
$ /usr/pgsql-12/bin/pg_upgrade -b /usr/pgsql-11/bin \
    -B /usr/pgsql-12/bin -d /var/lib/pgsql/11/data \
    -D /var/lib/pgsql/12/data
$ exit

Öntanımlıları değiştirilen veritabanı ayar dosyaları (postgresql.conf, pg_hba.conf, vs) karşılaştırılarak elle yeni sürüme aktarılır. Yeni sürüm PostgreSQL başlatılır ve servis açılışta otomatik çalışacak biçimde ayarlanır:

systemctl start postgresql-12
systemctl enable postgresql-12

Veritabanının aktarımı sonrasında sistemin istatistiklerinin oluşturulması için ANALYZE çalıştırılır:

su - postgres
$ ./analyze_new_cluster.sh
$ exit

Eski veri dizini ve eski PostgreSQL paketleri kaldırılabilir (ya da yedek olarak saklanabilir):

rm -rf /var/lib/pgsql/11/data/*
yum remove postgresql11-server postgresql11 postgresql11-contrib

Logical Replication Yaklaşımı ile Yükseltme

Güncellenmiş PostgreSQL sürümünden, logical replikasyon yöntemi ile bir standby sunucu oluşturulur. Logical replication, PostgreSQL’in farklı major sürümleri arasında replikasyonu destekler. Replika(yeni sürüm), Primary(eski sürüm) sunucu ile senkronize olduktan sonra primary replika yer değiştirilir ve Replika yeni primary yapılır ve eski primary kapatılır. Bu yöntem, yükseltme işleminin birkaç saniyelik kesinti ile gerçekleştirilmesini sağlar.

Kaynak:

[1]. PostgreSQL Documentation