プライマリ・コンテンツに移動
Oracle® Enterprise Managerライフサイクル管理ガイド
12cリリース5 (12.1.0.5)
B66837-13
  目次へ移動
目次
索引へ移動
索引

前
 
次
 

27 EM CLIを使用したMiddlewareプロビジョニング

この章では、Oracleが提供するコマンドライン・オプションのEnterprise Managerコマンドライン・インタフェースを使用してMiddlewareプロファイルを作成、説明、リスト、削除およびカスタマイズする方法について説明します。

この章の具体的な内容は次のとおりです。

27.1 Middlewareプロビジョニング・プロファイルの作成

プロファイルは、ソフトウェア・ライブラリで作成および格納できるテンプレートに似ています。プロファイルが作成されたら、WebLogicドメインおよび/またはOracleホームをプロビジョニングするために何度も起動できます。プロファイルを使用するメリットは、将来のWebLogicインストールを一貫性のある標準構成に確実に準拠させることができる点です。

プロファイルを作成できます。

27.1.1 WebLogicドメイン・プロファイルの作成

WebLogicドメインからFusion Middlewareプロビジョニング・プロファイルを作成するには、EM CLI動詞create_fmw_domain_profileを使用します。

emcli create_fmw_domain_profile
-name="Profile Name"
-ref_target="Reference Target Name"
[-description="Profile Description"]
[-oh_cred="Oracle Home Owner Credentials"]
[-includeOh]
[-schedule=
start_time:yyyy/MM/dd HH:mm;
[tz:{java timezone ID}];
[grace_period:xxx];
]

[ ] indicates that the parameter is optional.

Description for the options:

-name
Name of the WebLogic Domain profile.
 
-ref_target
Name of the reference target used to create the WebLogic Domain profile.
 
-description
A short description for the WebLogic Domain profile you create.
 
 -oh_cred 
        Named credential that will be used to access the reference host. 
        Format: CREDENTIAL_NAME:CREDENTIAL_OWNER. 
        All operations will be performed on the Administration Server host. 
        Credentials of the Oracle Home owner on the Administration Server host are required. 
        If no named credential is provided, then preferred host credentials for the Oracle Home target will be used.

-wls_cred 
        Named credential used to access the Administration Server. This is an optional parameter. 
        To pass the credential parameter, enter a name:value pair in the following format: 

credential_name:credential_owner. 
           Where, 
             Credential_name is the name of the named credential. 
             Credential_owner is the credentials of the Administrator of the WebLogic Domain. 
        All operations are performed in online mode (using T2P) in case of a Fusion Middleware domain. 
        If no named credential is provided, the preferred administrator credentials for the domain target will be used.

-includeOh 
        Whether the Oracle Home binaries have to be included in the profile or not.

-schedule 
        The schedule for the Deployment Procedure. 
        If not specified, the procedure will be executed immediately. 
                 start_time: when the procedure should start. 
                         tz: the timezone ID. 
               grace_period: grace period in minutes. 

次の例では、WebLogicドメイン・プロファイルの作成方法を説明します。

  • BitlessDomainProfileという名前のWebLogicドメインは、指定されたスケジュールの参照ターゲット/Farm01_base_domain/base_domainを使用して作成されます。Oracleホーム・パラメータが渡されないため、Oracleホーム・バイナリのないプレーンWebLogicドメインが作成されます。また、Oracleホーム資格証明が指定されていないため、ターゲット・ホームの優先ホスト資格証明が使用されます。

    emcli create_fmw_domain_profile
    -name="BitlessDomainProfile"
    -ref_target="/Farm01_base_domain/base_domain"
    -description="A domain profile without software bits"
    -schedule="start_time:2014/6/21 21:23;tz:America/New_York;grace_period:60"
    
  • DomainProfilewithBitsという名前のWebLogicドメイン・プロファイルがOracleホーム・バイナリとともに即座に作成されます。指定された名前付き資格証明を使用して、このプロファイルが参照ターゲット/Farm01_base_domain/base_domainから作成されます。

     emcli create_fmw_domain_profile
    -name="DomainProfileWithBits"
    -ref_target="/Farm01_base_domain/base_domain"
    -oh_cred="MY_HOST_CRED:SYSMAN"
    -includeMWH
    
  • Fusion Middleware Provisioning/Profilesディレクトリのソフトウェア・ライブラリに作成されます。スケジュールが示されていないため、ジョブが即座に実行されます。

     emcli create_fmw_domain_profile
    -name=D=SoaProfile
    -ref_target="="Farm01_SoaDomain/SoaDomain"
    

    出力:

    たとえば、プロファイルが正常に発行された場合に次の属性が表示されます。

    • instance_name: 'CreateFmwProfile-SoaProfile_SYSMAN_07_09_2014_11_36_AM'

    • instance_guid: 'FDC7FC56E2CF2972E04373B1F00A1512'


    注意:

    作成中のプロファイルのステータスを追跡するには、次のコマンドを使用します。

    emcli get_instance_status -instance=FDC7FC56E2CF2972E04373B1F00A1512 -xml -details -showJobOutput


27.1.2 Oracleホーム・プロファイルの作成

Oracleホーム・ターゲットからFusion Middlewareプロビジョニング・プロファイルを作成するには、EM CLI動詞create_fmw_home_profile_verbを使用します。

emcli create_fmw_home_profile
-name="Profile Name"
-ref_target="Reference Target Name"
[-description="Profile Description"]
[-oh_cred="Oracle Home Owner Credentials"]
[-schedule=
start_time:yyyy/MM/dd HH:mm;
[tz:{java timezone ID}];
[grace_period:xxx];
]
 
 
[ ] indicates that the parameter is optional.

Description for the options:
-name
Name of the Oracle home profile.
 
-ref_target
Name of the Oracle Home target used as reference to create the profile.
 
-description
A short description for the Oracle home profile you create.
 
-oh_cred
Named credentials used to access the reference host. This is an optional parameter.
To pass the credential parameter, enter a name:value pair in the following format: credential_name:credential_owner.
Where,
Credential_name is the name of the named credential.
Credential_owner is the credentials of the Oracle home owner on the Administration Server host.
If no named credential is provided, the preferred host credential for the Oracle home target will be used.
 
-schedule
The schedule for the Deployment Procedure.
If not specified, the procedure will be executed immediately.
To specify a value, enter:
start_time: when the procedure should start.
tz: the timezone ID.
grace_period: grace period in minutes. 

次の例では、Oracleホーム・プロファイルの作成方法について説明します。

  • Oracleホーム・プロファイルがFusion Middleware Provisioning/Profilesディレクトリのソフトウェア・ライブラリに作成されます。スケジュールが示されていないため、ジョブが即座に実行されます。

    emcli  create_fmw_home_profile
    -name=SoaProfile
    -ref_target="WebLogicServer10_3_6_0_slc00tkv.example.com_6316"
    

    出力:

    プロファイルが正常に発行された場合に次の属性が表示されます。

    • instance_name: 'CreateFmwProfile-SoaProfile_SYSMAN_07_09_2014_11_36_AM'

    • instance_guid: 'FDC7FC56E2CF2972E04373B1F00A1512'


    注意:

    作成中のプロファイルのステータスを追跡するには、次のコマンドを使用します。

    emcli get_instance_status -instance=FDC7FC56E2CF2972E04373B1F00A1512 -xml -details -showJobOutput


  • 優先資格証明を使用して指定されたスケジュールで参照ホスト・ターゲットを使用して、OhProfile1という名前のOracleホーム・プロファイルが作成されます。

    emcli create_fmw_home_profile
    -name="OhProfile1"
    -ref_target=""WebLogicServer_10.3.6.0_myhost.example.com_5033""
    -description="An Oracle Home profile"
    -schedule="start_time:2014/6/21 21:23;tz:America/New_York;grace_period:60"
    
  • 名前付き資格証明を使用して参照ホスト・ターゲットからOhProfile2という名前のOracleホーム・プロファイルが即座に作成されます。

    emcli create_fmw_home_profile
    -name="OhProfile2" -ref_target="WebLogicServer_11.4.1.0_myhost.example.com_5023"
    -oh_cred="MY_HOST_CRED:SYSMAN"
    

27.1.3 インストール・メディア・プロファイルの作成

Oracle Fusion Middlewareインストール・メディアを使用してプロファイルを作成するには、EM CLI動詞create_inst_media_profile_verbを使用します。

emcli create_inst_media_profile
-name="Profile Name"
-host="Reference Target Name"
-version="Reference Target Name"
-platform="Reference Target Name"
[-description="Profile Description"]
[-host_cred="Oracle Home Owner Credentials"]
-files=
WebLogic:WLSFile1;
SOA:SOAFile1,SOAFile2;
OSB:OSBFile;
RCU:RCUFile;

[ ] indicates that the parameter is optional.

Description for the options:
-name
Name of the installation media profile.
 
-host
Name of the host target where the installation media files are stored.
 
-version
Version of the installation media files.
 
-platform
Platform for which the installation media is applicable.
 
-description
A short description for the installation media profile.
 
-host_cred
Named credentials used to access the reference host. This is an optional parameter. To pass the credential parameter, enter a name:value pair in the following format: credential_name:credential_owner.
Where,
Credential_name is the name of the named credential.
Credential_owner is the credentials of the Oracle home owner on the Administration Server host.
If no named credential is provided, the preferred host credential for the host target will be used.
.
-files
List of files that have to be uploaded to Software Library. These files are passed in the format product:file1,file2. The Installation Media profile supports the following products: WebLogic, SOA, OSB, and RCU. Note that, to create any of these profiles, you must upload the WebLogic media file.

次の例では、Oracleホーム・プロファイルの作成方法について説明します。

  • ホストmyhost.example.comからwls1036_generic.jarという名前のWebLogic jarファイルを含むWebLogic1036Installerという名前のインストール・メディア・プロファイルをソフトウェア・ライブラリにアップロードします。また、インストール・メディア・ファイルのプラットフォームおよびバージョン詳細を指定する必要があります。パラメータとして資格証明を渡さなかったため、優先ホスト資格証明を使用してWebLogic jarファイルにアクセスします。

    emcli create_inst_media_profile
    -name="WebLogic1036Installer"
    -host="myhost.example.com"
    -description="WebLogic Server 10.3.6.0 installer"
    -version="10.3.6.0"
    -platform="Generic"
    -files="WebLogic:/u01/media/weblogic/wls1036_generic.jar"
    
  • ホストmyhost.example.comからSOAおよびWLSインストール・メディア・ファイルをソフトウェア・ライブラリにアップロードします。また、インストール・メディア・ファイルのプラットフォームおよびバージョン詳細を指定する必要があります。指定された名前付き資格証明を使用して、SOA+WLSInstallerという名前のプロファイルが作成されます。

     emcli create_inst_media_profile
    -name="SOA+WLSInstaller"
    -host="myhost.example.com"
    -description="SOA 11.1.1.7.0 and WebLogic Server 10.3.6.0 installer"
    -version="11.1.1.7.0"
    -platform="Generic"
    -host_cred="MY_HOST_CRED:SYSMAN"
    -files="WebLogic:/u01/media/weblogic/wls1036_generic.jar;SOA:/u01/media/soa/soa1.zip,/u01/media/soa/soa2.zip"
    
  • Oracleホーム・プロファイルがFusion Middleware Provisioning/Profilesディレクトリのソフトウェア・ライブラリに作成されます。スケジュールが示されていないため、ジョブが即座に実行されます。

    emcli  create_inst_media_profile
    -name="WebCenter Install Media"
    -host=slc03qtn.example.com
    -description="WC 11.1.1.8.0 and WebLogic Server 10.3.6.0 installer and RCU"
    -version="11.1.1.8.0"
    -platform="2000"
    -host_cred="BBANTHIA:SYSMAN"
    -files="WebLogic:/net/adcnas438/export/emgpqa/provisioning/fmwprov/linux64/shiphomes/upinsmed_wls/wls1036_generic.jar;WCP:/net/slcnas478/export/farm_em_repos/emgpqa/provisioning/fmwprov/linux64/shiphomes/wcp_11.1.1.8.0/wc.zip;WCC:/net/slcnas478/export/farm_em_repos/emgpqa/provisioning/fmwprov/linux64/shiphomes/wcc_11.1.1.8.0/ecm_main1.zip,/net/slcnas478/export/farm_em_repos/emgpqa/provisioning/fmwprov/linux64/shiphomes/wcc_11.1.1.8.0/ecm_main2.zip;RCU:/net/slcnas478/export/farm_em_repos/emgpqa/provisioning/fmwprov/linux64/shiphomes/wcrcu_11.1.1.8.0/rcuHome.zip"
    

27.2 EM CLIを使用したプロシージャの発行

コマンドラインを使用してプロビジョニングのプロセスを自動化するには、Enterprise Managerコマンドライン・インタフェース(EMCLI)・ユーティリティを使用してプロシージャを発行します。EMCLIにより、各種オペレーティング・システムのテキスト・ベースのコンソール(シェルおよびコマンド・ウィンドウ)からEnterprise Manager Cloud Control機能にアクセスできます。Enterprise Manager機能は、SQL*Plus、OSのシェル、Perl、Tclなどのカスタム・スクリプトを使用して呼び出すことができるため、社内のビジネス・プロセスとの統合も容易です。

27.3 Middlewareプロビジョニング・プロファイルのリスト

この項では、Enterprise Managerで作成したすべてのFusion Middlewareプロビジョニング・プロファイルをリストする方法について説明します。

この項では、特に次の内容を説明します。

27.3.1 すべてのプロファイルのリスト

すべてのFusion Middlewareプロファイルをリストするには、次のコマンドを実行します。

emcli list_fmw_profiles 
        [-source_type="Profile Source"]

Description for the options:
    -source_type 
        Valid values: weblogic_domain, oracle_home or install_media. 
        Profiles of only this type as source will be shown.

次の例では、Oracleホーム・プロファイルの作成方法について説明します。

  • すべてのMiddlewareプロビジョニング・プロファイルをリストするには、次のコマンドを実行します。

    emcli list_fmw_profiles 
    

    出力:

    ロケーション 製品 プラットフォーム バージョン 所有者
    Fusion Middleware Provisioning/Profiles/SoaBitlessProfile Oracle SOA Linux x86-64 10.3.6.0 SYSMAN
    Fusion Middleware Provisioning/Profiles/SoaGoldImage Oracle SOA Linux x86-64 10.3.6.0 SYSMAN
    Fusion Middleware Provisioning/Profiles/WebCenter Install Media Oracle WebCenter Content 汎用プラットフォーム 11.1.1.8.0 SYSMAN

27.3.2 すべてのWebLogicドメイン・プロファイルのリスト

すべてのWebLogicドメイン・プロファイルをリストするには、次のコマンドを実行します。

emcli list_fmw_profiles 
        [-source_type="Profile Source"]

Description for the options:
    -source_type 
        Valid values: weblogic_domain, oracle_home or install_media. 
        Profiles of only this type as source will be shown.

次の例では、Oracleホーム・プロファイルの作成方法について説明します。

  • すべてのWebLogicドメイン・プロビジョニング・プロファイルをリストするには、次のコマンドを実行します。

    emcli list_fmw_profiles
    -source_type=weblogic_domain
    

    出力:

    ロケーション 製品 プラットフォーム バージョン 所有者
    Fusion Middleware Provisioning/Profiles/SoaBitlessProfile Oracle SOA Linux x86-64 10.3.6.0 SYSMAN

27.3.3 すべてのOracleホーム・プロファイルのリスト

すべてのOracleホーム・プロファイルをリストするには、次のコマンドを実行します。

emcli list_fmw_profiles 
        [-source_type="Profile Source"]

Description for the options:
    -source_type 
        Valid values: weblogic_domain, oracle_home or install_media. 
        Profiles of only this type as source will be shown.

次の例では、Oracleホーム・プロファイルの作成方法について説明します。

  • すべてのWebLogicドメイン・プロビジョニング・プロファイルをリストするには、次のコマンドを実行します。

    emcli list_fmw_profiles
    -source_type=oracle_home
    

    出力:

    ロケーション 製品 プラットフォーム バージョン 所有者
    Fusion Middleware Provisioning/Profiles/SoaGoldImage Oracle SOA Linux x86-64 10.3.6.0 SYSMAN

27.3.4 すべてのインストール・メディア・プロファイルのリスト

すべてのOracleホーム・プロファイルをリストするには、次のコマンドを実行します。

emcli list_fmw_profiles 
        [-source_type="Profile Source"]

Description for the options:
    -source_type 
        Valid values: weblogic_domain, oracle_home or install_media. 
        Profiles of only this type as source will be shown.

次の例では、Oracleホーム・プロファイルの作成方法について説明します。

  • すべてのWebLogicドメイン・プロビジョニング・プロファイルをリストするには、次のコマンドを実行します。

    emcli list_fmw_profiles
    -source_type=install_media
    

    出力:

    ロケーション 製品 プラットフォーム バージョン 所有者
    Fusion Middleware Provisioning/Profiles/WebCenter Install Media Oracle WebCenter Content 汎用プラットフォーム 11.1.1.8.0 SYSMAN

27.4 プロビジョニング・プロファイルの記述

Cloud Controlで作成したFusion Middlewareプロビジョニング・プロファイルのサマリーを表示するには、次のコマンドを実行します。

使用方法:

emcli describe_fmw_profile
-location="Profile Location

Description for the options:
-location 
        Complete Software Library path to the Profile. 
        Use list_fmw_profiles to know the complete path. 

この項では、特に次の内容を説明します。

27.4.1 WebLogicドメイン・プロファイルの説明

WebLogicドメイン・プロファイルのサマリーを表示するには、次のコマンドを実行します。

使用方法:

emcli describe_fmw_profile
-location="Fusion Middleware Provisioning/Profiles/SoaBitlessProfile"

Output
Location: Fusion Middleware Provisioning/Profiles/SoaBitlessProfile
Created By: SYSMAN
Created On: Sun, 6 Jul 2014
URN: oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_FMWBundle:FD8AEF47A15C0874E04373B1F00AEC31:0.1

添付ファイル:

名前 サイズ コンテンツ・タイプ 追加者 追加日
nmMovePlan.xml 6.95KB text/plain SYSMAN 2014年7月6日日曜日
mdm-url-resolver.xml 268バイト text/plain SYSMAN 2014年7月6日日曜日
domainMovePlan.xml 56.91KB text/plain SYSMAN 2014年7月6日日曜日

Source: WebLogic Domain
Oracle Home Included: No
Node Manager Included: Yes
Platform: Linux x86-64
Version: 10.3.6.0

Oracleホーム:

Product: Oracle SOA
Version: 11.1.1.7.0

WebLogicドメイン:

Domain Name: SoaDomain
Size: 611.45 MB
Products: Oracle SOA
名前 ホスト リスニング・アドレス ポート・マシン クラスタ 最大ヒープ 平均CPU使用率
AdminServer slc00tkv.example.com slc00tkv.example.com 7001 LocalMachine
1365 0.361
Soa_server1 slc00tkv.example.com slc00tkv.example.com 8001LocalMachine cluster_soa 1365 0.717

データソース:

名前 ユーザー名 URL ターゲット
EDNDataSource SOA_SOAINFRA jdbc:oracle:thin:@slc00dbv.example.com:1521/dbv.example.com cluster_soa
EDNLocalTxDataSource SOA_SOAINFRA jdbc:oracle:thin:@slc00dbv.example.com:1521/dbv.example.com cluster_soa
OraSDPMDataSource SOA_SOAINFRA jdbc:oracle:thin:@slc00dbv.example.com:1521/dbv.example.com cluster_soa
OraSDPMDataSource SOA_SOAINFRA jdbc:oracle:thin:@slc00dbv.example.com:1521/dbv.example.com cluster_soa
SOALocalTxDataSource SOA_SOAINFRA dbc:oracle:thin:@slc00dbv.example.com:1521/dbv.example.com cluster_soa
mds-owsm SOA_MDS jdbc:oracle:thin:@slc00dbv.example.com:1521/dbv.example.com cluster_soa
mds-soa SOA_MDS jdbc:oracle:thin:@slc00dbv.example.com:1521/dbv.example.com cluster_soa

JMSサーバー:

名前 永続ストア ディレクトリ ターゲット
BPMJMSServer_auto_1 BPMJMSFileStore_auto_1 UMSJMSFileStore_auto_1 soa_server1
PS6SOAJMSServer_auto_1 PS6SOAJMSFileStore_auto_1 UMSJMSFileStore_auto_1 soa_server1
SOAJMSServer_auto_1 SOAJMSFileStore_auto_1 SOAJMSFileStore_auto_1 soa_server1
UMSJMSServer_auto_1 UMSJMSFileStore_auto_1 UMSJMSFileStore_auto_1 soa_server1

27.4.2 Oracleホーム・プロファイルの説明

Oracleホーム・プロファイルのサマリーを表示するには、次のコマンドを実行します。

使用方法:

emcli describe_fmw_profile
-location="Fusion Middleware Provisioning/Profiles/SoaGoldImage"

Output
Location: Fusion Middleware Provisioning/Profiles/SoaGoldImage
Created By: SYSMAN
Created On: Tue, 8 Jul 2014
URN: oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_FMWBundle:FDB228F176CA1B47E04373B1F00AF708:0.1
Source: Oracle Home
Platform: Linux x86-64
Version: 10.3.6.0

Oracleホーム:

Product: Oracle SOA
Version: 11.1.1.7.0

27.4.3 インストール・メディア・プロファイルの説明

インストール・メディア・プロファイルのサマリーを表示するには、次のコマンドを実行します。

使用方法:

emcli describe_fmw_profile
-location="Fusion Middleware Provisioning/Profiles/WebCenter Install Media"
Output:
Location: Fusion Middleware Provisioning/Profiles/WebCenter Install Media
Description: WC 11.1.1.8.0 and WebLogic Server 10.3.6.0 installer and RCU
Created By: SYSMAN
Created On: Sun, 6 Jul 2014
URN: oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_InstallationMedia:FD8AA7EEEEA369A5E04373B1F00AE77C:0.1
Source: Installation Media
Product: Oracle WebCenter
Platform: Generic Platform
Version: 11.1.1.8.0

ファイル:

製品 ファイル サイズ
Oracle WebCenter Content ecm_main1.zip

ecm_main2.zip

2.34GB

1.91GB

Oracle RCU PS6SOAJMSFileStore_auto_1 496.16MB
Oracle WebCenter Portal SOAJMSFileStore_auto_1 1.96GB
Oracle WebLogic Server UMSJMSFileStore_auto_1 1,019.01MB

27.5 プロビジョニング・プロファイルの削除

ソフトウェア・ライブラリからFusion Middlewareプロビジョニング・プロファイルを削除するには、次を実行します。

使用方法:

emcli delete_fmw_profile 
        -location="Profile Location" 
Description for the options:
    -location 
Complete Software Library path to the Profile. 
        Use list_fmw_profiles to know the complete path.

例:

MyProfileという名前のプロファイルを削除するには、次のコマンドを実行します。

emcli delete_fmw_profile 
              -location="Fusion Middleware Provisioning/Profiles/MyProfile" 

DomainProfileを削除するには、次のコマンドを実行します。

emcli delete_fmw_profile 
              -location="Fusion Middleware Provisioning/Profiles/DomainProfile" 

Output: The profile Fusion Middleware Provisioning/Profiles/DomainProfile has been deleted successfully.