eDirectoryサーバでeMBoxクライアントを実行する

eMBoxクライアントおよびSun JVM 1.3.1は、eDirectoryと同時にインストールされています。eDirectoryサーバの対話式モードでeMBoxクライアントを開始するには、次の操作を行います。

• NetWare、Linux、およびUNIX:コマンドラインから「edirutil -i」と入力します。
• Windows:「
  ドライブ\novell\nds\edirutil.exe -i」を実行します。

edirutilファイルは、eMBoxクライアントを実行するためのショートカットです。このファイルには、Java実行ファイルの場所とeMBoxがeDirectoryと同時にインストールされたデフォルトの場所が示されています。NetWareの場合、このファイルでは-nsオプションが指定されています(これはNetWareのJavaオプションで、「新規画面」を意味します)。(Java実行ファイルの場所は、eMBoxクライアント用にパスおよびクラスパスをセットアップするで示しているように手動で入力することもできます)。

管理対象のサーバに対してeMBoxコマンドラインクライアントを使用するには、ファイアウォール越しにアクセスできる必要があります。そのため、リモートで実行する場合は、VPNアクセスが必要となります。

ワークステーションでeMBoxクライアントを実行する

eDirectoryサーバではないコンピュータでeMBoxクライアントを使用するには、次の操作を実行します。

• eMBoxClient.jarファイルをeDirectoryサーバから目的のコンピュータにコピーします。
  • NetWare:sys:\system\embox\eMBoxClient.jar
  • Windows:\novell\nds\embox\eMBoxClient.jar
  • LinuxおよびUNIX:/opt/novell/eDirectory/lib/nds-modules/embox/eMBoxClient.jar
• Sun JVM 1.3.1がインストールされていることを確認します。
• 管理するサーバに対してeMBoxコマンドラインクライアントを使用するためには、ファイアウォール越しにアクセスできることを確認します。

サーバの場合とは異なり、ワークステーションの場合は、edirutilコマンドをショートカットとして使用してeMBoxクライアントを対話式モードで開始することはできません。パスおよびクラスパス内で環境をセットアップするか、パスをその都度手動で入力します。「eMBoxクライアント用にパスおよびクラスパスをセットアップする」を参照してください。

eMBoxクライアント用にパスおよびクラスパスをセットアップする

eMBoxクライアントがeDirectoryサーバで実行され、JavaまたはeMBoxClient.jarファイルの場所を変更していない場合、edirutilをショートカットとして使用してeMBoxクライアントを実行できます。(eDirectoryサーバでeMBoxクライアントを実行するを参照してください)。

ただし、デフォルトの場所を変更したか、またはeMBoxClient.jarファイルをサーバでないコンピュータ上で実行している場合、あるいはクラスパスを手動で入力したい場合は、eMBoxクライアントのパスおよびクラスパスをこのセクションの説明のようにセットアップする必要があります。

次の操作を実行すれば、eMBoxクライアントをコンピュータ上のどの場所からでも実行できます。

• Java実行ファイル(Java.exeなど)があるディレクトリをパスに追加するか、またはJavaがすでに実行されていることを確認します。

  サーバの場合、ほとんどはすでに実行されています。Windowsサーバ、Linuxサーバ、およびUNIXサーバでは、実行ファイルのディレクトリをパスに追加する必要があります。NetWareの場合、ディレクトリをパスに追加するのではなく、Javaが実行されている必要があります。

  ワークステーションの場合、手動セットアップが必要となる場合があります。たとえばWindowsでは、［スタート］>［設定］>［コントロールパネル］>［システム］の順にクリックします。［詳細設定］タブで［環境変数］をクリックし、PATH変数にパスを追加します。

  パスを手動で入力するには、次の操作を実行します。 Java実行ファイルへのパスが追加されていない場合、eMBoxを実行する前に、最初にコマンドラインでJava実行ファイルが含まれたディレクトリへ移動する必要があります。たとえば、Windowsで次のように入力します。
  cd c:\novell\nds\embox\jre\bin

• eMBoxClient.jarファイルへのパスを、クラスパスに追加します。

  NetWareサーバの場合:
  set ENVSET=パス\eMBoxClient.jar

  Windowsサーバまたはワークステーションの場合:
  set CLASSPATH=パス\eMBoxClient.jar

  LINUXサーバおよびUNIXサーバまたはワークステーションの場合:
  export CLASSPATH=パス/eMBoxClient.jar

  パスを手動で入力するには、次の操作を実行します。 クラスパスを指定するには、次のようにして、eMBoxを実行するたびにJavaの-cpフラグを使用する方法もあります。

  java -cp パス/eMBoxClient.jar embox -i

  たとえば、Windowsでは次のように入力します。
  java -cp c:\novell\nds\embox\eMBoxClient.jar embox -i

  警告:  NetWareサーバの場合のみ、異常終了を防ぐために-ns(「新規画面」を開くNetWareでのJavaオプション)を追加します。たとえば、次のように入力します。
  java -ns -cp sys:\system\embox\eMBoxClient.jar embox -i

これらの手順を実行した後は、次のコマンドを使用して、コンピュータ上のどの場所からでも対話式モードによるeMBoxクライアントを実行できます。

java embox -i

警告:  NetWareサーバの場合のみ、異常終了を防ぐために-ns(「新規画面」を開くNetWareでのJavaオプション)を追加します。たとえば、次のように入力します。
java -ns embox -i

Javaコマンドについては、Sun WebサイトにあるJavaのマニュアルを参照してください。

サーバにログインする

サーバにログインするには、サーバ名またはIPアドレス、および特定のサーバへ接続するためのポート番号を指定する必要があります。パブリックログインの場合、ユーザ名およびパスワードは必要ありません。

たとえば、eMBoxクライアントを対話式モードでオープンした後で、次のように入力します。

login -s 137.65.123.244 -p 8028 -u admin.mycompany  
-w mypassword -n

ポート番号についての詳細は、eDirectoryポート番号を確認するを参照してください。

使用言語、タイムアウト、およびログファイルを設定する

デフォルトの言語は、クライアントシステムの言語です。そのため、ほとんどの場合、特別に言語を設定する必要はありません。同様に、タイムアウトもほとんどの場合、デフォルトの設定で問題ありません。ログファイルを設定するには、ファイル名とファイルを開くモード(追加または上書き)を指定します。

次の表に、コマンド例を示します。

set -L en,de 

set -T 100

set -l mylog.txt -o

eMToolとそのサービスを表示する

サーバにログインしたら、listコマンドを使用して、そのサーバ上で使用できるサービスを表示できます。

listコマンドを使用すると、次に示すeMToolとそのサービスが動的に表示されます。

リストを強制的にリフレッシュするには、-rを使用します。サービスの詳細を表示するには、-tを使用します。コマンド形式だけを表示するには、-fを使用します。

次の表に、コマンド例を示します。

list

list -r

list -t backup

list -t dsrepair

list -t dsmerge -f 

特定のサービスを実行する

サーバにログインした後は、各eMToolサービスを使用してタスクを実行できます。例:

dsrepair.rld

backup.getconfig

詳細については、次を参照してください。

• eMBoxクライアントを使ったバックアップ/復元作業
• eMBoxクライアントを使用したツリーのマージ
• eMBoxクライアントを使用したデータベースの修復
• eMBoxクライアントのサービスマネージャeMToolを使用する

現在のサーバからログアウトする

現在のセッションからログアウトするには、次のコマンドを使用します。

logout

別のサーバにログインする場合は、自動的に現在のサーバからログアウトされるので、このコマンドは必要ありません。

eMBoxクライアントを終了する

eMBoxクライアントを終了するには、次のいずれかのコマンドを使用します。

exit

または

quit

単一タスク

コマンドラインから単一のeMBoxタスクをバッチモードで実行するには、コマンドに-tオプションを使用してツールとタスクを指定し、-iオプション（対話式モードを指定するオプション）を省くだけです。たとえば、次のように入力します。

java embox -s 137.65.123.244 -p 8028 -u admin.mycompany  
-w mypassword -l mylog.txt -t dsrepair.rld -n

警告:  NetWareの場合のみ、異常終了を防ぐために-ns(「新規画面」を開くNetWareでのJavaオプション)を追加します。たとえば、次のように入力します。
java -ns embox -s 137.65.123.244 -p 8028 -u admin.mycompany -w mypassword -l mylog.txt -t dsrepair.rld -n

異なるサーバ上で複数のタスクを実行する場合や、頻繁に実行するタスクの場合は、内部バッチファイルを使用する方が便利です。詳細については、次のセクション内部バッチファイル.を参照してください。

内部バッチファイル

eMBoxクライアントの内部バッチファイルを使用してeMBoxクライアントをバッチモードで実行するには、対話式モードで実行するようなeMBoxコマンドのグループを含むファイルを作成する必要があります。

eMBoxクライアントの内部バッチファイルを使用すれば、バッチファイル内のすべてのコマンドを自動で実行できます。複数のeMBoxツールを使用した複数のタスクを、同一のサーバ上でタスクごとにログインとログアウトを繰り返すことなく実行できます。また1つのサーバから、複数のサーバに対して複数のeMBoxツールを使用したタスクを実行できます。

内部バッチファイルを使用すれば、頻繁に実行するコマンドの編成や再利用ができます。そのため、これらのコマンドを実行するたびに、コマンドラインから手動で入力する必要はありません。

内部バッチファイルの実行は、コマンドラインからeMBoxクライアントコマンドを使用して行います。たとえば、次のコマンドは、サーバにログインし、mybatch.mbxファイル内に列挙されたコマンドを実行します。

java embox -s 137.65.123.244 -p 8028 -u admin.mycompany -w mypassword -l mylog.txt -o -b mybatch.mbx -n

警告:  NetWareの場合のみ、異常終了を防ぐために-ns(「新規画面」を開くNetWareでのJavaオプション)を追加します。たとえば、次のように入力します。
java -ns embox -s 137.65.123.244 -p 8028 -u admin.mycompany -w mypassword -l mylog.txt -o -b mybatch.mbx -n

もう1つの方法は、同様のコマンドをシステムバッチファイル内に記述し、そのファイルがサーバ上で自動実行されるようにスケジュールすることです。「システムバッチファイル」を参照してください。

次に、eMBox内部バッチファイルの例を示します。このファイルには、実行するコマンドの例および別のサーバへログインする例が記述されています。この例では、eMBoxクライアントを開いたときに、サーバにログインしているものと仮定しています。(それぞれのコマンドは、行を分ける必要があります。#で始まる行はコメントです。)

# This file is named mybatch.mbx. 
# This is an example of commands you could use in  
# an eMBox internal command batch file. 
 
# Backup commands  
backup.getconfig  
backup.backup -b -f mybackup.bak -l backup.log -t -e -w 
  
# DSRepair commands  
dsrepair.rld  
 
# Log in to a different server 
login -s 137.65.123.255 -p 8028 -u admin.mycompany -w mypassword -n 
 
# DSMerge commands  
dsmerge.pr -u admin.mycompany -p admin.mycompany -n mypassword # Schema Operations  
dsschema.rst  
dsschema.dse  
dsschema.rls  
dsschema.gsu  
dsschema.scc  
dsschema.irs -n LocalTree 
  
# DSService commands  
service.serviceList  
  
# End of example.

システムバッチファイル

他のコマンドラインツールと同様に、eMBoxクライアントコマンドが含まれたシステムバッチファイルを作成し、それらをコマンドラインから手動で実行したり、サーバ上で自動で実行されるようにスケジュールしたりできます。たとえば、バッチファイルとeMBoxクライアントによる無人バックアップで示す例のように、システムバッチファイルを使用して、自動でバックアップを実行できます。

1つのサーバから複数のサーバに対して、複数のeMBoxツールを使用したタスクを実行できます。

システムバッチファイルでは、eMBoxクライアントの単一コマンドと内部バッチファイルを組み合わせて使用できます。これにより、コマンドをより自由に実行でき、頻繁に実行するコマンドの編成や再使用ができます。詳細については、内部バッチファイルを参照してください。

バッチファイルを自動で実行する方法については、ご使用のオペレーティングシステムのマニュアルまたはサードパーティ製スケジューリングソフトウェアのマニュアルを参照してください。

注:  NetWareでは、サードパーティのスケジューリングソフトウェアが使用できます。また、サポート対象のツールではありませんが、Novell Technical SupportからCRON.NLMをダウンロードしてお使いいただけます。

Windowsの場合

1. ［スタート］>［設定］>［コントロールパネル］の順にクリックします。

2. Novell eDirectoryサービスアイコンをダブルクリックしてから、［トランスポート］タブをクリックします。

3. セキュアポート、または非セキュアポートを確認します。

   • 非セキュアポートを確認するには、HTTPの横のプラス記号をクリックします。
   • セキュアポートを確認するには、HTTPSの横のプラス記号をクリックします。

   ［Bound Transports(バインドされたトランスポート)］の横のプラス記号をクリックして、ポート番号を確認します。

NetWareの場合

サーバオブジェクトのネットワークアドレスプロパティに、ポートが表示されます。

サーバオブジェクトのネットワークアドレスプロパティは、次のツールで確認できます。

• iManagerで、［eDirectory管理］>［オブジェクトの変更］の順にクリックしてサーバオブジェクトを見つけ、［一般］タブのドロップダウンリストでネットワークアドレスを参照します。
• ConsoleOne^(R)で、サーバオブジェクトを右クリックするかまたはサーバオブジェクトを選択した状態で［オブジェクト］>［プロパティ］の順にクリックし、ネットワークアドレスのドロップダウンリストを参照します。

始めがhttp:またはhttps:で、終わりが/portalのネットワークアドレスを探します。これらのアドレスが、eMBoxツールが使用する非セキュアポートおよびセキュアポートです。

ポート番号の確認方法を次に示します。

• ネットワークアドレス内にポート番号が表示されている場合、その番号が割り当てられたポート番号です。

  たとえば、http://137.65.188.1:8028/portalの場合、ポート8028がeMBoxツールで使用されています。

• サーバのIPアドレスだけで、ポート番号が表示されていない場合、デフォルトのポート番号が使用されています。

  たとえば、https://137.65.188.1/portalの場合、IPアドレスの後にはポート番号が表示されていませんが、これはeMBoxツールでデフォルトのポート番号が使用されていることを示しています。デフォルトのポート番号は、NetWareでは8009、それ以外のプラットフォームでは8010です。

LinuxおよびUNIXの場合

次のコマンドを使用して、ポートを表示できます。

ndsconfig get | grep http

http.server.interface、その次にポート番号という表現で記述された行を探します。

また、NetWareの場合で説明している方法を使用し、iManagerまたはConsoleOneによりポート番号を確認することもできます。