TeamCity On-Premises 2026.2 Help

TeamCity メンテナンスモード涉

TeamCity の始動時に TeamCity メンテナンスページが表示される場合、この TeamCity インスタンスを起動する前に技術的なメンテナンスが必要です。 ほとんどの場合、このページは、TeamCity インストールで想定されるデータフォーマットが、 データディレクトリ またはデータベース内のデータフォーマットと一致しない場合に表示されます。 たとえば、 アップグレード中、TeamCity はデータを新しいフォーマットに変換する前にこのページを表示します。

セキュリティ上の理由から、メンテナンスは TeamCity サーバーがインストールされている環境への管理アクセス権を持つ システム管理者 が実行する必要があります。 TeamCity がインストールされているコンピューターへのアクセス権が しない 場合は、TeamCity に技術的なメンテナンスが必要であることをシステム管理者に知らせてください。

TeamCity システム管理者の場合は、このページの対応するフィールドに 認証トークン を入力して確認してください。 このトークンは、 <TeamCity ホームディレクトリ>/logsteamcity-サーバー.ログ ファイルにあります。

このトークンを提供した後、必要なメンテナンスの種類の詳細を確認できます。 次のいずれかの要因が原因である可能性があります。

TeamCity データのアップグレード

TeamCity インスタンスを更新するとき、インストール済みの TeamCity バージョンは、 TeamCity データディレクトリ とデータベースが新しい TeamCity バージョンで必要とされるものと同じデータフォーマットを使用しているかどうかを確認します。 新しいバージョンでデータ変換が必要な場合は、このページにデータ形式の詳細が表示されます。 注意深く確認して、データディレクトリとデータベースの場所が実際にサーバーで使用されることを意図したものであることを確認してください。

以前にデータをバックアップしたことがない場合は、この時点で、提供されているオプションを使用してバックアップしてください。 バックアップ処理には、特に大規模な TeamCity インストールでは時間がかかる場合があることに注意してください。 バックアップする他の方法については、 この記事で詳しく説明しています。

TeamCity がデータを変換すると、ダウングレードはできなくなります。 以前の TeamCity バージョンに戻す必要がある場合は、対応するバックアップからデータを復元することによってのみ戻すことができます。

データがバックアップされたら、 アップグレード をクリックします。

新しい TeamCity データフォーマット

TeamCity は、データフォーマットが実行しようとしている TeamCity バージョンより新しい TeamCity バージョンに対応していることを検出しました。 ダウングレードはサポートされていないため、実行する TeamCity バージョンのフォーマットに一致するデータを用意するまで、TeamCity は起動できません。 これを行うには、バックアップから必要なデータを復元します。 手順については、この記事を参照してください。

TeamCity 始動エラー

TeamCity の始動時に重大なエラーが発生した場合、このページにエラーメッセージが表示されます。 続行するには、エラーの原因を修正して TeamCity サーバーを再起動する必要があります。

TeamCity データベースの作成

外部データベースを使用して TeamCity を設定するとき、または 外部データベースに移行した後にこの画面が表示された場合は、 続行 をクリックして TeamCity 用の新しいデータベースを作成してください。

2026 年 9 月 11 日