Pré-requisitos para Configurar o MaxL Client

Para poder usar o MaxL Client, você precisará do URL do Essbase e talvez seja necessário configurar o certificado TLS (SSL).

Para executar scripts e instruções MaxL, você deve ser usuário avançado ou administrador. Para preparar o uso do MaxL Client,

Obtenha o URL da instância do Essbase com seu Administrador de Serviços. Seu formato básico é:
```
https://IP-address:port/essbase
```
Usando um web browser ou cURL, teste para ver se você consegue acessar o URL de descoberta pelo host cliente. Um URL de descoberta é fornecido por seu Administrador de Serviços, com /agent anexado no final. Este é um exemplo de cURL (para o modo seguro/TLS em uma implementação do Essbase independente):
```
curl https://192.0.2.1:9001/essbase/agent --tlsv1.2
```
Este é um exemplo de implantação de pilha do Essbase no OCI:
```
curl https://192.0.2.1:443/essbase/agent --tlsv1.2
```
Se você tiver conectividade, deverá ver uma resposta:
```
<html>
<head><title>Oracle&#x00ae; Essbase</title></head>
<body>
<H2>Oracle&#x00ae; Essbase</H2>
</body></html>
```
Configure o certificado SSL, se aplicável à sua organização.
- Se você estiver usando um desses tipos de implantação, um Certificado SSL Assinado por CA Confiável será incluído:
  - Oracle Analytics Cloud
  - Oracle Analytics Cloud com Identity Cloud Service (IDCS) e Balanceamento de Carga
  - Cloud at Customer com Balanceamento de Carga
- Se você estiver usando o Oracle Analytics Cloud ou Cloud at Customer com LDAP (sem Balanceamento de Carga), use um certificado autoassinado.
- Para verificar se um certificado é confiável, cole o URL de descoberta em um web browser. Se https estiver verde ou identificado como “Seguro”, é confiável. Se https estiver vermelho ou identificado como “Não seguro”, não é confiável.
- Se você estiver usando o MaxL Client no Essbase 21c com um certificado autoassinado, terá duas opções (faça isso após o download do cliente):
  1. Desative a verificação de nível definindo a variável de ambiente API_DISABLE_PEER_VERIFICATION=1
    
    Exemplo do Linux
    
    Edite startMAXL.sh, adicionando a seguinte linha:
```
export API_DISABLE_PEER_VERIFICATION=1
```
    Exemplo do Windows
    
    Edite startMAXL.bat, adicionando a seguinte linha:
```
set API_DISABLE_PEER_VERIFICATION=1
```
  2. Importe o certificado autoassinado para o armazenamento confiável do cliente (cacert.pem) e defina a variável de ambiente API_CAINFO=CA <caminho do arquivo de certificado>. O cliente verifica o certificado digital do servidor usando um armazenamento de certificados do pacote da Autoridade de Certificação fornecido. Forneça o local do ca-bundle especificando a variável de ambiente API_CAINFO=CA <caminho do arquivo de certificado>
    
    Exemplo do Linux
    
    Edite startMAXL.sh, adicionando a seguinte linha:
```
export API_CAINFO=/u01/cacert.pem
```
    Exemplo do Windows
    
    Edite startMAXL.bat, adicionando a seguinte linha:
```
set API_CAINFO=c:/cacert.pem
```
    Se você não informar o caminho do arquivo de certificado, o Essbase Runtime Client tentará obter o ca-bundle do local de instalação padrão do OpenSSL (aplicável a Linux e Macintosh).
    
    Um cacert.pem está disponível no arquivo zip do download do MaxL Client. Outra origem de amostra é: https://curl.haxx.se/docs/caextract.html.