機械翻訳について

Validate Model Tool

ツールを実行するメタデータ・モデルを使用する場合、モデルとその関連アーティファクトが整形式であることを簡単にバリデートし、特定のモデルのロケーションの有効な属性およびサブフォルダに関するヘルプを提供することが重要です。 Validate Model Toolは、モデル作成者のバリデーションとヘルプの両方をスタンドアロン・ツールとして提供します。 また、ツールはcreateDomainおよびdeployAppsツールと統合され、ドメインでアクションが実行される前に、バリデーション・エラーを早期に捕捉します。

Validate Model Toolを使用するには、validateModelシェル・スクリプトを正しい引数で実行します。 WebLogic Deploy Toolingインストールのツールの有効な引数のリストを表示するには、-helpオプション(または引数なし)を指定してシェル・スクリプトを実行し、シェル・スクリプトの使用方法情報を表示します。

たとえば、次に示すモデルから始めて、AdminServer属性MachineのスペルがMachinesと誤っています:

topology:
    Name: DemoDomain
    AdminServerName: AdminServer
    Cluster:
        mycluster:
    Server:
        AdminServer:
            ListenAddress: 192.168.1.50
            ListenPort: 7001
            Machines: machine1
            SSL:
                Enabled: true
                ListenPort: 7002
            ServerStart:
                ClassPath: c:\foo\bar
        m1:
            ListenAddress: 192.168.1.50
            ListenPort: 8001
            Cluster: mycluster
            Machine: machine1
            ServerStart:
                ClassPath: c:\foo\bar
        m2:
            ListenAddress: 192.168.1.51
            ListenPort: 8001
            Cluster: mycluster
            Machine: machine2
            ServerStart:
                ClassPath: c:\foo\bar
    Machine:
        machine1:
            NodeManager:
                ListenAddress: 192.168.1.50
                ListenPort: 5556
        machine2:
            NodeManager:
                ListenAddress: 192.168.1.51
                ListenPort: 5556

スタンドアロン・モデル・ファイルをバリデートするには、次のようにツールを実行します:

$ weblogic-deploy\bin\validateModel.cmd -oracle_home c:\wls12213 -model_file InvalidDemoDomain.yaml

ツールの出力は次のようになります:

-----------------------------------------------
Validation Area: topology Section
-----------------------------------------------

  Errors: 1
    Message: Machines is not one of the folder, folder instance or attribute names allowed in model location topology:/Server/AdminServer

Model Help Toolを使用して、このモデルのロケーションの属性およびフォルダの有効なリストを確認します。

モデルに変数定義が含まれ、変数ファイルが指定されている場合、Validate Model Toolは、モデル内のすべての変数参照が変数ファイルに定義されていることがバリデートします。 たとえば、次に示すようにツールを起動します: 

$ weblogic-deploy\bin\validateModel.cmd -oracle_home c:\wls12213 -model_file InvalidDemoDomain.yaml -variable_file InvalidDemoDomain.properties

db.password変数が変数ファイルに定義されていない場合、次のような出力になります。

-----------------------------------------------
Validation Area: Variable Substitutions
-----------------------------------------------

  Errors: 2
    Message: Model location resource:/JDBCSystemResource/Generic1/JdbcResource/JDBCDriverParams/PasswordEncrypted references variable db.password that is not defined in D:/demo/InvalidDemoDomain.properties
    Message: Model location resource:/JDBCSystemResource/Generic2/JdbcResource/JDBCDriverParams/PasswordEncrypted references variable db.password that is not defined in D:/demo/InvalidDemoDomain.properties

アーカイブ内に存在する必要があるバイナリをモデルが参照する場合、Validate Model Toolは、アーカイブ・ファイルのロケーションを指すモデル内のすべてのバイナリ参照がアーカイブ・ファイルに存在することをバリデートします。 たとえば、次に示すようにツールを起動します: 

$ weblogic-deploy\bin\validateModel.cmd -oracle_home c:\wls12213 -model_file InvalidDemoDomain.yaml -archive_file InvalidDemoDomain.zip

simpleear.earファイルがアーカイブ・ファイル内のモデル指定のロケーションにない場合、次のような出力になります。

-----------------------------------------------
Validation Area: Archive Entries
-----------------------------------------------

  Errors: 1
    Message: Model location appDeployments:/Application/simpleear/SourcePath references file wlsdeploy/applications/simpleear.ear that is not found in the archive file D:/demo/InvalidDemoDomain.zip

複数のモデルの使用

「複数のモデルの使用」で説明されているように、Validate Model Toolでは複数のモデルを使用できます。

validateModelのパラメータ表

パラメータ 定義 デフォルト
-archive_file 使用するアーカイブ・ファイルへのパス。 アーカイブ・ファイルが指定されていない場合、バリデーションでは指定されたアーティファクトのみがバリデートされます。 これは、アーカイブ・ファイルのカンマ区切りリストとして指定することもできます。 各アーカイブ内の内容が、リストの前のアーカイブより優先されます。
-domain_type ドメインのタイプ(WLS、JRFなど) WLS
-model_file 使用するモデル・ファイルのロケーション。 これは、モデル・ロケーションのコンマ区切りリストとして指定することもできます。このリストでは、前のモデル・ロケーションの上に続く各モデル層が配置されます。 指定しない場合、ツールはアーカイブ内のモデルを検索します。 モデルが見つからない場合、バリデーションでは指定されたアーティファクトのみがバリデートされます。
-oracle_home Oracle WebLogicインストールのホーム・ディレクトリ。 ORACLE_HOME環境変数が設定されていない場合は必須です。
-target_mode ツールがモデル・コンテンツのバリデートに使用するターゲットWLSTモード。 有効な値は、onlineまたはofflineのみです。 offline
-target_version ツールがモデル・コンテンツをバリデートするために使用するWebLogic Serverのターゲット・バージョン。 このバージョン番号は、ツールの実行に使用されているバージョンとは異なる場合があります。 Oracleホームのバージョン
-variable_file モデルで使用されるすべての変数の変数値を含むプロパティ・ファイルのロケーション。 変数ファイルが指定されていない場合、バリデーションでは指定されたアーティファクトのみがバリデートされます。
-remote リモート更新またはデプロイ・コマンドからモデルをバリデートします。 -archive_fileで指定する必要があります。