外部データベースへの移行

データ移行なしの切り替え

外部データベースにすばやく切り替え、サーバー上のユーザーやビルドなどの 既存のデータを保持したくない場合は、以下の手順に従ってください。 切り替え後、サーバーは空のデータベースで起動しますが、TeamCity データディレクトリに保存されているすべての 設定を保持します (何がどこに保存されているかについては 詳細を参照してください)。

1. TeamCity で使用する 外部データベースを作成して構成します。

2. TeamCity サーバーをシャットダウンします。

3. サーバーが使用する <TeamCity データディレクトリ> の バックアップコピーを作成します。

4. system ディレクトリをクリーンアップします: 必要がありますmessages および アーティファクト ディレクトリを、 system ディレクトリ (<TeamCity データディレクトリ>) から除去します。 場合があります 古い HSQLDB ファイル buildserver.* を削除して、不要になった内部ストレージデータを除去します。

5. TeamCity サーバーを起動します。

完全移行

これらの手順では、すべてのデータを保持しながら別のデータベースに切り替える方法について説明します。 これは、TeamCity 移行ツール — maintainDB コマンドラインユーティリティで実行されます。

maintainDB.[cmd|sh] シェル/バッチスクリプトは、 <TeamCity ホームディレクトリ>/バイナリ ディレクトリにあり、TeamCity データの移行、 バックアップ 、および 復元に使用されます。 このユーティリティは、TeamCity .tar.gz および . exe ディストリビューションでのみ使用できます。

TeamCity は HSQLDB、 MySQL、 Oracle、 PostgreSQL 、および Microsoft SQL サーバー をサポートしています。これらのデータベース間では、いずれの組み合わせでも移行できます。

ターゲットデータベースは、移行プロセスの前に空である必要があります（テーブルを含んではいけません）。

既存のデータをすべて新しい外部データベースに移行するには:

1. TeamCity で使用する 外部データベースを作成して構成し、データベースドライバーを TeamCity にインストールします。 この段階では TeamCity の設定を変更しないでください

2. TeamCity サーバーをシャットダウンします。

3. 対応するテンプレート (<TeamCity データディレクトリ>/config/database.<データベース_タイプ>.properties.dist) を使用して、ターゲットデータベースのカスタム名 (database.<データベースタイプ>.properties など) を持つ一時プロパティファイルを作成します。 プロパティを構成し、ファイルを任意の一時ディレクトリに配置します。 元の database.<データベースタイプ>.properties ファイルを変更しないでください。

4. migrate コマンドで maintainDB ツールを実行し、 -T オプションで新しく作成されたターゲットデータベースプロパティファイルへの絶対パスを指定します。

   maintainDB.[cmd|sh] migrate -T <path to database.properties file>

   TEAMCITY_DATA_PATH 環境が TeamCity データディレクトリ を指していない場合は、コマンド呼び出しに -A パラメーターを追加します：

   maintainDB.[cmd|sh] migrate -A <path to TeamCity Data Directory> -T <path to database.properties file>

   データベース移行の正常な補完時に、一時ファイルは TeamCity で使用される <TeamCity データディレクトリ>/config/データベース.properties ファイルにコピーされます。 一時ファイルは安全に削除できます。 外部データベース間で移行する場合、ソースデータベースの元の database.properties ファイルは、 -T オプションで指定されたファイルに置き換えられます。 元の database.properties ファイルの名前は自動的に database.properties.before.<タイムスタンプ> に変更されます。

5. TeamCity サーバーを起動します。 前回実行したものと同じ TeamCity バージョンである必要があります (TeamCity の アップグレードは別のプロシージャとして実行する必要があります)。

   移行が成功したことを確認したら、 場合があります 古い HSQLDB ファイル: buildserver.* を削除して、不要になった内部ストレージデータを除去します。

バックアップと復元

バックアップを作成し 、異なるターゲットデータベース設定を使用して 復元することができます。 データベースデータのみを復元するには、復元オプションを指定する必要がある場合があります。

トラブルシューティング

• 移行実行中の拡張情報は、 logs\teamcity-maintenance.log ファイルに記録されます。 また、 logs\teamcity-maintenance-truncation.log には、移行プロセス中のデータの切り捨てに関する拡張情報が含まれています。

• エラー "メモリ不足" が発生した場合は、 -Xmx512m パラメーターの数値を maintainDB スクリプト内で増やしてみてください。 32 ビットプラットフォームでは、最大値は約 1300 MB です。
  または、HSQLDB をスタンドアロンモードで次の方法で実行します

  java -Xmx256M -cp ..\webapps\ROOT\WEB-INF\lib\hsqldb.jar org.hsqldb.Server -database.0 <TeamCity Data Directory>\system\buildserver -dbname.0 buildserver

  次に、データベースをソースとして指定して移行ツールを実行します: jdbc:hsqldb:hsql://localhost/buildserver sa ''

• ツールの実行中に "入力行が長すぎます" エラーが発生した場合は、代替クラスパスメソッドを使用するようにスクリプトを変更してください。
  maintainDB.bat では、" WEB-INF\lib からすべての JAR をクラスパスに追加" コメントの下にある行を除去し、" 代替クラスパス: 必要な JAR のみを追加" コメントの下にある行をコメント解除してください。