این فصل نحوه ارتقاء nopCommerce به آخرین نسخه را توضیح می‌دهد. ممکن است بخواهید این کار را انجام دهید زیرا پیامی در بخش اخبار nopCommerce در داشبورد خود دیده‌اید که به شما اطلاع می‌دهد یک نسخه جدید منتشر شده است. nopCommerce از ارتقاء خودکار پشتیبانی نمی‌کند، شما باید آن را به صورت دستی انجام دهید.
Important
از نسخه 4.40 به بعد، ما دیگر از اسکریپت‌های ارتقاء SQL استفاده نمی‌کنیم. ارتقاء به صورت خودکار با استفاده از migrations (در زمان اولین اجرای برنامه) انجام می‌شود. بنابراین، هنگامی که از نسخه 4.30 به 4.40 ارتقاء می‌دهید، باید مرحله 2 از لیست زیر را رد کنید!
مراحل زیر را دنبال کنید:
- از همه چیز در سایت خود، از جمله پایگاه داده، یک نسخه پشتیبان تهیه کنید. این بسیار مهم است تا بتوانید در صورت بروز هرگونه مشکل در طول فرآیند ارتقاء، به سایت در حال اجرا بازگردید.
- [برای ارتقاء به nopCommerce 4.30 و پایین‌تر] سپس باید اسکریپت‌های ارتقاء SQL را اجرا کنید. باید آنها را به صورت گام به گام اجرا کنید. به عنوان مثال، اگر نسخه فعلی شما 3.90 است و آخرین نسخه موجود 4.20 است، باید ابتدا به نسخه 4.00، سپس به 4.10 و در نهایت به 4.20 ارتقاء دهید. بنابراین اسکریپت‌های ارتقاء مورد نیاز را از صفحه دانلود nopCommerce دانلود کنید. پس از دانلود اسکریپت ارتقاء، آن را روی پایگاه داده خود اجرا کنید.
Note
فراموش نکنید که فایل Readme.txt ارائه شده با اسکریپت ارتقاء را بخوانید. گاهی اوقات این فایل حاوی نکات مهمی در مورد ارتقاء به آخرین نسخه است.
- تمام فایل‌های نسخه قبلی را به جز فایل‌های JSON در دایرکتوری 'App_Data' مانند
appsettings.jsonوplugins.jsonحذف کنید. این فایل‌ها باید ذخیره شوند زیرا بعداً از آنها استفاده خواهیم کرد. برای نسخه‌های قدیمی‌تر: اگر فایل‌هایی مانندdataSettings.json،Settings.txtیاInstalledPlugins.txtوجود دارند، آنها را نیز ذخیره کنید. - فایل‌های سایت جدید را آپلود کنید (آخرین نسخه را از اینجا دریافت کنید).
- اطمینان حاصل کنید که همه چیز درست است.
Note
هنگام استقرار، مطمئن شوید که فایل appsettings.json هدف مطابق با آخرین نسخه nopCommerce به‌روزرسانی شده است تا سایت تولید همچنان به پایگاه داده تولید اشاره کند. در نسخه‌های قدیمی‌تر nopCommerce ممکن است فایل‌های dataSettings.json و Settings.txt باشند. همچنین، مطمئن شوید که فایل plugins.json (InstalledPlugins.txt) نیز مطابق با آخرین نسخه nopCommerce به‌روزرسانی شده است.
Note
اگر nopCommerce را به نسخه 4.50 از یکی از نسخه‌های قبلی ارتقاء می‌دهید، لطفاً اطمینان حاصل کنید که رشته اتصال شما شامل یکی از پارامترهای زیر باشد: Encrypt=false یا TrustServerCertificate=True (بسته به نیازهای سرور شما). می‌توانید این پارامترها را به صورت دستی به رشته اتصال خود در فایل \App_Data\appsettings.json اضافه کنید. این مرحله به دلیل کتابخانه Microsoft.Data.SqlClient است که مقدار پیش‌فرض گزینه Encrypt را از false به true تغییر داده است.
Note
اگر تصاویر خود را در سیستم فایل ذخیره کرده‌اید، از آنها نیز نسخه پشتیبان تهیه کنید (\wwwroot\Images\) و پس از ارتقاء آنها را کپی کنید.
Note
(ارتقاء از 3.X به 4.X): اگر می‌خواهید از نسخه 3.90 به آخرین نسخه ارتقاء دهید، ابتدا باید نسخه 4.00 را نصب کنید (روی پایگاه داده موجود)، اسکریپت SQL مهاجرت از 3.90 به 4.00 را اجرا کنید، و سپس به نسخه‌های 4.10، 4.20 و بالاتر ارتقاء دهید.
عیب‌یابی
اگر پس از ارتقاء با مشکل مواجه شدید، همیشه می‌توانید نسخه پشتیبان خود را بازیابی کرده و فایل‌ها را با فایل‌های نسخه قبلی جایگزین کنید. همیشه می‌توانید سوال خود را در انجمن‌های ما مطرح کنید.
Note
اگر هنگام جستجوی پیشرفته در انجمن‌های ما نتوانستید آنچه را که نیاز دارید پیدا کنید، می‌توانید یک جستجوی گوگل متمرکز بر سایت nopCommerce انجام دهید: [کلمات جستجوی شما site:nopcommerce.com].
