Upgrade a dedicated site to TeamForge 6.1.1 on new hardware

To upgrade to TeamForge 6.1.1, set up a new box, then bring over your old site's data and convert it.

On the existing TeamForge application box, log in as root and take these steps:

1. Stop the TeamForge application server and the Apache server, if they are running.
   • /etc/init.d/httpd stop
   • /etc/init.d/collabnet stop
2. Back up your site data.
   1. Make a dump file of your site database. (This may be the same as your TeamForge application server or a separate box.)

      You have to do a PostgreSQL dump because we are upgrading the PostgreSQL application as part of this upgrade.

      Note: These commands are for a PostgreSQL database, which is the default. If your site uses an Oracle database, follow the Oracle backup procedure instead.
      • su - postgres
      • /usr/bin/pg_dumpall > /var/lib/pgsql/backups/teamforge_data_backup.dmp
      • exit
      • mkdir /tmp/backup_dir
      • cp /var/lib/pgsql/backups/teamforge_data_backup.dmp /tmp/backup_dir/
      Note: If your reporting database is running on a separate port, back up your reporting database too:

      • /usr/bin/pg_dumpall -p <reports_database_port> > /var/lib/pgsql/backups/teamforge_reporting_data_backup.dmp
   2. Make an archive file with the following data directories:

      Directory	Contents
      /opt/collabnet/teamforge/var	User-created data, such as artifact attachments
      /svnroot	Subversion source code repositories
      /sf-svnroot	Subversion repository for branding data
      /cvsroot	CVS source code repositories (not present on all sites)

      • cp -Rpf /svnroot /sf-svnroot /cvsroot /opt/collabnet/teamforge/var /tmp/backup_dir
      • cd /tmp
      • tar czvf 61backup.tgz backup_dir
   3. Back up your SSH keys, if any.
   4. Back up your SSL certificates and keys, if any.
3. Stop PostgreSQL.
   • /etc/init.d/postgresql stop
4. Copy the file system data to the new box.
   • scp /tmp/61backup.tgz username@newbox:/tmp
5. Copy the master configuration file from the old server to the same location on the new server.
   • scp /opt/collabnet/teamforge-installer/6.1.0.0/conf/site-options.conf username@newbox:/tmp
   Tip: scp is just an example. Use whatever file transfer method you prefer.

Do this on the new TeamForge 6.1.1 box:

6. Install CentOS 5.6 and log in as root.
   • See Platform specification for TeamForge 6.1.1 for the full platform requirements.
   • See the Red Hat installation guide for help.
   Important: Don't customize your installation. Select only the default packages list.
7. Uninstall the PostgreSQL support package and the Dovecot mail server to clear the way for TeamForge to install PostgreSQL 9.0.4. These packages are installed as part of the default CentOS install.
   • yum erase postgresql-libs dovecot
8. Download the TeamForge 6.1.1 installation repository from open.collab.net. Copy it to /etc/yum.repos.d/.
9. Install the TeamForge application.
   • yum install teamforge-app teamforge-scm teamforge-database teamforge-etl
   Tip: If the yum installer balks, you may have duplicate rpm packages.

   1. Get the yum-utils package, if it isn't already installed.
      • yum install yum-utils
   2. Check for duplicate packages.
      • package-cleanup --dupes
   3. Clean up the older packages, if any.
      • package-cleanup --cleandupes
   4. Rerun the yum installer.
      • yum install teamforge [options]
10. Put the site-options.conf file where the installer can find it.
    • cp /tmp/site-options.conf /opt/collabnet/teamforge-installer/6.1.1.0/conf
11. Log in as root and unpack the file system data.
    • cd /tmp
    • tar xzvf 61backup.tgz
12. Open the site-options.conf file. This is the master configuration file that controls your TeamForge site.
    • vi /opt/collabnet/teamforge-installer/6.1.1.0/conf/site-options.conf
    Note: vi is an example. Any *nix text editor will work.
13. Update the host name and domain name, if necessary.
    • HOST_my.host.name=app database subversion cvs etl datamart
    • DOMAIN_my.host.name=my.domain.name
14. Make sure your Java settings are right for TeamForge 6.1.1.
    1. Check the JAVA_HOME variable in /opt/collabnet/teamforge-installer/6.1.1.0/conf/site-options.conf to make sure TeamForge is using the right JDK.
       • vi /opt/collabnet/teamforge-installer/6.1.1.0/conf/site-options.conf
       The JAVA_HOME variable should look like this:
       • JAVA_HOME=/usr/java/jdk1.6.0_26
    2. In the JBOSS_JAVA_OPTS variable, increase the MaxPermSize value to 512.
15. In the site-options.conf file, make sure you do the following:
    1. If you don't specify a domain name, replace the HOST_localhost token with the hostname. Otherwise, ViewVC pages for Subversion and CVS repositories created after the site is up, will be rendered with a CSS error.
    2. Important: It is mandatory that you include the SCM_DEFAULT_SHARED_SECRET token in the site-options.conf file of the primary TeamForge server, and give it a value of 16-24 characters.
       Remember that you need to use that same key in the external SCM integration server also.
    3. Increase the Phoenix optimization interval.

       PHOENIX_JAVA_OPTS=-Xms256m -Xmx256m -server -XX:+HeapDumpOnOutOfMemoryError  -XX:HeapDumpPath=/tmp -verbose:gc -XX:+
       PrintGCTimeStamps -XX:+PrintGCDetails -Dsun.rmi.dgc.client.gcInterval=600000 -Dsun.rmi.dgc.server.gcInterval=600000 -Dsf
       .luceneOptimizeEvery=100000

    4. Increase the value of MAX_WWW_CLIENTS.

       MAX_WWW_CLIENTS=200

    5. Review the variables you've changed, then save the site-options.conf file.
16. Run the installer.
    • cd /opt/collabnet/teamforge-installer/6.1.1.0
    • ./install.sh -r -I -V
17. Bring your site data back.
    1. Reload the PostgreSQL data.
       • su - postgres
       • /usr/bin/psql < /tmp/backup_dir/teamforge_data_backup.dmp
       • exit
       Note: If your reporting database is running on a separate port, restore that data too:

       • su - postgres -c "/usr/bin/psql -p <reports_database_port> < /tmp/backup_dir/teamforge_reporting_data_backup.dmp"
    2. Reload svnroot, sf-svnroot, cvsroot, and var.
18. Update the file permissions on your site's data.
    • /opt/collabnet/teamforge/runtime/scripts/fix_data_permissions.sh
    Note: This process can take a long time for a site with a lot of data.
19. Convert your site data to work with TeamForge 6.1.1.
    Tip: Before you kick off the data migration, use the /etc/init.d/collabnet status command to make sure Jboss and Tomcat are stopped.
    • /opt/collabnet/teamforge/runtime/scripts/migrate.py
    The migrate.py script locates the existing site data and modifies it as needed.

    This includes configuration data for LDAP and the James mail server. Any modifications that you have applied to these components on your old site are reproduced on your upgraded TeamForge 6.1.1 site.

20. Start TeamForge.
    • /etc/init.d/collabnet start
21. Apply the finishing touches and make sure everything is running smoothly after upgrading to TeamForge 6.1.1.
    Note: To ensure that Apache starts up automatically after a reboot, run this command now:

    • /sbin/chkconfig --level 2345 httpd on
    1. Make sure your users can still access their source control services. See Synchronize TeamForge source control integrations.
    2. If you are bringing SSL certificates and keys from your old site, make sure their locations match the paths specified by the SSL_CERT_FILE and SSL_KEY_FILE variables in site-options.conf. See Set up SSL for your TeamForge site.
    3. Log into your site as the administrator.
    4. Reboot the server and make sure all services come up automatically at startup.
    5. Rebuild your site's search index so that users get up-to-date search results. See Rebuild TeamForge search indexes for details.
    6. If your site has custom branding, verify that your branding changes still work as intended. See Customize anything on your site.
    7. Let your site's users know they've been upgraded. See Create a site-wide broadcast.
    Important: Do not delete the teamforge-installer/6.1.1.0 directory. You will need it for future maintenance and upgrades.