Migrating from Odoo 17/18 to Odoo 19: Complete Guide

ERP لائف سائیکل میں ہجرت سب سے زیادہ خطرے والی کارروائیوں میں سے ایک ہے — ڈیٹا کا نقصان، ٹوٹے ہوئے کسٹم ماڈیولز، اور بڑھا ہوا ڈاؤن ٹائم وہ تمام حقیقی خطرات ہیں جن کے لیے محتاط منصوبہ بندی اور عمل درآمد کی ضرورت ہوتی ہے۔

یہ گائیڈ Odoo 17 یا Odoo 18 سے Odoo 19 Enterprise پر جانے والی تنظیموں کے لیے ایک عملی، مرحلہ وار منتقلی کا طریقہ کار فراہم کرتا ہے۔ اس میں ابتدائی تشخیص اور ڈیٹا میپنگ سے لے کر حسب ضرورت ماڈیول اپ ڈیٹس، جانچ کے طریقہ کار، اور گو لائیو کٹ اوور پلان تک سب کچھ شامل ہے۔

اہم ٹیک ویز

• Odoo 19 کی API تبدیلیوں کے خلاف حسب ضرورت ماڈیول مطابقت کی تصدیق ہونی چاہیے۔
• ڈیٹا کی منتقلی Odoo کے آفیشل اپ گریڈ پلیٹ فارم یا OpenUpgrade کے ذریعے ہوتی ہے۔
• پروڈکشن کٹ اوور سے پہلے ایک متوازی جانچ کا ماحول لازمی ہے۔
• مفاہمت کے مسائل سے بچنے کے لیے کٹ اوور سے پہلے مالی ادوار کو بند کر دینا چاہیے۔
• تمام تھرڈ پارٹی انضمام کو منتقلی کے بعد دوبارہ تصدیق کی ضرورت ہے۔
• لائیو سے پہلے رول بیک پلان کو دستاویزی اور جانچنا ضروری ہے۔

---

ہجرت کی منصوبہ بندی: تشخیص کا مرحلہ

ایک واحد ہجرت کا اسکرپٹ لکھنے سے پہلے، مکمل تشخیص میں وقت لگائیں۔ نقل مکانی اکثر ناکام منصوبہ بندی کی وجہ سے ہوتی ہے نہ کہ تکنیکی پیچیدگی کی وجہ سے۔

مرحلہ 1: اپنے موجودہ ماحول کی فہرست بنائیں

اپنی موجودہ Odoo تنصیب کے ہر جزو کو دستاویز کریں:

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: حسب ضرورت ماڈیولز کی درجہ بندی کریں

ہر حسب ضرورت ماڈیول کے لیے، تعین کریں:

---

اپنے ہجرت کے راستے کا انتخاب کرنا

راستہ 1: اوڈو آفیشل اپ گریڈ سروس

Odoo SA upgrade.odoo.com پر ایک خودکار اپ گریڈ سروس فراہم کرتا ہے۔ آپ اپنا ڈیٹا بیس جمع کراتے ہیں، وہ Odoo SA کی طرف سے تیار کردہ اور برقرار رکھنے والے مائیگریشن اسکرپٹس چلاتے ہیں، اور آپ کو ایک اپ گریڈ شدہ ڈیٹا بیس ملتا ہے۔

فوائد:

• Odoo SA کے ذریعہ سرکاری مدد اور جانچ
• ڈیٹا بیس اسکیما کی تبدیلیوں کو خود بخود ہینڈل کرتا ہے۔
• کم سے کم تخصیصات کے ساتھ معیاری Odoo کے لیے موزوں

نقصانات:

• Odoo کے سرورز پر پیداواری ڈیٹا جمع کرنے کی ضرورت ہے۔
• نقل مکانی کے عمل پر محدود کنٹرول
• حسب ضرورت ماڈیول منتقلی آپ کی ذمہ داری ہے۔

پاتھ 2: اوپن اپ گریڈ (کمیونٹی ٹول)

OpenUpgrade ایک اوپن سورس پروجیکٹ ہے جو کمیونٹی کے لیے مائیگریشن اسکرپٹ فراہم کرتا ہے۔

راستہ 3: ڈیٹا امپورٹ کے ساتھ تازہ انسٹال

بہت زیادہ حسب ضرورت مثالوں یا بہت پرانے ورژن کے لیے:

1. ایک تازہ Odoo 19 انٹرپرائز مثال قائم کریں۔
2. تمام ماڈیولز اور ترتیبات کو دوبارہ ترتیب دیں۔
3. پرانے سسٹم سے اہم ڈیٹا برآمد کریں۔
4. Odoo کے درآمدی ٹول یا اپنی مرضی کے مطابق منتقلی کے اسکرپٹ کے ذریعے درآمد کریں۔
5. اکاؤنٹنگ کے لیے دستی طور پر اوپننگ بیلنس دوبارہ درج کریں۔

یہ راستہ سست ہے لیکن صاف ترین نقطہ آغاز فراہم کرتا ہے۔

زیادہ تر Odoo 17/18 → 19 ہجرت کے لیے تجویز کردہ: راستہ 1 یا 2 متوازی کسٹم ماڈیول کی دوبارہ ترقی کی کوششوں کے ساتھ مل کر۔

---

ہجرت سے پہلے کی تیاری

مالیاتی ادوار بند کریں:

ہجرت سے پہلے:

1. موجودہ مہینے سے پہلے کے تمام ادوار کو Odoo اکاؤنٹنگ میں مقفل کریں۔
2. عمر رسیدہ اور قابل ادائیگی رپورٹس چلائیں اور اختلافات کو ختم کریں۔
3. منتقلی کی تاریخ کے ذریعے تمام بینک سٹیٹمنٹس کو ملا دیں۔
4. تمام مسودہ رسیدیں پوسٹ کریں جنہیں تاریخی ڈیٹا میں شامل کیا جانا چاہیے۔

** ہر چیز کا بیک اپ لیں:**

# 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

---

ہجرت کے ماحول کو ترتیب دینا

انفراسٹرکچر سیٹ اپ:

# 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

---

حسب ضرورت ماڈیول کی منتقلی

یہ مرحلہ سب سے زیادہ وقت والا ہے۔ ہر اپنی مرضی کے ماڈیول کی ضرورت ہوتی ہے:

1۔ مینی فیسٹ ورژن کو اپ ڈیٹ کریں:

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

2۔ منظر نحو کو اپ ڈیٹ کریں:

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

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

3۔ ہر ماڈیول کو آزادانہ طور پر جانچیں:

# 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

---

ڈیٹا کی توثیق اور جانچ

ریکارڈ گنتی کی توثیق:

ماخذ اور منتقل شدہ ڈیٹا بیس کے درمیان ریکارڈ شمار کا موازنہ کریں:

# 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}")

صارف کی قبولیت کی جانچ کی فہرست:

• تمام مینوز اور نیویگیشن آئٹمز قابل رسائی
• کلیدی ورک فلوز: سیل آرڈر → ڈیلیوری → انوائس → ادائیگی
• اکاؤنٹنگ: جرنل اندراجات، بینک مفاہمت، رپورٹس
• انوینٹری: رسیدیں، ترسیل، اسٹاک کی تشخیص
• مینوفیکچرنگ: BOM، کام کے احکامات، معیار کی جانچ پڑتال (اگر قابل اطلاق ہو)
• HR: ملازمین، چھٹی کا انتظام، تنخواہ (اگر قابل اطلاق ہو)
• کسٹم ماڈیول کی فعالیت کی تصدیق کاروباری صارفین کے ذریعے کی گئی ہے۔
• رپورٹیں صحیح طریقے سے تیار ہوتی ہیں اور پری ہجرت کے آؤٹ پٹ سے ملتی ہیں۔
• بیرونی انضمام (API، ویب ہکس) اسٹیجنگ میں جانچے گئے۔

---

گو لائیو کٹ اوور پلان

** کٹ اوور ونڈو پلاننگ:**

کم سے کم کاروباری اثر کے ساتھ کٹ اوور ونڈو کا انتخاب کریں:

• ویک اینڈ (زیادہ تر کاروبار کے لیے ہفتہ کی شام سے اتوار کی صبح)
• مالی مہینے کا اختتام (اوپننگ بیلنس کے اندراج کو آسان بناتا ہے)
• بینک کی چھٹی سے پہلے آخری کاروباری دن کے بعد (اضافی بفر ٹائم)

کٹ اوور چیک لسٹ:

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

رول بیک پلان:

اگر کٹ اوور کے دوران اہم مسائل پائے جاتے ہیں:

1. DNS واپس پرانے سرور پر سوئچ کریں
2. صارفین کے لیے پرانے سسٹم کو دوبارہ فعال کریں۔
3. پائے گئے تمام مسائل کو دستاویز کریں۔
4. فالو اپ مائیگریشن ونڈو کو شیڈول کریں۔

---

اکثر پوچھے گئے سوالات

کیا میں Odoo 17 سے براہ راست Odoo 19 پر جا سکتا ہوں، یا مجھے 18 سے گزرنا ہوگا؟

Odoo کی آفیشل اپ گریڈ سروس کا استعمال کرتے ہوئے، آپ عام طور پر براہ راست 17 سے 19 تک جا سکتے ہیں۔ Odoo SA کی مائیگریشن اسکرپٹس ملٹی ورژن جمپس کو ہینڈل کرتی ہیں۔ اپنی ضرورت کے مخصوص ورژن کے لیے ہمیشہ اوپن اپ گریڈ ریپوزٹری کو چیک کریں۔

ایک عام Odoo کی منتقلی میں کتنا وقت لگتا ہے؟

ٹائم لائن حسب ضرورت کی سطح پر بہت زیادہ انحصار کرتی ہے۔ خود منتقلی (ڈیٹا بیس اپ گریڈ) میں گھنٹے لگتے ہیں۔ وقت جانچ، ماڈیول اپ ڈیٹس، اور توثیق کا ہے۔

ہجرت کے دوران اسٹوڈیو کی تخصیصات کا کیا ہوتا ہے؟

اسٹوڈیو کی تخصیصات معیاری Odoo ڈیٹا (ویوز، فیلڈز، آٹومیشن) کے طور پر محفوظ کی جاتی ہیں اور معیاری ڈیٹا بیس اپ گریڈ کے عمل کے ذریعے منتقل ہوتی ہیں۔ تاہم، اگر Odoo 19 نے بنیادی شکل کے ڈھانچے کو تبدیل کر دیا تو کچھ ویو کی تخصیصات کو دستی جائزہ لینے کی ضرورت ہو سکتی ہے۔ ہجرت کے بعد تمام اسٹوڈیو کی تخصیصات کی ہمیشہ جانچ کریں۔

کیا مجھے منتقلی کے بعد اوپننگ بیلنس دوبارہ داخل کرنے کی ضرورت ہے؟

نہیں، اگر آپ ڈیٹا بیس کو براہ راست منتقل کرتے ہیں۔ تمام تاریخی جرنل اندراجات اور ڈیٹا بیس کے ساتھ بیلنس کی منتقلی. اگر آپ "ڈیٹا امپورٹ کے ساتھ تازہ انسٹال" کا راستہ منتخب کرتے ہیں، تو آپ کو کٹ اوور کی تاریخ کے مطابق اوپننگ بیلنس داخل کرنے کی ضرورت ہوگی، جس کے لیے آپ کی اکاؤنٹنگ ٹیم کے ساتھ محتاط ہم آہنگی کی ضرورت ہے۔

---

اگلے اقدامات

اوڈو ہجرت اعلیٰ داؤ پر لگے منصوبے ہیں جو براہ راست کاروبار کے تسلسل کو متاثر کرتے ہیں۔ ہموار منتقلی اور تکلیف دہ کے درمیان فرق تیاری، مہارت، اور سخت جانچ کے طریقہ کار میں آتا ہے۔

ہمارے ہجرت کے طریقہ کار میں مکمل تشخیص، حسب ضرورت ماڈیول اپ ڈیٹس، متوازی جانچ، اور رول بیک طریقہ کار کے ساتھ دستاویزی کٹ اوور پلان شامل ہے۔

ECOSIRE سے Odoo مائیگریشن اسسمنٹ کی درخواست کریں →