人手によるユーザー・アカウントのマイグレーション

SAN ボリューム・コントローラー・コンソールのバージョン 4.3.1 から バージョン 5.1.0 にアップグレードする際、インストール・プログラムは、 現在クラスターに定義されているユーザー・アカウントをマイグレーションしようとします。 これらのアカウントのマイグレーションがインストール・プログラムの使用で失敗する場合は、 SAN ボリューム・コントローラー・コンソールをインストールする際に指定した ディレクトリー内の support フォルダーにある pmigrate.bat ファイルを使用して、 ユーザー・アカウントを手動でマイグレーションすることができます。 手動方式では、失敗の考えられる原因を示す詳細メッセージが提供されます。

始める前に

人手によるマイグレーション・コマンドは、クラスターがまだバージョン 4.3.1 を実行している間に実行する必要があります。 SAN ボリューム・コントローラー・クラスターを バージョン 5.1.0 にアップグレードした後で、ユーザーをマイグレーションすることはできません。
注: ユーザー・アカウントをマイグレーションする元のクラスターがファイアウォールの後ろにある場合は、 必ずファイアウォールに対して認証を行ってから、ユーザー・アカウントの人手によるマイグレーションを試行してください。

このタスクについて

pmigrate.bat ファイルは、Windows® のコマンド・プロンプトから起動され、 次のフォーマットになっています。
pmigrate PasswordFile=<Location of proxy CIMOM password file>
RoleFile=<Location of proxy CIMOM role file>
CimomIPAddress=<eCIMOM address> CimomPassword=<eCIMOM password>
[CimomUser=<eCIMOM username>]

このフォーマットでは、CIMOM パスワードはクラスターの管理者パスワードであり、CIMOM IP アドレスは クラスターの IP アドレスです。 インストール・プログラムは、CIMOM パスワードを cimserver.passwd ファイルに 保存し、CIMOM の役割定義を roles.txt ファイルに保存します。これらのファイルは両方とも最新のバックアップ・ディレクトリーに保管されます。 これらのファイルを指定するときは、これらのファイルが入れられているディレクトリーに絶対パスを組み込んでください。 eCIMOM username は、superuser でなければなりません。 手動でユーザー・アカウントをマイグレーションするには、以下の手順を実行します。

手順

Windows のコマンド・プロンプトで、次のコマンドを入力する。
 "C:¥Program Files¥IBM¥svcconsole¥support¥pmigrate.bat"
      PasswordFile="C:¥Program Files¥IBM¥svcconsole¥backup009
      ¥cimserver.passwd"
      RoleFile="C:¥Program Files¥IBM¥svcconsole¥backup009¥roles.txt"
      CimomUser=superuser
      CimomIPAddress=1.1.1.1
      CimomPassword=mypassword
この例では、バックアップ・ディレクトリーは backup009、 CIMOM パスワード・ファイルは cimserver.passwrd という名前、CIMOM の役割ファイルは roles.txt という名前です。

タスクの結果

この例では、ユーザー・アカウントを正常にマイグレーションすると、以下の結果を出します。
SVC Command Line Utility Version IBM-SVC-SMIS-Agent-5.1.0 
	Returning default value AgentDirectory=<C:¥Program Files¥IBM¥svcconsole¥cimom>
	Customization property file=<C:¥Program
    Files¥IBM¥svcconsole¥cimom¥svcutil.properties> is not present.
	Found CimomIPAddress=<1.1.1.1>  on command line
	Returning default value CimomIPPort=<5989>
	Returning default value CimomProtocol=<https://>
	Found CimomUser=<superuser> on command line
	Connected to: https://1.1.1.1:5989
	Found PasswordFile=<C:¥Program Files¥IBM¥svcconsole¥backup009¥cimserver.passwd>
    on command line.
	Found 	RoleFile=<C:¥Program Files¥IBM¥svcconsole¥backup009¥roles.txt> on
    command line.
	Enumerating instances of:IBMTSSVC_ObjectManager
	Enumerating instances of:IBMTSSVC_Cluster
	CIM_AGENT_INFORMATION: Connected to CIM Agent running on cluster <MyCluster> at 
    software version <4.3.	1.7>
	Enumerating instances of:IBMTSSVC_User
	>>> Invoking method: makeEncrypted
	with input parameters:
	[0] : CIMArgument(name=name, value="newadmin")
	[1] : CIMArgument(name=encryptedPassword, value="admin1")
	[2] : CIMArgument(name=role, value=0)
	<<< Method <makeEncrypted> returned value: 0 	ADD_USER_SUCCESS: Successfully 
    added user <newadmin> with role <Administrator(0)>
>>> Invoking method: makeEncrypted
	with input parameters:
	[0] : CIMArgument(name=name, value="newmonitor")
	[1] : CIMArgument(name=encryptedPassword, value="monitor1")
	[2] : CIMArgument(name=role, value=3)
	<<< Method <makeEncrypted> returned value: 0
	ADD_USER_SUCCESS: Successfully added user <newmonitor> with role <Monitor(3)>
	Restarting CIM Agent....
	Sending shutdown message to CIM Agent
	>>> Invoking method: BeginShutdown
	CIMOM appears to have exited during shutdown call
 

人手によるマイグレーションが失敗した場合、エラー・メッセージがマイグレーションの結果に表示されます。 表 1には、 ユーザー・アカウントのマイグレーションが失敗したときに生成される、考えられるエラー・メッセージのすべてがリストされています。

表 1. ユーザー・アカウント・マイグレーションのエラー・メッセージおよび解決
マイグレーション・エラー 解決
Customization property file <****> is not present. 解決が必要ない、小さいマイグレーション問題を示します。
Invalid hostname: "https://1.1.1.1.1" クラスターの現在の IP アドレスおよびプロトコルを入力します。
ERROR: Could not find the file <***> 指定したバックアップ・ディレクトリーにパスワード・ファイルまたは役割ファイルがないことを示します。
Exception in thread "main" org.sblim.wbem.cim.CIMTransportException: EXT_ERR_UNBLE_TO_CONNECT; nested exception is: クラスターへの接続問題を示します。 このエラーは、ネットワーク接続問題がある場合、またはユーザー名またはパスワードが無効な場合に起こる可能性があります。 接続およびユーザー名とパスワード情報を確認してください。
ライブラリー | サポート | ご利用条件 | フィードバック
(C) Copyright IBM Corporation 2003, 2010. All Rights Reserved.