| Oracle® Fusion Middleware Oracle Identity Managerのためのアプリケーションの開発とカスタマイズ 11gリリース2 (11.1.2.3.0) E61958-10 |
|
 前 |
 次 |
| Oracle® Fusion Middleware Oracle Identity Managerのためのアプリケーションの開発とカスタマイズ 11gリリース2 (11.1.2.3.0) E61958-10 |
|
前 |
次 |
この章は、次の項で構成されています。
Oracle Enterprise Managerを使用すると、ユーザー修正可能なメタデータXMLファイルを、MDSにエクスポート、MDSからインポート、MDSから削除することができます。
この項には次のトピックが含まれます:
メタデータXMLファイルをMDSにエクスポートするには:
次の形式でURLに移動することにより、管理者ユーザーとしてOracle Enterprise Managerにログインします。
http://ADMINSTRATION_SERVER/em
管理サーバーおよび少なくとも1つのOracle Identity Manager管理対象サーバーが実行されていることを確認します。
「Identity and Access」、「oim」、「oim(VERSION)」の順に移動します。右クリックして「システムMBeanブラウザ」に移動します。
「アプリケーション定義のMBeans」で、「oracle.mds.lcm」→「サーバー:oim_server1」→「アプリケーション:OIMMetadata」→「MDSAppRuntime」に移動します。
操作を使用してメタデータをエクスポートします。これを行うには、次の手順を実行します。
リストの1つ目のexportMetadata操作を選択して開きます。
toLocationに、このファイルがエクスポートされる一時ディレクトリへのパスを指定します。このファイルは、Oracle Identity Managerが実行中のコンピュータにエクスポートされます。したがって、指定したディレクトリ・パスがそのコンピュータ上に存在することを確認してください。
docsで、鉛筆アイコンをクリックし、「追加」をクリックして、要素ボックスに、エクスポートするファイルのフル・パスを指定します。「追加」をクリックすると、複数のdocsへのパスを指定できます。エクスポートするメタデータ・ドキュメントを追加した後、下部にある「OK」をクリックします。
操作を呼び出します。
MDSからメタデータXMLファイルをインポートするには:
管理ユーザーとしてOracle Enterprise Managerにログインします。管理サーバーおよび少なくとも1つのOracle Identity Manager管理対象サーバーが実行されていることを確認します。
「Identity and Access」、「oim」、「oim(VERSION)」の順に移動します。右クリックして「システムMBeanブラウザ」に移動します。
「アプリケーション定義のMBeans」で、「oracle.mds.lcm」→「サーバー:oim_server1」→「アプリケーション:OIMMetadata」→「MDSAppRuntime」に移動します。
操作を使用してメタデータをインポートします。これを行うには、次の手順を実行します。
「操作」タブで、リストの1つ目のimportMetadata操作を選択します。
fromLocationに、ドキュメントがインポートされるOracle Identity Managerホストのディレクトリ・パスを指定します。
docsで、鉛筆アイコンをクリックし、「追加」をクリックして、要素ボックスに、インポートするファイルのフル・パスを指定します。「追加」をクリックすると、複数のdocsへのパスを指定できます。値が指定されない場合、fromLocationディレクトリの下のすべてのものが再帰的にインポートされます。
操作を呼び出します。
MDSからメタデータXMLファイルを削除するには:
「MDSへのメタデータ・ファイルのエクスポート」の手順1で説明されているように、MDSAppRuntime mbeansに移動します。
操作を使用してメタデータを削除します。これを行うには、次の手順を実行します。
「操作」タブで、リストの1つ目のdeleteMetadata操作を選択します。
docsで、鉛筆アイコンをクリックし、「追加」をクリックして、要素ボックスに、削除するファイルのフル・パスを指定します。「追加」をクリックすると、削除する複数のdocsへのパスを指定できます。
操作を呼び出します。
場合によっては、カスタマイズを実行する前に、MDSのバックアップを作成しておく必要があります。Oracle Enterprise Managerを使用してMDSのバックアップを作成するには、次の手順を実行します。
管理者としてOracle Enterprise Managerにログインします。
「アプリケーションのデプロイ」、「oracle.iam.console.identity.self-service.ear(V2.0)」の順に移動します。右クリックし、「MDS構成」に移動します。
「エクスポート」の下で「このWebブラウザが稼働しているマシンにあるアーカイブにメタデータ・ドキュメントをエクスポートします。」オプションを選択し、「エクスポート」をクリックします。
すべてのメタデータがZIPファイルでエクスポートされます。
Oracle Identity Managerの構成の一部は、Oracle Identity Managerサーバーのファイル・システム上ではなく、MDSリポジトリに格納されます。構成の問題をトラブルシューティングする場合、MDSデータをすべてエクスポートして調べ、必要に応じて修正する必要がある場合があります。
MDSリポジトリに含まれるすべてのOracle Identity Managerメタデータをエクスポートするには、次のようにします。
前提条件として環境を設定します。
MDS操作を実行するには、WebLogic Application Serverのインストールおよび実行に使用するアカウントでOracle Identity Managerサーバー・ホストにログインします。
MIDDLEWAR_HOME/user_projects/domains/DOMAIN_NAME/bin/ディレクトリにある適切なsetDomainEnvスクリプトを実行して、Oracle Identity Managerドメインの環境変数を設定します。コマンドは次のとおりです。
$ cd MIDDLEWARE_HOME/user_projects/domains/OIMDomain/bin
$ .setDomainEnv.sh
/tmp/OIM/MDSData/などの一時ディレクトリを作成します。このディレクトリはデータベースから抽出される結果のXMLファイルの格納に使用されます。
アプリケーション・サーバーが稼働していることを確認します。
WebLogic管理者ユーザー名と管理サーバーのURLがわかっているか確認します。
次のようにしてエクスポートを実行します。
コマンド・シェルまたはコンソール・ウィンドウで、OIM_ORACLE_HOME/common/bin/ディレクトリに移動します。
次のように、wlst.shコマンドを実行し、connect()コマンドを実行します。
$ ./wlst.sh CLASSPATH=/opt/oracle/Middleware/wlserver_10.3/server/ext/jdbc/oracle/11g/ojdbc6dms.jar:... ... Your environment has been set. ... Initializing WebLogic Scripting Tool (WLST) ... Welcome to WebLogic Server Administration Scripting Shell Type help() for help on available commands wls:/offline> connect() Please enter your username [weblogic] : Please enter your password [welcome1] : Please enter your server URL [t3://localhost:port] : Connecting to t3://localhost:port with userid weblogic ... Successfully connected to Admin Server 'AdminServer' that belongs to domain 'OIMDomain'. Warning: An insecure protocol was used to connect to the server. To ensure on-the-wire security, the SSL port or Admin port should be used instead.
WebLogic管理者のユーザー名とパスワード、および管理サーバーのURLを指定します。
次のように、少なくともapplication、serverおよびtoLocation引数を指定してexportMetadataコマンドを実行します。
|
注意: 次のように、引数データを必ず一重引用符で囲んで渡します。server='oim_server1' |
wls:/OIMDomain/serverConfig> exportMetadata(application='OIMMetadata', server='oim_server1', toLocation='/tmp/OIM/MDSData')
エクスポートされたファイルのリストが表示されます。ここで、次のようにdisconnect()コマンドとそれに続けてexit()コマンドを実行できます。
wls:/OIMDomain/serverConfig> disconnect() Disconnected from weblogic server: AdminServer wls:/offline> exit() Exiting WebLogic Scripting Tool. $
/tmp/OIM/MDSData/ディレクトリに移動し、db/oim-config.xmlファイル、db/form-metadata/FormMetaData.xmlファイルまたはエクスポートした他のMDSファイルを表示します。
すべてのMDSファイルをエクスポートするWLSTスクリプトの例を次に示します。
connect('WEBLOGIC_USERNAME','PASSWORD','t3://localhost:PORT')
exportMetadata(application='OIMMetadata', server='oim_server1', toLocation='/tmp/OIM/MDSData')
disconnect()
exit()
このスクリプトを.pyファイル(たとえば、/tmp/exportOIMMDS.pyなど)に保存します。これを実行すると自動的に同じ結果が生成されます。.pyファイルの例を次に示します。
cd MIDDLEWARE_HOME/user_projects/domains/OIMDomain/bin . setDomainEnv.sh mkdir -p /tmp/OIM/MDSData cd $OIM_ORACLE_HOME/common/bin ./wlst.sh /tmp/exportOIMMDS.py
テスト環境から本番環境に移行するときに、すべてのコネクタ・アーティファクトをそれぞれのデータベース表に移行する必要があり、これはJARファイルおよびリソース・バンドルを移行する次のユーティリティを使用して実行できます。
|
注意:
|
UploadJars.shおよびUploadJars.batスクリプトはOIM_HOME/bin/ディレクトリで使用できます。これらのスクリプトを実行すると、JARファイルがデータベースにアップロードされます。
このユーティリティの起動例を次に示します。
[Enter Xellerate admin username :]ADMISTRATOR_LOGIN [Enter the admin password :]ADMINISTRATOR_PASSWORD [[Enter serverURL (Ex. t3://oimhostname:oimportno for weblogic)]:]t3://xyz.com:14000 [[Enter context (Ex. weblogic.jndi.WLInitialContextFactory for weblogic)]:]weblogic.jndi.WLInitialContextFactory Enter the jar type 1.JavaTasks 2.ScheduleTask 3.ThirdParty 4.ICFBundle 1 Enter the path/location of jar file : /tmp/example.jar Do u want to load more jars [y/n] :n
|
注意: 14000はOracle Identity Managerポートです。 |
DownloadJars.shおよびDownloadJars.batスクリプトはOIM_HOME/bin/ディレクトリで使用できます。これらのスクリプトを実行すると、JARファイルがデータベースからダウンロードされます。
このユーティリティの起動例を次に示します。
[Enter Xellerate admin username :]ADMINISTRATOR_LOGIN [Enter the admin password :]ADMINISTRATOR_PASSWORD [[Enter serverURL (Ex. t3://oimhostname:oimport for weblogic)]:]t3://localhost:14000 [[Enter context (i.e.: weblogic.jndi.WLInitialContextFactory for weblogic)]:]weblogic.jndi.WLInitialContextFactory Enter the jar type 1.JavaTasks 2.ScheduleTask 3.ThirdParty 4.ICFBundle 1 Enter the full path of the download directory : /home/joe/tmp Enter the name of jar file to be downloaded from DB : example.jar Do u want to download more jars [y/n] :n
|
注意: 14000はOracle Identity Managerポートです。 |
DeleteJars.shおよびDeleteJars.batスクリプトはOIM_HOME/bin/ディレクトリで使用できます。これらのスクリプトを実行すると、JARファイルがデータベースから削除されます。
このユーティリティの起動例を次に示します。
[Enter Xellerate admin username :]ADMINISTRATOR_LOGIN [Enter the admin password :]ADMINISTRATOR_PASSWORD [[Enter serverURL (Ex. t3://oimhostname:oimport for weblogic)]:]t3://localhost:14000 [[Enter context (i.e.: weblogic.jndi.WLInitialContextFactory for weblogic)]:]weblogic.jndi.WLInitialContextFactory Enter the jar type 1.JavaTasks 2.ScheduleTask 3.ThirdParty 4.ICFBundle 1 Enter the name of jar to be deleted from DB : example.jar Do u want to delete more jars [y/n] :n
UploadResourceBundles.shおよびUploadResourceBundles.batスクリプトはOIM_HOME/server/bin/ディレクトリで使用できます。これらのスクリプトを実行すると、コネクタまたはカスタム・リソースがデータベースにアップロードされます。
このユーティリティの起動例を次に示します。
Enter Xellerate admin username :]ADMINISTRATOR_LOGIN [Enter the admin password :]ADMINISTRATOR_PASSWORD [[Enter serverURL (Ex. t3://oimhostname:oimportno for weblogic)]:]t3://localhost:14000 [[Enter context (i.e.: weblogic.jndi.WLInitialContextFactory for weblogic)]:]weblogic.jndi.WLInitialContextFactory Enter the resource bundle type 1.Custom Resource 2.Connector Resource 2 Enter the path/location of resource bundle file : /tmp/example.properties Do u want to load more resource bundles [y/n] :n
DownloadResourceBundles.shおよびDownloadResourceBundles.batスクリプトはOIM_HOME/bin/ディレクトリで使用できます。これらのスクリプトを実行すると、リソース・バンドルがデータベースからダウンロードされます。
このユーティリティの起動例を次に示します。
[Enter Xellerate admin username :]ADMINISTRATOR_LOGIN [Enter the admin password :]ADMINISTRATOR_PASSWORD [[Enter serverURL (Ex. t3://oimhostname:oimportno for weblogic)]:]t3://localhost:14000 [[Enter context (i.e.: weblogic.jndi.WLInitialContextFactory for weblogic)]:]weblogic.jndi.WLInitialContextFactory Enter the resource bundle type 1.Custom Resource 2.Connector Resource 2 Enter the full path of the download directory : /home/joe/tmp Enter the name of resource bundle file : example.properties Do u want to download more resource bundles [y/n] :n
DeleteResourceBundles.shおよびDeleteResourceBundles.batは、OIM_HOME/bin/ディレクトリで使用できます。これらのユーティリティを実行すると、リソース・バンドルがデータベースから削除されます。
このユーティリティの起動例を次に示します。
[Enter Xellerate admin username :]ADMINISTRATOR_LOGIN [Enter the admin password :]ADMINISTRATOR_PASSWORD [[Enter serverURL (Ex. t3://oimhostname:oimportno for weblogic)]:]t3://localhost:14000 [[Enter context (i.e.: weblogic.jndi.WLInitialContextFactory for weblogic)]:]weblogic.jndi.WLInitialContextFactory Enter the resource bundle type 1.Custom Resource 2.Connector Resource 2 Enter the name of resource bundle file to be deleted from DB: example.properties Do u want to delete more resource bundles [y/n] :n
