関連ページ：

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

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

アップグレードについて

Enterprise Console では、20.2.x 以上から最新バージョンまで、コントローラのアップグレード（スタンドアロンと 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 が入力されたデータベース ルート パスワードとコントローラ ルート パスワードを検証します。

コントローラの20.xから最新バージョンへのアップグレード

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

  1. 開始する前に、Enterprise Console の前提条件を満たしていることを確認します。

  2. Enterprise ConsoleのアップグレードEnterprise Console を最新バージョンにアップグレードします。

  3. ブラウザを開き、GUIに移動します。

    http(s)://<hostname>:<port>

    デフォルトのポートは9191です。

  4. プラットフォームの [Controller] ページに移動します。
  5. アップグレードするコントローラホストを選択します。
  6. [ Upgrade Controller] を選択します。

  7. ドロップダウンから、利用可能な対象バージョンを選択します。

    この一覧には、Enterprise Consoleで認識されるバージョンが含まれています。これらのバージョンから、現在のコントローラバージョンと同じまたはそれ以上のバージョンのみが一覧に表示されます。

  8. 必要なパスワードを入力し、[Submit] を選択します。

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

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

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

コントローラの20.xから最新バージョンへのアップグレード

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

  1. Enterprise Consoleのアップグレード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. 次のコマンドを使用して、コントローラにアップグレードを適用します。

    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>
    BASH 
    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>
    BASH

    アップグレードが失敗した場合は、引数として useCheckpoint=true フラグを --args. の後に渡すことで、アップグレードを再開できます。


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

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

Enterprise Console がコントローラを検出した場合

Enterprise Console CLI コマンドを使用して、以下を行います。

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

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

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

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

    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 ペアをインストールしている場合は、パスワードを変更する際に偶発的なフェールオーバーを回避するために、自動フェールオーバーを無効にする必要があります。詳細については、「Automatic Failover」セクションを参照してください。

  1. 次のコマンドを実行して、ルートユーザとしてデータベースにログインします。

    ./mysql --user=root -p --host=127.0.0.1 --port=3388 --protocol=TCP

  2. 次のクエリを実行します。クエリの実行前に <new_password_here> を置き換えてください。

    update mysql.user set authentication_string=password('<new_password_here>') where user like 'controller%'; flush privileges; quit;
    CODE 
    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）ツールを使用してパスワードを難読化します。

    <platform-dir>/jre/<version>/bin/java -jar <controller-home>/tools/lib/scs-tool.jar obfuscate -plaintext '<new_password_here>
    CODE

    これによりパスワードが難読化されます。

  5. 次のフィールドを難読化されたパスワードで更新します。

     <Call name="setProperty">
 	<Arg>database.password</Arg>
	<Arg>[Specify the Obfuscated Password]</Arg>
 </Call>
    CODE

    コントローラ HA ペアの場合は、セカンダリ コントローラ サーバーで上記の手順を繰り返します。


  6. Appserver を再起動します。