A MaxL Client beállításának előfeltételei

A MaxL Client használata előtt szüksége lesz az Essbase URL-jére, és előfordulhat, hogy be kell állítania a TLS (SSL) tanúsítványt.

A MaxL-parancsfájlok vagy -utasítások végrehajtásához kiemelt felhasználói vagy adminisztrátori szerepkör szükséges. Felkészülés a MaxL Client használatára:

Kérje el az Essbase példányhoz tartozó URL-címet a szolgáltatásadminisztrátortól. Az alapvető formátuma a következő:
```
https://IP-address:port/essbase
```
Webböngésző vagy cURL használatakor tesztelje, hogy eléri-e a felderítési URL-címet a Client gazdagépéről. A felderítési URL-cím az az URL-cím, amelyiket a Szolgáltatásadminisztrátor adott meg, a végén az /agent szóval kiegészítve. Egy példa cURL-re (biztonságos/TLS módra egy független Essbase telepítésben):
```
curl https://192.0.2.1:9001/essbase/agent --tlsv1.2
```
Egy példa az Essbase-verem telepítésére az OCI rendszeren:
```
curl https://192.0.2.1:443/essbase/agent --tlsv1.2
```
Ha van kapcsolat, a következő választ kell látnia:
```
<html>
<head><title>Oracle&#x00ae; Essbase</title></head>
<body>
<H2>Oracle&#x00ae; Essbase</H2>
</body></html>
```
Telepítse az SSL tanúsítványt, ha ez vonatkozik az Önök szervezetére.
- Ha ezen telepítési típusok egyikét használja, akkor az tartalmazza a Trusted CA Signed SSL Certificate tanúsítványt is.
  - Oracle Analytics Cloud
  - Oracle Analytics Cloud az Identity Cloud Service (IDCS) szolgáltatással és terheléskiegyenlítéssel
  - Cloud at Customer terheléskiegyenlítéssel
- Ha az Oracle Analytics Cloud vagy a Cloud at Customer szolgáltatást az LDAP szolgáltatással együtt (terheléselosztás nélkül) használja, használjon önaláírt tanúsítványt.
- Annak ellenőrzéséhez, hogy megbízható-e a tanúsítvány másolja be egy webböngészőbe a felderítési URL-címet. Ha a https zöld, vagy a felirat a „Secure” szót tartalmazza, akkor megbízható. Ha a https piros, vagy az a felirat, hogy „Not secure”, akkor nem megbízható.
- Ha a MaxL Client szoftvert használja az Essbase 21c-ben saját aláírású tanúsítvánnyal, akkor két lehetősége van (ezeket a kliens letöltése után végezze el):
  1. Kapcsolja ki a partnerellenőrzést az API_DISABLE_PEER_VERIFICATION=1 környezeti változó beállításával.
    
    Példa Linux operációs rendszer esetén
    
    Szerkessze a startMAXL.sh fájlt a következő sor hozzáadásával:
```
export API_DISABLE_PEER_VERIFICATION=1
```
    Példa Windows operációs rendszer esetén
    
    Szerkessze a startMAXL.bat fájlt a következő sor hozzáadásával:
```
set API_DISABLE_PEER_VERIFICATION=1
```
  2. Importálja az önaláírt tanúsítványt az ügyfél megbízható tárolójába (cacert.pem), és állítsa be az API_CAIINFO=CA <tanúsítványfájl elérési útja> környezeti változót. Az ügyfél ellenőrzi a kiszolgáló tanúsítványát a kapott tanúsítvány-köteg tanúsítványtárolójának használatával. Adja meg a CA-csomag helyét az API_CAINFO=CA <tanúsítványfájl elérési útja> környezeti változó megadásával.
    
    Példa Linux operációs rendszer esetén
    
    Szerkessze a startMAXL.sh fájlt a következő sor hozzáadásával:
```
export API_CAINFO=/u01/cacert.pem
```
    Példa Windows operációs rendszer esetén
    
    Szerkessze a startMAXL.bat fájlt a következő sor hozzáadásával:
```
set API_CAINFO=c:/cacert.pem
```
    Ha nem adja meg a tanúsítványfájl elérési útvonalát, a Essbase futásidejű kliens megpróbálja a CA-csomagot az OpenSSL alapértelmezett telepítési helyéről beszerezni (Linux és Macintosh esetén alkalmazható).
    
    Talál egy cacert.pem nevű fájlt a MaxL Client letöltött .zip-fájljában. A mintaként használható másik forrás: https://curl.haxx.se/docs/caextract.html.