1.12.4 一般ユーザでREST APIをインストールする
背景
- メモ
-
REST APIのインストール時は、/tmpおよび/var/tmpディレクトリ下のプログラムの実行を制限するnoexecオプション設定は実施しないでください。
noexecオプション設定状況は、mountコマンドで確認できます。
REST APIのインストールが完了したら、ディレクトリ下のプログラムの実行を制限する設定を実施してもREST APIの動作には影響ありません。
一般ユーザでREST APIをインストールした環境でREST APIを運用できるのは、インストールを実施した一般ユーザだけです。rootユーザ、またはほかの一般ユーザではREST APIを運用できません。
- ヒント
バージョン8.5.3より前のConfiguration Manager REST APIは、rootユーザでだけ運用できます。そのため、バージョン8.5.3より前からアップグレードインストールする場合で、かつ一般ユーザでREST APIを運用をしたいときは、次の手順を実施して環境を移行してください。同じバージョンのREST APIを、rootユーザで運用する環境から、一般ユーザで運用する環境に移行したいときも同様に、次の手順を実施して環境を移行してください。
- 移行前の環境情報を事前に確認してください。
- rootユーザでREST APIをアンインストールします。
- 一般ユーザでREST APIをインストールします。
- 事前に確認しておいた環境情報をもとに、ストレージシステムを登録し直します。
リモートコピー操作を行う場合は、リモートストレージシステムの情報も登録し直してください。
インストール時の入力項目
インストール時に次の情報を指定するため、事前に確認してください。
- インストール先のパス（新規インストール時）
デフォルトのインストール先パスは次のとおりです。
/＜ユーザのホームディレクトリ＞/HiCommand
REST APIは、インストール中に指定したインストール先パスの下のConfManagerディレクトリにインストールされます。
REST APIのインストール先に指定できるパスの条件は次のとおりです。
- ユーザのホームディレクトリ、およびインストール先の絶対パスに指定できる文字：A～Z a～z 0～9 _ /
- 絶対パスの長さ：64バイト以内
- ディレクトリパスの最後が区切り文字（/）でない
- データベースのバックアップ先のパス（アップグレードインストールまたは上書きインストール時）
デフォルトのバックアップ先は次のとおりです。
/＜ユーザのホームディレクトリ＞/HiCommand/backup
前提条件
- REST APIをインストールする一般ユーザがホームディレクトリを持っていること
- REST APIで使用するポート番号を例外登録していること
-
COLUMNS環境変数が設定されていないこと
COLUMNS 環境変数が設定されている状態でアップグレードインストールまたは上書きインストールを実行すると、インストールが正常に終了しない可能性があります。
- REST APIに同梱されているRAID Managerを使用しているプログラムの停止
REST APIに同梱されているRAID Managerがインストールされた環境では、RAID Managerのファイルが使用されていると、REST APIのアップグレードインストール、上書きインストールができません。
操作手順
-
一般ユーザで管理サーバにログインします。
-
インストールメディアのすべてのファイルを、ユーザのホームディレクトリにコピーします。
-
インストーラ（install.sh）が格納されているディレクトリに移動します。
インストーラは、＜インストールメディアをコピーしたディレクトリ＞/ConfManagerディレクトリに格納されています。
-
次のコマンドを実行します。
./install.sh
-
表示されるメッセージに従って、必要な情報を指定します。
インストールが完了すると、次のメッセージが表示されます。
Configuration Manager REST API installation completed successfully.
-
（アップグレードインストールの場合）ストレージシステムの構成情報の更新状態を確認します。
-
ストレージシステムの構成情報の更新状態を取得するAPIを実行して、取得したstatus属性の値を確認します。
-
アップグレードインストールによってREST APIのデータベースが拡張された場合は、status属性の値がFailedと表示されます。この場合、エラー情報を確認し、ストレージシステムの構成情報を更新するAPIを実行します。
-