דרישות מקדימות להקמת לקוח ה-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) ואיזון עומסים
  - ענן אצל לקוח עם איזון עומסים
- אם אתה משתמש ב-Oracle Analytics Cloud או בענן אצל לקוח עם 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. יבא את האישור בחתימה עצמית ל-trust store של לקוח (cacert.pem) והגדר את המשתנה הסביבתי API_CAINFO=CA <נתיב קובץ אישור>. הלקוח יאמת את האישור הדיגיטלי של השרת באמצעות ca-bundle certificate store המסופק. ציין את המיקום של ca-bundle על-ידי ציון המשתנה הסביבתי API_CAINFO=CA <נתיב קובץ אישור>
    
    דוגמה ב-Linux
    
    ערוך את startMAXL.sh על-ידי הוספת השורה הבאה:
```
export API_CAINFO=/u01/cacert.pem
```
    דוגמה ב-Windows
    
    ערוך את startMAXL.bat על-ידי הוספת השורה הבאה:
```
set API_CAINFO=c:/cacert.pem
```
    אם לא תציין נתיב קובץ אישור, לקוח זמן הריצה של Essbase ינסה לקבל את ca-bundle מברירת המחדל של מיקום ההתקנה של OpenSSL (רלוונטי ל-Linux ול-Macintosh).
    
    cacert.pem זמין ב-zip של הורדת לקוח MaxL. מקור לדוגמה נוסף הוא: https://curl.haxx.se/docs/caextract.html.