ユーザーの名前変更コマンド

renameusersコマンドを使用して、特定のサーバー・インスタンスに対して名前変更するユーザーの情報のリストを含むJSONファイルをアップロードします。

ランチャ・スクリプト(UNIXの場合はdatamodel.sh、Windowsの場合はdatamodel.cmd)を介して、ユーティリティを実行します。

ドメインがデフォルトのフォルダにインストールされている場合、ランチャ・スクリプトの場所は次のようになります。

Oracle_Home/user_projects/domains/Domain_Name/bitools/bin/datamodel.shまたはWindowsの場合はdatamodel.cmd

クライアント・インストールにドメイン名がない場合、ランチャ・スクリプトの場所は次のようになります。

Oracle_Home\bi\bitools\bin\datamodel.cmd

詳細は、コマンドを使用する前の必知事項を参照してください。

このコマンドが使用するRPDおよびWEBCATプラグインの詳細は、ユーザーおよびアプリケーション・ロール・コマンドの概要を参照してください。

構文

renameusersコマンドは、次のパラメータをとります。

renameusers -T usernames.json[-L plugin list] -SI service instance -U cred username[-P cred password] [-S hostname] [-N port number] [-SSL] [-H]

説明

Tは、サーバー・インスタンスのユーザー名の変更を含むJSON入力ファイルの名前を指定します。アプリケーション・ロール入力ファイルの正しい構文の詳細は、ユーザーの名前変更JSON入力ファイルの作成の例を参照してください。

Lは、1つのプラグインの実行またはデフォルトのプラグイン実行順序を逆にすることを指定します。プラグインは、システムがリポジトリまたはOracle BIプレゼンテーション・カタログあるいはその両方に更新を適用する場合を決定します。RPDおよびWEBCATプラグインの使用方法の詳細は、ユーザーおよびアプリケーション・ロール・コマンドの概要を参照してください

注意:

Lには次のオプションがあります。

• RPD: このオプションを指定して、リポジトリのユーザー名のみ変更します。

• WEBCAT: このオプションを指定して、Oracle BIプレゼンテーション・カタログのユーザー名を変更します。たとえば、Oracle BIプレゼンテーション・カタログのユーザー名を変更する場合、-L WEBCATオプションを使用する必要があります。

• WEBCAT,RPD: このオプションを指定して、デフォルトのプラグイン実行順序を逆にします。デフォルトのプラグイン実行順序は、リポジトリ(RPD)、Oracle BIプレゼンテーション・カタログ(WEBCAT)の順になります。

• デフォルトの順序でプラグインを実行する場合は、このオプションを省略します。

SIは、コンポーネント・インスタンスの名前を指定します。

Uは、Oracle BI EE認証に使用する有効なユーザー名を指定します。

Pは、Uに指定したユーザーの名前に対応するパスワードを指定します。パスワードを指定していないと、コマンドの実行時にパスワードの入力を求められます。セキュリティ上の目的のため、自動化されたスクリプティングを使用してコマンドを実行する場合のみコマンドにパスワードを含めることをお薦めします。

Sは、Oracle BI EEホスト名を指定します。クライアント・インストールからコマンドを実行している場合のみ、このオプションを含めます。

Nは、Oracle BI EEポート番号を指定します。クライアント・インストールからコマンドを実行している場合のみ、このオプションを含めます。

SSLは、SSLを使用してOracle WebLogic Serverに接続してコマンドを実行することを指定します。クライアント・インストールからコマンドを実行している場合のみ、このオプションを含めます。

Hは、使用方法の情報を表示し、コマンドを終了します。-Hを使用するか、パラメータを指定しないで.shを実行すると、ヘルプ・コメントが表示されます。

例

datamodel.sh renameusers -T usernames.json -SI bi -U weblogic -P password -S server1.example.com -N 7777 -SSL

ユーザーの名前変更JSON入力ファイルの作成

次の構文を使用して、ユーザーの名前変更JSON入力ファイルを作成します。

{
    "Title":"Target Users",
    "Users":[
          { "oldname":"<current_user1>", "newname":"<new_user1>" },
          { "oldname":"<current_user2>", "newname":"<new_user2>" },
          { "oldname":"<current_user3>", "newname":"<new_user3>" }
    ]
}