名前 | 形式 | 機能説明 | 使用例 | 終了ステータス | ファイル | 属性 | 関連項目 | 警告 | 注意事項
luupgrade コマンドは、Solaris オペレーティング環境の Live Upgrade 機能を提供するコマンド群の 1 つです。Live Upgrade 機能については、live_upgrade(5) のマニュアルページを参照してください。
luupgrade コマンドは、指定したブート環境 (BE) にソフトウェアをインストールできるようにします。具体的な機能は次のとおりです。
BE 上のオペレーティングシステムイメージをアップグレードする (-u オプション)。Solaris フラッシュアーカイブなど、有効な Solaris インストール媒体をイメージのソースとして指定できる
インストーラプログラムを実行し、インストール媒体からソフトウェアをインストールする (-i オプション)
BE 上に Solaris フラッシュアーカイブを抽出する (-f オプション)。flar(1M) のマニュアルページを参照
BE にパッケージを追加する (-p)。または、BE から パッケージを削除する (-P)
BE にパッチを追加する (-t)。または、BE からパッチを削除する (-T)
パッケージに関する情報をチェックします (-I)。または、パッケージの情報を確認する (-C)
オペレーティングシステムのインストール媒体を確認する (-c)。
luupgrade を使用する前に、lucreate(1M) コマンドまたは、FMLI ベースのユーザーインタフェース lu(1M) を使って BE を作成しておきます。アップグレードできるのは、現在の BE 以外の BE です。
これらの機能では、それぞれに固有のオプションを使用できます。各機能で使用可能なオプションについてはその機能の説明を参照してください。
luupgrade を正しく完了するには、lustatus(1M) で取得される BE のステータスが、complete でなければならないことに注意してください。なお、lumount(1M) または mount(1M) でディスクスライスがマウントされている BE に対しては、luupgrade を実行できません。
luupgrade コマンドを実行するには、root 権限が必要です。
次のオプションは、どのような目的で luupgrade を実行する場合でも指定できます。
エラーメッセージと状態メッセージを、現在の環境での書き込み先だけでなく、error_log にも書き込みます。
すべてのコマンド出力を、現在の環境での書き込み先だけでなく、outfile にも書き込みます。
コマンド引数の指定が正しいかどうかを確認できる dry-run モードです。-c (媒体の検査) には適用されません。
XML 出力を有効にします。XML の特性は DTD (/usr/share/lib/xml/dtd/lu_cli.dtd.<num>) に定義されています。<num> は、各 DTD ファイルのバージョン番号を示します。
オペレーティングシステムのイメージをアップグレードするには、luupgrade コマンドに -u を指定します。この場合の構文は次のとおりです。
luupgrade -u -n BE_name -s os_image_path [ -j profile_path ] [ -l error_log ] [ -o outfile ] [-N] |
最初のオプション -u は、OS イメージのインストールを実行することを示します。この luupgrade を使用する場合に指定可能なその他のオプションは、次のとおりです。
OS をアップグレードする BE の名前のどちらでも指定できます。
OS イメージが格納されているディレクトリのパス名を指定します。CD-ROM などのインストール媒体上のディレクトリか、NFS または UFS ディレクトリのどちらでも指定できます。
JumpStart プロファイルのパスを指定します。luupgrade で呼び出すプロファイルで使用する有効なキーワードのリストについては、後述のセクション「JumpStart プロファイルのキーワード」を参照してください。JumpStart ソフトウェアについては、pfinstall(1M) のマニュアルページと Solaris のインストールマニュアルを参照してください。
指定した BE のディスク構成に対して -j で指定されたプロファイルの値をテストします。このオプションの結果は、プロファイルをテストする事前実行です。luupgrade はその出力に指定されたログファイルを作成するので、コマンドの結果を調べることができます。
複数のコンポーネントから成る媒体からアップグレードを行う場合 (複数の CD からアップグレードを行う場合など) は、-i オプションを指定して、2 番目以降の媒体からソフトウェアをインストールできるようにします。具体的には、次の項を参照してください。
インストーラプログラムを実行するには、luupgrade コマンドに -i を指定します。この場合の構文は次のとおりです。
luupgrade -i -n BE_name -s installation_medium [ -N ] [ -O "installer_options" ] [ -l error_log ] [ -o outfile ] |
最初のオプション -i は、-s で指定されたインストール上のインストーラプログラムを実行することを示します。この luupgrade を使用する場合に指定可能なその他のオプションは次のとおりです。
ソフトウェアのインストール先となる BE の名前を指定します。
Solaris インストーラプログラムに直接渡されるオプションを指定します。インストーラオプションについては、installer(1M) を参照してください。
インストール媒体のパス名を指定します。CD などのインストール媒体上のディレクトリか、NFS または UFS ディレクトリのどちらでも指定できます。
-i オプションを指定すると、luupgrade は指定した媒体上でインストールプログラムを検索し、実行します。
-i オプションを前述の -u オプションと組み合わせて指定すると、複数のコンポーネントから成る媒体 (複数の CD など) からインストールを行えます。
Solaris フラッシュアーカイブからオペレーティングシステムをインストールするには、luupgrade コマンドに -f を指定します。アーカイブをインストールすると、ターゲットとなる BE のすべてのファイルが上書きされることに注意してください。この場合の構文は次のとおりです。
luupgrade -f -n BE_name -s os_image_path ( -a archive | -j profile_path | -J "profile" ) [ -l error_log ] [ -o outfile ] [ -N ] |
最初のオプション -f は、Solaris フラッシュアーカイブから OS のインストールを行うことを示します。この luupgrade を使用する場合に指定可能なその他のオプションは次のとおりです。
OS のインストール先となる BE の名前のどちらでも指定できます。
OS イメージが格納されているディレクトリのパス名を指定します。CD-ROM などのインストール媒体上のディレクトリか、NFS または UFS ディレクトリのどちらでも指定できます。
ローカルファイルシステム上でアーカイブが使用可能な状態になっているときは、Solaris フラッシュアーカイブのパスを指定します。-a、-j、または -J のいずれかを指定する必要があります。
Solaris フラッシュインストール用に構成された JumpStart プロファイルのパスを指定します。luupgrade で呼び出すプロファイルで使用する有効なキーワードのリストについては、後述のセクション「JumpStart プロファイルのキーワード」を参照してください。JumpStart ソフトウェアについては、pfinstall(1M) のマニュアルページと Solaris のインストールマニュアルを参照してください。-a、-j、または -J のいずれかを指定する必要があります。
Solaris フラッシュインストール用に構成された JumpStart プロファイルのエントリを指定します。このオプションに有効な唯一のキーワードは、archive_location です。JumpStart ソフトウェアについては、pfinstall(1M) のマニュアルページと Solaris のインストールマニュアルを参照してください。-a、-j、または -J のいずれかを指定する必要があります。
指定した BE のディスク構成に対して -j または -J で指定されたプロファイルの値をテストします。このオプションの結果は、プロファイルをテストする事前実行です。luupgrade はその出力に指定されたログファイルを作成するので、コマンドの結果を調べることができます。
-s で指定した OS イメージのバージョンは、-a、-j、-J のいずれかのオプションで指定した Solaris フラッシュアーカイブ内の OS のバージョンと同じでなければなりません。
パッケージを追加する場合は、luupgrade コマンドに -p を指定します。パッケージを削除する場合は -P を指定します。構文は次のとおりです。
パッケージの追加:
luupgrade -p -n BE_name -s packages_path [ -l error_log ][ -o outfile ] [ -O "pkgadd_options" ] [ -a admin ] [ pkginst [ pkginst...]] [ -N ] |
パッケージの削除:
luupgrade -P -n BE_name [ -l error_log ][ -o outfile ] [ -O "pkgrm_options" ] [ pkginst [ pkginst...]] [ -N ] |
最初のオプションは、パッケージを追加する場合は -p、削除する場合は -P を指定します。この luupgrade を使用する場合に指定可能なその他のオプションは次のとおりです。
パッケージの追加先または削除先となる BE の名前を指定します。
追加するパッケージが格納されているディレクトリのパス名を指定します (パッケージの追加の場合のみ)。-d オプションで代用することもできます。-d は、pkgadd(1M) との互換性を確保する目的でサポートされています。
-s オプションと同じです。-s オプションの使用をお勧めします。
パッケージを追加する場合 (-p) は pkgadd に直接渡されるオプション、削除する場合 (-P) は pkgrm に直接渡されるオプションを指定します。これらのコマンドのオプションについては、pkgadd(1M) のマニュアルページと pkgrm(1M) のマニュアルページを参照してください。
admin ファイルのパスを指定します (パッケージの追加の場合のみ)。pkgadd の -a オプションと同じ意味になります。ここでの -a オプションは、-O “-a admin” と同等です。
追加または削除するゼロ個以上のパッケージを指定します。パッケージを追加する場合、上記の -s オプションで指定したすべてのパッケージが追加されます (デフォルト)。複数のパッケージ名は空白文字で区切って指定します。
追加するパッケージは、すべて『SVR4 Advanced Packaging Guidelines』 に準拠していなければなりません。「警告」の項を参照してください。
パッチを追加する場合は、luupgrade コマンドに -t を指定します。パッチを削除する場合は -T を指定します。構文は次のとおりです。
パッチの追加:
luupgrade -t -n BE_name -s patch_path [ -l error_log ][ -o outfile ] [ -O "patchadd_options" ] [ patch_name [ patch_name...]] [ -N ] |
パッチの削除:
luupgrade -T -n BE_name [ -l error_log ][ -o outfile ] [ -O "patchrm_options" ] [ patch_name [ patch_name...]] [ -N ] |
最初のオプションは、パッチを追加する場合は -t、削除する場合は -T を指定します。この luupgrade を使用する場合に指定可能なその他のオプションは、次のとおりです。
パッチの追加先となる BE の名前、またはパッチを削除する BE の名前を指定します。
追加するパッチが格納されているディレクトリのパス名を指定します (パッチの追加の場合のみ)。
パッチを追加する場合 (-p) は patchadd に直接渡されるオプション、削除する場合 (-P) は patchrm に直接渡されるオプションを指定します。これらのコマンドのオプションについては、patchadd(1M) のマニュアルページまたは patchrm(1M) のマニュアルページを参照してください。
追加または削除するゼロ個以上のパッチを指定します。パッチを追加する場合、上記の -s オプションで指定したすべてのパッチが追加されます (デフォルト)。複数のパッチ名は空白文字で区切って指定します。
追加するパッケージは、すべて『SVR4 Advanced Packaging Guidelines』 に準拠していなければなりません。「警告」の項を参照してください。
-C を指定すると、BE 上のすべてのパッケージまたは指定したパッケージに対して pkgchk(1M) が実行されます。-I オプションを指定すると、pkginfo(1) が実行されます。
pkgchk の実行:
luupgrade -C -n BE_name [ -l error_log ][ -o outfile ] [ -O "pkgchk_options" ][ pkginst [ pkginst...]] [ -N ] |
pkginfo の実行:
luupgrade -I -n BE_name [ -l error_log ][ -o outfile ] [ -O "pkginfo_options" ][ pkginst [ pkginst...]] [ -N ] |
最初のオプションは、pkgchk の場合は -C、pkginfo の場合は -I を指定します。この luupgrade を使用する場合に指定可能なその他のオプションは、次のとおりです。
パッケージを確認する BE、またはパッケージ情報を表示する BE の名前を指定します。
pkgchk に直接渡されるオプション (-C) または pkginfo に直接渡されるオプション (-I) を指定します。これらのオプションについては、pkgchk(1M) のマニュアルページまたは pkginfo(1) のマニュアルページを参照してください。
チェックするゼロ個以上のパッケージ名、または情報を表示するゼロ個以上のパッケージ名を指定します。パッケージ名を省略すると、BE 上のすべてのパッケージ情報が返されます。複数のパッケージ名は空白文字で区切って指定します。
-c オプションを指定すると、CD などのローカル媒体または遠隔媒体が有効なインストール媒体であるかどうかを確認できます。-c オプションは、指定した媒体に関する有用な情報を返します。この場合の luupgrade の構文は次のとおりです。
luupgrade -c -s path_to_medium [ -l error_log ] [ -o outfile ] |
最初のオプション -c は、これから実行する処理 (インストール媒体のチェック) を示します。上記の -s オプションの働きは次のとおりです。
CD-ROM などのインストール媒体のパス名を指定します。
このセクションでは、luupgrade のプロファイルで使用できる Solaris JumpStart キーワードを指定します。-j オプションに -u (アップグレード) オプション、または -f (フラッシュ) オプションを組み合わせて使用します。-u オプションの場合、必須のキーワードはありません。-f オプションは、完全なフラッシュアーカイブの場合は値を install_type: flash_install に、差分フラッシュアーカイブの場合は値を flash_update に指定する必要があります。-j オプションと -f オプションを合わせて使用する場合は、-a (アクティブな位置) オプションを指定するか、またはプロファイル中で archive_location キーワードを指定する必要があります。
archive_location キーワードは -J オプションに有効な唯一の引数です。
以下のキーワードオプションは、-u オプションおよび -f オプションで使用するプロファイルに使用することがあります。
システムに追加するソフトウェアグループを指定します。
システムにインストール、または追加する地域ロケールまたはロケールを指定します。使用可能な値の一覧については、『Solaris のインストール』 を参照してください。
64 ビットまたは 32 ビットのどちらのパッケージをインストールするかを指定します。有効な値は 64 と 32 です。
システムにインストールまたは追加するロケールパッケージを指定します。使用可能な値の一覧については、『Solaris のインストール』 を参照してください。
システムに追加する、またはシステムから削除するパッケージを指定します。
次のキーワードは、luupgrade で使用するプロファイルに使用してはなりません。
boot_device
dontuse
fdisk
filesys
layout_constraint
noreboot
partitioning
root_device
usedisk
すべての JumpStart プロファイルキーワードの説明、および JumpStart プロファイルを作成する手順については『Solaris のインストール』 を参照してください。
次の例は、ブート環境から複数のパッケージを削除して、追加し直します。
# luupgrade -P -n second_disk SUNWabc SUNWdef SUNWghi |
同じパッケージを追加します。
# luupgrade -p -n second_disk -s /net/installmachine/export/packages \ SUNWabc SUNWdef SUNWghi |
次の例では、上記のコマンドに -O オプションを追加することにより、引数を直接 pkgadd に渡しています。
# luupgrade -p -n second_disk -s /net/installmachine/export/packages \ -O "-r /net/testmachine/export/responses" SUNWabc SUNWdef SUNWghi |
このコマンドのオプションについては、pkgadd(1M) のマニュアルページを参照してください。
次の例は、ブート環境上のオペレーティング環境をアップグレードします。ソースイメージは、リモートディスクまたは DVD 上に結合イメージとしてあります。
# luupgrade -u -n second_disk \ -s /net/installmachine/export/solarisX/OS_image |
上記のコマンドに続けて次のコマンドを実行すると、アップグレードした BE がアクティブになります。
# luactivate second_disk |
次回のリブート時に、second_disk が現在のブート環境になります。luactivate(1M) のマニュアルページを参照してください。
次の例は、これまでに紹介した例の応用です。OS のアップグレードは CD 2 枚に格納されています。SPARC マシン上でアップグレードを開始するには、次のコマンドを入力します。
# luupgrade -u -n second_disk -s /dev/cdrom/cdrom0/s0 |
Intel アーキテクチャ (IA) マシンでは、-s の引数 s0 を s2 で置き換えます。
1 枚目の CD の内容の処理が完了したら、ドライブに 2 枚目の CD を挿入し、次のコマンドを入力します。
# luupgrade -i -n second_disk -s /dev/cdrom/cdrom0 \ -O "-nodisplay -noconsole" |
継続してインストールするときは、-u オプションよりも -i を使用してください。3 枚目以降も同様に -i オプションを使用してください。上記の -O オプションは、installer(1M) に渡されます。これらのオプションを省略すると、CD の挿入と読み取りが完了した時点でグラフィカルユーザーインタフェースが起動します。-O オプションについては installer(1M) を参照してください。
複数の CD からアップグレードを行う場合、すべての CD に対して luupgrade コマンドを入力し、その実行が完了した時点でアップグレードが終了します。各 CD からパッケージをインストールした後、次のようなメッセージが出力される場合があります。
WARNING: <num> packages must be installed on boot environment <disk_device>. |
これは、上記の例のように、複数の CD からパッケージのインストールが必要であるということを示すものです。全パッケージのインストールが完了していないと、アップグレードの完了した BE を luactivate を使用して有効化 (ブート先として指定) することはできません。
次のコマンド例は、プロファイル /home2/profiles/test.profile をテストするのに -D オプションを使用しています。
# luupgrade -u -n second_disk \ -s /net/installmachine/export/solarisX/OS_image \ -j /home2/profiles/test.profile -D |
このコマンドの結果が満足できる内容の場合は、上記のコマンドから -D オプションを省略して、アップグレードを実行します。
次の例は、 Solaris フラッシュアーカイブを使ってブート環境上のオペレーティング環境をアップグレードします。-J オプションで指定するファイルは、フラッシュインストールを指定する JumpStart プロファイルです。
# luupgrade -f -n second_disk \ -s /net/installmachine/export/solarisX/OS_image \ -J "archive_location http://example.com/myflash.flar" |
次のコマンドが上記のコマンド例と異なるのは、 -j オプションが -J オプションに置き換わっている点だけです。どちらかのコマンドに -D オプションを追加すると、実際にフラッシュインストールを実行する前にプロファイルをテストできます。
# luupgrade -f -n second_disk \ -s /net/installmachine/export/solarisX/OS_image \ -j /net/example/flash_archives/flash_gordon |
先の 2 つのコマンドは、完全フラッシュインストール、または差分フラッシュインストールとして動作します。差分フラッシュインストールか完全フラッシュインストールかは、プロファイル中の install_type キーワードの値で決まります。前述の「JumpStart プロファイルキーワード」を参照してください。
次の例は、pkgchk に -v オプションを指定して、SUNWluu と SUNWlur の 2 つのパッケージに対して pkgchk を実行する例です。
# luupgrade -C -n second_disk -O "-v" SUNWluu SUNWlur |
次のコマンドは、上記の 2 つのパッケージに対して pkginfo を実行します。
# luupgrade -I -n second_disk -O "-v" SUNWluu SUNWlur |
どちらのコマンドの場合でも、パッケージ名を省略すると、指定した BE の全パッケージの情報が返されます。これらのコマンドのオプションについては、pkgchk(1M) のマニュアルページと pkginfo(1) のマニュアルページを参照してください。
システム上にある BE のリスト
Live Upgrade の DTD (「常に指定可能なオプション」の -X オプションを参照)
次の属性については、attributes(5) のマニュアルページを参照してください。
属性タイプ | 属性値 |
---|---|
使用条件 | SUNWluu |
installer(1M), lu(1M), luactivate(1M), lucancel(1M), lucompare(1M), lucreate(1M), lucurr(1M), ludelete(1M), ludesc(1M), lufslist(1M), lumake(1M), lumount(1M), lurename(1M), lustatus(1M), lutab(4), attributes(5), live_upgrade(5)
パッケージまたはパッチを追加する場合は (-p、-P、-t、-T のいずれかを指定)、『SVR4 Advanced Packaging Guidelines』および『Solaris 9 インストールガイド』の付録 C に記載されているガイドラインに準拠したパッケージまたはパッチを指定してください。これらに準拠したパッケージまたはパッチは、pkgadd(1M) または patchadd(1M) の -R オプション (説明については各ユーティリティのマニュアルページを参照) に準拠することになります。ほぼすべての Sun のパッケージおよびパッチがこのガイドラインに準拠していますが、Sun 以外のベンダーのパッケージはガイドラインに準拠していない場合があります。また、Sun の古いパッケージおよびパッチの中には、-R オプションに対応していないものがあります。そのようなパッケージまたはパッチを見つけた場合は、Sun に報告してください。準拠していないパッケージまたはパッチを指定すると、luupgrade のパッケージまたはパッチ追加ソフトウェアを実行したときに問題が発生したり、現在の BE が変更されてしまう可能性があります。
Live Upgrade は、配布中のリリース、および最大 3 つのリリースをさかのぼってサポートします。たとえば、Solaris 9 版 (Solaris 9 Upgrade 版を含む) の Live Upgrade バージョンを入手した場合、Solaris 9 に加えて Solaris バージョン 2.6、Solaris 7、および Solaris 8 版をサポートします。Solaris 2.6 より前のバージョンの Solaris をサポートする Live Upgrade バージョンは存在しません。
名前 | 形式 | 機能説明 | 使用例 | 終了ステータス | ファイル | 属性 | 関連項目 | 警告 | 注意事項