If you have customized your OLD-CB/repository structure, e.g. mounted external volumes as docs and/or git, hg or svn, then the above procedure might not be appropriate, and, for the given example, you would better unmount the external volumes from OLD-CB/repository and mount to NEW-CB/repository.
To keep all codeBeamer system configuration data you can simply copy OLD-CB/tomcat/webapps/cb/WEB-INF/classes/general.xml to NEW-CB/tomcat/webapps/cb/WEB-INF/classes/general.xml,
Step 3. Get and install a new license
Please check whether your available license is compatible with target codeBeamer release.
You need to have that license at hand before you continue with the next steps.
Please also consider that you can only request licenses from Intland Software from Monday through Friday, 8:00 - 17:00 GMT+2, and that processing a license request may take hours up to several days!
So do not shut down your live production system or schedule to upgrade overnight or during the weekend until you already have a license for the new system.
To install the new license:
Copy the new license in XML format from the email you received to the clipboard.
Edit NEW-CB/tomcat/webapps/cb/WEB-INF/classes/general.xml and replace the (empty) <license> block with the license data from the clipboard.
Step 4. Database Configuration
There is no automatic migration of the OLD-CB database configuration to the NEW-CB installation.
Unless you change the <database> configuration in NEW-CB/tomcat/webapps/cb/WEB-INF/classes/general.xml and install a new license, codeBeamer will use its built-in (initially empty) Apache Derby database.
If you configure codeBeamer to re-use an existing database and have installed a new license, codeBeamer will convert the existing database schema automatically into the new schema upon first startup, and consequently this database cannot be used by OLD-CB any more.
Create a dump of the OLD_CB codeBeamer database schema: mysqldump --routines -h localhost -P 3306 --max_allowed_packet=128M -u root -p codebeamer > cb.dump
Please adjust database host, port, username and passwort according to your OLD_CB configuration.
Shutdown OLD_CB instance forever.
Setup a new MySQL instance as an independent service (you can also use an already existing shared MySQL 5.0 or higher instance) and prepare the new codeBeamer schema according to Preparing MySQL Database for Installation.
Import the dump into the new database schema: mysql -h localhost -P 3306 --max_allowed_packet=128M -u root -p codebeamer < cb.dump
Please adjust database host and port according to your NEW_CB configuration. You will also be prompted for the MySQL root password.
codeBeamer database schema requires the CREATE VIEW privilege.
Because this privilege was not required in older releases, it is typically missing and your database administrator has to grant it manually.
GRANT CREATE VIEW to <codeBeamer schema user>
No upgrade is supported for Apache Derby databases!
Please contact Intland Professional Services if you need to upgrade a codeBeamer instance with a Derby database, or want to migrate the Derby database to MySQL or Oracle.
You can copy your email sending settings from OLD-CB/tomcat/webapps/cb/WEB-INF/classes/general.xml and replace the empty <mail ... ></mail> in NEW-CB/tomcat/webapps/cb/WEB-INF/classes/general.xml.
Step 7. Login/Registration Setup
You can copy your login/registration settings from OLD-CB/tomcat/webapps/cb/WEB-INF/classes/general.xml and replace the empty <login ... </login> in NEW-CB/tomcat/webapps/cb/WEB-INF/classes/general.xml.
Step 8. Port Configuration
If you had configured an Apache server in front of OLD-CB (Tomcat) (via mod_jk), you need to enable the NEW-CB Tomcat AJP 1.3 Connector (typically on port 8009) again.
Please edit ~/NEW-CB/tomcat/conf/server.xml and remove the comments (<!---->) around the section
If you had used a different port for this connection, please adjust the port number as well.
Step 9. Runtime Parameters
If you had customised OLD-CB runtime variables, e.g. special JVM, HEAPSIZE, etc., then you should copy these settings from the OLD_CB start script to the NEW-CB start script.
Unix/Linux/Mac OS X
Windows (No Service)
For changes in ~/NEW-CB/tomcat/bin/cbservice.bat to take effect, you must run the following command manually afterwards
cbservice codebeamer codebeamer
Step 10. Start
Starting with codeBeamer 7.5.0, we introduced a post installation wizard that helps you configure your instance. (Alternatively, you can omit this wizard by selecting the upgrade option during the installation process). When the wizard is finished and every previous configuration is set, the application restarts the server and the upgrade procedure is finished.
Alternatively, you can switch off the wizard manually by modifying the NEW-CB/tomcat/webapps/cb/WEB-INF/classes/general.xml by setting the setup attribute to false in the installation tag:
<installation setup="false" ></installation>
Start the NEW-CB server. The first time the codeBeamer server is started, the database schema will be upgraded to version NEW-CB.
Depending on which version you're upgrading from, and the amount of data in your database, the first startup of the NEW-CB server might take up to 10-120 min, because the database scheme will be updated in the background (the database process might use a lot of CPU).
Do not shutdown or kill the NEW-CB server as long as the database upgrade is in progress, otherwise the database might be corrupted.
Step 11. Logo Configuration
To restore your custom logo and welcome text manually, you need to Login as system administrator and re-upload your logo file.
You can find the logo file used by OLD-CB at OLD-CB/tomcat/webapps/cb/images/IL_Logo_120x40.gif.
Step 12. Clearing Browser Caches
Step 13. Starting Re-indexing
After upgrading, the index database is empty thus searching will not provide any matching. Starting with codeBeamer 6.1, re-indexing is automatic after a completed upgrade.
(In older versions, re-indexing was started by the System Administrator (Index link under System Admin tab)).