Odoo 17/18'den Odoo 19'a Geçiş: Tam Kılavuz

Geçiş, ERP yaşam döngüsündeki en yüksek riskli işlemlerden biridir; veri kaybı, bozulan özel modüller ve uzun süreli kesintiler, dikkatli planlama ve yürütme gerektiren gerçek risklerdir.

Bu kılavuz, Odoo 17 veya Odoo 18'den Odoo 19 Enterprise'a geçiş yapan kuruluşlar için pratik, adım adım geçiş metodolojisi sağlar. İlk değerlendirme ve veri eşlemesinden özel modül güncellemelerine, test prosedürlerine ve canlıya geçiş planına kadar her şeyi kapsar.

Önemli Çıkarımlar

• Özel modül uyumluluğu Odoo 19'un API değişikliklerine göre doğrulanmalıdır
• Veri taşıma, Odoo'nun resmi yükseltme platformu veya OpenUpgrade aracılığıyla gerçekleştirilir
• Üretime geçmeden önce paralel bir test ortamı zorunludur
• Mutabakat sorunlarını önlemek için geçiş öncesinde mali dönemler kapatılmalıdır
• Tüm üçüncü taraf entegrasyonlarının geçişten sonra yeniden doğrulanması gerekir
• Geri alma planı hayata geçirilmeden önce belgelenmeli ve test edilmelidir

---

Geçiş Planlaması: Değerlendirme Aşaması

Tek bir geçiş komut dosyası yazmadan önce kapsamlı değerlendirmeye zaman ayırın. Taşıma işlemleri çoğunlukla teknik karmaşıklıktan değil, yetersiz planlamadan dolayı başarısız olur.

1. Adım: Mevcut ortamınızın envanterini çıkarın

Mevcut Odoo kurulumunuzun her bileşenini belgeleyin:

Current Environment Inventory:
- Odoo version: 17.0.x or 18.0.x
- Edition: Community or Enterprise
- Database size: X GB, Y records in sale.order, Z in account.move
- Installed modules: [list all modules]
- Custom modules: [list with developer contact]
- Third-party connectors: [Amazon, Shopify, etc.]
- Active integrations: [API, webhooks, cron jobs]
- Customized reports: [list]
- Custom fields (Studio or code): [list]
- Server specs: RAM, CPU, disk
- PostgreSQL version:

2. Adım: Özel modülleri sınıflandırın

Her özel modül için şunları belirleyin:

---

Geçiş Yolunuzu Seçme

Yol 1: Odoo Resmi Yükseltme Hizmeti

Odoo SA, upgrade.odoo.com adresinde otomatik yükseltme hizmeti sunmaktadır. Veritabanınızı gönderirsiniz, onlar Odoo SA tarafından geliştirilen ve bakımı yapılan geçiş komut dosyalarını çalıştırır ve siz de yükseltilmiş bir veritabanı alırsınız.

Artıları:

• Odoo SA tarafından resmi destek ve testler
• Veritabanı şeması değişikliklerini otomatik olarak yönetir
• Minimal özelleştirmelerle standart Odoo'ya uygundur

Eksileri:

• Üretim verilerinin Odoo sunucularına gönderilmesini gerektirir
• Geçiş süreci üzerinde sınırlı kontrol
• Özel modül geçişi sizin sorumluluğunuzdadır

Yol 2: OpenUpgrade (Topluluk Aracı)

OpenUpgrade, Topluluk için geçiş komut dosyaları sağlayan açık kaynaklı bir projedir.

Yol 3: Verileri İçe Aktarmayla Yeni Yükleme

Yoğun biçimde özelleştirilmiş örnekler veya çok eski sürümler için:

1. Yeni bir Odoo 19 Enterprise örneği kurun
2. Tüm modülleri ve ayarları yeniden yapılandırın
3. Kritik verileri eski sistemden dışarı aktarın
4. Odoo'nun içe aktarma aracı veya özel geçiş komut dosyaları aracılığıyla içe aktarın
5. Muhasebe için açılış bakiyelerini manuel olarak yeniden girin

Bu yol daha yavaştır ancak en temiz başlangıç ​​noktasını sağlar.

Odoo 17/18 → 19 geçişlerinin çoğu için önerilir: Yol 1 veya 2'nin paralel özel modül yeniden geliştirme çalışmasıyla birleştirilmesi.

---

Göç Öncesi Hazırlık

Yakın mali dönemler:

Taşımadan önce:

1. Odoo Muhasebe'de geçerli aydan önceki tüm dönemleri kilitleyin
2. Yaşlandırılmış alacak ve borç raporlarını çalıştırın ve farklılıkları uzlaştırın
3. Geçiş tarihine kadar tüm banka ekstrelerinin mutabakatını yapın
4. Geçmiş verilere dahil edilmesi gereken tüm taslak faturaları kaydedin

Her şeyi yedekleyin:

# PostgreSQL backup
pg_dump -h localhost -U odoo_user -Fc odoo_production > \
    odoo_prod_backup_$(date +%Y%m%d_%H%M%S).dump

# Filestore backup (attachments, images)
tar -czf odoo_filestore_$(date +%Y%m%d).tar.gz \
    /var/lib/odoo/.local/share/Odoo/filestore/

# Configuration backup
cp /etc/odoo/odoo.conf odoo_conf_backup_$(date +%Y%m%d).conf

---

Geçiş Ortamını Ayarlama

Altyapı kurulumu:

# Install Odoo 19 Enterprise on migration server

# Install PostgreSQL 15+
sudo apt install postgresql-15 postgresql-contrib

# Install Python 3.12 and dependencies
sudo apt install python3.12 python3.12-dev python3.12-venv \
    libxml2-dev libxslt1-dev libldap2-dev libsasl2-dev \
    libtiff5-dev libjpeg8-dev libopenjp2-7-dev zlib1g-dev \
    libfreetype6-dev liblcms2-dev libwebp-dev libharfbuzz-dev \
    libfribidi-dev libxcb1-dev

# Clone Odoo 19 Enterprise
git clone https://github.com/odoo/odoo.git -b 19.0 /opt/odoo19
git clone https://github.com/odoo/enterprise.git -b 19.0 /opt/odoo19-enterprise

# Install Python dependencies
pip3.12 install -r /opt/odoo19/requirements.txt

---

Özel Modül Geçişi

Bu aşama en fazla zaman alan aşamadır. Her özel modül şunları gerektirir:

1. Manifest sürümünü güncelle:

# Change from:
'version': '17.0.1.0.0',
# To:
'version': '19.0.1.0.0',

2. Görünüm sözdizimini güncelleyin:

<!-- Old (v16 and earlier): -->
<field name="state" attrs="{'invisible': [('active', '=', False)]}"/>

<!-- New (v17+): -->
<field name="state" invisible="not active"/>

3. Her modülü bağımsız olarak test edin:

# Install and test each custom module
python3 odoo-bin -d test_db -i my_custom_module --stop-after-init
python3 odoo-bin -d test_db --test-enable -u my_custom_module

---

Veri Doğrulama ve Test Etme

Kayıt sayımı doğrulaması:

Kaynak ve taşınan veritabanı arasındaki kayıt sayılarını karşılaştırın:

# Run on both source and target to compare
models_to_check = [
    'res.partner', 'product.template', 'product.product',
    'sale.order', 'purchase.order', 'account.move',
    'stock.quant', 'mrp.production', 'hr.employee'
]

for model in models_to_check:
    count = env[model].search_count([])
    print(f"{model}: {count}")

Kullanıcı kabul testi kontrol listesi:

• Tüm menülere ve gezinme öğelerine erişilebilir
• Temel iş akışları: satış siparişi → teslimat → fatura → ödeme
• Muhasebe: yevmiye kayıtları, banka mutabakatı, raporlar
• Envanter: makbuzlar, teslimatlar, stok değerlemesi
• Üretim: Malzeme Listesi, iş emirleri, kalite kontrolleri (varsa)
• İK: çalışanlar, izin yönetimi, maaş bordrosu (varsa)
• İş kullanıcıları tarafından doğrulanan özel modül işlevselliği
• Raporlar doğru bir şekilde oluşturuluyor ve geçiş öncesi çıktıyla eşleşiyor
• Aşamalandırmada test edilen harici entegrasyonlar (API, web kancaları)

---

Canlı Yayına Geçiş Planı

Kesim aralığı planlaması:

Minimum iş etkisine sahip bir geçiş aralığı seçin:

• Hafta sonu (çoğu işletme için cumartesi akşamından pazar sabahına kadar)
• Mali ayın sonu (açılış bakiyesi girişini kolaylaştırır)
• Resmi tatilden önceki son iş gününden sonra (ekstra ara süre)

Kesim kontrol listesi:

T-48 hours:
[ ] Final communication to all users about downtime window
[ ] Freeze all non-critical transactions in old system
[ ] Verify migration server is ready
[ ] Complete last data validation run

T-0 (Cutover Start):
[ ] Put old system in maintenance mode (disable user access)
[ ] Create final backup of production database
[ ] Run final migration on this backup
[ ] Verify record counts and financial balances
[ ] Test all critical workflows
[ ] DNS/URL cutover to new system
[ ] Smoke test from user devices (desktop, mobile)

T+2 hours (Go-Live Verification):
[ ] All users can log in
[ ] Create test sale order, confirm, ship, invoice
[ ] Verify email sending works
[ ] Check integrations are receiving/sending data
[ ] Monitor error logs for first 30 minutes

Geri alma planı:

Geçiş sırasında kritik sorunlar bulunursa:

1. DNS'yi eski sunucuya geri döndürün
2. Kullanıcılar için eski sistemi yeniden etkinleştirin
3. Bulunan tüm sorunları belgeleyin
4. Geçiş takibi penceresini planlayın

---

Sıkça Sorulan Sorular

Odoo 17'den doğrudan Odoo 19'a geçebilir miyim, yoksa 18'den mi geçmeliyim?

Odoo'nun resmi yükseltme hizmetini kullanarak genellikle doğrudan 17'den 19'a geçebilirsiniz. Odoo SA'nın geçiş komut dosyaları, çoklu sürüm atlamalarını yönetir. İhtiyacınız olan belirli sürümler için her zaman OpenUpgrade deposunu kontrol edin.

Tipik bir Odoo geçişi ne kadar sürer?

Zaman çizelgesi büyük ölçüde özelleştirme düzeyine bağlıdır. Geçişin kendisi (veritabanı yükseltmesi) saatler sürer; Zaman test etme, modül güncellemeleri ve doğrulama aşamasındadır.

Taşıma sırasında Studio özelleştirmelerine ne olur?

Studio özelleştirmeleri standart Odoo verileri (görünümler, alanlar, otomasyonlar) olarak depolanır ve standart veritabanı yükseltme işlemi yoluyla taşınır. Ancak Odoo 19'un temel form yapısını değiştirmesi durumunda bazı görünüm özelleştirmelerinin manuel olarak incelenmesi gerekebilir. Taşıma sonrasında her zaman tüm Studio özelleştirmelerini test edin.

Geçiş sonrasında açılış bakiyelerini yeniden girmem gerekir mi?

Hayır, veritabanını doğrudan taşırsanız. Tüm geçmiş yevmiye kayıtları ve bakiyeler veritabanına aktarılır. "Verileri içe aktararak yeni kurulum" yolunu seçerseniz geçiş tarihi itibarıyla açılış bakiyelerini girmeniz gerekir; bu da muhasebe ekibinizle dikkatli bir koordinasyon gerektirir.

---

Sonraki Adımlar

Odoo geçişleri iş sürekliliğini doğrudan etkileyen yüksek riskli projelerdir. Sorunsuz bir geçiş ile acılı bir geçiş arasındaki fark; hazırlık, uzmanlık ve sıkı bir test metodolojisine bağlıdır.

Geçiş metodolojimiz tam değerlendirmeyi, özel modül güncellemelerini, paralel testleri ve geri alma prosedürlerini içeren belgelenmiş bir geçiş planını kapsar.

ECOSIRE'den Odoo Geçiş Değerlendirmesi isteyin →