ترقية ArcGIS Notebook Server (حاويات Linux)

توفر ترقية ArcGIS Notebook Server لمؤسستك أحدث المزايا والتحسينات على البرامج، مع الحفاظ على دفاتر الملاحظات الحالية الخاصة بالمستخدمين. إذا كنت تقوم بترقية نشر ArcGIS Enterprise إلى 11.3، يجب أن تقوم أيضًا بترقية ArcGIS Notebook Server.

تكتشف حزمة إعداد ArcGIS Notebook Server 11.3 ما إذا كان لديك تثبيت حالي لإصدار سابق من ArcGIS Notebook Server على جهازك. إذا كان لديك، يمكنها ترقية البرنامج إلى 11.3.

في أثناء عملية الترقية، تجب إعادة ترخيص برنامج ArcGIS Notebook Server الخاص بـ 11.3 إذا قمت بالترقية من الإصدار 10.8.1 أو إصدار أقدم.

يجب عليك أيضًا تثبيت صور حاوية جديدة من Esri، مما يوفر للمستخدمين أوقات تشغيل دفتر ملاحظات 11.3. ستظل أوقات تشغيل دفتر الملاحظات من الإصدار السابق في الموقع؛ وسيظل المستخدمون قادرين على تشغيل دفاتر الملاحظات باستخدام أوقات التشغيل تلك. ومع ذلك، إذا أراد المستخدمون استخدام الوظائف الجديدة في 11.3، فعليهم تحديث وقت تشغيل دفاتر الملاحظات الخاصة بهم. تقع أوقات تشغيل دفتر الملاحظات المقابلة لـ 11.3 في الإصدار 10.0 (ArcGIS Notebook Server Standard 10.0 وArcGIS Notebook Server وخيارات 10.0).

ملاحظة:‏

إن كانت أي من دفاتر الملاحظات تستخدم أوقات تشغيل مخصصة، يلزمك إعادة إنشاء وإعادة تسجيل أوقات التشغيل المخصصة على خادم دفتر الملاحظات Windows وتحديث إعدادات وقت التشغيل لعناصر دفتر الملاحظات ذات الصلة.

ملاحظة:‏

ستُستبعد أوقات تشغيل دفتر الملاحظات بعد دورة حياة ArcGIS Enterprise. سيُستبعد وقت تشغيل دفتر الملاحظات في نفس وقت استبعاد الإصدار المتصل ArcGIS Enterprise. يجب ألا تستخدم دفاتر الملاحظات أوقات تشغيل مستبعدة ويجب تحديثها إلى وقت تشغيل مدعوم.

ستؤدي ترقية مدخل ArcGIS Enterprise أيضًا إلى تحديث نماذج Notebooks المتوفرة في معرض الموقع.

يتم دعم مواقع ArcGIS Notebook Server متعددة الأجهزة في الإصدار 10.7.1 والإصدارات الأحدث. إذا كان لديك موقع بجهاز واحد وترغب في توسيع موقع ArcGIS Notebook Server ليشمل أجهزة متعددة بعد الترقية، فاتبع الخطوات من أجل ضم أجهزة إضافية إلى الموقع بعد الانتهاء من الترقية إلى 11.3.

تعد عملية الترقية الخاصة بـ ArcGIS Notebook Server ترقية موضعية، ولا تتطلب إلغاء تثبيت البرنامج وإعادة تثبيته مرة أخرى. سيتوقف الموقع عن العمل في أثناء عملية الترقية، ولن يتمكن المستخدمون من الوصول إلى Notebooks أو تشغيلها حتى تكتمل الترقية.

اتبع الخطوات التالية للترقية من ArcGIS Notebook Server إلى 11.3.

الإعداد للترقية

قبل الترقية، راجع المعلومات التالية:

• يمكنك الوصول إلى جميع الملفات الضرورية في My Esri قبل الترقية، بما في ذلك صور الحاوية الخاصة 11.3.
• لكي يعمل ArcGIS Notebook Server بشكل صحيح، يجب أن يتطابق مع إصدار المدخل الذي يتحد معه.
• إذا كان خادم دفتر الملاحظات "Notebook" الخاص بك في وضع القراءة فقط حاليًا، قم بتعطيل وضع القراءة فقط قبل بدء عملية الترقية.
• ترقية Docker إلى الإصدار 23.0 أو الإصدار الأحدث.
• لترقية نشر ArcGIS Enterprise، قم بما يلي:
  1. قم بترقية Portal for ArcGIS.
  2. قم بترقية ArcGIS Web Adaptor (للمدخل).
  3. قم بترقية موقع ArcGIS Server الذي يعمل كخادم مضيف للمدخل.
  4. قم بترقية ArcGIS Web Adaptor (للخادم).
  5. قم بترقية ArcGIS Data Store (ترقية الرئيسي أولاً، ثم الاحتياطي).
  6. قم بترقية أي خوادم أخرى، بما في ذلك ArcGIS Notebook Server.
  7. تثبيت نماذج بيانات ArcGIS Notebook Server
• لا تقم بإلغاء تثبيت ArcGIS Notebook Server الحالي. تم تصميم برنامج إعداد ArcGIS Notebook Server ومثبتات سطر الأوامر لاكتشاف وترقية التثبيت الحالي لمكونات ArcGIS Notebook Server.
• لا تقم بإلغاء توحيد موقع ArcGIS Notebook Server من البوابة الإلكترونية أو إزالة تعيينه كخادم دفتر ملاحظات البوابة الإلكترونية في أي وقت أثناء عملية الترقية. يؤثر ذلك تأثيرًا سلبيًا على دفاتر الملاحظات الحالية التي تستضيفها البوابة الإلكترونية.
• يمكنك ترقية ArcGIS Notebook Server باستخدام إما برنامج الإعداد أو مثبت سطر الأوامر. اختر إحدى هذه الطرق للترقية.
• قبل الترقية، امسح ذاكرات التخزين المؤقت لجميع مستعرضات الويب المستخدمة على جهاز ArcGIS Notebook Server.

نقل دليل مساحة العمل

هذه العملية مطلوبة لنشر ArcGIS Notebook Server لجهاز واحد على Linux والتي تحتوي على دليل مساحة العمل/ داخل دليل تثبيت خادم دفتر الملاحظات.

1. سجّل الدخول إلى بوابة ArcGIS Enterprise الإلكترونية كمسؤول وافتح مدير ArcGIS Notebook Server.
2. انقر على علامة تبويب إعدادات.
3. انقر فوق الاتجاهات.
4. تحقق مما إذا كان المسار الحالي إلى دليل arcgisworkspace موجود داخل دليل تثبيت ArcGIS Notebook Server.

   <installdir>/arcgis/notebook/directories/arcgisworkspace

   إذا كان دليل arcgisworkspace موجودًا داخل دليل تثبيت ArcGIS Notebook Server، فيجب عليك نقل دليل مساحة العمل إلى موقع خارج دليل التثبيت قبل البدء في عملية الترقية.

   إذا كان دليل arcgisworkspace غير موجود داخل دليل تثبيت ArcGIS Notebook Server، فلا يتعين عليك إجراء الخطوات المتبقية في هذا القسم.

5. انقر فوق تحرير الخاص بدليل arcgisworkspace.
6. استبدل قيمة المسار الحالي للدليل بالمسار الجديد لدليل arcgisworkspace الذي يقع خارج دليل التثبيت.

   <installdir>/arcgis/arcgisnotebookserver/directories/arcgisworkspace

7. انقر حفظ.
8. انسخ يدويًا جميع المحتويات من دليل arcgisworkspace السابق إلى دليل arcgisworkspace الجديد.

نسخ النشر احتياطيًا

قبل الترقية، يوصى بإجراء نسخ احتياطية لعملية النشر.

سيتم تضمين Notebooks في النسخ الاحتياطية للبوابة باستخدام الأداة المساعدة webgisdr.

يمكنك استخدام عملية exportSite في دليل مسؤول ArcGIS Notebook Server لإجراء نسخ احتياطي لمخزن تكوين الموقع، كما هو موضح أدناه. بالإضافة إلى النسخة الاحتياطية لتكوين الموقع، يوصى بإجراء نسخ احتياطية يدوية لنظام الملفات الخاص بك.

لتشغيل عملية النسخ الاحتياطي، أكمل الخطوات الآتية:

1. افتح دليل مسؤول ArcGIS Notebook Server وقم بتسجيل الدخول كمستخدم يمتلك امتيازات إدارية.

   عنوان URL بالتحديد هو https://notebookserver.domain.com:11443/arcgis/admin.

2. انتقل إلى الموقع > تصدير الموقع.
3. اكتب المسار الكامل للموقع على جهازك الذي تريد تصدير الملف إليه.

   يجب أن يتمتع الموقع بحق الوصول إلى هذا الدليل.

4. انقر على تصدير.

   عند اكتمال عملية التصدير، سيقدم الدليل رابطًا لموقع ملف النسخ الاحتياطي على الخادم.

5. قم بتنزيل الملف، الذي سيكون له امتداد ملف .agssite، في أسرع وقت ممكن.

ترقية باستخدام برنامج الإعداد

ملاحظة:‏

استخدم ملف الإعداد لترقية ArcGIS Notebook Server إلى 11.3. بعد ترقية الإعداد، يجب ترقية موقع ArcGIS Notebook Server باستخدام معالج التكوين أو الأداة المساعدة لترقية الموقع.

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

تم تصميم ArcGIS Notebook Server لكشف التثبيت الحالي لمكونات ArcGIS Notebook Server وترقيته.

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

1. قم بتشغيل ./Setup من الموقع الذي تم فيه استخراج ArcGIS Notebook Server، واتبع الأوامر لإكمال الترقية.

   يجب تشغيل الإعداد كحساب المستخدم الذي قام بتثبيتArcGIS Notebook Server الحالي. في أثناء التثبيت، سيحدد برنامج الإعداد التثبيت الحالي، وسيُطلب منك تأكيد الترقية. أدخل خيار y لمتابعة التثبيت.

   سيؤدي هذا إلى إلغاء تثبيت الإصدار السابق من ArcGIS Notebook Server وتثبيت الإصدار الذي تمت ترقيته من ArcGIS Notebook Server.

2. بعد إكمال الأداة المساعدة للترقية، أعد ترخيص برنامج ArcGIS Notebook Server الخاص بـ 11.3. استخدم معالج ترخيص البرنامج لإكمال الترخيص.
3. افتح معالج التكوين باستخدام عنوان URL المدرج في نهاية ترقية التثبيت واتبع الإرشادات التي تظهر على الشاشة لترقية الموقع.
4. بالنسبة للموقع متعدد الأجهزة، فاتبع الخطوات من 1 إلى 3 لكل جهاز في الموقع.

الترقية من سطر الأوامر

للترقية من سطر الأوامر، أكمل الخطوات الآتية:

1. لبدء الترقية، قم بتشغيل ./Setup من الموقع الذي تم فيه استخراج ArcGIS Notebook Server، مع الوسيطة الموضحة في المثال أدناه واتبع المطالبات لإكمال الترقية.

   سيؤدي هذا إلى إلغاء تثبيت الإصدار السابق من ArcGIS Notebook Server وتثبيت الإصدار الذي تمت ترقيته من ArcGIS Notebook Server.

   <untar directory>/Setup -l yes -m silent

2. بعد إكمال الأداة المساعدة للترقية، أعد ترخيص برنامج ArcGIS Notebook Server الخاص بـ 11.3. قم بتشغيل ترخيص البرنامج باستخدام الصيغة التالية لترخيص ArcGIS Notebook Server دون مطالبة:

   <ArcGIS Notebook Server install directory>/tools/authorizeSoftware

   قم بتشغيل الأمر التالي لعرض جميع خيارات الترخيص:

   <ArcGIS Notebook Server install directory>/tools/authorizeSoftware --help

   ملاحظة:‏

   راجع قسم الترخيص في بيئة غير متصلة للحصول على معلومات عن ترخيص عمليات تثبيت ArcGIS Notebook Server في بيئة غير متصلة.

3. ترقية الموقع باستخدام الأداة المساعدة لسطر الأوامر upgradesite.

   تحتوي هذه الأداة المساعدة على معلمتين:

   • -s—عند تضمينهما في الأمر، يؤدي ذلك إلى مطالبة الأداة المساعدة بتشغيل الترقية. لن تعمل الترقية بدون -s. يعد ذلك بمثابة حماية لضمان تشغيل الترقية عندما تكون جاهزًا فقط.
   • -hــ يعرض التعليمات الخاصة بالأداة. عند تشغيل الأمر بدون -s، تظهر التعليمات أيضًا.

   افتراضيًا، تتوفر أداة upgradesite المساعدة في ${HOME}/arcgis/notebookserver/tools/upgradesiteutility/upgradesite.sh.

   قبل الترقية، راجع معلومات الإعداد في بداية هذا الموضوع. عندما تكون جاهزًا للترقية، افتح وحدة أوامر طرفية على الجهاز الذي تقوم بترقيته. استعرض للوصول إلى الدليل الذي يحتوي على الأداة المساعدة، وقم بتشغيل الأمر التالي:

   > ./upgradesite.sh -s

   ستعرض الأداة المساعدة تقارير التقدم وستتوقف عند اكتمال الترقية.

4. بالنسبة للموقع المتعدد الأجهزة، اتبع الخطوات من 1 إلى 3 لكل جهاز في الموقع، ثم انتقل إلى الخطوات الواردة في القسم التالي.

التخويل دون مطالبة

بعد اكتمال أداة الترقية المساعدة، يجب إعادة مصادقة برنامج ArcGIS Notebook Server لـ 11.3.

قم بتشغيل ترخيص البرنامج باستخدام الصيغة التالية لترخيص ArcGIS Notebook Server دون مطالبة:

<ArcGIS Notebook Server install directory>/tools/authorizeSoftware

قم بتشغيل الأمر التالي لعرض جميع خيارات الترخيص:

<ArcGIS Notebook Server install directory>/tools/authorizeSoftware --help

الترخيص في بيئة غير متصلة

يمكنك ترخيص ArcGIS Notebook Server في بيئة غير متصلة باستخدام ملف توفير (.prvc). خلال العملية، يتم إنشاء ملف لك لإرساله إلى Esri لإتمام العملية.

1. في الموجه، قم بتشغيل الأمر المقدم أدناه بعد اكتمال ترقية ArcGIS Notebook Server:

   <ArcGIS Notebook Server installation directory>/tools/authorizeSoftware -f <full path to the .prvc file> -o <full path to authorization file output>

2. عندما يتم إنشاء ملف معلومات الناتج، قم بأحد الإجراءات التالية:
   • استعرض Esri موقع الخدمة الذاتي. اتبع التعليمات الموجودة على الشاشة لتحميل ملف معلومات الترخيص وتنزيل ملف الترخيص.ecp.
   • أرسل ملف معلومات الترخيص بواسطة البريد الإلكتروني إلى [e-mail]. وسيرسل Esri ملف ترخيص .ecp إليك مرة أخرى في رسالة بريد إلكتروني.
3. عند استلام ملف اعتماد .ecp باستخدام أي من الطريقتين المذكورتين، قم بتشغيل برنامج authorizeSoftware النصي لمعالجته ولإكمال عملية اعتماد الخادم:

   <ArcGIS Notebook Server installation directory>/tools/authorizeSoftware -f <full path to the .ecp file>

كرر سير العمل هذا لكل الأجهزة التي تقوم بتشغيل ArcGIS Notebook Server.

خطوات ما بعد الترقية

قبل استخدام موقع ArcGIS Notebook Server الذي تمت ترقيته وإعادة ترخيصه، يجب عليك تشغيل أداة ما بعد التثبيت المساعدة لإضافة صور حاوية Docker الجديدة إلى الموقع. يجب عليك أيضًا استبدال مثيلات ArcGIS Web Adaptor المُسجّلة من خلال موقعك لمطابقة الإصدار الجديد.

قم بتشغيل الأداة المساعدة ما بعد التثبيت

لتشغيل الأداة المساعدة لما بعد التثبيت، أكمل الخطوات الآتية:

1. افتح محطة طرفية باستخدام حساب التثبيت ArcGIS Notebook Server.
2. غيِّر الدلائل إلى مجلد أدوات ArcGIS Notebook Server. بشكل افتراضي، هذا المسار هو ${HOME}/arcgis/notebookserver/tools/postInstallUtility.
3. يمكنك الرجوع اختياريًا إلى تعليمات الأداة المساعدة عن طريق تشغيل الأمر التالي: ./PostInstallUtility.sh -h
4. يتطلب ArcGIS Notebook Server تثبيت Docker Engine على جهازك. حدد ما إذا كان Docker نشطًا على جهازك عن طريق تشغيل الأمر التالي: ./PostInstallUtility.sh -d
5. إذا لم يكن Docker Desktop مثبتًا بالفعل، فقم بتثبيته الآن.
6. قم بتثبيت صورة Notebooks بتحديد مسار ملفها. يجب أن تكون الصورة مضغوطة بالتنسيق .tar.gz. إذا كان لديك ترخيص متقدم وDocker Desktop، قم بتشغيل الأمر مرتين لتثبيت صور الحاوية القياسية والمتقدمة التي قمت بتنزيلها من My Esri.

   ملاحظة:‏

   تأكد من أن جهازك يحتوي على 75 جيجابايت على الأقل مساحة حرة على القرص.

   شغِّل الأمر التالي: ./PostInstallUtility.sh -l <path of .tar.gz Docker image>

   ملاحظة:‏

   تأكد من تثبيت صورتي الحاوية. حتى إذا كان لديك الترخيص المتقدم، فقد يظل المستخدمون بحاجة إلى استخدام وقت التشغيل القياسي.

ملاحظة:‏

لا تزال الصور الأقدم تلقائيًا. يجب عليك تحديث أوقات التشغيل المرتبطة بكل دفتر ملاحظات يدويًا للإصدار الأحدث قبل حذف صور وقت التشغيل السابقة.

تثبيت وتكوين نماذج بيانات ArcGIS Notebook Server

عند إعداد موقع ArcGIS Notebook Server متعدد الأجهزة، يجب عليك تثبيت نماذج بيانات وتكوينها فقط على الجهاز الأول الذي قمت بتثبيت Notebook Server وإنشاء الموقع عليه.

لتثبيت نماذج بيانات ArcGIS Notebook Server، أكمل الخطوات التالية:

1. افتح وعاء الأمر بصفته المستخدم الذي سيشغل ArcGIS Notebook Server. انتقل إلى الدليل الذي أنزلت منه ملف ArcGIS Notebook Server لنماذج بيانات tar.gz من My Esri.
2. فك ضغط الملف tar.gz بالأمر التالي:

   tar -xvzf ArcGIS_Notebook_Server_Samples_Data_Linux_.tar.gz

3. تصفح <install directory>/notebookserver/License لقراءة اتفاقية الترخيص.
4. من الدليل، شغِّل البرنامج النصي.

   ./ArcGISNotebookServerSamplesData-Setup.sh

5. قم بتغيير الدلائل إلى مجلد أدوات ArcGIS Notebook Server.

   افتراضيًا، هذا المسار هو ${HOME}/arcgis/notebookserver/tools/postInstallUtility.

6. يمكنك الرجوع اختياريًا إلى تعليمات الأداة المساعدة من خلال تشغيل الأمر التالي:

   > ./PostInstallUtility.sh -h

7. قم بتشغيل أداة ما بعد التثبيت المساعدة لاستخراج نماذج البيانات إلى دليل arcgisworkspace لموقع Notebook Server.

   > ./PostInstallUtility.sh -x

استبدال مثيلات ArcGIS Web Adaptor

لاستبدال مثيلات ArcGIS Web Adaptor، أكمل الخطوات الآتية:

1. قم بإلغاء تسجيل المثيل السابق لـ ArcGIS Web Adaptor من الموقع وإلغاء تثبيته.
   1. سجّل الدخول على دليل مسؤول ArcGIS Notebook Server.
   2. انتقل إلى النظام > Web Adaptor > الجهاز المُسجّل.
   3. انقر فوق إلغاء تسجيل Web Adaptor.
2. قم بتثبيت مثيل جديد لـ ArcGIS Web Adaptor 11.3 وتكوينه باستخدام ArcGIS Notebook Server.
بمجرد اكتمال ترقية النشر، يمكنك استخدام وظائف 11.3.
3. في حالة الترقية من الإصدار 10.8 أو إصدار سابق، لتمكين جدولة دفاتر الملاحظات في البوابة الإلكترونية، قم بما يلي:
   1. اختياريًا، قم بتحديث أي من الأدوار المخصصة التي تتضمن امتيازات دفتر الملاحظات لإضافة الامتياز الجديد جدولة دفاتر الملاحظات.
   2. اطلب من مؤلفي دفتر ملاحظاتك تحديث وقت تشغيل جميع دفاتر الملاحظات الخاصة بهم إذا كانوا يريدون استخدام ميزة الجدولة.

      يمكن جدولة دفاتر الملاحظات التي تستخدم وقت التشغيل 10.8.1 (الإصدار 4.0) أو أحدث فقط.

موقع ArcGIS Notebook Server 11.3 جاهز الآن لاستضافة ArcGIS Notebooks.