Managerのコマンド行インタフェース・スクリプトこの章では、コマンドライン・インタフェース(CLI)に関する情報を提供します。この章には次の項目があります。Managerのコマンドライン・インタフェース(CLI)スクリプトでは、OAAM管理を使用しないで様々なタスクを実行できます。ManagerのCLIスクリプトは、次の目的で使用できます。ポリシー、グループ、条件、その他のモジュールなどのオブジェクトをグラフィカル・ユーザー・インタフェースを使用しないでインポートまたはエクスポートします。Managerデータベースにロケーション・データをロードします。CLI環境の設定CLI環境の設定には、次のタスクが含まれます。CLI作業フォルダの設定CLIフォルダ$IDM_ORACLE_HOME/oaam/cli/oaam_cliを作業ディレクトリ(oaam_cliなど)にコピーします。注意:IDM_ORACLE_HOMEフォルダ(IDMソフトウェアをインストールしたフォルダ)内にあるファイルを編集または変更することは推奨されないため、このタスクが必要になります。Unixの場合:次のコマンドを実行します。次のコマンドを実行します。c:\work\oaam_cliフォルダ全体がコピーされるように、求められたらD=directoryを選択します。Manager暗号化キーにアクセスするための次のいずれかのメカニズムを選択します。MBeanを含まないCSFの使用このアプローチに関する重要な注意事項は次のとおりです。Serverと同じコンピュータで実行する必要があります。この方法では、WebLogic管理者とパスワードを指定する必要はありません。Managerがクラスタ化された環境にデプロイされている場合、この方法はお薦めしません。このメカニズムを使用する手順:cliフォルダをコピーした作業フォルダに移動します。テキスト・エディタでconf/bharosa_properties/oaam_cli.propertiesファイルを開き、次のプロパティを設定します。プロパティ名プロパティ値に関する注意事項oaam.csf.useMBeansfalseoaam.jps.config.filepathjps-config-jse.xmlの絶対パスを設定します。通常は、$DOMAIN_HOME/config/fmwconfigフォルダにあります。Managerデータベースに関連する次のプロパティを設定します。誤入力がないことを確認します。oaam.db.additional.properties.file追加のtoplinkプロパティがない場合は、空白のままにします。それ以外の場合は、追加のtoplinkプロパティを含むプロパティ・ファイルの名前を指定します。ファイルがoaam_cli.propertiesと同じフォルダにあることを確認します。Managerがクラスタ化された環境にデプロイされている場合、この方法をお薦めします。Serverにリモートで接続できます。WebLogic管理ユーザーとパスワードを指定する必要があります。Managerデータベースの詳細を構成するには、次の手順を実行します。cliフォルダをコピーした作業フォルダに移動します。テキスト・エディタでconf/bharosa_properties/oaam_cli.propertiesファイルを開き、次のプロパティを設定します。(trueを維持します)oaam.adminserver.hostname<WebLogic管理サーバーが実行されるホストの名前>oaam.adminserver.port<WebLogic管理サーバーのポート番号。通常は7001>oaam.adminserver.username<WebLogic管理ユーザーのユーザー名。Managerデータベースに関連する次のプロパティを設定します。誤入力がないことを確認します。oaam.db.additional.properties.file追加のtoplinkプロパティがない場合は、空白のままにします。それ以外の場合は、追加のtoplinkプロパティを含むプロパティ・ファイルの名前を指定します。ファイルがoaam_cli.propertiesと同じフォルダにあることを確認します。Managerデータベース資格証明の設定」を参照してください。Managerデータベース資格証明を設定しないで、persistence.xmlを使用する場合は、次の手順を実行します。このアプローチは推奨されておらず、サポートされていません。cliフォルダをコピーした作業フォルダに移動します。テキスト・エディタでファイルconf/bharosa_properties/oaam_cli.propertiesを開き、oaam.db.toplink.useCredentialsFromCSFのプロパティ値をfalseに設定します。Managerデータベース接続の詳細をMETA-INF/persistence.xmlファイルで更新します。ManagerのCLIは、OAAM管理ではなくキーボードを使用して様々なタスクを実行できるツールです。ManagerのCLIは、次の方法で使用できます。ポリシー、グループ、条件、その他のモジュールなどのオブジェクトをグラフィカル・ユーザー・インタフェースを使用しないでインポートまたはエクスポートします。プログラムを使用して、異なる環境間でインポートおよびエクスポートを実行します(QAやステージングなど)。ロケーション・データをロードします。ManagerのCLI環境を設定します。詳細は、29.2項「CLI環境の設定」を参照してください。ManagerのCLI作業フォルダに移動します。引数を指定せずにrunImportExport.shスクリプトを実行します。コマンドライン・オプションこの項では、コマンド行オプションに関する詳細を提供します。インポートまたはエクスポートを実行するには、コマンドを次とともに入力します。コマンドの構文コマンド行インタフェースでは、次の構文を使用します(改行やキャリッジ・リターンなしで1行に入力します)。CLIのパラメータこのオプションは、29.3項「CLIの使用」で説明されています。CLIのパラメータパラメータ説明entitycmdエクスポートされるモジュールのエンティティが、ファイルのインポート時にデータベースに追加されるかデータベースから削除されるかを示します。デフォルトはaddです。exportmodeエクスポートの結果がZIPファイルかXMLファイルかを示します。デフォルトはZIPです。includeelementsグループ要素をエクスポートに含める必要があるかどうかを示します。デフォルトはtrueです。これは、グループのエクスポートのみに適用されます。listelemcmdこのファイルがインポートされるときに、データベースでグループ要素が追加されるか、削除されるか、置換されるかを示します。デフォルトはaddです。これは、グループのエクスポートのみに適用されます。outdirエクスポート結果のファイルが保存される出力フォルダ。デフォルト値は現在のフォルダです。batchmodeリスト項目がバッチでインポートされるときのデータベース・コミットを制御します。バッチがその制限に達したときに、オブジェクトはデータベースに挿入されます。batchmodeがtrueの場合、データベース更新もコミットされます。デフォルトでは、batchmodeはfalseに設定されています。submoduleエクスポートに含める必要があるグループのタイプを指定するために使用されます。デフォルト値はallです。これは、グループのエクスポートのみに適用されます。loadTypeエクスポートする必要があるプロパティのタイプを指定するために使用されます。指定しない場合は、すべてのタイプのプロパティが含まれます。これは、プロパティのエクスポートのみに適用されます。11gのサポートされているモジュールのリストが示されています。変換の質問questionsForTranslationパターンパターンエンティティエンティティトランザクショントランザクション構成可能なアクションdynamicActionsスケジューラ・タスク・グループtaskGroups10gのポリシー・セットおよびポリシー・モジュールは、11gでは有効ではなくなりました。modelsと同じです)。ファイルのインポートインポート・オプションの例は次のとおりです。ファイルからのインポートファイルからインポートするには、次のコマンドを発行します。exportData\properties\<properties_zip_file>ZIPファイルのコンテンツのインポートZIPファイルのコンテンツをインポートするには、次のコマンドを発行します。<filename>次に例を示します。チャレンジ質問をアップロードするには、次のコマンドを発行します。<filename>条件をインポートするには、次のコマンドを発行します。<filename>ポリシーをインポートするには、次のコマンドを実行します。<filename>グループをインポートするには、次のコマンドを実行します。<filename>XMLファイルのユーザーのグループのインポートXMLファイルのユーザーのグループをインポートするには、次のコマンドを発行します。<abc.xml>複数のZIPファイルからの複数のポリシーのインポート複数のXMLファイルの複数のポリシーをインポートするには、次のコマンドを発行します。<OneModel.zip>複数のZIPファイルからの複数の質問のインポート複数のZIPファイルから複数の質問をインポートするには、次のコマンドを発行します。<OneQuestions.zip>複数のZIPファイルからの複数の検証のインポート複数のZIPファイルから複数の検証をインポートするには、次のコマンドを発行します。<OneValidations.zip>注意:不適切なオプションは警告なしで無視され(たとえば、outdirオプションがインポートに使用された場合)、優先度の低いオプションはオーバーライドされます(たとえば、includeelementsがfalseである場合、listelemcmdは無関係です)。ファイルのエクスポート次に、エクスポート・オプションの例を示します。プロパティのエクスポートloadtypeに関係なくすべてのプロパティをエクスポートするには、次のコマンドを発行します。properties任意の特定のloadtypeのプロパティをすべてエクスポートするには、次のコマンドを発行します。system>たとえば、loadtypeがデータベースであるすべてのプロパティをエクスポートするには、次のコマンドを発行します。database任意の単一のプロパティをエクスポートするには、次のコマンドを発行します。<propertyname>すべてのエクスポートエクスポートを実行する場合、エンティティ名を指定しないと、その特定のモジュール(およびサブモジュール)のすべてのエンティティがエクスポートされます。このため、エクスポートでは名前を指定する必要はありません。特定のモジュールのすべてのエンティティをエクスポートするには、次のコマンドを発行します。entity_name>すべてのポリシーのエクスポートすべてのポリシーをエクスポートするには、次のコマンドを発行します。modelsすべてのユーザー・グループのエクスポートグループをエクスポートするには、次のコマンドを発行します。usersすべての質問のエクスポート質問をエクスポートするには、次のコマンドを発行します。questionsそれらの質問を完全なものにするために、CLIではすべての関連するカテゴリ、検証およびロケール情報がエクスポートされます。すべての検証のエクスポートすべての検証をエクスポートするには、次のコマンドを発行します。validations条件のエクスポート条件をエクスポートするには、次のコマンドを発行します。conditions削除スクリプトを含む条件のエクスポート削除スクリプトを含む条件をエクスポートするには、次のコマンドを発行します。delete要素を含めない特定のグループ(Grp1およびGrp2)の削除対象としてのエクスポート要素を含めずに特定のグループをエクスポートするには、次のコマンドを発行します。Grp2entitycmdは、エクスポートされるモジュールのエンティティが、ファイルのインポート時にデータベースに追加されるかデータベースから削除されるかを示します。この例では、このエクスポート・コマンドの結果のファイルがインポートされると、グループGrp1およびGrp2はデータベースから削除されます。G2グループG1およびG2のグループ要素は、このエクスポート・コマンドの結果のファイルのインポート時にZIPファイル内の要素によって置換されます。グループG1は要素e1とe2がデータベース内にあり、ZIPファイルに要素e2とe3がある場合、インポートの実行後、グループG1の要素はe2とe3になります。listelemcmdの値がaddであった場合は、インポート後、G1の要素はe1、e2およびe3になります。指定された値がdeleteであった場合は、インポート後、e2は削除されるためグループG1の要素はe1のみになります。Group2exportmodeがfileの場合、データは1つ以上のXMLファイルとしてエクスポートされます。注意:コマンドは、依存データを含むポリシーや質問などのモジュールに対しては機能しません。エラーが発生し、ZIPストリームが予期されるというメッセージが表示されます。インポート・オプションbatchmodeオプションは、リスト項目がバッチでインポートされるときのデータベース・コミットを制御します。バッチがその制限に達したときに、オブジェクトはデータベースに挿入されます。batchmodeがtrueの場合、データベース更新もコミットされます。デフォルトでは、batchmodeはfalseに設定されています。false}注意:batchmodeは他のモジュールと組み合せて使用しないでください。リストのみとともに使用する必要があります。次に、batchmodeの使用例を示します。バッチ・モードでのグループのインポートバッチ・モードでグループをインポートするには、次のコマンドを発行します。同じトランザクションでの、複数タイプのエンティティのインポート前述の例は、処理されるエンティティが同じタイプであるシナリオのみを対象としています。異なるタイプのモジュールを同時に処理できるようにするには、複数のモジュールをサポートするようにコマンド行を変更する必要があります。1つのコマンドに指定したすべてのエンティティは単一のトランザクションで処理されるため、関連するエンティティのセットを同時に使用して、「すべてまたはなし」というアプローチを適用できます。次に、複数のモジュールを同時にインポートする例を示します。様々なモジュールの同時インポート様々なモジュールを同時にインポートするには、次のコマンドを発行します。model1.zip注意:アクション・パラメータは繰り返しませんが、-moduleパラメータからのコマンドのみ、インポートされる異なるアイテムの数だけ繰り返します。コマンド行でアイテムを指定した順序は、エンティティのタイプと各エンティティのファイルの両方で保持されます。複数のモジュールおよび追加のオプション(共通と固有)複数のモジュールをサポートすることによって、数多くの質問が発生します。追加のオプションにはどのようなものがあるか。すべてのモジュールに共通のオプションを指定するにはどうするか。共通のオプションとして定義されているオプションに、特定のモジュールの固有の指定を行うにはどうするか。次の点に注意してください。インポートまたはエクスポート・コマンドを作成するときには、-moduleは新しいオプションのセットの先頭とみなされることに注意してください。-moduleの後に続くすべての内容が、1つのオプションのセットとなります。最初の-moduleオプションの前に指定するすべての内容は、共通オプションのセットとみなされ、各-moduleに適用されます。特定のオプションが、共通オプションとして指定され、かつ、モジュール固有のオプションとしても指定された場合、固有の値が優先されます。allディレクトリにすべてエクスポートするが、ポリシーはpoliciesディレクトリにエクスポートする場合allディレクトリにすべてエクスポートするが、ポリシーはpoliciesディレクトリにエクスポートする場合は、次のコマンドを実行します。groupsグループG1とG2の削除アイテムとしてのエクスポートおよびG3とG4の置換アイテムとしてのエクスポートグループG1とG2を削除アイテムとしてエクスポートし、G3とG4を置換アイテムとしてエクスポートするには、次のコマンドを発行します。トランザクション処理トランザクション処理はインポートおよびエクスポートとは異なります。インポートは、リストをインポートするためにバッチ・モードを使用する場合を除いて、厳密に1つのトランザクションで処理されます。いずれかのモジュールのエンティティのインポートでエラーが発生した場合は、プロセス全体がロールバックされます。このため、データベースの更新はコミットされません。インポートは厳密に1つのトランザクションで実行されますが、リスト内に無効なアイテムがあっても(たとえば、正しくない都道府県や国を含む市区町村のインポートなど)停止しません。警告メッセージが記録され、インポート・プロセスはそのようなアイテムを無視して続行します。エクスポートはベスト・エフォート原則に基づいて処理されます。いずれかのエンティティのエクスポートが失敗した場合、次のエンティティの処理が続行されます。これは、エクスポートではデータベースの更新が実行されないためです。データベースからの情報の選択とファイルへの情報の挿入のみが行われます。ロケーション・データベースのアップロードIPロケーション・ローダー・ユーティリティを使用するには、29.4項「IPロケーション・データのインポート」の設定手順を実行します。グローバリゼーションこのリリースでは、CLIはグローバル化されていません。ManagerデータベースにIPロケーション・データをインポートする方法について説明します。このデータは、特定のIPアドレスに関連する不正のリスクを判断するために、リスク・ポリシー・フレームワークによって使用されます。この項の内容は次のとおりです。ManagerのCLI環境を設定します。詳細は、29.2項「CLI環境の設定」を参照してください。Serverデータベースにデータをロードするには、sqljdbc.jarをサード・パーティ・ディレクトリにコピーする必要があります。(http://www.microsoft.com/downloads/details.aspx?FamilyID=6d483869-816a-44cb-9787-a866235efc7c&DisplayLang=en)から無料でダウンロードできます。IPロケーション・ローダー・プロパティの設定<ORACLE_MW_HOME>/<IAM_HOME>/oaam/cliディレクトリに移動し、サンプルbharosa_location.propertiesファイルのコピーを作成します。bharosa_location.properties次の例のように、ロケーション・データの詳細でbharosa_location.propertiesを更新します。ロケーション・データは、サポートされているいずれかのベンダー(ip2location、maxmind、Quova/Neustarなど)から取得する必要があります。一般的に、「拡張」とマークされているプロパティは変更できません。IPデータのロードの設定IPロケーション・ローダーを実行する前に、次のコマンドを使用してMaxMindのBlocks.csvファイルを前処理する必要があります。Manager環境の設定」を参照してください。Managerデータベースにロケーション・データをロードします。JAVA_HOME環境変数をJDKのロケーションを指すように設定します。11gで認証されているJDKに設定されていることを確認します。loadIPLocationDataスクリプトを実行します。shellから、loadIPLocationData.shを実行します。Windowsコマンド・プロンプトから、loadIPLocationData.cmdを実行します。このコマンドでは、データのロードが正常に実行された場合は0が返され、失敗した場合は1が返されます。IPロケーション・データ・ファイルから読み込みます。ユーティリティは、新しいデータベースに対して初めて実行されたときに、データファイル内のレコードごとに1行以上をvcrypt_ip_location_mapに追加します。データファイル内の一意の国名ごとにvcrypt_countryに新しいレコードを作成し、データファイル内の国名と都道府県名の一意の組合せごとにvcrypt_stateに新しいレコードを作成し、データファイル内の国名、都道府県名および市区町村名の一意の組合せごとにvcrypt_cityに新しいレコードを作成します。IPロケーション・ローダーは、新しいデータファイルを使用して、すでに移入済のデータベースに対して実行されると、データファイル内の一致がある(vcrypt_ip_location_map表に同じレコードがある)レコードをスキップします。これは、データベースにFROM_IP_ADDRがまだ存在しないデータファイル内のレコードごとに、vcrypt_ip_location_mapに新しい行を作成します。これは、FROM_IP_ADDRがデータファイル内のレコードと一致するが、他の列に異なるデータがあるvcrypt_ip_location_mapの行を更新します。ローダーは、データベースにまだ存在しない新しい国、都道府県および市区町村も作成します。Quova/Neustarのファイル・レイアウトQuova/Neustarデータファイルは、各行に29フィールド、行ごとに1レコードが含まれているパイプ区切り(|)のファイルです。Glossaryから取得されます。次の表で、IPはvcrypt_ip_location_map表、COはvcrypt_country表、STはvcrypt_state表、CIはvcrypt_city表をそれぞれ表します。ファイル・レイアウトは次のとおりです。IPIP.from_ip_addrIP範囲の先頭であり、vcrypt_ip_location_map表で代替主キーとしても使用されます。IPIP.to_ip_addrIP範囲の終わり。CIDR(使用されていません)Continent(使用されていません)CountryCO.country_name国名。ISO2(使用されていません)Region(使用されていません)StateST.state_name都道府県/州名。CityCI.city_name市区町村名。zone(使用されていません)LatitudeCI.latitudeIPアドレスの緯度。正の値は北、負の値は南を表します。LongitudeCI.longitudeIPアドレスの緯度。正の値は東、負の値は西を表します。FlagIP.isp_idにマップされます。IPアドレスかどうかを示します。CFIP.country_cf正しい国が識別されていることの信頼度係数(1-99)。CFIP.state_cf正しい都道府県が識別されていることの信頼度係数(1-99)。CFIP.city_cf正しい市区町村が識別されていることの信頼度係数(1-99)。typeIP.connection_typeにマップされます。デバイスまたはLANとインターネット間のデータ接続を示します。「接続タイプ・マッピング」を参照してください。typeIP.routing_typeにマップされます。ユーザーがインターネットにルーティングされる方法を示します。「IPルーティング・タイプ・マッピング」を参照してください。speedIP.connection_speedにマップされます。接続スピードを示します。接続タイプによって異なります。「接続スピード・マッピング」を参照してください。ASNIP.asn単一のエンティティによって管理されるネットワークまたはネットワークのグループに割り当てられたグローバルに一意の番号。CarrierIP.carrierASNエンティティを管理するエンティティの名前。DomainIP.sec_level_domainにマップされます。URLの第2レベルのドメイン。www.oracle.comの名前。Quova/Neustar参照ファイルを介してマップされます。DomainIP.top_level_domainにマップされます。URLの最上位レベルのドメイン。www.company.comのcom。Quova/Neustar参照ファイルを介してマップされます。ルーティング・タイプ・マッピング表29-5には、ルーティング・タイプ・マッピングの表が示されています。固定1ユーザーIPはユーザーと同じロケーションにあります。アノニマイザ2ユーザーIPは、アノニマイザ・アクティビティに対してテストで肯定的となったネットワーク・ブロック内にあります。AOL3ユーザーはAOLサービスのメンバーであり、ほとんどの場合ユーザーの国は特定できますが、国よりも詳細な地域情報は特定できません。POP4ユーザーはAOLサービスのメンバーであり、ほとんどの場合ユーザーの国は特定できますが、国よりも詳細な地域情報は特定できません。AOLダイアルアップ5ユーザーはAOLサービスのメンバーであり、ほとんどの場合ユーザーの国は特定できますが、国よりも詳細な地域情報は特定できません。AOLプロキシ6ユーザーはAOLサービスのメンバーであり、ほとんどの場合ユーザーの国は特定できますが、国よりも詳細な地域情報は特定できません。POP7ユーザーは地域のISPにダイアルしており、IPロケーションの近くにいる可能性が高くなります。ユーザーは地理的境界をまたいでダイアルしている可能性があります。スーパーPOP8ユーザーは複数の都道府県または複数国のISPにダイアルしており、IPロケーションの近くにいない可能性が高くなります。ユーザーは地理的境界をまたいでダイアルしている可能性があります。衛星9ユーザーは民生衛星を介してインターネットに接続しているか、または地上接続に関する情報を入手できないバックボーン衛星プロバイダを使用してインターネットに接続しています。キャッシュ・プロキシ10ユーザーは、インターネット・アクセラレータまたはコンテンツ配信サービスを介してプロキシされます。国際プロキシ11複数の国からのトラフィックを含むプロキシ。地域プロキシ121つの国の複数の都道府県からのトラフィックを含むプロキシ(アノニマイザではなく)。モバイル・ゲートウェイ13モバイル・デバイスを一般のインターネットに接続するゲートウェイ。WAPは携帯電話のプロバイダによって使用されるゲートウェイです。なし14ルーティング方法は不明であるか、前述の説明で特定できません。不明99ルーティング方法は不明であるか、前述の説明で特定できません。接続タイプ・マッピング表29-6には、接続タイプ・マッピングが示されています。ID説明OCX1主に大規模なバックボーン・キャリアによって使用される、OC-3回線、OC-48回線などを表します。TX2数多くの中小企業で現在も使用されているT-3回線とT-1回線が含まれます。衛星3民生衛星と地球同期衛星または低軌道衛星の間の高速リンクまたはブロードバンド・リンクを表します。フレーム・リレー4フレーム・リレー回線は低速から高速までの幅があり、T-1のバックアップまたは代替として使用されます。ほとんどの場合は高速リンクであり、GeoPointではそのように分類されます。DSL5aDSL、iDSL、sDSLなどを含むデジタル・サブスクライバ・ライン・ブロードバンド回線。通常、速度は256kから20MB/秒の範囲です。ケーブル6ケーブル・テレビの会社によって提供されるケーブル・モデム・ブロードバンド回線。速度は128k/秒から36MB/秒の範囲であり、提供されるケーブル・モデム・スイッチに設定されたロードによって異なります。ISDN7デジタル総合サービス網高速銅線テクノロジ(128K/秒の速度をサポートし、1MB/秒以上の速度を提供するISDNモデムおよびスイッチを使用)。主要な電気通信会社によって提供されます。ダイアルアップ8このカテゴリはコンシューマ・ダイアルアップ・モデム・スペースを表し、56k/秒で動作します。プロバイダにはEarthlink、AOL、Netzeroなどがあります。固定無線9受信機の位置が固定されている固定無線接続を表します。DirectなどのWDSLプロバイダおよび新しいWiMaxプロバイダが含まれます。Wirelessなどのセルラー・ネットワーク・プロバイダを表します。速度は19.2k/秒から3MB/秒の範囲です。民生衛星11不明/高12GeoPointで接続タイプを取得できなかったか、接続タイプを前述の説明で特定できません。不明/中13GeoPointで接続タイプを取得できなかったか、接続タイプを前述の説明で特定できません。不明/低14GeoPointで接続タイプを取得できなかったか、接続タイプを前述の説明で特定できません。不明99GeoPointで接続タイプを取得できなかったか、接続タイプを前述の説明で特定できません。接続スピード・マッピング表29-7には、接続スピード・マッピングが示されています。高1OCX、TXおよびフレーム・リレー。中2衛星、DSL、ケーブル、固定無線およびISDN。低3ダイアルアップおよびモバイル無線。不明99Quova/Neustarは回線スピード情報を取得できませんでした。Managerの表この項には、ETLプロセスで使用される表が含まれます。アノニマイザアノニマイザ・データをアップロードするために次の表および順序が使用されます。ETLプロセスにこれらの表の読取りおよび更新を行うための十分な権限があることを確認してください。ロケーション・ロードの表IPロケーション・ローダーには、次の表への読取り/書込みアクセス権が必要です。ロードが成功したときの確認ローダー・スクリプトでは、データのロードが正常に実行された場合は0が返され、失敗した場合は1が返されます。reserved.法律上の。