Predpoklady na nastavenie klienta MaxL

Skôr ako začnete používať klienta MaxL, budete potrebovať adresu URL služby Essbase a pravdepodobne bude potrebné nastaviť aj certifikát TLS (SSL).

Skripty alebo príkazy MaxL môže spúšťať iba pokročilý používateľ alebo administrátor. Ako sa pripraviť na používanie klienta MaxL:

Získajte adresu URL pre inštanciu Essbase od administrátora služby. Základný formát:
```
https://IP-address:port/essbase
```
Pomocou webového prehľadávača alebo príkazu cURL vyskúšajte, či je možné prejsť na adresu discovery URL z hostiteľa klienta. Adresa discovery URL je adresa URL poskytnutá administrátorom služby s príponou /agent na konci. Príklad príkazu cURL (pre zabezpečený režim/režim TLS v nezávislom nasadení služby Essbase):
```
curl https://192.0.2.1:9001/essbase/agent --tlsv1.2
```
Príklad nasadenia zásobníka Essbase v infraštruktúre OCI:
```
curl https://192.0.2.1:443/essbase/agent --tlsv1.2
```
Ak máte pripojenie, mali by ste vidieť odozvu:
```
<html>
<head><title>Oracle&#x00ae; Essbase</title></head>
<body>
<H2>Oracle&#x00ae; Essbase</H2>
</body></html>
```
Nastavte certifikát SSL, ak sa pre vašu organizáciu používa.
- Ak používate niektorý z nasledujúcich typov nasadenia, dôveryhodný podpísaný certifikát CA SSL je už zahrnutý:
  - Oracle Analytics Cloud
  - Oracle Analytics Cloud so službami Identity Cloud Service (IDCS) a vyrovnávaním záťaže
  - Cloud at Customer s vyrovnávaním záťaže
- Ak používate službu Oracle Analytics Cloud alebo Cloud at Customer s LDAP (bez vyrovnávania záťaže), použite certifikát s vlastným podpisom.
- Ak chcete skontrolovať, či je certifikát dôveryhodný, prilepte adresu discovery URL do webového prehľadávača. Ak má výraz https zelenú farbu alebo sa zobrazuje označenie Zabezpečené, certifikát je dôveryhodný. Ak má výraz https červenú farbu alebo sa zobrazuje označenie Nezabezpečené, certifikát je nedôveryhodný.
- Ak používate klienta MaxL v službe Essbase 21cs certifikátom s vlastným podpisom, máte dve možnosti (toto urobte až po stiahnutí klienta):
  1. Deaktivujte overovanie partnera nastavením premennej prostredia API_DISABLE_PEER_VERIFICATION=1
    
    Príklad pre systém Linux
    
    Upravte startMAXL.sh pridaním nasledujúceho riadka:
```
export API_DISABLE_PEER_VERIFICATION=1
```
    Príklad pre systém Windows
    
    Upravte skript startMAXL.bat pridaním nasledujúceho riadka:
```
set API_DISABLE_PEER_VERIFICATION=1
```
  2. Importujte certifikát s vlastným podpisom do klientskeho súboru dôveryhodných certifikátov (cacert.pem) a nastavte premennú prostredia API_CAINFO=CA <certificate file path>. Klient overí digitálny certifikát servera pomocou poskytnutého súboru certifikátov zväzku CA. Zadajte umiestnenie zväzku CA tak, že zadáte premennú prostredia API_CAINFO=CA <certificate file path>
    
    Príklad pre systém Linux
    
    Upravte startMAXL.sh pridaním nasledujúceho riadka:
```
export API_CAINFO=/u01/cacert.pem
```
    Príklad pre systém Windows
    
    Upravte skript startMAXL.bat pridaním nasledujúceho riadka:
```
set API_CAINFO=c:/cacert.pem
```
    Ak nezadáte premennú certificate file path, runtime klient Essbase sa pokúsi získať zväzok CA z predvoleného umiestnenia inštalácie OpenSSL (v prípade systémov Linux a Macintosh).
    
    Súbor cacert.pem je dostupný v stiahnutom súbore zip klienta MaxL. Ďalší príklad zdroja: https://curl.haxx.se/docs/caextract.html.