自動アップグレードに失敗した MID サーバーを手動で復元またはアップグレードする方法DescriptionMID サーバーの想定した自動アップグレードが失敗した場合の問題、または失敗したインストールや不足しているファイルを修復するするための、MID サーバーの手動アップグレード手順です。 この手順は最後の手段であり、通常は原因を特定するために Now Support (HI) でサポートケースをオープンしていただく必要があります。原因となった構成ミスが解消されない場合は、アップグレードのたびにこの手順を続けなければならないかもしれません。CauseMID サーバーのインストールや自動アップグレードが失敗する原因はいくつか考えられます。MID サーバーの agent\logs フォルダーから agent0.log.0 ファイルと wrapper.log ファイルをコピーし、アップグレードサービスが失敗した場合は temp フォルダーから upgrade-wrapper.log ファイルをコピーすることで、通常はエラーとログから関連する PRB を特定できます。これらの PRB に特化した KB 記事では、再発を防ぐために、より破損の可能性が少ないワークアラウンドや、MID サーバーの修正方法が見つかる場合があります。 これらの原因のいくつかは、この簡単な方法で解決でき、時間を大幅に節約できます。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 running (KB0779816 ServiceNow プラットフォームディストリビューションアップグレードサービスの途中でクラッシュし、MID サーバーが停止してサービスが実行されなくなった後に MID サーバーのアップグレードを続行する方法)KB1646639/PRB1734629 wrapper.conf.のファイルロックが原因で、MID Server が java.nio.file.FileSystemException で失敗する (Washington パッチ 4 で修正済み) ノート: 既存のファイルを新しいファイルで上書きする他の手順を見たことがあるかもしれません。この手順が、既存のフォルダを上書きするのではなく、新しいフォルダから開始する理由は、次の点に注意してください。 既存のファイルにはファイルロックはありません。新しいバージョンに存在しなくなった余分なファイルは残していません。MID Serverの実行中にその場で生成された破損または誤った一時ファイルは保持されません。 注意: この手順では、キーストアも意図的に削除され、MID Server にキーストアの再作成が強制され、再度検証が要求されます。つまり、MID Server Web サーバー拡張用に統一キーストアに追加された証明書、Web サーバーの TLS 証明書、および Web サーバーとの mTLS 認証用の証明書は、最後に手動で再度追加する必要があります。Resolutionアップグレード前の手順： 失敗したアップグレードのログや他の詳細を保存しておき、後で原因を究明できるようにします。次のような必要な情報と構成設定を収集します。 MID サーバーがログインに使用するインスタンスユーザーのインスタンスユーザー名とパスワード。このユーザーは MID サーバーのフォームに表示されます。プロキシサーバーを使用している場合は、プロキシサーバーの詳細、ユーザー名、パスワードなど、プロキシサーバーの情報。MID サーバーを実行しているホストサーバー、インストールフォルダー、およびそのサービス名。[ホームフォルダー] フィールドは MID Server フォームにはありませんが、リスト ビューに簡単に追加できます。管理者としてホストサーバーへのリモートデスクトップアクセス権を持っている。 次のファイルをバックアップします。 agent\config.xmlagent\conf\wrapper-override.confagent\jre\lib\security\cacerts注: アップグレードの失敗により JRE フォルダ全体が見つからない場合、このファイルが失われる可能性があります。これに証明書を追加しない限り、問題ありません。 ServiceNow インスタンスから現在の MID サーバーのフルパッケージをダウンロードする [MID サーバー] > [ダウンロード] に移動します。下部にあるチェックボックスにチェックを入れて、Zipファイルのリンクを再表示します。ダウンロードする MID Server ホストのプラットフォームの ZIP 形式のリンクを選択します。ZIP ファイルを MID サーバーホストにコピーします。ZIP ファイルを一時フォルダーに解凍します。ZIP ファイルの解凍中にエラーがないことを確認します。 MID Server がまだ実行中で稼働している場合の追加ステップ: これらの手順を本当に実行する必要があるかどうかを判断します。通常、原因が特定されれば、他の破壊的でない解決策があります。このプロセスでは、ネットワーク、通信、または認証の問題は解決されません。特に本番インスタンスで実行する場合は、作業中に MID サーバーを使用するスケジュール設定済みジョブが発生していないことを確認してください。現在「準備完了」または「処理中」ステータスとなっている MID サーバーの ECC キュー出力レコードがないことも確認してください。ecc_queue レコードのステータスを [エラー] に変更すると、MID Server がバックアップされるとすぐに実行されなくなります。MID サーバーサービスを停止します。 修復手順: 既存の MID サーバーインストールフォルダーに移動し、既存の「agent」フォルダーの名前を変更して別の場所に移動します。 将来混乱が生じないように、「agent_old-do_not_run」などの名前を使用してください。オペレーティング システムでファイルがまだ使用されているためにこれが不可能な場合は、 [サービスの起動] を [手動] に設定し (起動時に実行されないようにするため)、ホスト サーバーの OS を再起動してファイルを解放します。 「agent」フォルダーが元あった場所に、先程解凍した「agent」フォルダーを移動します。同等のバックアップ ファイルの情報と以前に収集した資格情報に基づいて、次のファイルを手動で更新します。 config.xml url、mid.instance.username、mid.instance.password、namemid_sys_id - MID Server が重複と見なされないようにするために必要その他の考えられるカスタム値： mid.proxy.use_proxy、および mid.proxy.* の各種パラメーター (プロキシが MID サーバーとインスタンスの間で使用されている場合)threads.max、threads.expedited.max、threads.interactive.max (デフォルトと異なる場合) instance.date.format (デフォルトと異なる場合) conf/wrapper-override.conf wrapper.name、wrapper.displayname。 注：これらは、既存の Windows サービス名や表示名と一致する必要があります。不一致が原因でアップグレードが失敗した場合は、ここで Windows サービスと一致するように修正します。 SSL証明書が追加されたカスタムcacertsファイルがある場合は、バックアップの「cacerts」ファイルを「agent\jre\lib\security」フォルダ内のファイルの上にコピーします。これはトラストストアで、デフォルトでルート CA 証明書の標準セットが含まれています。内部ルート CA 証明書と、統合エンドポイントへの接続を許可するために必要な追加の証明書を追加した可能性があります。これは統合キーストアとは異なります。MID Server サービスを開始します。インスタンス内の MID Server にステータスが [稼働中] と表示されるまで待ちます。MID Server は最初の起動後に自動的に再起動することが予想されるため、再起動が発生するまで数分待ってから [Up (稼働中)] のままにします。起動しない場合は、agent0.log.0 とwrapper.logを確認して、原因を特定してください。MID Server フォームの [検証] をクリックします。これにより、MID Server の別の自動再起動がトリガーされますが、その後は [Up] になり、フォームには [Validated] と表示されます。 統合キーストアに証明書を追加した場合(非常にまれ)、またはカスタムキーペアを使用していた場合(非常にまれです): ホスト マシン上の MID Server サービスを再度停止します。agent\bin\scripts\install-certificate.bat/.sh スクリプトを使用して、これらを再び追加できます。 カスタムキーペアの追加方法については、次を参照してください。 MID Server 統一キーストアWeb サーバー証明書の追加方法については、以下を参照してください。 セキュアな MID Web サーバー拡張の設定 MID Server サービスを開始します。 Additional Informationこの手順が失敗した場合は、新たに MID サーバーをインストールし、失敗した MID サーバーと同様の機能/IP 範囲/アプリケーションをセットアップし、失敗した MID サーバーで使用していた機能とジョブ、およびクラスターを再構成して、新しい MID サーバーを使用する必要があるかもしれません。 ドキュメントに記載されている通常の新規インストール手順に従います。MID サーバーのファイルのダウンロードMID サーバーのインストール