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

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. の後に渡すことで、アップグレードを再開できます。

How to Reset the Database User Password

You can customize the database user password. However, if you are upgrading your system, you may have forgotten the password. How you reset the database user password depends on whether the Enterprise Console has discovered the Controller.
Use the Enterprise Console CLI commands to:

  1. Log in to the Enterprise Console.

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

    Replace EC_GUI_PASSWORD with your actual value.

  2. Reset the database user password.

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

    Replace <platform_name> and <password> with your actual values.

As a result, an Enterprise Console job is generated where you can verify the success of the password reset.

If the Enterprise Console has NOT discovered the Controller
Note: Downtime is required to change the Controller Database user password. If you have installed a Controller HA pair, you must disable auto-failover to avoid an accidental failover while changing the password. For more details, refer to the

Automatic Failover

section.
  1. Log in to the database as the root user by running the following command: 
    platform-admin/bin/platform-admin.sh login --user-name admin --password EC_GUI_PASSWORD
  2. Execute the following queries, replacing <new_password_here> before executing the query.
    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. Verify the login by running the following command in the <controller_home>/db/bin 
    ./mysql -u controller -p -P 3388 -h 127.0.0.1
  4. Obfuscate the password using Secure Credential Store (SCS) tool.It gives you the obfuscated password.
    CODE 
    <platform-dir>/jre/<version>/bin/java -jar <controller-home>/tools/lib/scs-tool.jar obfuscate -plaintext '<new_password_here>
  5. Update the following field with the obfuscated password in the <controller_home>/appserver/jetty/etc/webapp-common.xml file.
    CODE 
    <Call name="setProperty">
<Arg>database.password</Arg>
<Arg>[Specify the Obfuscated Password]</Arg>
</Call>
    Warning: In the case of a Controller HA pair, repeat the above steps on the secondary controller server.

  6. Restart the Appserver.