単一コントローラのアップグレード

Enterprise Console を使用して、単一ノードのコントローラインスタンスをオンボードおよびアップグレードできます。GUI の [Custom Install Discover & Upgrade] オプションを使用すると、プラットフォームを作成し、コントローラを検出できます。

あるいは、すでにプラットフォームを作成済みの場合は、発見を実行する前に、プラットフォームに認証情報とホストを追加する必要があります。その後、そのページでコントローラを検出します。コントローラを検出するということは、Enterprise Console がプロファイル、テナンシーモード、既存のドメイン構成、データベース構成など、既存のコントローラデプロイの情報を保有していることを意味します。この情報はアップグレードの実行に使用されます。

アップグレードについて

Enterprise Console では、20.2 以上から最新バージョンまで、コントローラのアップグレード（スタンドアロンと HA ペア）をサポートしています。状況に応じた一連のアクションを確認するには、次の表を使用します。

現在のコントローラのバージョン アップグレード後のコントローラバージョン 実行するアクション
Equal to version 20.2 or later コントローラバージョン 20.2 または最新バージョン
  1. MYSQL を 5.7 バージョンへアップグレードします。
  2. サポートされている OS バージョンにアップグレードします。「オペレーティングシステムおよびコンポーネントとのコントローラの互換性」を参照してください。
  3. ダウンロードポータルにアクセスし、コントローラバージョンをダウンロードします。
  4. Enterprise Console を使用して、既存のコントローラバージョンから目的のコントローラバージョンにアップグレードします。

GUIを使用したコントローラのアップグレード

適用可能なコントローラアップグレードがある場合、GUIのCustom InstallページかControllerページでアップグレードプロセスを開始できます。

注: アップグレードの前に、コントローラとデータベースが実行されていることを確認します。アップグレード中に、Enterprise Console が入力されたデータベース ルート パスワードとコントローラ ルート パスワードを検証します。

コントローラの最新バージョンへのアップグレード

コントローラを最新バージョンにアップグレードするには、コントローラのアップグレード機能を使用します。

  1. 開始する前に、Enterprise Console の前提条件を満たしていることを確認します。
  2. 最新バージョンに Enterprise Console をアップグレードします。
  3. ブラウザを開き、GUI に移動します。デフォルトポートは 9191 です。 
    http(s)://<hostname>:<port>
  4. プラットフォームの [Controller] ページに移動します。
  5. アップグレードするコントローラホストを選択します。
  6. Upgrade Controller を選択します。
  7. ドロップダウンから利用可能な Target Version を選択します。
    注: この一覧には、Enterprise Consoleで認識されるバージョンが含まれています。これらのバージョンから、現在のコントローラバージョンと同じまたはそれ以上のバージョンのみが一覧に表示されます。
  8. 必要なパスワードを入力し、[Submit] を選択します。

CLIを使用したコントローラのアップグレード

適用可能なコントローラアップグレードがある場合、アプリケーション CLI を使用してアップグレードプロセスを開始できます。

注: アップグレードの前に、コントローラとデータベースが実行されていることを確認します。アップグレード中に、Enterprise Console が入力されたデータベース ルート パスワードとコントローラ ルート パスワードを検証します。

コントローラの最新バージョンへのアップグレード

最新バージョンへのアップグレードは、Enterprise Console の [Controller] ページから、または以下のコマンドを使用して実行できます。

  1. 最新バージョンに Enterprise Console をアップグレードします。
  2. <Enterprise Console home directory>/platform-admin directory に移動します。
  3. 最後のセッションから1日以上経った場合には、以下のコマンドを使用してログインする必要があります。 
    bin/platform-admin.sh login --user-name <admin_username> --password <admin_password>
  4. 次のコマンドを使用して、コントローラにアップグレードを適用します。
    Linux
    CODE 
    bin/platform-admin.sh submit-job --service controller --job upgrade --platform-name <name_of_the_platform> --args controllerRootUserPassword=<controller_root_password> mysqlRootPassword=<db_root_password>
    Windows
    CODE 
    bin/platform-admin.exe cli submit-job --service controller --job upgrade --platform-name <name_of_the_platform> --args controllerRootUserPassword=<controller_root_password> mysqlRootPassword=<db_root_password>
    アップグレードが失敗した場合は、引数として useCheckpoint=true フラグを --args. の後に渡すことで、アップグレードを再開できます。

データベース ユーザ パスワードをリセットする方法

データベース ユーザ パスワードをカスタマイズできます。ただし、システムをアップグレードする場合に、パスワードを忘れてしまっている可能性があります。データベース ユーザ パスワードのリセット方法は、Enterprise Console がコントローラを検出したかどうかによって異なります。
Enterprise Console CLI コマンドを使用して、以下を行います。

  1. Enterprise Console にログインします。

    CODE 
    platform-admin/bin/platform-admin.sh login --user-name admin --password EC_GUI_PASSWORD

    実際の値で EC_GUI_PASSWORD を置き換えてください。

  2. データベース ユーザ パスワードをリセットします。

    CODE 
    platform-admin/bin/platform-admin.sh submit-job --platform-name <platform_name> --service controller --job update-passwords --args newDatabaseUserPassword=<password>

    実際の値で <platform_name> および <password> を置き換えてください。

その結果、Enterprise Console ジョブが生成され、パスワードのリセットが成功したことを確認できます。

Enterprise Console がコントローラを検出しなかった場合
注: コントローラ データベース ユーザー パスワードを変更するには、ダウンタイムが必要です。コントローラの HA ペアをインストールしている場合は、パスワードを変更する際に偶発的なフェールオーバーを回避するために、自動フェールオーバーを無効にする必要があります。詳細は、以下を参照してください。

自動フェールオーバー

セクションに指定します。
  1. 次のコマンドを実行して、ルートユーザとしてデータベースにログインします。 
    platform-admin/bin/platform-admin.sh login --user-name admin --password EC_GUI_PASSWORD
  2. 次のクエリを実行します。クエリの実行前に <new_password_here> を置き換えてください。
    MySQL 5.7 以前
    CODE 
    update mysql.user set authentication_string=password('<new_password_here>') where user like 'controller%'; flush privileges; quit;
    MySQL 8.0 以降 
    alter user 'controller'@'localhost' identified by '<new-password-here>';
flush privileges; quit;
  3. <controller_home>/db/bin で次のコマンドを実行し、ログインを確認します。 
    ./mysql -u controller -p -P 3388 -h 127.0.0.1
  4. Secure Credential Store（SCS）ツールを使用してパスワードを難読化します。これにより、難読化されたパスワードを取得できます。
    CODE 
    <platform-dir>/jre/<version>/bin/java -jar <controller-home>/tools/lib/scs-tool.jar obfuscate -plaintext '<new_password_here>
  5. 次のフィールドを <controller_home>/appserver/jetty/etc/webapp-common.xml ファイルの難読化されたパスワードで更新します。
    CODE 
    <Call name="setProperty">
<Arg>database.password</Arg>
<Arg>[Specify the Obfuscated Password]</Arg>
</Call>
    警告: コントローラ HA ペアの場合は、セカンダリ コントローラ サーバーで上記の手順を繰り返します。

  6. Appserver を再起動します。