المتطلبات الأساسية لإعداد عميل MaxL

قبل استخدام عميل MaxL، فستحتاج إلى عنوان URL لـ Essbase، وقد تحتاج إلى إعداد شهادة TLS (SSL).

لتشغيل اسكربتات أو عبارات MaxL، يجب أن تكون مستخدمًا متقدمًا أو مسؤولاً. للإعداد لاستخدام عميل MaxL،

إحضار عنوان URL لطبعة Essbase من مسؤول الخدمة لديك. الصيغة الأساسية هي:
```
https://IP-address:port/essbase
```
باستخدام متصفح ويب أو cURL، اختبر قدرتك على الوصول إلى عنوان URL للاستكشاف من خلال مضيف العميل. عنوان URL للاستكشاف هو عنوان URL المقدم بواسطة مسؤول الخدمة، مشتملاً على اللاحقة /agent في نهايته. فيما يلي مثال لعنوان cURL (لتمكين وضع آمن/TLS في توزيع مستقل لتطبيق Essbase):
```
curl https://192.0.2.1:9001/essbase/agent --tlsv1.2
```
فيما يلي مثال لتوزيع متكامل لتطبيق Essbase على OCI:
```
curl https://192.0.2.1:443/essbase/agent --tlsv1.2
```
إذا كان لديك اتصال، يجب أن ترى ردًا:
```
<html>
<head><title>Oracle&#x00ae; Essbase</title></head>
<body>
<H2>Oracle&#x00ae; Essbase</H2>
</body></html>
```
قم بإعداد شهادة SSL، إن كانت تسري على مؤسستك.
- إذا كنت تستخدم أحد أنواع التوزيع التالية، فسيشتمل على شهادة SSL موقعة من جهة إصدار شهادات موثوقة:
  - Oracle Analytics Cloud
  - Oracle Analytics Cloud مع Identity Cloud Service (IDCS) وموازنة الحمل
  - Cloud at Customer مع موازنة الحمل
- إذا كنت تستخدم Oracle Analytics Cloud أو Cloud at Customer مع LDAP (دون موازنة الحمل) فاستخدم شهادة موقعة ذاتيًا.
- للتحقق مما إذا كانت الشهادة موثوقة، الصق عنوان URL الخاص بالاستكشاف في متصفح ويب. إذا ظهر https باللون الأخضر أو متضمنًا كلمة آمن "Secure"، فهو إذن موثوق. إذا ظهر https باللون الأحمر أو متضمنًا كلمة غير آمن "Not secure" فهو غير موثوق.
- إذا كنت تستخدم عميل MaxL في Essbase 21c باستخدام شهادة موقعة ذاتيًا، فإن لديك خيارين (القيام بهذا بعد تنزيل العميل):
  1. تعطيل تحقق النظراء عن طريق تعيين متغير البيئة API_DISABLE_PEER_VERIFICATION=1
    
    مثال لنظام Linux
    
    تحرير startMAXL.sh، بإضافة السطر التالي:
```
export API_DISABLE_PEER_VERIFICATION=1
```
    مثال لنظام Windows
    
    تحرير startMAXL.bat، بإضافة السطر التالي:
```
set API_DISABLE_PEER_VERIFICATION=1
```
  2. استيراد الشهادة الموقعة ذاتيًا في مخزن المعلومات الموثوقة الخاص بالعميل (cacert.pem) وتعيين متغير البيئة API_CAINFO=CA <مسار ملف الشهادة>. يقوم العميل بالتحقق من الشهادة الرقمية للخادم باستخدام مخزن شهادات حزمة جهة إصدار الشهادات. أدخل موقع حزمة جهة إصدار الشهادات عن طريق تحديد متغير البيئة API_CAINFO=CA <مسار ملف الشهادة>
    
    مثال لنظام Linux
    
    تحرير startMAXL.sh، بإضافة السطر التالي:
```
export API_CAINFO=/u01/cacert.pem
```
    مثال لنظام Windows
    
    تحرير startMAXL.bat، بإضافة السطر التالي:
```
set API_CAINFO=c:/cacert.pem
```
    في حالة عدم تقديم مسار ملف الشهادة، فسيحاول عميل Essbase في وقت التشغيل الحصول على حزمة جهة إصدار الشهادات من موقع تثبيت OpenSSL الافتراضي (صالح في نظامي Linux وMacintosh).
    
    يتوفر cacert.pemفي مجلد تنزيل عميل MaxL المضغوط zip. مصدر عينة آخر هو: https://curl.haxx.se/docs/caextract.html.