Character set/collation-related problems
To fix a problem, perform the following steps:
- Create a new database with the appropriate character set and collation. For the database-specific information, see PostgreSQL, MySQL
MS SQL. If you are using MySQL or MS SQL, we recommend using the case-sensitive collation to avoid issues with agents on Unix-like OS. - Copy the current <TeamCity Data Directory>/config/database.properties file, and change the database references in the copy to the newly created database.
- Stop the TeamCity server.
- Use the maintainDB tool to migrate to the new database:
maintainDB migrate [-A <path-to-data-dir>] -T <
new
-database-properties-file>
Depending on the size of your database, the migration may take from several minutes to several hours. For more information on the maintainDB tool, see this section.
- Upon the successful completion of the database migration, the maintainDB tool should update the <TeamCity Data Directory>/config/database.properties file with references to the new database. Ensure that the file has been updated. Edit the file manually if the tool fails to do it automatically.
- Start the TeamCity server.
Please sign in to leave a comment.