CollabNet TeamForge 7.0 Administration Guide | Contents | 2 Contents TeamForge system administrator how-tos.............................................................6 Install CollabNet TeamForge 7.0.........................................................................................................................6 Plan your CollabNet TeamForge 7.0 installation.....................................................................................6 Set up networking for your TeamForge box........................................................................................... 7 Install CollabNet TeamForge 7.0 on Red Hat/CentOS............................................................................8 Install CollabNet TeamForge 7.0 on SuSE............................................................................................62 Install TeamForge on VMware Player or VMware ESXi................................................................... 114 Upgrade to TeamForge 7.0.............................................................................................................................. 118 Plan your upgrade to TeamForge 7.0.................................................................................................. 118 Upgrade to TeamForge 7.0 on Red Hat/CentOS................................................................................. 119 Upgrade to TeamForge 7.0 on SuSE................................................................................................... 173 Upgrade to CollabNet TeamForge 7.0 on a virtual machine...............................................................221 Is my TeamForge site "dedicated" or "advanced?"............................................................................. 223 Enable reporting while upgrading from TeamForge 6.1.1 to 7.0........................................................ 224 Troubleshooting: Upgrade PostgreSQL manually............................................................................... 224 Install a different build of TeamForge 7.0...........................................................................................225 TeamForge 7.0 Patch........................................................................................................................................226 Patch CollabNet TeamForge 7.0 on Red Hat/CentOS.........................................................................226 Patch CollabNet TeamForge 7.0 on SuSE...........................................................................................228 Patch TeamForge 7.0 on VMware Player or VMware ESXi.............................................................. 230 Maintain your TeamForge 7.0 site...................................................................................................................232 Upgrade CLI reports to the latest version on Red Hat, CentOS or SUSE...........................................232 Install Indexer on a separate server..................................................................................................... 232 Supply your TeamForge license key from Teamforge user interface..................................................234 Supply your CollabNet TeamForge license key as a text file............................................................. 234 Support CollabNet TeamForge System Administrators.......................................................................235 Protect your CollabNet TeamForge site...............................................................................................245 Get information about a CollabNet TeamForge site............................................................................249 Rebuild runtime without the install directory...................................................................................... 250 Turn on site-wide reporting..................................................................................................................250 Synchronize TeamForge source control integrations...........................................................................251 Provide more than one source control server...................................................................................... 251 Upgrade Subversion on RedHat or CentOS.........................................................................................252 Upgrade Subversion on SuSE.............................................................................................................. 252 Change your site's domain name..........................................................................................................253 Specify DNS servers.............................................................................................................................253 Optimize PostgreSQL with vacuum.....................................................................................................254 Change the location of a log file......................................................................................................... 254 Change the logging level on your site................................................................................................. 254 Raise the logging visibility of selected database requests................................................................... 255 Rotate TeamForge log files..................................................................................................................256 Schedule data extraction for reporting................................................................................................. 256 Removing users from monitoring objects............................................................................................ 257 Back up and restore CollabNet TeamForge data................................................................................. 257 Move the datamart to a separate box...................................................................................................259 Integrate TeamForge 7.0 with other tools........................................................................................................261 Integrated application example: Pebble................................................................................................261 Set up Black Duck Code Sight............................................................................................................ 262 Set up Review Board............................................................................................................................276 | Contents | 3 Set up the TeamForge Git integration..................................................................................................286 A preface to the TeamForge-Orchestrate integration...........................................................................287 Frequently asked questions about administrating a TeamForge site.............. 288 TeamForge installation FAQs.......................................................................................................................... 288 Do I need an advanced TeamForge installation?.................................................................................288 How many servers do I need to run a CollabNet TeamForge site?.....................................................289 How does TeamForge handle third-party applications?...................................................................... 289 Should I upgrade to TeamForge 7.0 on a new box?........................................................................... 290 Should I move my TeamForge database to its own server?................................................................291 Should I move my source control application to its own server?........................................................291 What are the right PostgreSQL settings for my site?.......................................................................... 291 Is it possible to change artifact prefixes in TeamForge?..................................................................... 292 Can I run other java applications in the same JBoss instance as CollabNet Team Forge?.................. 292 What does it mean to run CollabNet TeamForge on a virtual machine?.............................................292 Who is responsible for applying OS updates to the underlying VMware image?............................... 292 What is a patch?................................................................................................................................... 292 Why do I get a URL "not found" or "moved permanently" error after applying a patch/upgrade?..... 293 Why does the the Yum installer display a warning message on Centos 6?.........................................293 Why am I getting a Yum repository filename conflict?...................................................................... 293 When do I run the initial load job?..................................................................................................... 294 Common errors in TeamForge......................................................................................................................... 295 Troubleshooting VMware errors.......................................................................................................... 295 Troubleshooting database/datamart/ETL errors................................................................................... 296 Troubleshooting JBoss errors..............................................................................................................