機械翻訳について
  1. Oracle Java Cloud ServiceのREST API
  2. タスク
  3. AppToCloudの移行

WebLogic Serverのドメイン構成のインポート

post

/paas/api/v1.1/instancemgmt/{identityDomainId}/services/jaas/instances/{serviceId}/import

このエンドポイントはOracle Public Cloudでのみ使用できます。

オンプレミスのWebLogic Serverのドメイン構成およびデプロイ済のアプリケーションを既存のOracle Java Cloud Serviceインスタンスにインポートします。 サービス・インスタンスは、Oracle Storage Cloud Serviceコンテナにアップロードされている適切なAppToCloudアーティファクトとともにプロビジョニングされている必要があります。

AppToCloudインフラストラクチャでは、既存のJavaアプリケーションおよびそれらをサポートするOracle WebLogic ServerリソースをOracle Java Cloud Serviceにすばやく移行できます。 ドメインおよびアプリケーションをインポートする前に、満たしている必要がある特定の前提条件、および実行する必要がある特定のオンプレミス・タスクとOracle Cloudタスクがあります。 Oracle Java Cloud Serviceの使用のAppToCloudの前提条件についてに関する項およびOracle Java Cloud Serviceへのアプリケーションの移行の一般的なワークフローに関する項を参照してください。

簡単に言うと必須のタスクは次のとおりです。

  • オンプレミスのAppToCloudツールのインストール
  • オンプレミスのドメインの健全性のチェック
  • オンプレミスのドメインのエクスポート
  • Database Cloud Serviceへのアプリケーション・データベースの移行
  • AppToCloudを使用したサービス・インスタンスの作成
  • サービス・インスタンスへのドメイン構成およびアプリケーションのインポート
  • 一部のドメイン・リソースの再作成(必要な場合)

前提条件タスクの完了後、ドメイン構成およびアプリケーションをインポートする前に、AppToCloudとともにサービス・インスタンスを作成し、AppToCloudツールによって生成されたエクスポートされたファイルにサービス・インスタンスを関連付ける必要があります。 AppToCloudを使用してサービス・インスタンスを作成するために使用するペイロードは、サービス・インスタンスの作成で説明されているものと同じですが、リクエスト本文に追加の必須のcustomPayloadパラメータを指定します。 ドメインおよびアプリケーションは、customPayloadを使用してサービス・インスタンスを作成した後にのみインポートできます。

注意: インポートを実行する前に、サービス・インスタンスをバックアップしてください。 インポートが失敗した場合に、サービス・インスタンスを既知の動作状態に復元できます。

リクエスト

サポートされているメディア・タイプ
  • application/json
パス・パラメータ
identityDomainId
型: string
必須: true
Oracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID。
serviceId
型: string
必須: true
Oracle Java Cloud Serviceインスタンスの名前。
ヘッダー・パラメータ
X-ID-TENANT-NAME
型: string
必須: true
Oracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID。
本文パラメータ
リクエスト本文は、Oracle Storage Cloud Serviceコンテナ内のAppToCloudアーティファクトの場所を定義します。 ソース・ドメインに構成されているデータ・ソース、外部JNDIプロバイダおよびその他のリソースも定義します。 データ・ソースのバインディング、サービスのバインディングおよびその他のリソースのバインディングについては、エクスポートされたJSONファイルを参照してください。
ルート・スキーマ: import-postrequest
ネストされたスキーマ: customPayload
型: array
ソースのオンプレミスのWebLogic Serverドメインに構成されているデータ・ソース、外部JNDIプロバイダおよびその他のリソースに関する情報をグループ化します。 元のドメインの各データ・ソースは、既存のOracle Database Cloud Serviceデータベース・デプロイメントに関連付ける必要があります。

このcustomPayloadは、AppToCloudアーティファクトとともにサービス・インスタンスを作成するために使用したcustomPayloadと同じです。

ネストされたスキーマ: custompayload-details
ネストされたスキーマ: ds
タイプ: object
ソース・ドメインに構成されている1つ以上のデータ・ソースに関する情報をグループ化します。

各データ・ソースは、Oracle Database Cloud Serviceのデータベース・デプロイメントにマップする必要があります。

ネストされたスキーマ: jmsMessageBridgeDestination
タイプ: object
ソース・ドメインに構成されている1つ以上のメッセージ・ブリッジ宛先に関する情報をグループ化します。

各JMSメッセージ・ブリッジ宛先には、既存のOracle Java Cloud Serviceインスタンスの接続URLまたは宛先情報が必要です。

ネストされたスキーマ: jmsMessagingBridge
タイプ: object
ソース・ドメインに構成されている1つ以上のメッセージング・ブリッジに関する情報をグループ化します。

各JMSメッセージング・ブリッジは、ソースJMSブリッジ宛先およびターゲットJMSブリッジ宛先を持つことができます。

ネストされたスキーマ: jmsModule
タイプ: object
ソース・ドメインに構成されている1つ以上のJMSモジュールに関する情報をグループ化します。

各JMSモジュールは、ゼロ個以上の外部JMSサーバー、およびゼロ個以上のリモート・ストア・アンド・フォワード(SAF)コンテキストを持つことができます。

ネストされたスキーマ: jndi
タイプ: object
ソース・ドメインに構成されている1つ以上の外部JNDI (Java Naming and Directory Interface)プロバイダに関する情報をグループ化します。

各外部JNDIプロバイダは、JNDIプロバイダを問い合せるためにWebLogic Serverが使用するURLまたは既存のOracle Java Cloud Serviceインスタンスの宛先情報で構成されている必要があります。

ネストされたスキーマ: mailSession
タイプ: object
ソース・ドメインに構成されている1つ以上のJavaメール・セッションに関する情報をグループ化します。

各メール・セッションは、デフォルト、送信および受信オブジェクトを持つことができます。 ソース・ドメインにトランスポート(送信)またはストア(受信)がない場合、送信または受信オブジェクトは追加できません。

ネストされたスキーマ: storage
タイプ: object
エクスポート・ツールによって生成されたAppToCloudアーティファクトが含まれているOracle Storage Cloud Serviceコンテナに関する情報をグループ化します。
ネストされたスキーマ: datasource
タイプ: object
エクスポートされたJSONファイルにあるdataSourceBindings,の実際のdataSourceNameの名前にこれを置き換えます。 エクスポートされたJSONファイルにある各dataSourceNameに1つのデータ・ソース・オブジェクトを指定します。
ネストされたスキーマ: messagebridgedestination
タイプ: object
エクスポートされたJSONファイルにあるjmsBindings内のJMSBridgeDestinationBindingの実際のresourceRef名にこれを置き換えます。
ネストされたスキーマ : destination
タイプ: object
既存のOracle Java Cloud Serviceインスタンスに関する情報。 destinationのserverまたはclusterの詳細を指定します。

destinationまたはconnectionUrlのいずれかが各ブリッジ宛先に指定されている必要があることに注意してください。

ネストされたスキーマ: messagingbridge
タイプ: object
エクスポートされたJSONファイルにあるjmsBindings内のJMSBridgeBindingの実際のresourceRef名にこれを置き換えます。

ソースおよびターゲットの宛先は、JMSBridgeBindingのソースおよびターゲットの宛先の値と一致している必要があります。 ブリッジ宛先は変更できません。 バインディングのソース宛先またはターゲット宛先が空の場合は、ブリッジのターゲットであるサーバーまたはクラスタのローカルに宛先があることを示しています。

ネストされたスキーマ: jmsmodule
タイプ: object
エクスポートされたJSONファイルにあるjmsBindings内のJMSModuleBindingの実際のresourceRef名にこれを置き換えます。 エクスポートされたJSONファイルにある各JMSモジュール・バインディングに1つのオブジェクトを指定します。 各オブジェクトは、ゼロ個以上のjmsForeignServerおよびゼロ個以上のsafRemoteContextを持つことができます。
ネストされたスキーマ: jmsForeignServer
タイプ: object
1つ以上のJMS外部サーバーに関する情報をグループ化します。

各JMS外部サーバーには、既存のOracle Java Cloud ServiceインスタンスのJNDI接続URLまたは宛先情報が必要です。

ネストされたスキーマ: safRemoteContext
タイプ: object
1つ以上のリモート・ストア・アンド・フォワード(SAF)コンテキストに関する情報をグループ化します。

各リモートSAFコンテキストには、既存のOracle Java Cloud ServiceインスタンスのURLまたは宛先情報が必要です。

ネストされたスキーマ: jmsforeignserver
タイプ: object
外部サーバーのバインディングの実際のresourceRef名にこれを置き換えます。
ネストされたスキーマ : destination
タイプ: object
既存のOracle Java Cloud Serviceインスタンスに関する情報。 destinationのserverまたはclusterの詳細を指定します。

destinationまたはjndiConnectionUrlのいずれかが各外部JMSサーバー・オブジェクトに指定されている必要があることに注意してください。

ネストされたスキーマ: safremotecontext
タイプ: object
リモートSAFコンテキストのバインディングの実際のresourceRef名にこれを置き換えます。
ネストされたスキーマ : destination
タイプ: object
既存のOracle Java Cloud Serviceインスタンスに関する情報。 destinationのserverまたはclusterの詳細を指定します。

destinationまたはurlのいずれかが各リモートSAFコンテキストに指定されている必要があることに注意してください。

ネストされたスキーマ: foreignjndi
タイプ: object
エクスポートされたJSONファイルにあるserviceBindingsの外部JNDIプロバイダ・バインディングの実際のresourceRef名にこれを置き換えます。 エクスポートされたJSONファイルにある各外部JNDIプロバイダ・バインディングに1つのオブジェクトを指定します。
ネストされたスキーマ : destination
タイプ: object
既存のOracle Java Cloud Serviceインスタンスに関する情報。 destinationのserverまたはclusterの詳細を指定します。

destinationまたはproviderのいずれかが各外部JNDIプロバイダ・オブジェクトに指定されている必要があることに注意してください。

ネストされたスキーマ: javamailsession
タイプ: object
エクスポートされたJSONファイルにあるserviceBindingsのメール・セッション・バインディングの実際のresourceRef名にこれを置き換えます。 エクスポートされたJSONファイルにある各メール・セッション・バインディングに1つのオブジェクトを指定します。
ネストされたスキーマ: defaultMail
タイプ: object
メール・ホストのデフォルトのプロパティ値。
ネストされたスキーマ: optionalProperties
タイプ: object
その他のJavaメール・プロパティをグループ化します。
ネストされたスキーマ: receive
タイプ: object
受信メール・ホストのプロパティ値。
ネストされたスキーマ: send
タイプ: object
送信メール・ホストのプロパティ値。

レスポンス

サポートされているメディア・タイプ
  • application/json
200レスポンス
OK。 その他のHTTPステータス・コードの詳細は、「ステータス・コード」を参照してください。

例

次の例は、WebLogic Serverのドメイン構成をオンプレミス環境からAppToCloudアーティファクトとともに作成されたOracle Java Cloud Serviceインスタンスにインポートする方法を示しています。

注意: この例のコマンドでは、URL構造https://rest_server_url/resource-pathが使用されています。ここで、rest_server_urlはアイデンティティ・ドメインを問い合せるためのOracle Public CloudのRESTサーバーです。 Oracle Public Cloudに使用する適切なURL構造の詳細は、リクエストの送信を参照してください。

cURLコマンド

curl -i -X POST -u username:userPassword1! -d @importcustompayload.json -H "Content-Type:application/json" -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/api/v1.1/instancemgmt/ExampleIdentityDomain/services/jaas/instances/ExampleInstance/import

リクエスト本文の例

元のWebLogic Serverドメインの各データ・ソースは、既存のOracle Database Cloud Serviceデータベース・デプロイメントに関連付ける必要があります。 GridLinkおよびMultiデータ・ソースの場合は、Oracle Real Application Clusters (Oracle RAC)データベースをホストするDatabase Cloud Serviceデータベース・デプロイメントを使用します。

JSON形式のリクエスト本文の例を次に示します。

注意: インポートPOSTリクエストで使用されるcustomPayLoadの詳細は、サービス・インスタンス作成POSTリクエストで使用されたcustomPayLoadの詳細と同じです。

{
    "customPayload": [
    {  
        "ds":
        {
            "mymultidatasource":
            {
                "username":"sys as sysdba",
                "password":"MyDBPassword1#",
                "mymultidatasource":"some-db-cloud-instance",
                "targetDataSourceType":"Generic"
            },
            "grid-2":
            {
                "username":"sys as sysdba",
                "password":"MyDBPassword1#",
                "grid-2":"some-db-cloud-instance",
                "targetDataSourceType":"Generic"
            },
            "JDBC Data Source-0":
            {
                "username":"sys as sysdba",
                "password":"MyDBPassword1#",
                "JDBC Data Source-0":"some-db-cloud-instance",
                "targetDataSourceType":"Generic"
            },
            "abcdjdbc":
            {
              "username":"sys as sysdba",
              "password":"Welcome#1",
              "abcdjdbc":"some-db-cloud-instance",
              "targetDataSourceType":"Generic"
            }
        },
        "jndi":
        {
            "myforeign-jndi":
            {
                "bypassPrecheck": "false",
                "username":"myweblogicuser",
                "password":"myweblogic1password",
                "provider":"T3_WEBLOGIC_SERVER_URL"
            },
            "abcd":
            {
                "bypassPrecheck": "false",
                "username":"myweblogicuser",
                "password":"myweblogic1password",
                "provider":"T3_WEBLOGIC_SERVER_URL"
            },
            "abcd provider jndi":
            {
                "bypassPrecheck": "false",
                "username":"myweblogicuser",
                "password":"myweblogic1password",
                "destination":
                {
                    "jaasInstance": "targetJCSInstance",
                    "server": "myserver",
                    "protocol": "t3"
                }
            }
        },
        "mailSession": 
        {
            "MyMailSession-0": 
            {
                "mailSessionName": "MyMailSession-0",
                "defaultMail": 
                {
                    "port": "asdasd",
                    "username": "asdasd",
                    "host": "asad",
                    "type": "Default",
                    "password":"testPassword"
                },
                "send": 
                {
                    "port": "465",
                    "username": "asdsad",
                    "protocol": "smtp",
                    "host": "anexample.example.com",
                    "type": "Send",
                    "password":"testPassword"
                },
                "bypassPrecheck": "false",
                "receive": 
                {
                    "port": "993",
                    "username": "asdsad",
                    "protocol": "imap",
                    "host": "anexample.example.com",
                    "type": "Receive",
                    "password":"testPassword"
                },
                "optionalProperties": 
                {
                    "mail.smtp.ssl.enable": "true",
                    "mail.imap.starttls.enable": "true",
                    "mail.imap.ssl.enable": "true",
                    "mail.smtp.auth": "true",
                    "mail.smtp.starttls.enable": "true",
                    "mail.imap.auth": "true"
                }
            },
            "MyMailSession-1": 
            {
                "mailSessionName": "MyMailSession-1",
                "defaultMail": 
                {
                    "port": "asdsad",
                    "username": "asdsd",
                    "host": "asdasd",
                    "type": "Default",
                    "password":"testPassword"
                },
                "send": 
                {
                    "port": "465",
                    "username": "asdasd",
                    "protocol": "smtp",
                    "host": "anexample.example.com",
                    "type": "Send",
                    "password":"testPassword"
                },
                "bypassPrecheck": "false",
                "optionalProperties": 
                {
                    "mail.smtp.ssl.enable": "true",
                    "mail.smtp.auth": "true",
                    "mail.smtp.password":"testPassword",
                    "mail.smtp.starttls.enable": "true"
                }
            }
        },
        "jmsModule": 
        {
            "My Advanced Jms Module 1": 
            {
                "jmsForeignServer": 
                {
                    "MyForeignJMS3": 
                    {
                        "username": "asdsd",
                        "jndiConnectionUrl": "t3:\/\/127.0.0.1:8101",
                        "bypassPrecheck": "false",
                        "password":"testPassword"
                    }
                },
                "safRemoteContext": 
                {
                    "MyRemoteSAFcontext-0": 
                    {
                        "username": "asdasd",
                        "bypassPrecheck": "false",
                        "password":"testPassword",
                        "url": "t3:\/\/127.0.0.1:8101"
                    },
                    "MyRemoteSAFcontext-1": 
                    {
                        "username": "tjghgh",
                        "bypassPrecheck": "false",
                        "password":"testPassword",
                        "url": "t3:\/\/127.0.0.1:8101"
                    },
                    "MyRemoteSAFcontext-2":
                    {
                        "username": "egertert",
                        "bypassPrecheck": "false",
                        "password":"testPassword",
                        "destination":
                        {
                            "jaasInstance": "targetJCSInstance",
                            "server": "mycluster",
                            "protocol": "t3"
                        }   
                    }
                }
            },
            "MyAdvancedJmsModule2": 
            {
                "jmsForeignServer": 
                {
                    "My Foreign JMS 0": 
                    {
                        "username": "dfhrtuu",
                        "jndiConnectionUrl": "t3:\/\/127.0.0.1:8101",
                        "bypassPrecheck": "false",
                        "password":"testPassword"
                    },
                    "ForeignServer-10": 
                    {
                        "username": "username3",
                        "password": "password3",
                        "bypassPrecheck": "false",
                        "destination": { 
                            "jaasInstance": "targetJCSInstance", 
                            "cluster": "my cluster", 
                            "protocol": "t3"
                        } 
                    }
                },
                "safRemoteContext": 
                {
                    "MyRemoteSAFcontext-0": 
                    {
                        "username": "were545",
                        "bypassPrecheck": "false",
                        "password":"testPassword",
                        "url": "t3:\/\/127.0.0.1:8101"
                    },
                    "MyRemoteSAFcontext-1": 
                    {
                        "username": "sdfsdfs",
                        "bypassPrecheck": "false",
                        "password":"testPassword",
                        "url": "t3:\/\/127.0.0.1:8101"
                    },
                    "MyRemoteSAFcontext-2": 
                    {
                        "username": "uuyhmn",
                        "bypassPrecheck": "false",
                        "password":"testPassword",
                        "url": "t3:\/\/127.0.0.1:8101"
                    }
                }
            }
        },
        "jmsMessageBridgeDestination": 
        {
            "JMS Bridge Remote Destination": 
            {
                "connectionUrl": "t3:\/\/127.0.0.1:8101",
                "bypassPrecheck": "false",
                "username": "someusername",
                "password": "somepassword"
            },
            "JMS Bridge Local Destination": 
            {
                "connectionUrl": "t3:\/\/127.0.0.1:8101",
                "bypassPrecheck": "false",
                "username": "someusername",
                "password": "somepassword"
            },
            "JMS Bridge Another Local Destination": 
            {
                "connectionUrl": "t3:\/\/127.0.0.1:8101",
                "bypassPrecheck": "false",
                "username": "someusername",
                "password": "somepassword"
            },
            "JMS Bridge Another Remote Destination": 
            {
                "bypassPrecheck": "false",
                "username": "someusername",
                "password": "somepassword",
                "destination":
                {
                    "jaasInstance": "targetJCSInstance",
                    "server": "mycluster",
                    "protocol": "t3"
                }               
            }
        },
        "jmsMessagingBridge": 
        {
            "MyMessagingBridge-2": 
            {
                "sourceDestination": "JMS Bridge Remote Destination",
                "targetDestination": "JMS Bridge Local Destination"
            },
            "MyMessagingBridge-1": 
            {
                "sourceDestination": "JMS Bridge Local Destination",
                "targetDestination": "JMS Bridge Remote Destination"
            },
            "Another Messaging Bridge-2": 
            {
                "sourceDestination": "JMS Bridge Another Remote Destination",
                "targetDestination": "JMS Bridge Another Local Destination"
            }
        },
        "storage":
        {
            "a2cModelJsonLocation": "https://storage-url/v1/storage-storageidentitydomain/containername/domain1.json",
            "cloudStoragePwd": "MyPassword1#",
            "cloudStorageUser": "joe@example.com"
        },
        "type": "app2cloud"
    }
    ]
}

レスポンス・ヘッダーの例

次にレスポンス・ヘッダーの例を示します。

HTTP/1.1 200 OK
Date: Tue, 19 Jul 2016 23:22:09 GMT
Content-Length: 0
Content-Type: application/json