MID Serverのアップグレード前のチェック
アップグレードの前に、MID Server はテストを実行して、アップグレードプロセスが失敗したり、MID Server が機能停止したりする可能性がある問題を特定します。
各 MID Serverには、MID Serverのバージョンとインスタンスのバージョンを比較して MID Serverのアップグレードが必要かどうかを判断する、AutoUpgrade モニターが含まれています。AutoUpgrade モニターにより MID Serverのバージョンが古くなっていることが検出されると、その MID Serverのアップグレード前の妥当性確認テストが実行されます。問題が検出された場合は、MID Serverの問題 [ecc_agent_issue] テーブルにメッセージが記録され、アップグレードがブロックされます。AutoUpgrade モニターは、テストにすべて合格するまで 1 時間ごとに実行され続けます。ブロックの原因となる問題がない場合、MID Serverは適切なアップグレード パッケージをダウンロードし、アップグレード プロセスを開始します。MID Server のアップグレード前チェックは、インスタンスのアップグレード時にインスタンスによってトリガーされたアップグレードと、手動アップグレードに対しても実行されます。
アップグレード前のテスト
アップグレード前には、必須テストとアラートテストという 2 セットのテストが実行されます。MID Server のアップグレードを開始するには、すべての必須テストに合格する必要があります。必須テストに合格しなかった場合、テストはエージェントログに記録され、MID Server のアクティブな問題が MID Server の問題 [ecc_agent_issue] テーブルに作成されます。これらのエラーは実際の MID Serverのアップグレードが行われる前に公開され、アップグレードを続行する前に解決する必要があります。MID Server はアップグレードプロセスを停止し、MID Server のステータス に基づいてステータスを変更します。アラートテストに合格しなかった場合、エージェントログと MID Server の問題テーブルにメッセージが追加されますが、アップグレード前のチェックは続行され、MID アップグレードは停止しません。
- 1 GB 以上の空きディスクスペース
- ダウンロードサイト (install.service-now.com) へのアクセス
- ダウンロードしたサンプルファイルのデジタル署名の確認
- 実行権限。以下が含まれます。
- temp フォルダーへの ZIP アーカイブの展開
- temp フォルダーから agent フォルダーへのファイルのコピー
- テキストファイルの読み取り、およびコンテンツの検証
- アップグレード前のチェックコンテンツの削除
- MID Server ホストマシンが 32 ビットシステムではない
- Linux MID Server では、glibC のバージョンが 2.17 以上
- すべての MID Server アップグレードブロッカーサービスがホストマシンで実行されている
- ホストマシンでのアプリケーションエクスペリエンスのステータス
- Windows サービスの [ログオンユーザー (Log On As user)] が、LocalSystem か、ローカル管理者グループに属しているユーザーであることを確認します。デフォルトでは、コンピューターをドメインに参加させるときに、ローカル管理者グループにドメイン管理者が追加されます。
アップグレードをブロックするエラー
- 空きディスク スペースが不足しています。システムにより <n> バイトの空きがレポートされています (Not enough free disk space. The system reports <n> bytes free)
- このメッセージは、MID Server ホストで 1 GB 未満の空きディスクスペースが検出された場合に表示されます。このエラーは、MID Serverのエージェント ログにも書き込まれます。
- インストールサーバーから更新をダウンロードできません (Unable to download updates from the install server)
- このメッセージは、MID Server ホストに install.service-now.com からインストールパッケージをダウンロードする権限がないか、ネットワークの問題により接続が妨げられていることを示しています。このエラーは、MID Serverのエージェント ログにも書き込まれます。
- 署名の検証に失敗しました：<メッセージ> (Signature verification failed:<message>)
- このメッセージは、アップグレード前のチェックでダウンロードしたチェックファイルのデジタル署名を検証しようとしたときに、検証例外が発生したことを示します。
- デジタル署名を検証できません：<メッセージ> (Unable to verify digital signature:<message>)
- このメッセージは、検証署名プロセスが例外によって中断されたことを示します。
- アップグレード前のチェック zip の内容を展開できません (Unable to extract contents of pre upgrade check zip)
- このメッセージは、MID Server ホストのサービスアカウントに、アップグレード前の ZIP アーカイブを一時フォルダーに展開する権限がないことを示しています。
- フォルダーを作成できません <アップグレードチェックパス> (Unable to create folder <upgrade check file path>)
- このメッセージは、MID Server のサービスアカウントに、アップグレード前のチェックファイル用の upgradeCheck フォルダーを agent/package パスに作成する権限がないことを示しています。
- ファイルの権限を確認できません：<メッセージ> (Unable to verify file permissions: <message>)
- このメッセージは、ファイルの権限を確認したときに、存在しないファイルやアクセスの失敗などの例外が発生したことを示しています。
- MID Server Windows サービスが LocalSystem またはローカル管理者として実行されていません (MID Server Windows Service is not running as LocalSystem or a local Administrator)
- このメッセージは、Windows サービスが適切な権限で実行されていないことを警告しています。
- アップグレードの失敗：ホストマシンが、MID Server をアップグレードするための最小システム要件を満たしていません。(Upgrade Failure: The host machine does not meet the minimum system requirements to upgrade the MID server.)
- MID アップグレードは 32 ビットホストではサポートされていません。詳細については、KB0863694 を参照してください。
- アップグレードの失敗：ホストが、 MID Server をアップグレードするための最小システム要件を満たしていません。詳細については、GlibC ライブラリの MID Server 製品ドキュメントを参照してください。(Upgrade Failure: Host does not meet the minimum system requirements to upgrade the MID server. Please refer to MID Server product documentation on GlibC library for more information)
- このエラーは、Linux MID Server でのみ発生する可能性があります。詳細については、「Java バージョンのサポート」を参照してください。
ブロックされない警告
- $logOnAsUser を解析できません (Unable to parse $logOnAsUser)
- このメッセージは、Windows サービスの [ログオンユーザー (Log On As User)] の値が、次のいずれかの期待される形式になっていないことを警告しています。
- user@domain.company.com
- domain\user
- ログオンユーザーのグループを検索できません (Unable to look up Log On As user's groups)
インスタンスは、ログオンユーザーのグループメンバーシップの検索を試みる際に、net user <username> コマンドを実行します。インスタンスは、このコマンドから Windows サービスによる特定の出力構造を期待し、期待される出力が実際の出力と一致しない場合はこの警告を発行します。
これらの PowerShell の警告は、MID Server のエージェントログにのみ書き込まれます。PowerShell は MID Serverを使用する必要がないため、これらの構成の問題は Windows MID Serverのアップグレードを妨げません。ただし、これらの警告は、注意が必要な環境内の問題を示している可能性があります。
- PowerShell が使用できないため、PowerShell のアップグレードチェックをスキップします (kipping PowerShell upgrade checks since PowerShell is not usable)
- (最低限の) PowerShell 3.0 がインストールされていないか、MID Server サービスユーザーが powershell.exe を利用できません。
- Powershell テストをスキップ：ターゲットフォルダーが初期化されていません (Skipping Powershell test: Target folder has not been initialized)
- Powershell テストをスキップ：サービス名を検出できません (Skipping Powershell test: Unable to detect the service name)
- MID Server ホストマシンで実行されているサービス CiscoAMP は、MID Server アップグレードブロッカーとして識別されます (Service CiscoAMP running on the MID Server host machine is identified as a MID Server upgrade blocker)
- 詳細については、KB0870329 を参照してください。
- MID Server ホストでアプリケーションエクスペリエンスが無効になっているため、自動アップグレードプロセスが失敗し、MID Server がダウンする可能性があります。自動アップグレードを確実に成功させるには、ホストでサービスを有効にします (The Application Experience is disabled on the MID Server host, which can cause the auto-upgrade process to fail and the MID Server to go down. Enable the service on the host to ensure successful auto-upgrade)
- 詳細については、KB0597552 を参照してください。
- アップグレードを続行しますが、upgradeCheck 中に次の問題が発生しました：<例外メッセージ> (Continuing with upgrade, but the following issue was encountered during upgradeCheck: <exception message>)
- このメッセージは、アップグレード前のテストの PowerShell 部分の実行中に問題が発生したことを示しています。
アップグレード前のチェックの無効化
mid.upgrade.run_precheck という名前の MID Serverの設定パラメーターは、デフォルトで true に設定されています。これにより、自動的にアップグレード前のテストを実行できます。単一の MID Server でこのテストを無効にするには、その MID Server の config.xml ファイルにこのパラメーターを追加して、false に設定します。すべての MID Serverでこのテストを無効にするには、mid.upgrade.run_precheck という名前の新しいレコードを MID Server プロパティ [ecc_agent_property] テーブルに追加します。このプロパティの値を false に設定し、[MID Server] フィールドは空のままにします。