TeamForge 7.2 Administration Guide | Contents | 2 Contents TeamForge system administrator how-tos.............................................................6 Install CollabNet TeamForge 7.2.........................................................................................................................6 Plan your CollabNet TeamForge 7.2 installation.....................................................................................6 Set up networking for your TeamForge server........................................................................................7 Install CollabNet TeamForge 7.2 on Red Hat/CentOS............................................................................8 Install CollabNet TeamForge 7.2 on SuSE............................................................................................44 Install TeamForge on VMware Player or VMware ESXi..................................................................... 79 Verify your TeamForge 7.2 installation.................................................................................................83 Upgrade to TeamForge 7.2................................................................................................................................ 83 Plan your upgrade to TeamForge 7.2.................................................................................................... 83 Upgrade to TeamForge 7.2 on Red Hat/CentOS................................................................................... 84 Upgrade to TeamForge 7.2 on SuSE................................................................................................... 138 Upgrade to CollabNet TeamForge 7.2 on a virtual machine...............................................................189 Install a different build of TeamForge 7.2...........................................................................................191 TeamForge 7.2 Patch........................................................................................................................................192 Patch CollabNet TeamForge 7.2 on RHEL/CentOS............................................................................192 Patch CollabNet TeamForge 7.2 on SUSE..........................................................................................193 Patch TeamForge 7.2 on VMware Player or VMware ESXi.............................................................. 195 Uninstall TeamForge 7.2.................................................................................................................................. 197 Maintain your TeamForge 7.2 site...................................................................................................................197 Upgrade PostgreSQL using PGTurant................................................................................................. 197 Upgrade CLI reports to the latest version on Red Hat, CentOS or SUSE...........................................199 Install Indexer on a separate server..................................................................................................... 200 Supply your TeamForge license key from Teamforge user interface..................................................201 Supply your CollabNet TeamForge license key as a text file............................................................. 201 Support CollabNet TeamForge System Administrators.......................................................................202 Protect your CollabNet TeamForge site...............................................................................................212 Get information about a CollabNet TeamForge site............................................................................217 Rebuild runtime without the install directory...................................................................................... 218 Turn on site-wide reporting..................................................................................................................218 Synchronize TeamForge source control integrations...........................................................................219 Provide more than one source control server...................................................................................... 219 Upgrade Subversion and PGSQL on RHEL or CentOS......................................................................220 Upgrade Subversion and PGSQL on SuSE......................................................................................... 221 Change the scmviewer password......................................................................................................... 222 Change your site's domain name..........................................................................................................222 Specify DNS servers.............................................................................................................................223 Optimize PostgreSQL with vacuum.....................................................................................................223 Change the location of a log file......................................................................................................... 224 Change the logging level on your site................................................................................................. 224 Raise the logging visibility of selected database requests................................................................... 224 Rotate TeamForge log files..................................................................................................................225 Schedule data extraction for reporting................................................................................................. 226 Removing users from monitoring objects............................................................................................ 226 Back up and restore CollabNet TeamForge data................................................................................. 227 Move the datamart to a separate box...................................................................................................229 Integrate TeamForge 7.2 with other tools........................................................................................................230 Integrated application example: Pebble................................................................................................230 Set up Black Duck Code Sight............................................................................................................ 232 | Contents | 3 Set up Review Board............................................................................................................................244 Set up Git..............................................................................................................................................249 A preface to the TeamForge-Orchestrate integration...........................................................................250 Frequently asked questions about administrating a TeamForge site.............. 252 TeamForge installation/upgrade FAQs.............................................................................................................252 Should I upgrade to TeamForge 7.2 on a new box?........................................................................... 252 How many servers do I need to run a CollabNet TeamForge site?.....................................................252 Should I move my TeamForge database to its own server?................................................................253 What are the right PostgreSQL settings for my site?.......................................................................... 253 Should I move my source control application to its own server?........................................................254 Upgrade TeamForge 7.1 search index to Lucene 4.x format...............................................................255 Why do I get an exception when recreating the runtime?................................................................... 255 Users invoked via su command in TeamForge....................................................................................255 How does TeamForge handle third-party applications?...................................................................... 256 Is it possible to change artifact prefixes in TeamForge?..................................................................... 257 Can I run other java applications in the same JBoss instance as CollabNet TeamForge?................... 257 What does it mean to run CollabNet TeamForge on a virtual machine?.............................................257 Who is responsible for applying OS updates to the underlying VMware image?............................... 257 What is a patch?................................................................................................................................... 257 Why do I get a URL "not found" or "moved permanently" error after applying a patch/upgrade?..... 258 Why does the the Yum installer display a warning message on Centos 6?.........................................258 Why am I getting a Yum repository filename conflict?...................................................................... 258 When do I run the initial load job?..................................................................................................... 258 Common errors in TeamForge........................................................................................................................