المساعد الشخصي الرقمي

مشاهدة النسخة كاملة : منتدي الجيل الخامس vBulletin 5 | شرح الترقية / خطوات / نصائح / تحذيرات



Rise Company
30-12-2019, 02:19
شرح / خطوات / نصائح / تحذيرات قبل الترقية الى الجيل الخامس VB5
كل ما تحتاج معرفته قبل الترقية أو تنصيب vBulletin 5
شرح ترقية المنتدى من الجيل الرابع إلى الجيل الخامس Upgrading VB4 to VB5
VBulletin upgrade from V4.2.5 to VB5 Connect
How to Upgrade to vBulletin 5- vB5 Upgrade Instructions

https://www.rise.company/upload/uploads/157767024825341.png




Upgrading from previous versions of vBulletin 5 Connect




[*=center]Turn your vBulletin Connect site off so that users do not try to add content while you are updating the software. You can do this in the AdminCP under Settings -> Options -> Turn Your vBulletin On or Off.
[*=center]Using the tools provided by your hosting provider, make a backup of your current database.
[*=center]Using your SFTP client, upload the new files to your server. When prompted tell it to overwrite all files in the current transfer queue.
[*=center]With your web browser run the Upgrade Wizard. The location will be https://%yourdomain/%forumroot%/install/upgrade.php
[*=center]When the Upgrade Wizard is complete, you will need to delete the install folder within /core/ on your server to proceed.
[*=center]Log into your site and review the upgrade.
[*=center]When everything appears satisfactory, turn your site back on in the AdminCP under Settings -> Options -> Turn Your vBulletin On or Off.



Upgrading via the Command Line Interface

If you have a larger site, then you may want to run the upgrade scripts from the Command Line Interface (CLI). vBulletin can support this. After you have prepared your files using the steps above then you can log into your command line interface, usually SSH. From your SSH terminal, change into the %forumroot%/core/install directory. Then run the upgrade utility with this command line:


php -f upgrade.php

Upgrading from vBulletin 4.2.5 Publishing Suite

If you are using an older version of vBulletin. It is recommended that you download and upgrade to the vBulletin 4.2.5 Publishing Suite before proceeding to vBulletin 5. This will make sure your system is at the most compatible level to be converted. Please follow these tips for the best migration:



[*=center]Uninstall all third-party addons in the AdminCP under Plugins & Products -> Product Manager.
[*=center]Leave the vBulletin Blog and vBulletin CMS products installed.
[*=center]All other Products are incompatible.
[*=center]Download your logo to be reused.
[*=center]Read why we recommend using a test server for the initial upgrade (below)
[*=center]Make a backup of your database to store locally.
[*=center]Delete all vBulletin 4.X files. Maintain your attachment, customavatar, and signaturepics directories in their current locations.
[*=center]Follow the Upgrade Steps below.



Using a Test Server for the Initial Upgrade
vBulletin Connect is more than an upgrade from older versions of vBulletin. It reimagines how a lot of the system functions to achieve various goals. These goals include standardized functionality across content creation, mobile device support, modularity, security, and updating programming standards. This requires a different code structure than previous versions of vBulletin and comes with a new database structure. When upgrading to vBulletin Connect, the process is more of a migration of data rather than the generally simply upgrades. For this reason we recommend upgrading a test copy first. This will allow your older version of vBulletin to remain live while you test and verify that the ugprade was successful. It will also give you and your team time to familiarize yourself with the new software so you can provide support to your end-users.
You can read how to utilize a test server in our online manual here: https://www.vbulletin.com/go/testserver

Upgrade to vBulletin 5

Now that you have prepared your vBulletin 4.2.5 data to be upgraded to vBulletin Connect you can follow these steps.



[*=center]After Purchasing, download vBulletin Connect from the your Member's Area (https://members.vbulletin.com).
[*=center]Unzip the downloaded package on your local machine. Depending on your hosting provider and internet connection this can take some time.
[*=center]In your vBulletin files there will be a directory called upload. Enter it.
[*=center]Rename config.php.bkp to config.php (ren config.php.bkp config.php)
[*=center]Enter the /upload/core/includes directory.
[*=center]Rename config.php.new to config.php (ren config.php.new config.php)
[*=center]Edit config.php and change these values to match your information.

$config['Database']['dbname'] = 'databasename';
$config['Database']['technicalemail'] = '[email protected]';
$config['MasterServer']['servername'] = 'localhost'; // may be referred to as a host name
$config['MasterServer']['port'] = 3306;
$config['MasterServer']['username'] = 'username';
$config['MasterServer']['password'] = 'password';
Make sure that all values are to the right of the equal sign (=) and between the single quotes ('). If you do not know these values they can be obtained from your hosting provider.
No other values need to be changed in this file for a basic installation of vBulletin Connect.


[*=center]Using your SFTP Client, upload the contents of the upload directory (including all sub-directories and files) to your server. Place these files in the directory where you want to install vBulletin. This directory should be empty.
[*=center]If you store file attachments and custom avatars in the file system (both recommended), then you will need to copy these to your new directory as well.
[*=center]Rename htaccess.txt to .htaccess (the leading period is required). If you are using Filezilla, you can do this by right-clicking on the file and choosing rename on the context menu. This can also be done from the Windows Command Line before uploading the files to the server.
[*=center]Load the Upgrade Wizard in your browser. The URL should be https://%yourdomain%/%forumroot%/install/upgrade.php
[*=center]The Upgrade Wizard will ask for your Customer ID. This can be found in your Member's Area after logging in.
[*=center]Process all the steps in the Wizard. Some steps make take a long time.



Upgrading from Older Versions of vBulletin
For the best upgrade scenarios, we recommend that you first upgrade to vBulletin 4.2.5 and then follow the steps above.

After Upgrading

During the upgrade process from vBulletin 3 and vBulletin 4, the search index is not created. This improves upgrade times significantly. After upgrading, you will need to rebuild your search index. Your site can be live during the search engine rebuild but there may be performance issues while indexing occurs. There are two ways to index your site for keyword based searches.



[*=center]Within the AdminCP at Maintenance -> General Update Tools -> Rebuild Search Index.
[*=center]Using the searchindex.php located in the do_not_upload directory of your download package. The file should be placed in your %forumroot% directory and then executed from the command line. When indexing is completed, the file should be deleted from your server.



File Cleanup

Often when we refactor functionality within the system, it requires the removal of files that become obsolete. Due to the upgrade process, these files can build up on your server. In addition to this, each version includes its own set of javascript files with unique names. While these files shouldn't cause issues, they will take up space on your server. We recommend deleting these obsolete files from your server in order to maintain a clean file set.

This requires a few steps to complete

1. Delete rollup javascript files that do not include your version number in the file name. These will not appear in the Suspect File Version diagnostic.

2. Use the Suspect File Version tool in the AdminCP to delete all obsolete PHP files.



[*=center]In the AdminCP go to Maintenance -> Diagnostics.
[*=center]Run the Suspect File Versions tool.
[*=center]It will scan the vBulletin directories and list all files not part of vBulletin.
[*=center]Review these files to make sure they aren't part of a customization. If they aren't needed, then delete them with your SFTP client.



3. If you store your CSS as Files, you would want to follow these steps:



[*=center]Turn off Store CSS as Files (AdminCP -> Settings -> Options -> Style & Language Options).
[*=center]Delete the contents of the /core/clientscript/vbulletin_css directory.

If you store your CSS files elsewhere, delete the contents of that location.


[*=center]Turn on Store CSS as Files (AdminCP -> Settings -> Options -> Style & Language Options).





Frequent Upgrade Issues

After installing vBulletin 5, my site is unformatted

This means that URL Rewriting is not working on your site. Possible causes include:



[*=center]htaccess.txt has not been renamed to .htaccess (the leading period is important)
[*=center]mod_rewrite is not installed for Apache 2.4
[*=center]URL Rewrite is not installed for IIS 8.5+
[*=center]The server configuration for NGINX has not been updated. See the file for your version of PHP within the do_not_upload folder.
[*=center]AllowOverride is not allowed in the Apache configuration file.


You hosting provider can help you get the ability to rewrite URLS working on your site.

The AdminCP directory is empty

This is by design. The /admincp/ directory is just a place holder and not actually needed or used by the software.

The option to rename the AdminCP is missing
.
This is by design. Renaming this directory doesn't actually provide any security to your installation. If someone has access to your Administrator username and password, they can still access the AdminCP. vBulletin Connect and vBulletin Cloud both have other methods to secure the AdminCP. These include both Two-Factor Authentication and IP Blocking built into the software.

The system states that it is not able to find the Log In Form

Make sure that the Log In URL is set correctly in the AdminCP. In most installations, it should be the same as the Frontend URL.



متطلبات ترقية المنتدى الى نسخة vb5.5.5 المواصفات Recommended Requirements (https://www.rise.company/forum/threads/51569-%D9%85%D8%AA%D8%B7%D9%84%D8%A8%D8%A7%D8%AA-%D8%AA%D8%B1%D9%82%D9%8A%D8%A9-%D8%A7%D9%84%D9%85%D9%86%D8%AA%D8%AF%D9%89-%D8%A7%D9%84%D9%89-%D9%86%D8%B3%D8%AE%D8%A9-vb5-5-5-%D8%A7%D9%84%D9%85%D9%88%D8%A7%D8%B5%D9%81%D8%A7%D 8%AA-Recommended-Requirements)


https://www.rise.company/upload/uploads/157767097280291.png
اعدادات يتم عملها على المنتدى الجيل الرابع vb4

1- حذف جميع الهاكات او plugins المضافة كاكواد
2- حذف جميع الستايلات وابقاء الافتراضي

اعدادات يتم عملها على المنتدى الجيل الرابع vb5

1- قم برفع مجلد المنتدى الجديد في مجلد آخر غير الذي موجود سابقا
2- قم بتعديل امتداد ملف .htaccess لكي يعمل بوضع النقطة فى الاول
3- قم بتعديل ملف config الموجود داخل core بداخل includes
4- بعد الإنتهاء من الترقية قم بتحديث العدادات

للتوضيح : اهمية تفعيل htaccess

أهمية ملف .htaccess لأن الجيل الخامس يستخدم نوعا واحد من الروابط فقط، يتوجب عليك قبل تنصيبه أو الترقية إليه أن تتوفر على أداة لإعادة كتابة و صياغة روابط موقع مثل الـ mod_rewrite أو ما يشابهه. حاليا نحن ندعم أدوات إعادة كتابة و صياغة الروابط التالية : الأباتشي : يستخدم النموذج mod_rewrite (https://httpd.apache.org/docs/current/mod/mod_rewrite.html) لإعادة كتابة و صياغة روابط موقعك و ملف .htaccess الموجود داخل ملف نسختك التي قمت بتحميلها سيتكفل بذلك لذا تأكد من أنك قمت برفع هذا الملف إن كان موقعك يستخدم الأباتشي.

للتوضيح : اهمية عمل مجلد جديد vb5

لا تقم برفع ملفات نسختك الخامسة إلى مجلد نسختك السابقة (الرابعة أو الثالثة) و استبدالها. نظام و ترتيب الملفات في الجيل الخامس مختلف تماما. لذا تأكد أنك قمت برفع ملفات نسختك الخامسة إلى مجلد جديد فارغ. من المهم جدا تنصيب vBulletin 5 في ملف جديد نظيف. لا تقم برفع ملفات نسختك إلى نفس المجلد الذي فيه ملفات نسختك السابقة الثالثة أو الرابعة ثم تقوم باستبدالها. لو فعلت ذلك ستفشل الترقية و تجد نفسك مع مئات من الملفات غير المستعملة.

للتوضيح : اهمية تفعيل config.php
لاحظ رجاء أن vBulletin 5 يستخدم ملفين config.php. من المهم جدا أن يتم تعديل الملفين و أن تكون كل القيم التي تم إدخالها (مثل قيمة متغيرات الكوكيز مثلا) متطابقة في كلا الملفين.يتم وضع بيانات قاعدة البيانات و اليوزر و الباسورد لقاعدة البيانات المطلوب عمل ترقية لها.

للتوضيح : اهمية حذف الاستايلات و الهاكات و اللغة

- كل المعلومات الخاصة بستايلات نسختك السابقة لن يتم حفظها. لذا قبل عملية الترقية تأكد من أنك تحتفظ بأكواد ألوان ستايلك و كذا بالصور الخاصة به و بقية الأمور المتعلقة بالستايل.

- غير هام حذف اللغة ولكن بطبيعة الحال هتحذفها بعد الترقية لتنزيل اللغة المحدثة للجيل الخامس, فيمكنك حذفها من الان لو احببت ذلك ولكن راجه هذا الموضوع اولا
منتدي الجيل الخامس vBulletin 5 | حل مشكلة التعريب وظهور رموز (https://www.rise.company/forum/threads/51571-%D9%85%D9%86%D8%AA%D8%AF%D9%8A-%D8%A7%D9%84%D8%AC%D9%8A%D9%84-%D8%A7%D9%84%D8%AE%D8%A7%D9%85%D8%B3-vBulletin-5-%D8%AD%D9%84-%D9%85%D8%B4%D9%83%D9%84%D8%A9-%D8%A7%D9%84%D8%AA%D8%B9%D8%B1%D9%8A%D8%A8-%D9%88%D8%B8%D9%87%D9%88%D8%B1-%D8%B1%D9%85%D9%88%D8%B2) - إذا كان موقعك يعتمد على الإضافات التالية فنحن ننصحك أن لا تقوم بالترقية لانها قد تفقدها فى الجيل الخامس
المجلة - نظام الاشتراكات المدفوعة - نظام المخالفات - الستايلات المخصصة - الهاكات

---------------------------------------------------------------------
أسئلة الشائعة
---------------------------------------------------------------------

س : هاكات نسختي السابقة لا تعمل.
ج : كل هاكات الجيل الثالث و الرابع لا تدعمها النسخة الخامسة.

س : ستايلات نسختي السابقة لا تعمل.
ج : كل ستايلات الجيل الثالث و الرابع لا تدعمها النسخة الخامسة.

س : أعضاء موقعي لا يستطيعون استخدام الاشتراكات المدفوعة
ج : نظام الاشتركات المدفوعة لا يوجد بالنسخة الحالية. ستتم إعادةته في نسخة مقبلة.

س : ماذا حدث لمجلتي و كل مقالاتها و محتوياتها ؟
ج : نظام المجلة غير موجود في النسخة 5.0. سيتم توفيره في نسخة مقبلة. و مقالات و محتويات مجلتك تم تخزينها في قناة مخفية و سيتم نقلها عندما سنقوم بتوفير المجلة.

س : أين نظام المخالفات ؟
ج : نظام المخالفات لا يوجد بالنسخة الحالية. ستتم إعادة في نسخة مقبلة.

س : أين نظام التعليمات FAQ ؟
ج : نظام التعليمات لا يوجد بالنسخة الحالية. ستتم إعادة في نسخة مقبلة.

س : أين قائمة الأعضاء ؟
ج : لا توجد قائمة أعضاء في الجيل الخامس.

س : تصلني رسالة خطأ داخل لوحة تحكم الإدارة
ج : العديد من وظائف لوحة تحكم الإدارة لم تعد تعمل. و يمكن أن تصلك رسائل خطأ بسبب ذلك. افتح تذكرة دعم فني إن كنت في حاجة للمساعدة.

س : هل لديكم لائحة لكل الأمور التي قمتم بحذفها في الجيل الخامس ؟
ج : لا، لا نتوفر على لائحة كاملة حاليا. رجاء أكتب موضوعا في المنتدى عن الوظيفة التي تنقصك و ستحصل على المساعدة.

س : كيف أستطيع أن أحذف المدونات، المجموعات الاجتماعية، الألبومات ؟
ج : الإجابة المختصرة هي : لا تستطيع ذلك. لكن تستطيع عبر التراخيص منع أعضائك من مشاهدة هذه الوظائف. رجاء أكتب موضوعا في المنتدى و ستحصل على المساعدة.

س : كيف أستطيع حذف Activity Stream ؟
ج : لا تستطيع. لكن يمكنك تعطيل القائمة الخاصة بهذه الخدمة و إعادة ترتيب القوائم. لمزيد من التوضيح رجاء أكتب موضوعا في المنتدى.

---------------------------------------------------------------------
مشاكل شائعة
---------------------------------------------------------------------

مشكلة : بعد الترقية، كل الصور و الـCSS لا تظهر عندي بشكل مثالي.

تأكد من أنك لا تستخدم مخزن الـCSS في نظام الملفات (File System).
تأكد من أن رابط موقعك ينتهي بـ core/ في الإعدادات => الخيارات => اسم الموقع / رابط الموقع (URL) / بيانات الإتصال. المسار لمن يستخدم نسخة غير معربة
Settings -> Options -> Site Name / URL / Contact Details
تأكد من أن المسارات (paths) صحيحة في ملف Config.php الرئيسي* الموجود في هذا المسار : /config.php
* في الجيل الخامس هناك ملفان Config.php. أحدهما يوجد في المجلد الرئيسي لموقعك على المسار /config.php و الثاني يوجد داخل مجلد includes على المسار /core/includes/config.php. الأول أسميه Config.php رئيسي و الثاني أسميه Config.php فرعي. لمزيد من التفاصيل اقرأ هذا الرد هنا (https://www.traidnt.net/vb/traidnt2155995-2/#post19246520).

مشكلة : لا أستطيع دخول موقعي كمسجل أو البقاء كمسجل حتى لو اخترت خيار "تذكرني" (Remember Me).

تأكد من أن نفس القيمة لمتغيرات الكوكيز موجودة في كلا ملفي Config.php، الرئيسي و الفرعي. القيمة الافتراضية هي bb و بالتالي السطر الخاص بمتغيرات الكوكيز في كلا الملفين يجب أن يكون هكذا :
$config['cookie_prefix'] = 'bb';

مشكلة : توقفت الترقية عندما وصلت إلى 99% أي في مرحلة تحديث كاش الستايل (Style Cache).

هذا مشكل شائع معروف السبب. لحل هذا المشكل رجاء احذف كل ستايلات الجيل الثالث و الرابع من قاعدة البيانات قبل الترقية. هذا الإجراء سيسمح للترقية بالاكتمال.

مشكلة : ماذا حدث للصور الرمزية للأعضاء و المرفقات ؟

إذا كنت تحتفظ بمرفقاتك و الصور الرمزية في ملف النظام (file system) فتستطيع أن تقوم باسترجاعها و رفعها من جديد. حسب المكان الذي نصبت فيه vBulletin 5 و كيف هو المسار الخاص به في قاعدة البيانات، يستحسن أن تقوم بنقل تلك الملفات إلى مكان جديد لتعمل بشكل جيد.


مشكلة : لماذا تم إعادة ترقيم المنتديات، المواضيع، المجموعات الاجتماعية، ...الخ ؟ أم أنه تم وضع ترقيم (ID) جديد لها ؟

بسبب الهيكلة الجديدة لقاعدة البيانات في vBulletin 5 التي تعمل بالروابط و القنوات فالترقية تقوم باستيراد الجداول القديمة لتحويلها إلى جداول جديدة. و بما أن المواقع و المنتديات تقوم عادة بحذف بعض المحتويات و الأقسام و ما إلى ذلك، فتكون هناك عادة بعض الاختلالات في أرقام المواضيع و الأقسام ... خلال الاستيراد يتم معالجة هذه الاختلالات بفضل طريقة عمل MySQL و الترقيم التلقائي.

---------------------------------------------------------------------
تـــنـــويـــه :
---------------------------------------------------------------------

4- قم برفع ملفات مجلد /upload/ لنسختك إلى هذا المجلد الجديد الذي أنشأته.

لو قمت برفع ملفات /upload/ إلى هذا المجلد مباشرة فالرابط الرئيسي لموقعك الذي ستكتبه في ملف config.php سيكون هو :
رمز PHP:
http://example.com


لكن تستطيع إنشاء مجلد تسميه ما شئت، مثلا vb5، داخل مجلد public_html. نفس الطريقة المستخدمة في الجيل الرابع و الثالث حيث أنك تقوم بإنشاء مجلد forum (أو vb بالنسبة للجيل الثالث) داخل مجلد public_html. لو فعلت هذا فالرابط الرئيسي لموقعك الذي ستكتبه في ملف config.php سيصبح هكذا :

رمز PHP:
http://example.com/vb5


5- قم بتعديل اسم ملف config.php الفرعي الموجود في هذا المسار :

رمز PHP:
/vb5/core/includes/config.php.new


ليصبح config.php عوض config.php.new. ثم غير أيضا معلومات و اسم قاعدة بياناتك داخل هذا الملف. هذا شبيه بما تفعله في الجيل الثالث و الرابع قبل أي تنصيب أو ترقية.


خطوات خاصة بالجيل الخامس

1- قم بتعديل اسم ملف config.php الرئيسي الموجود على هذا المسار :

رمز PHP:
/vb5/config.php.bkp


من config.php.bkp إلى config.php.

طبعا المسار السابق هو لمن قام بإنشاء مجلد vb5 داخل المجلد الرئيسي public_html ثم قام برفع ملفات نسخته إليه. أما من قام برفع ملفات /upload/ مباشرة إلى public_html فسيجد ذلك لملف في المسار التالي :

رمز PHP:
/config.php.bkp


2- قم بإضافة المعلومات و القيم المطلوبة داخل ملف config.php الرئيسي كما يلي :

- الرابط الرئيسي لموقعك سيكون إذا رفعت ملفات مجلد /upload/ إلى public_html مباشرة :

رمز PHP:
$config['baseurl'] = 'http://example.com'


أما إذا أنشأت مجلد vb5 داخل المجلد الرئيسي public_html و رفعت ملفات مجلد /upload/ إليه فستصبح القيمة هكذا :

رمز PHP:
$config['baseurl'] = 'http://example.com/vb5'


- الرابط الرئيسي للنواة سيصبح مثل الرابط أعلاه لكن بإضافة core/ في نهاية الرابط :

إذا رفعت ملفات مجلد /upload/ إلى public_html مباشرة

رمز PHP:
$config['baseurl_core'] = 'http://example.com/core'


إذا أنشأت مجلد vb5 داخل المجلد الرئيسي public_html و رفعت ملفات مجلد /upload/ إليه

رمز PHP:
$config['baseurl_core'] = 'http://example.com/vb5/core'


- المسار الرئيسي لنظام الملفات (Core Path).

إذا كان سيرفر موقعك يستخدم نظام الوينداوز (Windows)

فستصبج القيمة هكذا إذا رفعت ملفات مجلد /upload/ إلى public_html مباشرة

رمز PHP:
$config['core_path'] = 'C:\\xampp\\htdocs\\core';


و إذا أنشأت مجلد vb5 داخل المجلد الرئيسي public_html و رفعت ملفات مجلد /upload/ إليه فتصبح هكذا :

رمز PHP:
$config['core_path'] = 'C:\\xampp\\htdocs\\vb5\\core';


إذا كان سيرفر موقعك يستخدم نظام اللينوكس (Linux)

فستصبج القيمة هكذا إذا رفعت ملفات مجلد /upload/ إلى public_html مباشرة

رمز PHP:
$config['core_path'] = '/home/users/yourusername/core';


و إذا أنشأت مجلد vb5 داخل المجلد الرئيسي public_html و رفعت ملفات مجلد /upload/ إليه فتصبح هكذا :

رمز PHP:
$config['core_path'] = '/home/users/yourusername/vb5/core';


- مجلد Admincp حاليا في نسخة البيتا

رمز PHP:
$config['admincpdir'] = 'admincp';


- الكوكيز Cookie Prefix .. تأكد من أنك أدخلت نفس هذه القيمة في ملف config.php الآخر (الفرعي).

رمز PHP:
$config['cookie_prefix'] = 'bb';


- إذا كنت تستخدم النسخة بيتا ستريد تفعيل debug mode حينها غير القيمة

رمز PHP:
$config['debug'] = false;


إلى

رمز PHP:
$config['debug'] = true;

---------------------------------------------------------------------
تنفيذ عملية الترقية
---------------------------------------------------------------------

1- اذهب لمسار الترقية الخاص بالنواة لتنصيب vBulletin 5. على مسار يشبه المسار المستخدم في الجيل الرابع.

مثال لمسار الترقية لمن رفع ملفات مجلد /upload/ إلى public_html مباشرة
رمز PHP:
http://www.example.com/core/install/upgrade.php


مثال لمسار الترقية لمن أنشأ مجلد vb5 داخل المجلد الرئيسي public_html و رفع ملفات مجلد /upload/ إليه :
رمز PHP:
http://www.example.com/vb5/core/install/upgrade.php


2- عند انتهاء الترقية يمكنك أن تشاهد موقعك على الرابط التالي :

رمز PHP:
http://www.example.com


أو
رمز PHP:
http://www.example.com/vb5


3- يمكنك الدخول إلى لوحة تحكم موقعك عبر الرابط التالي :

رمز PHP:
http://www.example.com/admincp


أو
رمز PHP:
http://www.example.com/vb5/admincp

---------------------------------------------------------------------
تعليمات خاصة بالترقية باستخدام الأوامر
---------------------------------------------------------------------

إذا كنت تملك موقعا كبيرا و ضخما يجب أن تقوم بالترقية باستخدام الأوامر، لأن ذلك سيكون أسرع و أنجع طريقة لترقية موقعك. لأجل ذلك اتبع الخطوات التالية :

1- قم بتعديل ملف config.php كما شرحنا أعلاه.

2- اتصل بسيرفر موقعك عبر SSH.

3- اذهب إلى المجلد الخاص بترقية النواة الرئيسية لموقعك (forum's core install directory). مثال :

رمز PHP:
cd <install location>/core/install


4- ازرع الأمر التالي :

رمز PHP:
php upgrade.php


إذا خفت أن تفقد الاتصال باستخدام SSH أثناء عملية الترقية، استخدم الأمر التالي :

رمز PHP:
nohup php upgrade.php &

هذا سيسمح لعملية الترقية بالاستمرار حتى دون اتصال.



تـــنـــويـــه : قبل أن تقوم بعملية الترقية إلى النسخة الخامسة، بالإضافة إلى كل ما جاء في الموضوع، تأكد من أنك عطلت خيار تخزين أنماط CSS كملفات. هذا مهم جدا جدا و تركه مفعلا سيحدث لك بالتأكيد مشاكل في عملية الترقية أو سيمنع ظهور بعض الصفحات بعد الترقية.

الإعدادات => الخيارات => إعدادات اللغة - الستايل => تخزين أنماط CSS كملفات؟ اختر (لا)

تـــوضـــيـــح مـــهـــم :

لو كنت تخزن مرفقاتك في مجلد مستقل attachments فهذا المجلد لا تقم بحذفه و إلا ستفقد كل ملفاتك المرفقة. نفس الأمر ينطبق على من يستخدم مجلد خاص بمركز تحميل أو رفع صور خاص بموقعه. هذا الملف كذلك لا تقم بحذفه و إلا ستفقد كل الصور التي قمت برفعها على مركز رفع الصور و الملفات الخاص بموقعك.

أصلا، يفضل وضع مجلد attachments و مجلد up خارج مجلد public_html .. لكن من لم يفعل فلا بأس يمكنك تركهما داخل ملف public_html ثم رفع ملفات نسختك الخامسة إليه دون خوف.





هام جدا بعد اتمام الترقية :

يجب مراجعة كل صغيرة وكبيرة فى الموقع للتاكد انه لا يوجد اى خطاء او مشاكل
قم بتجربة الروابط داخل الموقع و على جوجل - قم بمراجعة attachments - قم بمراجعة اللغة العربية

Rise Company
30-12-2019, 02:34
أدنى ما يحتاجه نظام موقعك من أجل أن يتوافق مع الجيل الخامس.
تنويه : هذه المتطلبات يمكن أن تتغير في الفترة بين النسخة بيتا و النسخة النهائية.
هذه هي أدنى المتطلبات التي يحتاجها نظام موقعك لكي يتوافق مع نسخ الجيل الخامس و إلا فلن تستطيع تنصيبه على موقعك :
PHP 5.3.0

MySQL 5.1.5
ملف لإعادة قراءة الروابط سواء mod_rewrite أو ما يشابهه.
ضرورة تحميل ملف .htaccess أو ملف web.config.


لأجل تنصيب و ترقية و عمل جيد ننصح بهذه المتطلبات :

PHP 5.4.0 أو أحدث
MySQL 5.5.0 أو أحدث

Rise Company
30-12-2019, 03:02
Quick Overview: Upgrading vBulletin Connect Sat 12th May '18, 11:01am


Now that you've been using vBulletin Connect for a while, a new version has become available and you're thinking "How do I upgrade this?" That is what this tutorial is for. We will step you through upgrading vBulletin and making sure that your site has as little downtime as possible.

Tools needed to upgrade vBulletin Connect on your server

A text editor that understands Linux linefeeds. Suggested editors are Atom (https://atom.io/), Visual Studio Code (https://code.visualstudio.com/), and Notepad++ (https://notepad-plus-plus.org/).
ZIP Management Utility.
SFTP Client. We suggest Filezilla (https://filezilla-project.org/).


A moderate knowledge of HTML (https://www.w3schools.com/html/default.asp) and CSS (https://www.w3schools.com/css/default.asp) will be beneficial in customizing your site but is not necessary for basic customizations.

Terms


A couple of definitions before we get started:

%yourdomain% should be replace with the domain name you are using for your site.
%forumroot% refers to the directory where vBulletin Connect is installed. If you install vBulletin Connect in the public_html or www directory, this value would be empty.



Upgrading from previous versions of vBulletin 5 Connect

Turn your vBulletin Connect site off so that users do not try to add content while you are updating the software. You can do this in the AdminCP under Settings -> Options -> Turn Your vBulletin On or Off.
Using the tools provided by your hosting provider, make a backup of your current database.
Using your SFTP client, upload the new files to your server. When prompted tell it to overwrite all files in the current transfer queue.
With your web browser run the Upgrade Wizard. The location will be https://%yourdomain/%forumroot%/install/upgrade.php
When the Upgrade Wizard is complete, you will need to delete the install folder within /core/ on your server to proceed.
Log into your site and review the upgrade.
When everything appears satisfactory, turn your site back on in the AdminCP under Settings -> Options -> Turn Your vBulletin On or Off.


Upgrading via the Command Line Interface
If you have a larger site, then you may want to run the upgrade scripts from the Command Line Interface (CLI). vBulletin can support this. After you have prepared your files using the steps above then you can log into your command line interface, usually SSH. From your SSH terminal, change into the %forumroot%/core/install directory. Then run the upgrade utility with this command line:
Code:
php -f upgrade.php
Upgrading from vBulletin 4.2.5 Publishing Suite


Preparing for your upgrade
If you are using an older version of vBulletin. It is recommended that you download and upgrade to the vBulletin 4.2.5 Publishing Suite before proceeding to vBulletin 5. This will make sure your system is at the most compatible level to be converted. Please follow these tips for the best migration:

Uninstall all third-party addons in the AdminCP under Plugins & Products -> Product Manager.
Leave the vBulletin Blog and vBulletin CMS products installed.
All other Products are incompatible.
Download your logo to be reused.
Read why we recommend using a test server for the initial upgrade (below)
Make a backup of your database to store locally.
Delete all vBulletin 4.X files. Maintain your attachment, customavatar, and signaturepics directories in their current locations.
Follow the Upgrade Steps below.


Using a Test Server for the Initial Upgrade
vBulletin Connect is more than an upgrade from older versions of vBulletin. It reimagines how a lot of the system functions to achieve various goals. These goals include standardized functionality across content creation, mobile device support, modularity, security, and updating programming standards. This requires a different code structure than previous versions of vBulletin and comes with a new database structure. When upgrading to vBulletin Connect, the process is more of a migration of data rather than the generally simply upgrades. For this reason we recommend upgrading a test copy first. This will allow your older version of vBulletin to remain live while you test and verify that the ugprade was successful. It will also give you and your team time to familiarize yourself with the new software so you can provide support to your end-users.

You can read how to utilize a test server in our online manual here: https://www.vbulletin.com/go/testserver

Upgrade to vBulletin 5.
Now that you have prepared your vBulletin 4.2.5 data to be upgraded to vBulletin Connect you can follow these steps.

After Purchasing, download vBulletin Connect from the your Member's Area (https://members.vbulletin.com).
Unzip the downloaded package on your local machine. Depending on your hosting provider and internet connection this can take some time.
In your vBulletin files there will be a directory called upload. Enter it.
Rename config.php.bkp to config.php (ren config.php.bkp config.php)
Enter the /upload/core/includes directory.
Rename config.php.new to config.php (ren config.php.new config.php)
Edit config.php and change these values to match your information.

$config['Database']['dbname'] = 'databasename';
$config['Database']['technicalemail'] = '[email protected]';
$config['MasterServer']['servername'] = 'localhost'; // may be referred to as a host name
$config['MasterServer']['port'] = 3306;
$config['MasterServer']['username'] = 'username';
$config['MasterServer']['password'] = 'password';
Make sure that all values are to the right of the equal sign (=) and between the single quotes ('). If you do not know these values they can be obtained from your hosting provider.
No other values need to be changed in this file for a basic installation of vBulletin Connect.


Using your SFTP Client, upload the contents of the upload directory (including all sub-directories and files) to your server. Place these files in the directory where you want to install vBulletin. This directory should be empty.
If you store file attachments and custom avatars in the file system (both recommended), then you will need to copy these to your new directory as well.
Rename htaccess.txt to .htaccess (the leading period is required). If you are using Filezilla, you can do this by right-clicking on the file and choosing rename on the context menu. This can also be done from the Windows Command Line before uploading the files to the server.
Load the Upgrade Wizard in your browser. The URL should be https://%yourdomain%/%forumroot%/install/upgrade.php
The Upgrade Wizard will ask for your Customer ID. This can be found in your Member's Area after logging in.
Process all the steps in the Wizard. Some steps make take a long time.


Upgrading from Older Versions of vBulletin
For the best upgrade scenarios, we recommend that you first upgrade to vBulletin 4.2.5 and then follow the steps above.

After Upgrading

During the upgrade process from vBulletin 3 and vBulletin 4, the search index is not created. This improves upgrade times significantly. After upgrading, you will need to rebuild your search index. Your site can be live during the search engine rebuild but there may be performance issues while indexing occurs. There are two ways to index your site for keyword based searches.

Within the AdminCP at Maintenance -> General Update Tools -> Rebuild Search Index.
Using the searchindex.php located in the do_not_upload directory of your download package. The file should be placed in your %forumroot% directory and then executed from the command line. When indexing is completed, the file should be deleted from your server.


File Cleanup

Often when we refactor functionality within the system, it requires the removal of files that become obsolete. Due to the upgrade process, these files can build up on your server. In addition to this, each version includes its own set of javascript files with unique names. While these files shouldn't cause issues, they will take up space on your server. We recommend deleting these obsolete files from your server in order to maintain a clean file set. This requires a few steps to complete.

1. Delete rollup javascript files that do not include your version number in the file name. These will not appear in the Suspect File Version diagnostic.

2. Use the Suspect File Version tool in the AdminCP to delete all obsolete PHP files.

In the AdminCP go to Maintenance -> Diagnostics.
Run the Suspect File Versions tool.
It will scan the vBulletin directories and list all files not part of vBulletin.
Review these files to make sure they aren't part of a customization. If they aren't needed, then delete them with your SFTP client.



3. If you store your CSS as Files, you would want to follow these steps:

Turn off Store CSS as Files (AdminCP -> Settings -> Options -> Style & Language Options).
Delete the contents of the /core/clientscript/vbulletin_css directory.

If you store your CSS files elsewhere, delete the contents of that location.


Turn on Store CSS as Files (AdminCP -> Settings -> Options -> Style & Language Options).

Rise Company
30-12-2019, 03:02
Frequent Upgrade Issues

After installing vBulletin 5, my site is unformatted
This means that URL Rewriting is not working on your site. Possible causes include:

htaccess.txt has not been renamed to .htaccess (the leading period is important)
mod_rewrite is not installed for Apache 2.4
URL Rewrite is not installed for IIS 8.5+
The server configuration for NGINX has not been updated. See the file for your version of PHP within the do_not_upload folder.
AllowOverride is not allowed in the Apache configuration file.

You hosting provider can help you get the ability to rewrite URLS working on your site.

The AdminCP directory is empty
This is by design. The /admincp/ directory is just a place holder and not actually needed or used by the software.

The option to rename the AdminCP is missing.
This is by design. Renaming this directory doesn't actually provide any security to your installation. If someone has access to your Administrator username and password, they can still access the AdminCP. vBulletin Connect and vBulletin Cloud both have other methods to secure the AdminCP. These include both Two-Factor Authentication and IP Blocking built into the software.

The system states that it is not able to find the Log In Form
Make sure that the Log In URL is set correctly in the AdminCP. In most installations, it should be the same as the Frontend URL.
Last edited by Wayne Luke (https://forum.vbulletin.com/member/868-wayne-luke); Tue 21st May '19, 8:51am.

Rise Company
30-12-2019, 03:05
Quick Overview: How to Upgrade to vBulletin 5 Connect. Wed 5th Sep '12, 10:25am


vBulletin 5 Requires URL Rewriting. This will be mod_rewrite or its equivalent under Apache and URL Rewrite under IIS. There is an .htaccess (Apache) file and web.config (IIS) included in the upload folder for this purpose. The software will not work without URL Rewriting.

Note: It is important to install vBulletin 5 into a clean directory. Do not attempt to overwrite your 4.X files or the install will fail and you will be left with hundreds of unused files.


Setting Up vBulletin 5
Please note that vBulletin 5 has two config.php files. It is very important that both are edited and the values of any overlapping variables like cookie prefix are identical in both files.


If Upgrading from a previous version, you need to create a backup of your database before proceeding.
After Purchasing, download vB5 from the your Member's Area.
Unzip the package.
Create a new directory to hold vBulletin 5. It should not contain any vBulletin 3 or 4 files.
Copy the /upload/ your new html folder. For simplicity’s sake, I’m going to assumed it’s been renamed and refer to it as /vb5/.
Rename /vb5/core/includes/config.php.new to config.php and edit it like you would for vB4. (Change the database credentials & database name.). This is similar to how you installed/upgraded vBulletin 3 and 4.
Rename htaccess.txt to .htaccess (Note the preceding . IS required)



5.X specific steps

Rename /vb5/config.php.bkp to config.php.
Set the cookieprefix to be the same as the one in /vb5/core/includes/config.php.



Running the Upgrade Wizard

Go to the install directory of core in your browser to install vB5. This is just like installing vB4. Ex: http://www.example.com/vb5/core/install/upgrade.php
When finished you can view the site through the baseurl (http://www.example.com/vb5).
You should be able to access your AdminCP via the baseurl + /admincp (http://www.example.com/vb5/admincp).




Command Line Upgrades.
If you have a larger forum, you should upgrade via the command line. This is a faster and more efficient way to upgrade. In order to do this, follow these steps:

Edit your config.php files as stated above.
Connect to your server via SSH.
Switch to your forum's core install directory. example: cd <install location>/core/install
Type this command: php upgrade.php



You can use this command "nohup php upgrade.php &" if you feel that your SSH connection will fail in the middle of the upgrade. This will allow the upgrade to continue in the background without a connection.

Why are there two config.php files?
vBulletin 5 has two layers of functionality. These are the Presentation and the Core Layers. The Presentation layer does not have permission to use code in the Core layer directly and accesses it via the API. This allows more data security and in the future can include the functionality where the Core layer is located on a completely different server for more security.