MaxLクライアント設定の前提条件

MaxLクライアントを使用するには、Essbase URLが必要になります。また、TLS (SSL)証明書を設定する必要がある場合もあります。

MaxLのスクリプトや文を実行するには、パワー・ユーザーまたは管理者である必要があります。MaxLクライアントの使用を準備するには、

EssbaseインスタンスのURLをサービス管理者から取得します。その基本形式は次のとおりです。
```
https://IP-address:port/essbase
```
WebブラウザまたはcURLを使用して、クライアント・ホストから検出URLに到達できることをテストします。検出URLは、サービス管理者から提供されたURLの最後に/agentを追加したものです。次に、cURLの例(独立したEssbaseデプロイメントでのセキュア/TLSモード用)を示します:
```
curl https://192.0.2.1:9001/essbase/agent --tlsv1.2
```
次に、OCIでのEssbaseのスタック・デプロイメントの例を示します:
```
curl https://192.0.2.1:443/essbase/agent --tlsv1.2
```
接続がある場合は、次のレスポンスが表示されます:
```
<html>
<head><title>Oracle&#x00ae; Essbase</title></head>
<body>
<H2>Oracle&#x00ae; Essbase</H2>
</body></html>
```
SSL証明書を設定します(ユーザーの組織に該当する場合)。
- 次のデプロイメント・タイプのいずれかを使用している場合は、信頼できるCAの署名済SSL証明書が含まれています。
  - Oracle Analytics Cloud
  - Oracle Analytics Cloud with Identity Cloud Service (IDCS) and Load Balancing
  - Cloud at Customer with Load Balancing
- Oracle Analytics CloudまたはCloud at Customer with LDAP (ロード・バランシングなし)を使用している場合は、自己署名証明書を使用します。
- 証明書が信頼されているかどうかを確認するには、検出URLをWebブラウザに貼り付けます。httpsが緑色になるか、「安全」というラベルが表示される場合は信頼されています。httpsが赤色になるか、「安全でない」というラベルが表示される場合は信頼されていません。
- MaxLクライアントをEssbase 21cで自己署名証明書とともに使用する場合、次の2つのオプションがあります(これはクライアントのダウンロード後に行います):
  1. 環境変数API_DISABLE_PEER_VERIFICATION=1を設定して、ピア確認を無効化します
    
    Linuxの例
    
    startMAXL.shを編集して、次の行を追加します:
```
export API_DISABLE_PEER_VERIFICATION=1
```
    Windowsの例
    
    startMAXL.batを編集して、次の行を追加します:
```
set API_DISABLE_PEER_VERIFICATION=1
```
  2. 自己署名証明書をクライアント・トラスト・ストア(cacert.pem)にインポートして、環境変数API_CAINFO=CA <証明書ファイルのパス>を設定します。クライアントは提供されたca-bundle証明書ストアを使用してサーバーのデジタル証明書を確認します。ca-bundleの場所は、環境変数API_CAINFO=CA <証明書ファイルのパス>を指定することによって設定します。
    
    Linuxの例
    
    startMAXL.shを編集して、次の行を追加します:
```
export API_CAINFO=/u01/cacert.pem
```
    Windowsの例
    
    startMAXL.batを編集して、次の行を追加します:
```
set API_CAINFO=c:/cacert.pem
```
    証明書ファイルのパスを指定しない場合、Essbaseランタイム・クライアントはデフォルトのOpenSSLインストール場所からca-bundleの取得を試みます(LinuxおよびMacintoshに適用)。
    
    cacert.pemはMaxLクライアント・ダウンロードzip内にあります。別のサンプル・ソースはhttps://curl.haxx.se/docs/caextract.htmlです。