Oracle Java Cloud Service REST API

サービス・インスタンスへのCoherenceデータ層クラスタの追加

既存のOracle Java Cloud ServiceインスタンスにCoherenceデータ層クラスタを追加する場合、次の手順に従い、サービス・インスタンスに対してOracle Coherenceを有効化します。

Oracle Coherenceが有効な場合、管理対象サーバーの別のWebLogic Serverクラスタがドメインに作成されます。クラスタは、デフォルトでストレージ対応です。

Coherenceデータ層クラスタは、Oracle WebLogic Server 12c (12.2.1)またはOracle WebLogic Server 12c (12.1.3)とOracle WebLogic Suiteを実行するようにプロビジョニングされているサービス・インスタンスにのみ追加できます。サービス・インスタンスでOracle Coherenceがすでに有効な場合、サービス・インスタンスに別のCoherenceデータ層クラスタを追加することはできません。

Coherenceデータ層クラスタを追加する場合、サービス・インスタンスに対してデフォルト容量単位を使用するか、カスタム容量単位を定義する必要があります。 Oracle Public Cloudでの容量単位の詳細は、『Oracle Cloud Oracle Java Cloud Serviceの使用』のOracle Java Cloud Service-Coherenceインスタンスのデフォルト容量単位の概要に関する項およびOracle Java Cloud Service-Coherenceインスタンスのカスタム容量単位と高度な構成の概要に関する項を参照してください。 Oracle Cloud Machineでの容量単位の詳細は、OPCMのOracle Java Cloud Serviceの使用の「Oracle Java Cloud Service-Coherenceインスタンスのデフォルト容量単位について」および「Oracle Java Cloud Service-Coherenceインスタンスのカスタム容量単位と高度な構成について」を参照してください。

注意:

REST APIで使用されるスケーリング・ユニットという語は、容量単位と同じ意味です。
cURLコマンドの例では、URL構造https://rest_server_url/resource-pathが使用されています。ここで、rest_server_urlはアイデンティティ・ドメインまたはテナント名を問い合せるためのOracle Public CloudまたはOracle Cloud MachineのRESTサーバーです。 Oracle Public CloudまたはOracle Cloud Machineに使用する適切なURL構造の詳細は、リクエストの送信を参照してください。

Oracle Java Cloud ServiceインスタンスへのCoherenceデータ層クラスタの追加手順:

使用可能なデフォルト容量単位を確認します。デフォルト容量単位を使用しない場合、各自の容量単位を定義する準備をします。

curl -i -X GET -u username:userPassword1! -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/service/jcs/api/v1.1/datagrid/ExampleIdentityDomain/config/scalingUnits/defaultScalingUnits

cURLコマンドラインで次のオプションを指定します。

出力にHTTPヘッダーを含める-iオプション。このオプションは省略可能です。
リクエストのタイプ(GET)を指定する-Xオプション。
認証のためのOracle Java Cloud Serviceアカウントのユーザー名とパスワードを指定する-uオプション。
アイデンティティ・ドメインIDまたはテナント名を識別するカスタム・ヘッダーX-ID-TENANT-NAMEを定義する-H。

詳細は、「デフォルト容量単位の表示」を参照してください。

次の例では、レスポンスのコンテンツを示しています。

{
  "siteConfig":{
    "siteUrl":""https://some_value",
    "siteSize":30,
    "maxCluster":80,
    "maxVmsPerUnit":10
  },
  "scalingUnitDefs":[
    {
      "scalingUnitName":"BASIC",
      "scalingUnit":{
        "shape":"oc3",
        "vmCount":1,
        "heapSize":"4608M",
        "jvmCount":1,
        "totalPrimary":"1536M",
        "totalHeap":"4608M",
        "maxPrimary":"46080M",
        "maxHeap":"138240M"
      }
    },
    {
      "scalingUnitName":"SMALL",
      "scalingUnit":{
        "shape":"oc3",
        "vmCount":3,
        "heapSize":"4608M",
        "jvmCount":1,
        "totalPrimary":"4608M",
        "totalHeap":"13824M",
        "maxPrimary":"46080M",
        "maxHeap":"138240M"
      }
    },
    {
      "scalingUnitName":"MEDIUM",
      "scalingUnit":{
        "shape":"oc4",
        "vmCount":3,
        "heapSize":"5120M",
        "jvmCount":2,
        "totalPrimary":"10240M",
        "totalHeap":"30720M",
        "maxPrimary":"102400M",
        "maxHeap":"307200M"
      }
    },
    {
      "scalingUnitName":"LARGE",
      "scalingUnit":{
       "shape":"oc5",
       "vmCount":3,
       "heapSize":"5632M",
       "jvmCount":4,
       "totalPrimary":"22528M",
       "totalHeap":"67584M",
       "maxPrimary":"135168M",
       "maxHeap":"405504M"
      }
    }
  ]
}

容量単位の詳細を定義するJSONドキュメントadddatatier.jsonを作成します。
次に、SMALL構成を使用してデフォルト容量単位を1つ追加する場合のリクエスト・ドキュメントの例を示します。

RESTリソース・リクエストの属性の詳細は、「Coherenceデータ層クラスタの追加」を参照してください。
```
{
  "clusterType" : "DG",
  "scalingUnitCount" : "1",
  "clusterName" : "ExampleDGCluster",
  "scalingUnitName" : "SMALL"
}
```
既存のサービス・インスタンスにCoherenceデータ層クラスタを作成し、手順2で作成したJSONドキュメントを渡します。
```
curl -i -X POST -u username:userPassword1! -d @adddatatier.json -H "Content-Type:application/vnd.com.oracle.oracloud.datagrid.Service+json" -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/service/jcs/api/v1.1/instances/ExampleIdentityDomain/ExampleInstance/clusters
```
cURLコマンドラインで次のオプションを指定します。
- 出力にHTTPヘッダーを含める-iオプション。このオプションは省略可能です。
- リクエストのタイプ(POST)を指定する-Xオプション。
- 認証のためのOracle Java Cloud Serviceアカウントのユーザー名とパスワードを指定する-uオプション。
- ローカル・マシン上でJSON形式のリクエスト・ドキュメント(adddatatier.json)を識別する-dオプション。
- コンテンツ・タイプをapplication/vnd.com.oracle.oracloud.datagrid.Service+jsonとして識別し、アイデンティティ・ドメインIDまたはテナント名を識別するカスタム・ヘッダーX-ID-TENANT-NAMEを定義する-H。
RESTリソースの詳細は、「Coherenceデータ層クラスタの追加」を参照してください。

レスポンス・ヘッダーの例を次に示します。
```
HTTP/1.1 202 Accepted
Date: Tue, 06 Oct 2015 19:52:23 GMT
Location: https://rest_server_url/paas/service/jcs/api/v1.1/instances/ExampleIdentityDomain/status/scale/job/536
Content-Length: 0
Content-Type: application/vnd.com.oracle.oracloud.datagrid.Service+json
Service-URI: https://rest_server_url/paas/service/jcs/api/v1.1/instances/ExampleIdentityDomain/ExampleInstance/clusters/ExampleDGCluster
```

Locationヘッダーで返されるリソースURIを使用して、データ層クラスタの追加リクエストのステータスをチェックします。詳細は、「サービス・インスタンス・ライフサイクル操作のステータスの表示」を参照してください。

curl -i -X GET -u username:userPassword1! -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/service/jcs/api/v1.1/instances/ExampleIdentityDomain/status/scale/job/536

cURLコマンドラインで次のオプションを指定します。

出力にHTTPヘッダーを含める-iオプション。このオプションは省略可能です。
リクエストのタイプ(GET)を指定する-Xオプション。
認証のためのOracle Java Cloud Serviceアカウントのユーザー名とパスワードを指定する-uオプション。
アイデンティティ・ドメインIDまたはテナント名を識別するカスタム・ヘッダーX-ID-TENANT-NAMEを定義する-H。

JSON形式のレスポンス本文の例を次に示します。

{
  "service_name": "ExampleInstance",
  "version": "12cR3",
  "wlsVersion": "12.1.3.0.xxxxxx",
  "status": "Running",
  "error_status_desc": "",
  "compliance_status": "",
  "compliance_status_desc": "",
  "auto_update": "true",
  "description": "ExampleInstance",
  "identity_domain": "ExampleIdentityDomain",
  "creation_time": "Tue Oct 6 16:24:8 UTC 2015",
  "last_modified_time": "Tue Oct 6 16:24:6 UTC 2015",
  "created_by": "username",
  "service_uri": "https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/ExampleIdentityDomain\/ExampleInstance",
  "message": [
    "Successfully created DataGrid option",
    "    Successfully created cluster [ExampleDGCluster] for DataGrid option",
    "    Successfully created managed servers in cluster [ExampleDGCluster]...",
    "        Successfully created capacity unit(s)...",
    "        Starting capacity unit...",
    "        Successfully started capacity unit...",
    "        Starting to transfer keys to the datagrid VMs",
    "        Finished transferring keys to datagrid VMs",
    "        Successfully transferred keys to [exampleinstance-wls-5]",
    "        Successfully transferred keys to [exampleinstance-wls-3]",
    "        Successfully transferred keys to [exampleinstance-wls-4]",
    "        Checking managed servers...",
    "        Successfully checked managed servers...",
    "        Performing Service Reachability Check (SRC) of Datagrid Managed Servers.",
    "        Successfully completed Service Reachability Check (SRC) of Datagrid Managed Servers.",
    "        Successfully created capacity unit(s)...",
    "        Successfully created capacity unit(s)...",
    "            Configuration check for Host [exampleinstance-wls-3] containing WebLogic Managed Server(s) [[ExampleI_server_3_DG]] completed...",
    "            Configuration check for Host [exampleinstance-wls-4] containing WebLogic Managed Server(s) [[ExampleI_server_4_DG]] completed...",
    "            Configuration check for Host [exampleinstance-wls-5] containing WebLogic Managed Server(s) [[ExampleI_server_5_DG]] completed...",
    "            Service Reachabilty Check (SRC) of WebLogic Administration Server completed...",
    "            Service Reachabilty Check (SRC) of WebLogic Managed Server(s) [ExampleI_server_1, ExampleI_server_2, ExampleI_server_3_DG, ExampleI_server_4_DG, ExampleI_server_5_DG] completed..."
  ]
}

クラスタが追加されてサービス・インスタンスが実行している場合、管理対象サーバーのリストを調べて、新しい管理対象Coherence Serverがインスタンスに追加されたことを確認します。

curl -i -X GET -u username:userPassword1! -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/service/jcs/api/v1.1/instances/ExampleIdentityDomain/ExampleInstance/servers

次に、ExampleI_server_3_DG、ExampleI_server_4_DGおよびExampleI_server_5_DGがドメインの管理対象サーバーのリストに追加された、JSON形式のレスポンス本文の例を示します。ストレージ対応管理対象サーバーは、"nodeType": "DG"プロパティで識別されます。

詳細は「すべての管理対象サーバーの表示」を参照してください。

注意: デフォルトでは、ストレージ対応管理対象Coherence Serverの名前は、ドメイン名の最初の8文字から生成され、次の形式になります。first8charsOfDomainName_server_n_DG。nは1から始まり、管理対象Coherence Serverを追加するたびにそれぞれが一意の名前になるように1ずつ増分されます。

{
   "servers": [       
       {
           "clusterName": "ExampleI_cluster",
           "name": "ExampleI_server_1",
           "shape": "oc3",
           "nodeType": "WLS",
           "isAdmin": true,
           "hostname": "12.345.678.900",
           "status": "Ready",
           "reservedIp": "",
           "storageAllocated": 73728,
           "creationDate": "Oct 6, 2015 4:24:29 PM"
       },
       {
           "clusterName": "ExampleI_cluster",
           "name": "ExampleI_server_2",
           "shape": "oc3",
           "nodeType": "WLS",
           "isAdmin": false,
           "hostname": "exampleinstance-wls-2",
           "status": "Ready",
           "reservedIp": "",
           "storageAllocated": 53248,
           "creationDate": "Oct 6, 2015 4:24:34 PM"
       },
       {
           "clusterName": "ExampleDGCluster",
           "name": "ExampleI_server_3_DG",
           "shape": "oc3",
           "nodeType": "DG",
           "isAdmin": false,
           "hostname": "exampleinstance-wls-3",
           "status": "Ready",
           "reservedIp": "",
           "jobId":"538",
           "storageAllocated":43600,
           "creationDate":"Oct 6, 2015 7:52:40 PM",
           "createdBy":"username"
       },
       {
           "clusterName": "ExampleDGCluster",
           "name": "ExampleI_server_4_DG",
           "shape": "oc3",
           "nodeType": "DG",
           "isAdmin": false,
           "hostname": "exampleinstance-wls-4",
           "status": "Ready",
           "reservedIp": "",
           "jobId":"538",
           "storageAllocated":43600,
           "creationDate":"Oct 6, 2015 7:52:40 PM",
           "createdBy":"username"
       },
       {
           "clusterName": "ExampleDGCluster",
           "name": "ExampleI_server_5_DG",
           "shape": "oc3",
           "nodeType": "DG",
           "isAdmin": false,
           "hostname": "exampleinstance-wls-5",
           "status": "Ready",
           "reservedIp": "",
           "jobId":"538",
           "storageAllocated":43600,
           "creationDate":"Oct 6, 2015 7:52:40 PM",
           "createdBy":"username"
       }
   ],
   "serverInProgress": []
}