=============================================================================
                       NEC iLOアカウント登録ツール
                                                                  [UTF-8][LF]
=============================================================================
【対象機器】 iLO搭載装置
【対象ユーザー】 iLOのホスト認証を有効にしてお使いになるお客様
【対象OS】
  ・Red Hat Enterprise Linux 8.8 (以降)
     +- openssl-libs-1.1.1k-9.el8_7.x86_64 (以降)
  ・Red Hat Enterprise Linux 9.2 (以降)
     +- openssl-libs-3.0.7-6.el9_2.x86_64 (以降)
  ※Red Hat Enterprise Linuxのインストール媒体に同梱さている
    openssl-libsパッケージの提供している機能を使用します。
    OS最小構成でインストールされるため、インストールは不要です。
【対象製品】
  ・ESMPRO/ServerAgentService
  ・RAID Report Service
  ・装置情報収集ユーティリティ
=============================================================================
-----------------------------------------------------------------------------
目次
  1.概要
  2.使用方法
  3.動作確認
  4.バージョン・更新履歴
  a.付録
  a-1.メッセージ一覧
  a-2.アスキーコード一覧
-----------------------------------------------------------------------------


1.概要

  iLO搭載装置においてiLOのホスト認証を有効にしたとき、iLOから情報取得している
  対象製品は、iLOへアクセス不可になります。
  本ツールは、対象製品にiLOアカウント情報 (ログインユーザー名、パスワード) を
  通知するツールです。
  本ツールは、対象製品がiLOへアクセス可能にすることを目的としています。


2.使用方法

  ユーザー名は、1から39文字の半角英数字・半角記号を指定してください。

  パスワードは、0(パスワードなし)から39文字の半角英数字・半角記号を指定して
  ください。パスワードなしは、 "" と指定してください。

  半角英数字と半角記号は、アスキーコード 0x20～0x7e の範囲を指定してください。
  半角記号を指定する場合、半角記号の前に \ を入力してください。
    アンダーバーを指定する例：abC\_xYZ

  【iLOアカウント情報を登録する】
    1) rootユーザーでログインします。
    2) 以下のコマンドを実行します。
         # ./iLOUserSet -u username -p password
       実行した結果はメッセージを参照してください。

  【iLOアカウント情報を削除する】
    1) rootユーザーでログインします。
    2) 以下のコマンドを実行します。
         # ./iLOUserSet -d
       実行した結果はメッセージを参照してください。

  以下のようなreadコマンドを使用するスクリプトで、ユーザー名とパスワードが
  コマンド履歴に保存されるのを回避できます。
  -----
  #!/bin/bash
  #
  USERNAME=""
  PASSWORD=""

  read -p "Enter user name : " USERNAME
  read -s -p "Enter password : " PASSWORD
  ./iLOUserSet -u ${USERNAME} -p ${PASSWORD}
  -----


3.動作確認

  対象製品が正しく動作しているか確認してください。問題が発生している場合は
  以下のメッセージのイベントがsyslogに出力されます。
  イベントが出力される場合は、iLOアカウント情報を再設定してください。

      iLOへのログインに失敗しました。NEC iLOアカウント登録ツールを使用して
      アカウントを設定してください。


4.バージョン・更新履歴

  [バージョン] 1.00

  [更新履歴]
   2024/08/30 Ver.1.00
     - 新規作成


a.付録
a-1.メッセージ一覧
  ------------------------------------------------------------------------------
  戻り値  種別    メッセージ
                  --------------------------------------------------------------
                  説明
  ------------------------------------------------------------------------------
    0     正常    iLOUserSet: account data registered successfully.
                  --------------------------------------------------------------
                  ユーザー名とパスワードを設定しました。
  ------------------------------------------------------------------------------
    0     正常    iLOUserSet: account data deleted successfully.
                  --------------------------------------------------------------
                  ユーザー名とパスワードを削除しました。
  ------------------------------------------------------------------------------
    1     情報    Usage:
                  iLOUserSet -u username -p password
                  iLOUserSet -d
                  --------------------------------------------------------------
                  オプションの指定がありません。
                  ユーザー名とパスワードを指定してください。
  ------------------------------------------------------------------------------
    1     情報    iLOUserSet: input username is none.
                  --------------------------------------------------------------
                  ユーザー名がありません。
                  ユーザー名は1から39文字の半角英数字・半角記号を指定してください。
  ------------------------------------------------------------------------------
    1     情報    iLOUserSet: input username is too long.
                  --------------------------------------------------------------
                  ユーザー名が長すぎます。
                  ユーザー名は1から39文字の半角英数字・半角記号を指定してください。
  ------------------------------------------------------------------------------
    1     情報    iLOUserSet: input password is too long.
                  --------------------------------------------------------------
                  パスワードが長すぎます。
                  パスワードは0から39文字の半角英数字・半角記号を指定してください。
  ------------------------------------------------------------------------------
    1     情報    iLOUserSet: invalid option. {エラー情報}.
                  --------------------------------------------------------------
                  オプションの指定が正しくありません。
                  指定しているオプションを確認してください。
                  ユーザー名またはパスワードに半角記号を指定する場合、
                  半角記号の前に \ を入力してください。
                    アンダーバーを指定する例：abC\_xYZ
                  パスワードを指定しない場合、 "" と入力してください。
  ------------------------------------------------------------------------------
    1     情報    iLOUserSet: invalid option.
                  Usage:
                  iLOUserSet -u username -p password
                  iLOUserSet -d
                  --------------------------------------------------------------
                  オプションの指定が正しくありません。
                  指定しているオプションを確認してください。
                  半角記号を指定する場合、半角記号の前に \ を入力してください。
                    アンダーバーを指定する例：abC\_xYZ
                  パスワードを指定しない場合、 "" と入力してください。
  ------------------------------------------------------------------------------
    2     情報    iLOUserSet: need root privileges.
                  --------------------------------------------------------------
                  root権限が必要です。
                  rootユーザで実行してください。
  ------------------------------------------------------------------------------
    3     異常    iLOUserSet: failed to get LANG environment variable.
                  --------------------------------------------------------------
                  LANG環境変数の取得に失敗しました。
                  コンソールのLANG環境変数をUTF-8に設定して、再実行してください。
                    # export LANG=ja_JP.UTF-8
  ------------------------------------------------------------------------------
    3     異常    iLOUserSet: failed to convert of UTF-8. {エラー情報}.
                  --------------------------------------------------------------
                  文字コードの変換に失敗しました。
                  コンソールのLANG環境変数をUTF-8に設定して、再実行してください。
                    # export LANG=ja_JP.UTF-8
  ------------------------------------------------------------------------------
    3     異常    iLOUserSet: failed to load {エラー情報}.
                  --------------------------------------------------------------
                  ロードに失敗しました。
                  openssl-libsパッケージがインストールされているか確認ください。
                    # rpm -qa | grep openssl-libs
                  - openssl-libsパッケージがインストールされていない場合、
                    openssl-libsパッケージをインストールしてください。
                  - openssl-libsパッケージがインストールされている場合、
                    ロードの処理で何らかのエラーが発生しました。
                    後ほどもう一度実行してください。
  ------------------------------------------------------------------------------
    3     異常    iLOUserSet: failed to initialize. {エラー情報}.
                  --------------------------------------------------------------
                  初期化に失敗しました。
                  初期化の処理で何らかのエラーが発生しました。
                  後ほどもう一度実行してください。
  ------------------------------------------------------------------------------
    3     異常    iLOUserSet: failed to encryption. {エラー情報}.
                  --------------------------------------------------------------
                  暗号化に失敗しました。
                  暗号化の処理で何らかのエラーが発生しました。
                  後ほどもう一度実行してください。
  ------------------------------------------------------------------------------
    3     異常    iLOUserSet: failed to update username.
                  iLOUserSet: failed to open username for reading. {エラー情報}.
                  iLOUserSet: failed to change permission mode of username. {エラー情報}.
                  --------------------------------------------------------------
                  ユーザー名の設定に失敗しました。
                  ユーザー名を設定する処理で何らかのエラーが発生しました。
                  後ほどもう一度実行してください。
  ------------------------------------------------------------------------------
    3     異常    iLOUserSet: failed to delete username. {エラー情報}.
                  --------------------------------------------------------------
                  ユーザー名を削除する処理で何らかのエラーが発生しました。
                  後ほどもう一度実行してください。
  ------------------------------------------------------------------------------
    3     異常    iLOUserSet: failed to update password.
                  iLOUserSet: failed to open password for reading. {エラー情報}.
                  iLOUserSet: failed to change permission mode of password. {エラー情報}.
                  --------------------------------------------------------------
                  パスワードを設定する処理で何らかのエラーが発生しました。
                  後ほどもう一度実行してください。
  ------------------------------------------------------------------------------
    3     異常    iLOUserSet: failed to delete password. {エラー情報}.
                  --------------------------------------------------------------
                  パスワードを削除する処理で何らかのエラーが発生しました。
                  後ほどもう一度実行してください。
  ------------------------------------------------------------------------------

a-2.アスキーコード一覧
  --------------------------------------
  入力文字    半角文字    アスキーコード
  --------------------------------------
  \(スペース) (スペース)  0x20
  \!          !           0x21
  \"          "           0x22
  \#          #           0x23
  \$          $           0x24
  \%          %           0x25
  \&          &           0x26
  \'          '           0x27
  \(          (           0x28
  \)          )           0x29
  \*          *           0x2A
  \+          +           0x2B
  \,          ,           0x2C
  \-          -           0x2D
  \.          .           0x2E
  \/          /           0x2F
  0           0           0x30
  1           1           0x31
  2           2           0x32
  3           3           0x33
  4           4           0x34
  5           5           0x35
  6           6           0x36
  7           7           0x37
  8           8           0x38
  9           9           0x39
  \:          :           0x3A
  \;          ;           0x3B
  \<          <           0x3C
  \=          =           0x3D
  \>          >           0x3E
  \?          ?           0x3F
  \@          @           0x40
  A           A           0x41
  B           B           0x42
  C           C           0x43
  D           D           0x44
  E           E           0x45
  F           F           0x46
  G           G           0x47
  H           H           0x48
  I           I           0x49
  J           J           0x4A
  K           K           0x4B
  L           L           0x4C
  M           M           0x4D
  N           N           0x4E
  O           O           0x4F
  P           P           0x50
  Q           Q           0x51
  R           R           0x52
  S           S           0x53
  T           T           0x54
  U           U           0x55
  V           V           0x56
  W           W           0x57
  X           X           0x58
  Y           Y           0x59
  Z           Z           0x5A
  \[          [           0x5B
  \\          \           0x5C
  \]          ]           0x5D
  \^          ^           0x5E
  \_          _           0x5F
  \`          `           0x60
  a           a           0x61
  b           b           0x62
  c           c           0x63
  d           d           0x64
  e           e           0x65
  f           f           0x66
  g           g           0x67
  h           h           0x68
  i           i           0x69
  j           j           0x6A
  k           k           0x6B
  l           l           0x6C
  m           m           0x6D
  n           n           0x6E
  o           o           0x6F
  p           p           0x70
  q           q           0x71
  r           r           0x72
  s           s           0x73
  t           t           0x74
  u           u           0x75
  v           v           0x76
  w           w           0x77
  x           x           0x78
  y           y           0x79
  z           z           0x7A
  \{          {           0x7B
  \|          |           0x7C
  \}          }           0x7D
  \~          ~           0x7E
  --------------------------------------

=============================================================================
   Copyright NEC Corporation 2024
