KACE SMA をv12.0からv12.1へアップグレードする手順 (4257407)

この記事では KACE システム管理アプライアンス KACE Systems Management Appliance (SMA) を v12.0からv12.1へアップグレードする手順を説明します。

■はじめに

技術文書 KACE SMA 12.1

• リリースノート

  KACE Systems Management Appliance 12.1 Common Documents Release Notes

  新機能と強化点、廃止される機能、解決済みの問題、既知の問題、システム要件、アプライアンスの更新等

• 技術仕様 ( Technical Specifications for Virtual Appliances)

  仮想化インフラストラクチャ要件(Virtualization Infrastructure Requirements)

  ESXi 6.7以上(FreeBSD 12.xのため) 、Windows Server 2016 / Windows Server 2019 のHyper-V, Nutanix AOS 5.20.1.1 (LTS) 以上

• バージョン12.1 新着情報(337743)

■前提要件

• サーバーの最小バージョン: 12.0

• エージェントの最小バージョン: Agent 11.0 (サポートされないバージョンのアップデートは 【補足】 参照)

サーバーバージョンが前提を満たしていない場合、満たすように更新を行ってください。

参考記事: SMAサーバーおよびエージェントのアップグレードパス (4284819)

■推奨事項

1. バックアップファイルの取得

   バージョンアップ作業前にはKACE SMAのメンテナンスバックアップによる直近のバックアップをKACE SMA外部に保存しておくことを強く推奨します。

   KACE SMA上でのバックアップデータの作成は、毎日夜間のメンテナンス時刻で行われておりますのでFTPまたはブラウザから直近のファイルを外部にダウンロードするのみです。

(単一組織SMAの場合) 設定→「バックアップと復元」に移動します。

(複数組織SMAの場合) 組織をシステム に切り替えて 設定→「バックアップと復元」に移動します。

オフボード転送を設定してバックアップファイルを安全な場所に保管している場合、上述の作業は不要です。オフボード先に正しくファイルが保存されていることをご確認ください。

以下のファイルを取得します。

• ベースバックアップのダウンロード: yyyymmdd_k1_base_version.tgz

• 差分バックアップのダウンロード: yyyymmdd_k1_incr_version_YYYYMMDD.tgz

  詳細は次の記事をご確認ください：

  バックアップファイルを自動で指定のディレクトリに転送する方法 (260737) （SMAがSFTP/Amazon S3/Azure Blob Storage/Samba/FTP等を使用して転送先へアップロードする: 推奨）

  手動でK1000のバックアップを行いバックアップファイルを取得する方法 (176568) (FTPクライアント経由でSMAからダウンロードする)

KACE SMAでは一度上げたバージョンを直接ダウングレードすることはできません。詳細については以下の記事をご確認ください。

KACE SMAのバージョンをアップグレード前に戻す手順について（232620)

■アップグレードの手順

1. バージョン更新用ファイル(.kbin)の入手

   以下のページにアクセスし、画面上の サインイン からサインインします。サインインパスワードがわからない場合、パスワードのリセットを実施ください

   最新リリースのダウンロード https://support.quest.com/ja-jp/download-product-select

   検索欄にて、KACE Systems Management Appliance を検索して選択します。 その後、製品バージョン を選択して各ファイルのダウンロードを実施します。

   • 12.1 サーバー更新ファイル: k1000_server_12.1.168.kbin

       1. 製品バージョンから[12.1] を選択します。
       2. Update の「KACE Systems Management Appliance 12.1.168」あるいは その行の下矢印をクリックするとダウンロード選択がされます。
       3.   [ダウンロードに追加]→[今すぐダウンロード]をクリックしてダウンロードします。

   • 12.1 エージェント更新ファイル Agent Bundle:  k1000_agents_12.1.55.kbin

     1. 製品バージョンから[12.1] を選択します。
     2. Agent Bundles の「KACE Systems Management Appliance (SMA) 12.1.55 Agent Bundle」あるいは、その行の下矢印をクリックするとダウンロード選択がされます。
     3. [ダウンロードに追加]→[今すぐダウンロード]をクリックしてダウンロードします。

2. サーバー v12.1.168へのアップグレード

   1. SMAサーバーの管理コンソールに admin ユーザーでログイン後、下記の項目へと進みます。

      現在のバージョン が 12.0.149 を満たすことを確認します。

      • (単一組織の場合) KACE 管理コンソールにログインし、設定 | アプライアンスの更新 へ移動します。
      • (複数組織が有効の場合)KACE管理コンソールにログインし、組織: システム に切り替え、設定 | アプライアンスの更新 へ移動します。

   2. 更新を開始します。

      使用可能な更新 が 12.1.168 となっている場合には [今すぐ更新]ボタンを押します。

      使用可能な更新 が 12.1.168 となっていない場合 または 無し の場合、手動更新 にて、サーバー更新ファイル: k1000_server_12.1.168.kbin を指定して 更新 を押します。

       

      アップグレード画面が表示されている間、サーバーやサービスの再起動が行われます。手動でのSMAサーバーの再起動・停止/電源停止等は実施しないでください。

      Webブラウザから管理インターフェース画面の利用が可能になりましたら使用許諾の確認が表示されます。

      ログイン後、画面右側の ”サポートが必要な場合” のバーをクリックし、表示される情報アイコンをクリックして、 バージョン の表示が 12.1.168 となったことを確認してください。

      更新後、ダッシュボードに次のメッセージが表示されることがありますが更新後の初回のバックアップ後に発生しなければ問題はありません。

      - '緊急: 1つまたは複数のエラーが発生したためK1000の日ベースのバックアップが失敗しました：「ベースバックアップ」ファイルが存在しません。「増分バックアップ」が存在しません。購入したばかりのK1000では、最初のバックアップが実行されるまでこれらのメッセージが表示されます。このメッセージが表示され続ける場合は、サポートにお問い合わせください。'

      参考: アップグレード後、緊急のバックアップエラーが発生(155171)

      更新後、アプライアンスの更新 ページに次のメッセージが示されますがこれは問題性のないメッセージです。
      - 'アプライアンスのアップグレードを実行する場合、SMA でポート 52231 がアクセス可能で、コンソールのアップグレードを表示できることを確認してください（アップグレード中のみ利用可能）。'
      参考: 12.0以上に更新後「アプライアンスの更新」ページに情報メッセージが表示される (338657)
      
      重要 v12.1.168のままの場合　以下のhotfixを適用して12.1.169にしてください。
      KACE SMA の2022年9月緊急のセキュリティ更新がリリースされました (4368804)
       

3. エージェントの12.1 への自動更新

   自動でエージェントバンドルがダウンロードされた場合には以下のバンドル更新・確認の手順から実施します。 エージェントバンドルファイルを手動でアップロードする場合の適用の手順.から実施します。

   1. エージェントバンドルを更新します。

      • (単一組織の場合) KACE管理コンソールにログインし、 設定 | アプライアンスの更新 へ移動します。
      • (複数組織が有効の場合) KACE管理コンソールにログインし、組織:システムに切り替え、設定 | アプライアンスの更新 へ移動します。

   2. バージョン情報の確認 エージェント：使用可能なバージョンが 12.1.55 となっていることを確認します。

   3. バンドルの適用

      • (単一組織の場合) 設定 ｜ プロビジョニング へ移動します
      • (複数組織が有効の場合) 管理コンソールから（システムを”除く”）各組織で、設定 ｜ プロビジョニング へ移動します。

   4. エージェントのアップデート を開きます。

   5. 通知更新 にて アップデートの削除 をクリックします。登録済みのバンドルが削除されます。

   6. エージェントバンドル 12.1.55が利用可能な場合には [適用] を押します。 エージェントバンドルファイルを使用する場合、 バンドルされたエージェントファイル(.kbin) からエージェントバンドルファイル k1000_agents_12.1.55.kbin を選択してアップロードします。

      通知更新 の エージェントバージョン が 12.1.55 になったことをご確認ください。

   7. 登録済みのデバイスエージェント更新 （後からでも結構です)

      設定｜プロビジョニング｜エージェントのアップデート へ移動し、エージェント設定の有効欄にチェックが入っていることを確認します。

      個別デバイスおよびラベルで更新対象したいデバイスへ更新がスケジュールされます。 エージェントソフトウェアが更新されると、デバイスインベントリの エージェントのバージョン に新しいバージョンが反映されます。

      エージェントからサーバーに接続されていればチェックインの周期で更新がおこなわれますが、念のため一晩程度お待ちください。

      台数が多い場合にはネットワークへの負荷が懸念されます。一度にすべてのマシンに更新をするのではなくラベル等で指定して順次更新を進めるかレプリケーション共有を使用して負荷を調整ください。 （1台あたりWin:74MB,Mac:147MB,RHEL:62MB程度の転送が発生します）

エージェントの更新手順は以上となりますが アップデート後のタスク として「正常に完了していることの確認」「セキュリティ設定の確認」を実施いただくことをお勧めします。

重要: SMA v12.0以上では、エージェント管理デバイスをインベントリに追加するには、11.0以上のエージェントが必要かつ、検疫状態での手動承認を行うかトークンによる承認が必要となります。(v10.2およびそれより古いバージョンは完全に接続できません。)
エージェントの検疫について (328369)
バージョン11.0: トークンを使用するエージェントの手動インストール (328406)
バージョン11.0での新機能: 適切なトークンが組み込まれたエージェントインストーラーを取得する (328407)

【補足】互換性のないエージェントの更新について

更新後のサーバーでのエージェントバージョンが最小要件未満となる場合、自動更新によるアップデートは保証されません。（テクニカルサポートでは自動更新が機能する想定でのトラブルへの対応は行いません）
SMAサーバーおよびエージェントのアップグレードパス (4284819)

アップグレード前にサポート対象バージョンへ更新していただくか、困難な場合、サーバーアップグレード後に手動あるいはKACE以外の仕組みでの更新をご検討ください。

(1) Agent msiとmsiexecコマンドを使用して手動でインストールする(非対話、ホスト名指定、トークン指定)

msiexec /qn /i ampagent-xx.r.nn-x86_K1000Webサーバー名.msi TOKEN=トークン文字列 

あるいは

msiexec /qn /i ampagent-xx.r.nn-x86.msi HOST=K1000Webサーバ名 TOKEN=トークン文字列  

あるいは

msiexec /qn /i ampagent-xx.r.nn-x86_K1000Webサーバー名+トークン文字列.msi 

(2) 何らかのツールを使用してリモートでのインストールを行う

PSTools/PSexec を利用してKACE エージェントを遠隔操作する方法 (148209)

(3) ActiveDirectoryのGroupPolicyを使用する(非GPO Provisioning Tool)

GPO によるKACEエージェントインストール方法(111244)