自動アップグレードに失敗した MID サーバーを手動で復元またはアップグレードする方法Issue <!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } 注: このナレッジ記事が更新およびテストされるまでは、この方法を Basic Authentication を使用して認証する MID Server には使用しないでください。private key JWT または mTLS 相互認証を使用している場合は、ユーザー証明書を使用してキーストアを再設定する必要があるため、この方法は機能しない可能性があります。 MID Server の想定される自動アップグレードが失敗した場合、または破損したインストールや欠落したファイルを修復するための MID Server 手動アップグレード手順です。 この手順は最終手段と考慮すべきです。通常は、原因を特定するために HI でサポートケースをオープンしていただくようお願いしています。原因となる設定ミスが残っている場合は、アップグレードのたびにこの手順を繰り返す必要が生じる可能性があります。 警告: お客様がテクニカルサポートに相談する前にこの手順を試すことで、状況がさらに悪化することがよくあります。この手順では多くの根本原因は解決されず、次回のアップグレードが失敗するまでの一時的な回避策にしかならない可能性があります。 Release<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } すべてのリリース Cause<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } MID Server のインストールが破損する場合や、自動アップグレードが失敗する場合には、いくつかの原因が考えられます。MID Server の agent\logs フォルダーから agent0.log.0 ファイルおよび wrapper.log ファイルをコピーし、アップグレードサービスが失敗した場合は temp フォルダーから upgrade-wrapper.log ファイルもコピーすることで、通常は確認されたエラーおよびログから特定の PRB を識別できます。これらの PRB に固有の KB 記事には、より影響の少ない回避策や、同じ問題が再発しないように MID Server を修正する方法が記載されている場合があります。 これらの原因の一部は、この簡単な方法で解決できます。これにより多くの時間を節約できます。 KB0779816 How to continue a MID Server upgrade after it has crashed in the middle of the ServiceNow Platform Distribution Upgrade service, leaving the MID Server Down and the Service not runningKB1646639 / PRB1734629 Mid server is failing with java.nio.file.FileSystemException, due to a file lock on wrapper.conf. (Washington Patch 4 で修正済み) 注: 既存のファイルを新しいファイルで上書きする他の手順を見たことがあるかもしれません。この手順が既存のフォルダーを上書きするのではなく、新しいフォルダーから開始する理由は、次の点を確実にするためです。 既存のファイルにファイルロックが存在しないこと新しいバージョンに存在すべきではない余分なファイルを残さないことMID Server の実行中に動的に生成された破損または誤った一時ファイルを保持しないこと 注: この手順では、意図的にキーストアも削除されるため、MID Server はキーストアを再作成し、再度 Validation が必要になります。つまり、Unified Keystore に追加されていた証明書、MID Server Web Server 拡張用の証明書、Web サーバーの TLS 証明書用の証明書、および Web サーバーとの mTLS 認証用の証明書は、最後に手動で再度追加する必要があります。 Resolution<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } アップグレード前の手順 後で原因を特定できるよう、失敗したアップグレードのログおよびその他の詳細情報を保存します。必要な情報および構成設定を収集します。 MID Server がログインに使用するインスタンスユーザーの Instance Username および Password。このユーザーは MID Server フォームに表示されます。使用している場合は、プロキシサーバー、ユーザー名、パスワードを含むプロキシサーバー情報。MID Server を実行しているホストサーバー、そのインストールフォルダー、およびサービス名。Home folder フィールドは MID Server フォームにはありませんが、リストビューに簡単に追加できます。管理者としてホストサーバーにリモートデスクトップでアクセスできること。 次のファイルをバックアップします。 agent\config.xmlagent\conf\wrapper-override.confagent\jre\lib\security\cacerts注: 失敗したアップグレードにより JRE フォルダー全体が失われている場合、このファイルも失われている可能性があります。このファイルに追加の証明書を追加したことがなければ問題ありません。 ServiceNow インスタンスから現在の完全な MID Server パッケージをダウンロードします。 MID Server - Downloads に移動します。下部のチェックボックスを選択して ZIP ファイルのリンクを表示します。MID Server ホストのプラットフォームに対応する ZIP 形式のリンクを選択してダウンロードします。ZIP ファイルを MID Server ホストにコピーします。ZIP ファイルを一時フォルダーに展開します。ZIP ファイルの展開時にエラーが発生していないことを確認します。 MID Server が引き続き稼働中 (Up) の場合の追加手順 これらの手順を本当に実施する必要があるか判断します。通常は、原因が特定されれば、より影響の少ない他の解決策があります。この手順ではネットワーク、通信、または認証の問題は解決されません。特に PRODUCTION インスタンスで実施する場合は、手順実施中に MID Server を使用するスケジュール済みジョブが実行されないことを確認します。また、MID Server の ECC Queue 出力レコードに Ready または Processing 状態のものが存在しないことを確認することも推奨されます。ecc_queue レコードのステータスを Error に変更すると、MID Server が再び稼働した直後にそれらが実行されることを防止できます。MID Server サービスを停止します。 修復手順 既存の MID Server のインストールフォルダーに移動し、既存の agent フォルダーの名前を変更して別の場所へ移動します。 将来混乱しないように、agent_old-do_not_run などの名前を使用します。オペレーティングシステムによってファイルがまだ使用中であるためにこれができない場合は、サービスのスタートアップを Manual に設定し(起動時に実行されないようにするため)、ファイルを解放するためにホストサーバーの OS を再起動します。 新たに展開した agent フォルダーを、元の agent フォルダーの場所へ移動します。対応するバックアップファイルの情報と、事前に収集した認証情報を基に、次のファイルを手動で更新します。 config.xml url,mid.instance.username,mid.instance.password,namemid_sys_id (MID Server が重複として認識されないようにするために必要)その他の可能性のあるカスタム値: mid.proxy.use_proxy および各種 mid.proxy.* パラメーター(MID Server と Instance の間で Proxy を使用している場合)threads.max、threads.expedited.max、threads.interactive.max(デフォルト値と異なる場合)instance.date.format(デフォルト値と異なる場合) conf/wrapper-override.confwrapper.namewrapper.displayname注: これらは既存の Windows Service 名および表示名と一致している必要があります。不一致が原因でアップグレードが失敗した場合は、この時点で Windows Service と一致するように修正できます。 SSL 証明書を追加したカスタム cacerts ファイルがある場合は、バックアップした cacerts ファイルを agent\jre\lib\security フォルダー内のファイルへコピーします。これは Truststore であり、デフォルトで標準の Root CA 証明書一式が含まれています。内部 Root CA 証明書や、統合エンドポイントへの接続を許可するために必要な追加の証明書を追加している場合があります。これは Unified Keystore とは異なります。MID Server Service を起動します。インスタンス内の MID Server が Up ステータスになるまで待機します。MID Server は初回起動後に自動的に再起動することが想定されるため、その再起動が発生し、その後も Up の状態を維持することを確認するために数分待機します。起動しない場合は、原因を把握するために agent0.log.0 および wrapper.log を確認してください。MID Server フォームで Validate をクリックします。これにより MID Server が再度自動的に再起動されますが、その後は Up となり、フォームには Validated と表示されます。 Unified Keystore に追加の証明書を追加していた場合(非常にまれ)、または Custom Keypair を使用していた場合(極めてまれ) ホストマシン上の MID Server Service を再度停止します。agent\bin\scripts\install-certificate.bat/.sh スクリプトを使用して、これらを再度追加できます。 Custom Keypair を再度追加する方法については、以下を参照してください。MID Server unified key storeWeb Server 証明書を再度追加する方法については、以下を参照してください。Configure a secure MID Web Server extension MID Server Service を起動します。 Related Links<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } この手順が失敗した場合は、新たに MID サーバーをインストールし、失敗した MID サーバーと同様の機能/IP 範囲/アプリケーションをセットアップし、失敗した MID サーバーで使用していた機能とジョブ、およびクラスターを再構成して、新しい MID サーバーを使用する必要があるかもしれません。 ドキュメントに記載されている通常の新規インストール手順に従います。MID サーバーのファイルのダウンロードMID サーバーのインストール