Förutsättningar för att ställa in MaxL-klienten

Innan du kan använda MaxL-klienten behöver du webbadressen till Essbase och du kan behöva ställa in TLS-certifikatet (SSL).

Om du vill köra MaxL-skript eller -satser måste du vara avancerad användare eller administratör. Förberedelser för användning av MaxL-klienten:

Kontakta tjänsteadministratören och be att få URL:en till Essbase-instansen. Grundläggande format:
```
https://IP-address:port/essbase
```
Med en webbläsare eller cURL testar du att du kan nå upptäckts-URL:en från klientvärden. En upptäckts-URL är den URL som anges av tjänsteadministratören, med /agent tillagt i slutet. Här är ett cURL-exempel (för säkert läge/TLS-läge i en oberoende Essbase-distribution):
```
curl https://192.0.2.1:9001/essbase/agent --tlsv1.2
```
Här är ett exempel på en stackdistribution av Essbase i OCI:
```
curl https://192.0.2.1:443/essbase/agent --tlsv1.2
```
Om du har anslutning bör du se ett svar:
```
<html>
<head><title>Oracle&#x00ae; Essbase</title></head>
<body>
<H2>Oracle&#x00ae; Essbase</H2>
</body></html>
```
Ställ in SSL-certifikatet, om det är tillämpligt för din organisation.
- Om du använder någon av de här distribueringstyperna inkluderas ett SSL-certifikat från en betrodd certifikatutfärdare:
  - Oracles analysmoln
  - Oracles analysmoln med Identity Cloud Service (IDCS) och lastbalansering
  - Cloud at Customer med lastbalansering
- Om du använder Oracles analysmoln eller moln hos kund med LDAP (utan lastbalansering) använder du ett självsignerat certifikat.
- Om du vill kontrollera om ett certifikat är betrott klistrar du in upptäckts-URL:en i en webbläsare. Om https är grönt eller det står "Säker" på en etikett är certifikatet betrott. Om https är rött eller det står "Inte säkert" är certifikatet inte betrott.
- Om du använder MaxL-klienten i Essbase 21c med ett självsignerat certifikat har du två alternativ (gör det här efter det att du laddat ned klienten):
  1. Avaktivera verifiering av likställda genom att ange miljövariabeln API_DISABLE_PEER_VERIFICATION=1
    
    Exempel för Linux
    
    Redigera startMAXL.sh genom att lägga till följande rad:
```
export API_DISABLE_PEER_VERIFICATION=1
```
    Exempel för Windows
    
    Redigera startMAXL.bat genom att lägga till följande rad:
```
set API_DISABLE_PEER_VERIFICATION=1
```
  2. Importera det självsignerade certifikatet till klientsäkerhetslagret (cacert.pem) och ange miljövariabeln API_CAINFO=CA <sökväg till certifikatfilen>. Klienten verifierar det digitala certifikatet för servern med ett angett certifikatlager med certifikatutfärdarpaket. Ange plats för certifikatutfärdarpaketet genom att ange miljövariabeln API_CAINFO=CA <sökväg till certifikatfilen>
    
    Exempel för Linux
    
    Redigera startMAXL.sh genom att lägga till följande rad:
```
export API_CAINFO=/u01/cacert.pem
```
    Exempel för Windows
    
    Redigera startMAXL.bat genom att lägga till följande rad:
```
set API_CAINFO=c:/cacert.pem
```
    Om du inte anger sökvägen till certifikatfilen försöker Essbase Runtime Client hämta certifikatutfärdarpaketet från OpenSSL-installationsplatsen (gäller för Linux och Macintosh).
    
    Det finns en cacert.pem i den nedladdade zip-filen för MaxL-klienten. En annan exempelkälla är: https://curl.haxx.se/docs/caextract.html.