Pré-Requisitos para Configurar o Cliente de MaxL

Antes de poder utilizar o Cliente de MaxL, precisará do URL do Essbase e poderá ter de configurar o certificado de TLS (SSL).

Para executar scripts ou instruções de MaxL, deve ser um utilizador avançado ou administrador. Para preparar para a utilização do Cliente de MaxL,

Obtenha o URL para a instância do Essbase contactando o seu Administrador do Serviço. O respetivo formato básico é:
```
https://IP-address:port/essbase
```
Utilizando um browser da Web ou cURL, verifique se consegue aceder ao URL de descoberta a partir do host do cliente. Um URL de descoberta é o URL fornecido pelo Administrador do Serviço, com /agent anexado no fim. Segue-se um exemplo de cURL (para o modo seguro/TLS numa implementação independente do Essbase):
```
curl https://192.0.2.1:9001/essbase/agent --tlsv1.2
```
Segue-se um exemplo para uma implementação da pilha do Essbase no OCI:
```
curl https://192.0.2.1:443/essbase/agent --tlsv1.2
```
Se 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 de SSL, se for aplicável à sua organização.
- Se estiver a utilizar um destes tipos de implementação, é incluído um Certificado de SSL Assinado por CA Fidedigna:
  - Oracle Analytics Cloud
  - Oracle Analytics Cloud com Identity Cloud Service (IDCS) e Load Balancing
  - Cloud at Customer com Load Balancing
- Se estiver a utilizar o Oracle Analytics Cloud ou Cloud at Customer com LDAP (sem Load Balancing), utilize um certificado com assinatura automática.
- Para verificar se um certificado é fidedigno, cole o URL de descoberta num browser da Web. Se https aparecer a verde ou uma etiqueta indicar "Seguro", é fidedigno. Se https aparecer a vermelho ou uma etiqueta indicar "Não seguro", não é fidedigno.
- Se estiver a utilizar o Cliente de MaxL no Essbase 21c com um certificado com assinatura automática, terá duas opções (faça isto depois de descarregar o cliente):
  1. Desative a verificação do peer definindo a variável de ambiente API_DISABLE_PEER_VERIFICATION=1
    
    Exemplo do Linux
    
    Edite startMAXL.sh, acrescentando a seguinte linha:
```
export API_DISABLE_PEER_VERIFICATION=1
```
    Exemplo do Windows
    
    Edite startMAXL.bat, acrescentando a seguinte linha:
```
set API_DISABLE_PEER_VERIFICATION=1
```
  2. Importe o certificado com assinatura automática para o depósito de certificados fidedignos do cliente (cacert.pem) e defina a variável de ambiente API_CAINFO=CA <percurso do ficheiro de certificado>. O cliente verifica o certificado digital do servidor utilizando um depósito de certificados de pacote da CA. Forneça a localização do pacote da CA especificando a variável de ambiente API_CAINFO=CA <percurso do ficheiro de certificado>
    
    Exemplo do Linux
    
    Edite startMAXL.sh, acrescentando a seguinte linha:
```
export API_CAINFO=/u01/cacert.pem
```
    Exemplo do Windows
    
    Edite startMAXL.bat, acrescentando a seguinte linha:
```
set API_CAINFO=c:/cacert.pem
```
    Se não fornecer o percurso do ficheiro de certificado, o Cliente de Runtime do Essbase tentará obter o pacote da CA a partir da localização de instalação de OpenSSL por omissão (aplicável a Linux e Macintosh).
    
    Um cacert.pem está disponível no ficheiro comprimido de descarregamento do Cliente de MaxL. Outra origem de exemplo é: https://curl.haxx.se/docs/caextract.html.